@elizaos/plugin-feishu 2.0.0-beta.1 → 2.0.3-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,146 +1,98 @@
-# Feishu/Lark Client Plugin for ElizaOS
+# @elizaos/plugin-feishu
 
-This plugin integrates a Feishu (飞书) / Lark client with ElizaOS, allowing agents to interact via ByteDance's enterprise collaboration platform. It supports both the Chinese Feishu platform and the global Lark platform.
+Feishu (飞书) / Lark messaging connector for elizaOS agents. Connects an Eliza
+agent to ByteDance's enterprise collaboration platform — Feishu for China, Lark
+globally — over a persistent WebSocket event subscription using the Lark Open
+Platform API (`@larksuiteoapi/node-sdk`).
 
-## Features
+The plugin registers a `FeishuService` that opens the WebSocket connection,
+routes inbound messages to the agent runtime as standard elizaOS message events,
+and exposes a message connector (`send_message`, `send_card`, `send_image`,
+`send_file`). It is opt-in and auto-enables when a `feishu` connector block is
+present in the agent config (see `auto-enable.ts`).
 
-- **Seamless Feishu/Lark Integration**: Connects ElizaOS agents to Feishu/Lark through the Open Platform API.
-- **WebSocket Real-time Events**: Receives messages and events via WebSocket for low-latency interactions.
-- **Multi-region Support**: Works with both Feishu (China) and Lark (Global) platforms.
-- **Configuration Validation**: Ensures required settings are properly configured before starting.
-- **DM and Group Support**: Handles both direct messages and group conversations.
+## Setup
 
-## Configuration Options
+### 1. Create a Feishu/Lark app
 
