@elizaos/plugin-feishu 2.0.0-alpha.7 → 2.0.11-beta.7

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

@@ -0,0 +1,98 @@
+# @elizaos/plugin-feishu
+
+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`).
+
+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`).
+
+## Setup
+
+### 1. Create a Feishu/Lark app
+
+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.
+
+### 2. Provide credentials
+
+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
+```
+
+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
+
+Add a `feishu` block to the character `connectors` config. The plugin
+auto-enables when the block is present and not explicitly disabled:
+
+```json
+{
+  "connectors": {
+    "feishu": { "enabled": true }
+  }
+}
+```
+
+## Config
+
+| 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. |
+
+## Supported message 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`.
+
+## Events emitted
+
+`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`.
+
+## Commands
+
+```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 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).
+
+Keep `FEISHU_APP_SECRET` out of source control. Restrict access in production
+with `FEISHU_ALLOWED_CHATS`.
+
+For internals (services, providers, layout, gotchas), see `CLAUDE.md`.

package/auto-enable.ts

@@ -0,0 +1,21 @@
+// Auto-enable check for @elizaos/plugin-feishu.
+//
+// Plugin manifest entry-point — referenced by package.json's
+// `elizaos.plugin.autoEnableModule`. Keep this module light: env reads only,
+// no service init, no transitive imports of the full plugin runtime. The
+// auto-enable engine loads dozens of these per boot.
+import type { PluginAutoEnableContext } from "@elizaos/core";
+
+/** Enable when a `feishu` connector block is present and not explicitly disabled. */
+export function shouldEnable(ctx: PluginAutoEnableContext): boolean {
+  const c = (ctx.config?.connectors as Record<string, unknown> | undefined)
+    ?.feishu;
+  if (!c || typeof c !== "object") return false;
+  const config = c as Record<string, unknown>;
+  if (config.enabled === false) return false;
+  // The full per-connector field check (appId/appSecret) lives in the
+  // central engine's isConnectorConfigured. We delegate to a simple "block
+  // present + not explicitly disabled" check here; the central engine's
+  // stricter check remains as a fallback during migration.
+  return true;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-feishu",
-  "version": "2.0.0-alpha.7",
+  "version": "2.0.11-beta.7",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -8,37 +8,62 @@
   "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": [
-    "dist"
+    "dist",
+    "auto-enable.ts"
   ],
+  "elizaos": {
+    "plugin": {
+      "autoEnableModule": "./auto-enable.ts",
+      "capabilities": [
+        "messaging"
+      ]
+    }
+  },
   "dependencies": {
-    "@elizaos/core": "2.0.0-alpha.3",
-    "@types/node": "^25.0.3",
+    "@elizaos/core": "2.0.11-beta.7",
     "@larksuiteoapi/node-sdk": "^1.40.0",
-    "typescript": "^5.9.3"
+    "@types/node": "^25.0.3",
+    "typescript": "^6.0.3"
   },
   "devDependencies": {
-    "vitest": "^4.0.0",
-    "@biomejs/biome": "^2.3.11"
+    "@biomejs/biome": "^2.4.14",
+    "vitest": "^4.0.0"
   },
   "scripts": {
     "build": "bun run build.ts",
     "dev": "bun --hot build.ts",
-    "test": "vitest run --passWithNoTests",
+    "test": "vitest run",
     "test:watch": "vitest",
     "lint": "bunx @biomejs/biome check --write --unsafe .",
-    "clean": "rm -rf dist .turbo node_modules .turbo-tsconfig.json tsconfig.tsbuildinfo",
+    "clean": "rm -rf dist .turbo .turbo-tsconfig.json tsconfig.tsbuildinfo",
     "format": "bunx @biomejs/biome format --write .",
     "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"
@@ -82,7 +107,7 @@
       }
     }
   },
-  "milady": {
+  "eliza": {
     "platforms": [
       "node"
     ],
@@ -90,5 +115,6 @@
     "platformDetails": {
       "node": "ESM build available via exports.import"
     }
-  }
+  },
+  "gitHead": "cdbc876f793d96073d7eb0d09715a031ce0cd32e"
 }

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 { SEND_MESSAGE_ACTION, sendMessageAction } from "./sendMessage";
-//# 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,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/actions/sendMessage.d.ts

@@ -1,4 +0,0 @@
-import type { Action } from "@elizaos/core";
-export declare const SEND_MESSAGE_ACTION = "SEND_FEISHU_MESSAGE";
-export declare const sendMessageAction: Action;
-//# sourceMappingURL=sendMessage.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"sendMessage.d.ts","sourceRoot":"","sources":["../../src/actions/sendMessage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAQP,MAAM,eAAe,CAAC;AAIvB,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD,eAAO,MAAM,iBAAiB,EAAE,MA0G/B,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":"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"}

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;IAC3B,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;CACtC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI,CAyD3E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAcA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAK3E"}