-| Key | Type | Default | Description |
-| --- | ---- | ------- | ----------- |
-| `FEISHU_APP_ID` | String | Required | Application ID from Feishu/Lark Open Platform (cli_xxx format). |
-| `FEISHU_APP_SECRET` | String | Required | Application secret for authentication. |
-| `FEISHU_DOMAIN` | String | `"feishu"` | Domain to use: `"feishu"` for China or `"lark"` for global. |
-| `FEISHU_ALLOWED_CHATS` | JSON Array | `[]` | List of chat IDs the bot is allowed to interact with. |
-| `FEISHU_TEST_CHAT_ID` | String | - | Chat ID for running tests. |
+1. Open the [Feishu Open Platform](https://open.feishu.cn/) or
+   [Lark Open Platform](https://open.larksuite.com/) and create an application.
+2. Enable the **Bot** capability (send/receive messages) and **Event
+   Subscription** in **long connection / WebSocket** mode.
+3. Copy the App ID (`cli_xxx`) and App Secret from the credentials page.
 
-## Pre-Requisites
+### 2. Provide credentials
 
-### 1. Create a Feishu/Lark App
-
-1. Go to the [Feishu Open Platform](https://open.feishu.cn/) or [Lark Open Platform](https://open.larksuite.com/)
-2. Create a new application
-3. Enable the following capabilities:
-   - **Bot** - For sending and receiving messages
-   - **Event Subscription** - Enable WebSocket mode for real-time events
-4. Copy your App ID and App Secret from the credentials page
-
-### 2. Configure Environment Variables
-
-Add the following to your `.env` file:
+Set the env vars (read via `runtime.getSetting` in `src/environment.ts`):
 
 ```env
 FEISHU_APP_ID=cli_xxx
 FEISHU_APP_SECRET=your-app-secret
-FEISHU_DOMAIN=feishu  # or "lark" for global
+FEISHU_DOMAIN=feishu   # or "lark" for global
 ```
 
-### 3. Configure Your Character
+The env vars act as the `"default"` account. For multiple accounts, set
+`character.settings.feishu` instead (see `src/accounts.ts`,
+`FeishuMultiAccountConfig`).
+
+### 3. Enable the connector
 
-Create or modify your character configuration file:
+Add a `feishu` block to the character `connectors` config. The plugin
+auto-enables when the block is present and not explicitly disabled:
 
 ```json
 {
-  "clients": ["feishu"],
-  "settings": {
-    "feishu": {
-      "appId": "cli_xxx",
-      "appSecret": "your-app-secret",
-      "domain": "feishu"
-    }
+  "connectors": {
+    "feishu": { "enabled": true }
   }
 }
 ```
 
-## Usage
-
-### Starting the Bot
-
-From the project root:
-
-```bash
-npm run dev
-```
-
-Or using bun:
-
-```bash
-bun start --character="characters/your-character.json"
-```
-
-## API Endpoints
-
-The plugin connects to the following Feishu/Lark API endpoints:
-
-| Domain | Base URL |
-| ------ | -------- |
-| Feishu (China) | `https://open.feishu.cn` |
-| Lark (Global) | `https://open.larksuite.com` |
-
-## Message Types Supported
+## Config
 
-- Text messages
-- Rich text (post) messages
-- Interactive cards
-- Image messages
-- File messages
+| Env var | Required | Default | Description |
+|---|---|---|---|
+| `FEISHU_APP_ID` | Yes | — | App ID (`cli_xxx` format; must start with `cli_`). |
+| `FEISHU_APP_SECRET` | Yes | — | App secret for authentication. |
+| `FEISHU_DOMAIN` | No | `feishu` | `feishu` (China, `open.feishu.cn`) or `lark` (global, `open.larksuite.com`). |
+| `FEISHU_ALLOWED_CHATS` | No | `[]` | JSON array of chat IDs the bot may interact with. Empty = all chats. |
+| `FEISHU_IGNORE_BOT_MESSAGES` | No | `true` | Set `"false"` to process messages from other bots. |
+| `FEISHU_RESPOND_ONLY_TO_MENTIONS` | No | `false` | Set `"true"` to respond only when @-mentioned. |
+| `FEISHU_TEST_CHAT_ID` | No | — | Chat ID used by the test suite. |
 
-## Event Types
+## Supported message types
 
-The plugin emits the following event types:
+Text, rich text (`post`), interactive cards, images, and files. Outbound text is
+chunked at `FEISHU_TEXT_CHUNK_LIMIT` (4000 chars) via `chunkFeishuText` in
+`src/formatting.ts`.
 
-| Event | Description |
-| ----- | ----------- |
-| `FEISHU_WORLD_JOINED` | Bot joined a new chat/group |
-| `FEISHU_WORLD_CONNECTED` | Bot connected successfully |
-| `FEISHU_WORLD_LEFT` | Bot left a chat/group |
-| `FEISHU_MESSAGE_RECEIVED` | A message was received |
-| `FEISHU_MESSAGE_SENT` | A message was sent |
-| `FEISHU_ENTITY_JOINED` | A user joined a chat |
-| `FEISHU_ENTITY_LEFT` | A user left a chat |
+## Events emitted
 
-## Security Best Practices
+`FeishuEventTypes` (`src/types.ts`): `FEISHU_WORLD_CONNECTED`,
+`FEISHU_WORLD_JOINED`, `FEISHU_WORLD_LEFT`, `FEISHU_ENTITY_JOINED`,
+`FEISHU_ENTITY_LEFT`, `FEISHU_ENTITY_UPDATED`, `FEISHU_MESSAGE_RECEIVED`,
+`FEISHU_MESSAGE_SENT`, `FEISHU_REACTION_RECEIVED`, `FEISHU_INTERACTION_RECEIVED`,
+`FEISHU_SLASH_START`.
 
-- **Production**: Restrict bot access using `FEISHU_ALLOWED_CHATS` to specify authorized chat IDs.
-- **Token Management**: Keep your App Secret secure and never expose it in public repositories.
-- **Webhook Verification**: The plugin automatically verifies webhook signatures from Feishu/Lark.
+## Commands
 
-## Feishu vs Lark
-
-| Feature | Feishu | Lark |
-| ------- | ------ | ---- |
-| Region | China | Global |
-| Domain | open.feishu.cn | open.larksuite.com |
-| Language | Chinese | English |
-| Data Residency | China | Global |
-
-Use `FEISHU_DOMAIN=lark` when deploying for international users.
+```bash
+bun run --cwd plugins/plugin-feishu build         # bun run build.ts → dist/
+bun run --cwd plugins/plugin-feishu dev           # bun --hot build.ts
+bun run --cwd plugins/plugin-feishu test          # vitest run
+bun run --cwd plugins/plugin-feishu lint          # biome check --write --unsafe
+bun run --cwd plugins/plugin-feishu typecheck     # tsgo --noEmit
+```
 
 ## Troubleshooting
 
-### Connection Issues
-
-If you encounter connection issues:
-
-1. Verify your App ID and App Secret are correct
-2. Ensure the Bot capability is enabled in your app settings
-3. Check that WebSocket event subscription is enabled
-4. Verify your server can reach Feishu/Lark API endpoints
-
-### Message Not Received
-
-If messages are not being received:
-
-1. Ensure the bot is added to the chat/group
-2. Check that `FEISHU_ALLOWED_CHATS` includes the chat ID (or is empty for all chats)
-3. Verify event subscription is properly configured
+- **Connection fails:** verify App ID / App Secret, confirm the Bot capability is
+  enabled, and confirm Event Subscription is in WebSocket (long connection) mode.
+  The service retries connection up to 5 times with exponential backoff.
+- **Messages not received:** confirm the bot is added to the chat, and that the
+  chat ID is in `FEISHU_ALLOWED_CHATS` (or that the list is empty).
 
-## License
+Keep `FEISHU_APP_SECRET` out of source control. Restrict access in production
+with `FEISHU_ALLOWED_CHATS`.
 
-MIT
+For internals (services, providers, layout, gotchas), see `CLAUDE.md`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-feishu",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.3-beta.2",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -8,10 +8,26 @@
   "exports": {
     "./package.json": "./package.json",
     ".": {
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
       "import": {
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       }
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
   "files": [
@@ -27,7 +43,7 @@
     }
   },
   "dependencies": {
-    "@elizaos/core": "2.0.0-beta.1",
+    "@elizaos/core": "2.0.3-beta.2",
     "@larksuiteoapi/node-sdk": "^1.40.0",
     "@types/node": "^25.0.3",
     "typescript": "^6.0.3"
@@ -47,7 +63,7 @@
     "format:check": "bunx @biomejs/biome format .",
     "lint:check": "bunx @biomejs/biome check .",
     "build:ts": "bun run build",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsgo --noEmit"
   },
   "publishConfig": {
     "access": "public"
@@ -99,5 +115,6 @@
     "platformDetails": {
       "node": "ESM build available via exports.import"
     }
-  }
+  },
+  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
 }

package/dist/accounts.d.ts

@@ -1,148 +0,0 @@
-import type { IAgentRuntime } from "@elizaos/core";
-/**
- * Default account identifier used when no specific account is configured
- */
-export declare const DEFAULT_ACCOUNT_ID = "default";
-/**
- * Token source indicator
- */
-export type FeishuTokenSource = "config" | "env" | "character" | "none";
-/**
- * Group-specific configuration
- */
-export interface FeishuGroupConfig {
-    /** If false, ignore messages from this group */
-    enabled?: boolean;
-    /** Allowlist for users in this group */
-    allowFrom?: Array<string | number>;
-    /** Require bot mention to respond */
-    requireMention?: boolean;
-    /** Custom system prompt for this group */
-    systemPrompt?: string;
-    /** Skills enabled for this group */
-    skills?: string[];
-}
-/**
- * Configuration for a single Feishu account
- */
-export interface FeishuAccountConfig {
-    /** Optional display name for this account */
-    name?: string;
-    /** Bot display name */
-    botName?: string;
-    /** If false, do not start this Feishu account */
-    enabled?: boolean;
-    /** Feishu App ID */
-    appId?: string;
-    /** Feishu App Secret */
-    appSecret?: string;
-    /** Path to file containing app secret */
-    appSecretFile?: string;
-    /** Encrypt key for event callback */
-    encryptKey?: string;
-    /** Verification token for event callback */
-    verificationToken?: string;
-    /** Base API URL (for self-hosted Feishu) */
-    apiUrl?: string;
-    /** Allowlist for DM senders */
-    allowFrom?: Array<string | number>;
-    /** Allowlist for groups */
-    groupAllowFrom?: Array<string | number>;
-    /** DM access policy */
-    dmPolicy?: "open" | "allowlist" | "pairing" | "disabled";
-    /** Group message access policy */
-    groupPolicy?: "open" | "allowlist" | "disabled";
-    /** Max media size in MB */
-    mediaMaxMb?: number;
-    /** Text chunk limit for messages */
-    textChunkLimit?: number;
-    /** Webhook path for event callbacks */
-    webhookPath?: string;
-    /** Group-specific configurations */
-    groups?: Record<string, FeishuGroupConfig>;
-}
-/**
- * Multi-account Feishu configuration structure
- */
-export interface FeishuMultiAccountConfig {
-    /** Default/base configuration applied to all accounts */
-    enabled?: boolean;
-    appId?: string;
-    appSecret?: string;
-    appSecretFile?: string;
-    encryptKey?: string;
-    verificationToken?: string;
-    apiUrl?: string;
-    dmPolicy?: "open" | "allowlist" | "pairing" | "disabled";
-    groupPolicy?: "open" | "allowlist" | "disabled";
-    mediaMaxMb?: number;
-    textChunkLimit?: number;
-    webhookPath?: string;
-    /** Per-account configuration overrides */
-    accounts?: Record<string, FeishuAccountConfig>;
-    /** Group configurations at base level */
-    groups?: Record<string, FeishuGroupConfig>;
-}
-/**
- * Resolved Feishu account with all configuration merged
- */
-export interface ResolvedFeishuAccount {
-    accountId: string;
-    enabled: boolean;
-    name?: string;
-    appId: string;
-    appSecret: string;
-    tokenSource: FeishuTokenSource;
-    configured: boolean;
-    config: FeishuAccountConfig;
-}
-/**
- * Normalizes an account ID, returning the default if not provided
- */
-export declare function normalizeAccountId(accountId?: string | null): string;
-/**
- * Gets the multi-account configuration from runtime settings
- */
-export declare function getMultiAccountConfig(runtime: IAgentRuntime): FeishuMultiAccountConfig;
-/**
- * Lists all configured account IDs
- */
-export declare function listFeishuAccountIds(runtime: IAgentRuntime): string[];
-/**
- * Resolves the default account ID to use
- */
-export declare function resolveDefaultFeishuAccountId(runtime: IAgentRuntime): string;
-/**
- * Resolves a complete Feishu account configuration
- */
-export declare function resolveFeishuAccount(runtime: IAgentRuntime, accountId?: string | null): ResolvedFeishuAccount;
-/**
- * Lists all enabled Feishu accounts
- */
-export declare function listEnabledFeishuAccounts(runtime: IAgentRuntime): ResolvedFeishuAccount[];
-/**
- * Checks if multi-account mode is enabled
- */
-export declare function isMultiAccountEnabled(runtime: IAgentRuntime): boolean;
-/**
- * Resolves group configuration for a specific group
- */
-export declare function resolveFeishuGroupConfig(runtime: IAgentRuntime, accountId: string, groupId: string): FeishuGroupConfig | undefined;
-/**
- * Checks if a user is allowed based on policy and allowlist
- */
-export declare function isFeishuUserAllowed(params: {
-    userId: string;
-    accountConfig: FeishuAccountConfig;
-    isGroup: boolean;
-    groupId?: string;
-    groupConfig?: FeishuGroupConfig;
-}): boolean;
-/**
- * Checks if mention is required in a group
- */
-export declare function isFeishuMentionRequired(params: {
-    accountConfig: FeishuAccountConfig;
-    groupConfig?: FeishuGroupConfig;
-}): boolean;
-//# sourceMappingURL=accounts.d.ts.map

package/dist/accounts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../src/accounts.ts"],"names":[],"mappings":"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"}

package/dist/actions/index.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/actions/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}

package/dist/config.d.ts

@@ -1,87 +0,0 @@
-/**
- * Feishu plugin configuration types.
- *
- * These types define the configuration schema for the Feishu plugin.
- * Shared base types are imported from @elizaos/core.
- */
-import type { BlockStreamingCoalesceConfig, ChannelHeartbeatVisibilityConfig, DmConfig, DmPolicy, GroupPolicy, GroupToolPolicyBySenderConfig, GroupToolPolicyConfig, MarkdownConfig, ProviderCommandsConfig } from "@elizaos/core";
-export type FeishuReactionNotificationMode = "off" | "own" | "all" | "allowlist";
-export type FeishuActionConfig = {
-    reactions?: boolean;
-    sendMessage?: boolean;
-};
-export type FeishuGroupConfig = {
-    requireMention?: boolean;
-    tools?: GroupToolPolicyConfig;
-    toolsBySender?: GroupToolPolicyBySenderConfig;
-};
-export type FeishuAccountConfig = {
-    /** Optional display name for this account (used in CLI/UI lists). */
-    name?: string;
-    /** Optional provider capability tags used for agent/runtime guidance. */
-    capabilities?: string[];
-    /** Markdown formatting overrides (tables). */
-    markdown?: MarkdownConfig;
-    /** Override native command registration for Feishu (bool or "auto"). */
-    commands?: ProviderCommandsConfig;
-    /** Allow channel-initiated config writes (default: true). */
-    configWrites?: boolean;
-    /** If false, do not start this Feishu account. Default: true. */
-    enabled?: boolean;
-    /** Feishu App ID (from developer console). */
-    appId?: string;
-    /** Feishu App Secret (from developer console). */
-    appSecret?: string;
-    /** Feishu Verification Token (for webhook validation). */
-    verificationToken?: string;
-    /** Feishu Encrypt Key (for decrypting message payloads). */
-    encryptKey?: string;
-    /** Webhook mode: event subscription callback. */
-    webhookPath?: string;
-    /** WebSocket mode: use Feishu WS push (default: false). */
-    useWebSocket?: boolean;
-    /** Direct message access policy (default: pairing). */
-    dmPolicy?: DmPolicy;
-    /** Optional allowlist for Feishu DM senders (open_id). */
-    allowFrom?: Array<string | number>;
-    /** Optional allowlist for Feishu group senders (open_id). */
-    groupAllowFrom?: Array<string | number>;
-    /**
-     * Controls how group messages are handled:
-     * - "open": groups bypass allowFrom, only @mention-gating applies
-     * - "disabled": block all group messages
-     * - "allowlist": only allow group messages from senders in groupAllowFrom/allowFrom
-     */
-    groupPolicy?: GroupPolicy;
-    /** Max group messages to keep as history context (0 disables). */
-    historyLimit?: number;
-    /** Max DM turns to keep as history context. */
-    dmHistoryLimit?: number;
-    /** Per-DM config overrides keyed by user ID. */
-    dms?: Record<string, DmConfig>;
-    /** Outbound text chunk size (chars). Default: 4000. */
-    textChunkLimit?: number;
-    /** Chunking mode: "length" (default) splits by size; "newline" splits on every newline. */
-    chunkMode?: "length" | "newline";
-    /** Disable block streaming for this account. */
-    blockStreaming?: boolean;
-    /** Merge streamed block replies before sending. */
-    blockStreamingCoalesce?: BlockStreamingCoalesceConfig;
-    /** Maximum media file size in MB. Default: 100. */
-    mediaMaxMb?: number;
-    /** Per-action tool gating. */
-    actions?: FeishuActionConfig;
-    /** Reaction notification mode (off|own|all|allowlist). Default: off. */
-    reactionNotifications?: FeishuReactionNotificationMode;
-    /** Allowlist for reaction notifications when mode is allowlist. */
-    reactionAllowlist?: Array<string | number>;
-    /** Per-group config overrides keyed by chat_id. */
-    groups?: Record<string, FeishuGroupConfig>;
-    /** Heartbeat visibility settings for this channel. */
-    heartbeat?: ChannelHeartbeatVisibilityConfig;
-};
-export type FeishuConfig = {
-    /** Optional per-account Feishu configuration (multi-account). */
-    accounts?: Record<string, FeishuAccountConfig>;
-} & FeishuAccountConfig;
-//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,4BAA4B,EAC5B,gCAAgC,EAChC,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,6BAA6B,EAC7B,qBAAqB,EACrB,cAAc,EACd,sBAAsB,EACtB,MAAM,eAAe,CAAC;AAMvB,MAAM,MAAM,8BAA8B,GACvC,KAAK,GACL,KAAK,GACL,KAAK,GACL,WAAW,CAAC;AAMf,MAAM,MAAM,kBAAkB,GAAG;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAMF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,aAAa,CAAC,EAAE,6BAA6B,CAAC;CAC9C,CAAC;AAMF,MAAM,MAAM,mBAAmB,GAAG;IACjC,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACnC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACxC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/B,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjC,gDAAgD;IAChD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,sBAAsB,CAAC,EAAE,4BAA4B,CAAC;IACtD,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,8BAA8B,CAAC;IACvD,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC3C,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,sDAAsD;IACtD,SAAS,CAAC,EAAE,gCAAgC,CAAC;CAC7C,CAAC;AAMF,MAAM,MAAM,YAAY,GAAG;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC/C,GAAG,mBAAmB,CAAC"}

package/dist/connector-account-provider.d.ts

@@ -1,16 +0,0 @@
-/**
- * Feishu ConnectorAccountManager provider.
- *
- * Adapts the multi-account scaffolding in `accounts.ts` to the
- * `ConnectorAccountProvider` contract from
- * `@elizaos/core/connectors/account-manager`.
- *
- * Source of truth for accounts is character settings (`character.settings.feishu`)
- * plus env-var fallbacks (FEISHU_APP_ID, FEISHU_APP_SECRET). `listAccounts`
- * enumerates all configured/enabled accounts; single-account env-only
- * deployments still surface as a `default` account. AccountKey is the appId.
- */
-import type { ConnectorAccountProvider, IAgentRuntime } from "@elizaos/core";
-export declare const FEISHU_PROVIDER_ID = "feishu";
-export declare function createFeishuConnectorAccountProvider(runtime: IAgentRuntime): ConnectorAccountProvider;
-//# sourceMappingURL=connector-account-provider.d.ts.map

package/dist/connector-account-provider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"connector-account-provider.d.ts","sourceRoot":"","sources":["../src/connector-account-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAIX,wBAAwB,EACxB,aAAa,EACb,MAAM,eAAe,CAAC;AASvB,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAmC3C,wBAAgB,oCAAoC,CACnD,OAAO,EAAE,aAAa,GACpB,wBAAwB,CA0C1B"}

package/dist/constants.d.ts

@@ -1,20 +0,0 @@
-/**
- * Service name used to register and retrieve the Feishu service.
- */
-export declare const FEISHU_SERVICE_NAME = "feishu";
-/**
- * Default API domains for Feishu and Lark.
- */
-export declare const FEISHU_DOMAINS: {
-    readonly feishu: "https://open.feishu.cn";
-    readonly lark: "https://open.larksuite.com";
-};
-/**
- * Maximum message length for Feishu text messages.
- */
-export declare const MAX_MESSAGE_LENGTH = 4000;
-/**
- * Default timeout for API requests in milliseconds.
- */
-export declare const DEFAULT_TIMEOUT_MS = 30000;
-//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAQ,CAAC"}

package/dist/environment.d.ts

@@ -1,38 +0,0 @@
-import type { IAgentRuntime } from "@elizaos/core";
-/**
- * Configuration for the Feishu service.
- */
-export interface FeishuConfig {
-    /** Application ID (cli_xxx format) */
-    appId: string;
-    /** Application secret */
-    appSecret: string;
-    /** Domain: 'feishu' for China or 'lark' for global */
-    domain: "feishu" | "lark";
-    /** API base URL */
-    apiRoot: string;
-    /** Allowed chat IDs (empty means all allowed) */
-    allowedChatIds: string[];
-    /** Test chat ID for testing */
-    testChatId?: string;
-    /** Whether to ignore bot messages */
-    shouldIgnoreBotMessages: boolean;
-    /** Whether to respond only to mentions */
-    shouldRespondOnlyToMentions: boolean;
-}
-/**
- * Validates and returns the Feishu configuration from runtime settings.
- */
-export declare function getFeishuConfig(runtime: IAgentRuntime): FeishuConfig | null;
-/**
- * Validates the Feishu configuration.
- */
-export declare function validateConfig(config: FeishuConfig): {
-    valid: boolean;
-    error?: string;
-};
-/**
- * Checks if a chat is allowed based on configuration.
- */
-export declare function isChatAllowed(config: FeishuConfig, chatId: string): boolean;
-//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,uBAAuB,EAAE,OAAO,CAAC;IACjC,0CAA0C;IAC1C,2BAA2B,EAAE,OAAO,CAAC;CACrC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI,CAyD3E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG;IACrD,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAcA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAK3E"}