@elizaos/plugin-discord 2.0.0-alpha.5 → 2.0.0-alpha.537

package/dist/service.d.ts

@@ -0,0 +1,207 @@
+import { ChannelType, type Character, type Content, type IAgentRuntime, type Media, type Memory, Service, type TargetInfo, type UUID } from "@elizaos/core";
+/**
+ * IMPORTANT: Discord ID Handling - Why stringToUuid() instead of asUUID()
+ *
+ * Discord uses "snowflake" IDs - large 64-bit integers represented as strings
+ * (e.g., "1253563208833433701"). These are NOT valid UUIDs.
+ *
+ * UUID format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (8-4-4-4-12 hex digits with dashes)
+ * Discord ID:  1253563208833433701 (plain number string)
+ *
+ * The two UUID-related functions behave differently:
+ *
+ * - `asUUID(str)` - VALIDATES that the string is already a valid UUID format.
+ *   If not, it throws: "Error: Invalid UUID format: 1253563208833433701"
+ *   Use only when you're certain the input is already a valid UUID.
+ *
+ * - `stringToUuid(str)` - CONVERTS any string into a deterministic UUID by hashing it.
+ *   Always succeeds. The same input always produces the same UUID output.
+ *   Use this for Discord snowflake IDs.
+ *
+ * When working with Discord IDs in ElizaOS:
+ *
+ * 1. `stringToUuid(discordId)` - For storing Discord IDs in UUID fields (e.g., `messageServerId`).
+ *
+ * 2. `createUniqueUuid(runtime, discordId)` - For `worldId` and `roomId`. This adds the agent's
+ *    ID to the hash, ensuring each agent has its own unique namespace for the same Discord server.
+ *
+ * 3. `messageServerId` - The correct property name for server IDs on Room and World objects.
+ *
+ * 4. Discord-specific events (e.g., DiscordEventTypes.VOICE_STATE_UPDATE) are not in core's
+ *    EventPayloadMap. When emitting these events, cast to `string[]` and payload to `any`
+ *    to use the generic emitEvent overload.
+ */
+import { type Channel, Client as DiscordJsClient, type Guild, type GuildMember, type Interaction, type Message, type MessageReaction, type PartialMessageReaction, type PartialUser, type User } from "discord.js";
+import { type ICompatRuntime } from "./compat";
+import { MessageManager } from "./messages";
+import type { ChannelHistoryOptions, ChannelHistoryResult, DiscordSettings, DiscordSlashCommand, IDiscordService } from "./types";
+import { VoiceManager } from "./voice";
+/**
+ * DiscordService class representing a service for interacting with Discord.
+ * @extends Service
+ * @implements IDiscordService
+ * @property {string} serviceType - The type of service, set to DISCORD_SERVICE_NAME.
+ * @property {string} capabilityDescription - A description of the service's capabilities.
+ * @property {DiscordJsClient} client - The DiscordJsClient used for communication.
+ * @property {Character} character - The character associated with the service.
+ * @property {MessageManager} messageManager - The manager for handling messages.
+ * @property {VoiceManager} voiceManager - The manager for handling voice communication.
+ */
+export declare class DiscordService extends Service implements IDiscordService {
+    protected runtime: ICompatRuntime;
+    static serviceType: string;
+    capabilityDescription: string;
+    client: DiscordJsClient | null;
+    character: Character;
+    discordSettings: DiscordSettings;
+    messageManager?: MessageManager;
+    voiceManager?: VoiceManager;
+    private messageDebouncer?;
+    private channelDebouncer?;
+    private _loginFailed;
+    private userSelections;
+    private timeouts;
+    clientReadyPromise: Promise<void> | null;
+    /**
+     * List of allowed channel IDs (parsed from CHANNEL_IDS env var).
+     * If undefined, all channels are allowed.
+     */
+    private allowedChannelIds?;
+    /**
+     * Set of dynamically added channel IDs through joinChannel action.
+     * These are merged with allowedChannelIds for runtime channel management.
+     */
+    private dynamicChannelIds;
+    private ownerDiscordUserIds;
+    slashCommands: DiscordSlashCommand[];
+    private commandRegistrationQueue;
+    allowAllSlashCommands: Set<string>;
+    /**
+     * Resolves owner Discord user IDs from either the explicit
+     * ELIZA_DISCORD_OWNER_USER_IDS_JSON setting or the Discord application's
+     * team/owner metadata, and registers them as Discord connector admins.
+     * Called from the extracted onReady handler once the client is ready.
+     */
+    refreshOwnerDiscordUserIds(client: DiscordJsClient): Promise<void>;
+    /**
+     * Registers slash commands with Discord. Called from the onReady event
+     * handler via the DISCORD_REGISTER_COMMANDS event emitted by
+     * registerBuiltinSlashCommands(). Merges incoming commands with the
+     * existing set, then pushes them to Discord both globally (for DMs) and
+     * per-guild (for instant availability).
+     */
+    registerSlashCommands(commands: DiscordSlashCommand[]): Promise<void>;
+    private resolveDiscordTargetUserId;
+    /**
+     * Constructor for Discord client.
+     * Initializes the Discord client with specified intents and partials,
+     * sets up event listeners, and ensures all servers exist.
+     *
+     * @param {IAgentRuntime} runtime - The AgentRuntime instance
+     */
+    constructor(runtime: IAgentRuntime);
+    isHealthy(): boolean;
+    static start(runtime: IAgentRuntime): Promise<DiscordService>;
+    /**
+     * The SendHandlerFunction implementation for Discord.
+     * @param {IAgentRuntime} runtime - The runtime instance.
+     * @param {TargetInfo} target - The target information for the message.
+     * @param {Content} content - The content of the message to send.
+     * @returns {Promise<void>} A promise that resolves when the message is sent or rejects on error.
+     * @throws {Error} If the client is not ready, target is invalid, or sending fails.
+     */
+    handleSendMessage(runtime: IAgentRuntime, target: TargetInfo, content: Content): Promise<void>;
+    /**
+     * Set up event listeners for the client.
+     * Delegates to the extracted setupDiscordEventListeners() function.
+     * @private
+     */
+    private setupEventListeners;
+    /**
+     * Handles tasks to be performed once the Discord client is fully ready. Delegates to extracted module.
+     * @private
+     */
+    private onReady;
+    /**
+     * Registers send handlers for the Discord service instance.
+     * @static
+     */
+    static registerSendHandlers(runtime: IAgentRuntime, serviceInstance: DiscordService): void;
+    /**
+     * Fetches all members who have access to a specific text channel.
+     */
+    getTextChannelMembers(channelId: string, useCache?: boolean): Promise<Array<{
+        id: string;
+        username: string;
+        displayName: string;
+    }>>;
+    /**
+     * Fetches the topic/description of a Discord text channel.
+     */
+    getChannelTopic(channelId: string): Promise<string | null>;
+    /**
+     * Checks if a channel ID is allowed based on both env config and dynamic additions.
+     */
+    isChannelAllowed(channelId: string): boolean;
+    /**
+     * Adds a channel to the dynamic allowed list.
+     */
+    addAllowedChannel(channelId: string): boolean;
+    /**
+     * Removes a channel from the dynamic allowed list.
+     */
+    removeAllowedChannel(channelId: string): boolean;
+    /**
+     * Gets the list of all allowed channels (env + dynamic).
+     */
+    getAllowedChannels(): string[];
+    /**
+     * Fetches and persists message history from a Discord channel. Delegates to extracted module.
+     */
+    fetchChannelHistory(channelId: string, options?: ChannelHistoryOptions): Promise<ChannelHistoryResult>;
+    /**
+     * Builds a Memory object from a Discord Message. Delegates to extracted module.
+     */
+    buildMemoryFromMessage(message: Message, options?: {
+        processedContent?: string;
+        processedAttachments?: Media[];
+        extraContent?: Record<string, unknown>;
+        extraMetadata?: Record<string, unknown>;
+    }): Promise<Memory | null>;
+    /**
+     * Maps a Discord snowflake user id to the runtime entity UUID, substituting
+     * the canonical Eliza owner entity when the user is a known Discord owner.
+     */
+    resolveDiscordEntityId(userId: string): UUID;
+    /**
+     * Handles reaction addition. Delegates to extracted module.
+     */
+    handleReactionAdd(reaction: MessageReaction | PartialMessageReaction, user: User | PartialUser): Promise<void>;
+    /**
+     * Handles reaction removal. Delegates to extracted module.
+     */
+    handleReactionRemove(reaction: MessageReaction | PartialMessageReaction, user: User | PartialUser): Promise<void>;
+    /**
+     * Handles guild creation (bot joined a guild). Delegates to extracted module.
+     */
+    handleGuildCreate(guild: Guild): Promise<void>;
+    /**
+     * Handles interaction creation (slash commands, modals, etc). Delegates to
+     * extracted module.
+     */
+    handleInteractionCreate(interaction: Interaction): Promise<void>;
+    /**
+     * Handles a new guild member joining — emits an ENTITY_JOINED event so the
+     * runtime can create the entity record.
+     */
+    handleGuildMemberAdd(member: GuildMember): Promise<void>;
+    /**
+     * Stops the Discord service and cleans up resources.
+     */
+    stop(): Promise<void>;
+    /**
+     * Asynchronously retrieves the type of a given channel.
+     */
+    getChannelType(channel: Channel): Promise<ChannelType>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

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

package/dist/setup-routes.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Discord local setup HTTP routes.
+ *
+ * Provides status, authorization, and subscription management for the
+ * Discord local IPC connector:
+ *
+ *   GET  /api/discord-local/status          connection + auth status
+ *   POST /api/discord-local/authorize       start OAuth authorize flow
+ *   POST /api/discord-local/disconnect      tear down session
+ *   GET  /api/discord-local/guilds          list guilds (requires auth)
+ *   GET  /api/discord-local/channels        list channels for a guild
+ *   POST /api/discord-local/subscriptions   subscribe to channel messages
+ *
+ * These routes are registered with `rawPath: true` so they mount at their
+ * legacy paths without the plugin-name prefix.
+ */
+import type { Route } from "@elizaos/core";
+/**
+ * Plugin routes for Discord local setup.
+ * Registered with `rawPath: true` to preserve legacy `/api/discord-local/*` paths.
+ */
+export declare const discordSetupRoutes: Route[];
+//# sourceMappingURL=setup-routes.d.ts.map

package/dist/setup-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-routes.d.ts","sourceRoot":"","sources":["../setup-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAEX,KAAK,EAGL,MAAM,eAAe,CAAC;AA6RvB;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,EAqCrC,CAAC"}

package/dist/slash-commands.d.ts

@@ -0,0 +1,39 @@
+import { type IAgentRuntime } from "@elizaos/core";
+import type { AutocompleteInteraction, ChatInputCommandInteraction } from "discord.js";
+type SlashCommandRole = "OWNER" | "ADMIN" | "USER" | "GUEST";
+interface SlashCommand {
+    name: string;
+    description: string;
+    options?: SlashCommandOption[];
+    ephemeral?: boolean;
+    cooldown?: number;
+    ownerOnly?: boolean;
+    /** Minimum elizaOS role required to execute this command. */
+    requiredRole?: SlashCommandRole;
+    execute: (interaction: ChatInputCommandInteraction, runtime: IAgentRuntime) => Promise<void>;
+    autocomplete?: (interaction: AutocompleteInteraction) => Promise<void>;
+}
+/** Context resolved by the Discord service before dispatching built-in commands. */
+export interface SlashCommandContext {
+    entityId: string;
+    roomId: string;
+}
+interface SlashCommandOption {
+    name: string;
+    description: string;
+    type: "string" | "number" | "boolean" | "user" | "channel" | "role";
+    required?: boolean;
+    choices?: Array<{
+        name: string;
+        value: string;
+    }>;
+    autocomplete?: boolean;
+}
+export declare function registerSlashCommands(runtime: IAgentRuntime): Promise<void>;
+export declare function handleSlashCommand(interaction: ChatInputCommandInteraction, runtime: IAgentRuntime, context?: SlashCommandContext): Promise<void>;
+export declare function handleAutocomplete(interaction: AutocompleteInteraction): Promise<void>;
+export declare function getRegisteredCommands(): ReadonlyMap<string, SlashCommand>;
+export declare function addCommand(command: SlashCommand): void;
+export declare function removeCommand(name: string): boolean;
+export {};
+//# sourceMappingURL=slash-commands.d.ts.map

package/dist/slash-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.d.ts","sourceRoot":"","sources":["../slash-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EACX,uBAAuB,EACvB,2BAA2B,EAC3B,MAAM,YAAY,CAAC;AAKpB,KAAK,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7D,UAAU,YAAY;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,OAAO,EAAE,CACR,WAAW,EAAE,2BAA2B,EACxC,OAAO,EAAE,aAAa,KAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,WAAW,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,oFAAoF;AACpF,MAAM,WAAW,mBAAmB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,UAAU,kBAAkB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAqZD,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,kBAAkB,CACvC,WAAW,EAAE,2BAA2B,EACxC,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA2Gf;AAED,wBAAsB,kBAAkB,CACvC,WAAW,EAAE,uBAAuB,GAClC,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAgB,qBAAqB,IAAI,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAEzE;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAEtD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/status-reactions.d.ts

@@ -0,0 +1,11 @@
+import type { Message as DiscordMessage } from "discord.js";
+export type StatusReactionScope = "all" | "group-mentions" | "none";
+export interface StatusReactionController {
+    setQueued: () => void;
+    setThinking: () => void;
+    setDone: () => void;
+    setError: () => void;
+}
+export declare function shouldShowStatusReaction(scope: StatusReactionScope, message: DiscordMessage, botId: string | undefined): boolean;
+export declare function createStatusReactionController(message: DiscordMessage): StatusReactionController;
+//# sourceMappingURL=status-reactions.d.ts.map

package/dist/status-reactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-reactions.d.ts","sourceRoot":"","sources":["../status-reactions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,gBAAgB,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,wBAAwB;IACxC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACrB;AAOD,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CAeT;AAED,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,cAAc,GACrB,wBAAwB,CA6C1B"}

package/dist/test-setup.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=test-setup.d.ts.map

package/dist/test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../test-setup.ts"],"names":[],"mappings":""}

package/dist/tests.d.ts

@@ -0,0 +1,123 @@
+import type { Readable } from "node:stream";
+import { type VoiceConnection } from "@discordjs/voice";
+import { type IAgentRuntime, type TestSuite } from "@elizaos/core";
+import { AttachmentBuilder, type Guild, type TextChannel } from "discord.js";
+import type { DiscordService } from "./service";
+/**
+ * Represents a test suite for Discord functionality.
+ * @class DiscordTestSuite
+ * @implements TestSuite
+ * @property {string} name - The name of the test suite
+ * @property {DiscordService | null} discordClient - The Discord client instance
+ * @property {Array<{ name: string; fn: (runtime: IAgentRuntime) => Promise<void> }>} tests - Array of test functions
+ */
+export declare class DiscordTestSuite implements TestSuite {
+    name: string;
+    private discordClient;
+    tests: {
+        name: string;
+        fn: (runtime: IAgentRuntime) => Promise<void>;
+    }[];
+    /**
+     * Constructor for initializing the tests array with test cases to be executed.
+     *
+     * @constructor
+     * @this {TestSuite}
+     */
+    constructor();
+    /**
+     * Asynchronously tests the creation of Discord client using the provided runtime.
+     *
+     * @param {IAgentRuntime} runtime - The agent runtime used to obtain the Discord service.
+     * @returns {Promise<void>} - A Promise that resolves once the Discord client is ready.
+     * @throws {Error} - If an error occurs while creating the Discord client.
+     */
+    testCreatingDiscordClient(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Asynchronously tests the join voice slash command functionality.
+     *
+     * @param {IAgentRuntime} runtime - The runtime environment for the agent.
+     * @returns {Promise<void>} - A promise that resolves once the test is complete.
+     * @throws {Error} - If there is an error in executing the slash command test.
+     */
+    testJoinVoiceSlashCommand(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Asynchronously tests the leave voice channel slash command.
+     *
+     * @param {IAgentRuntime} runtime - The Agent Runtime instance.
+     * @returns {Promise<void>} A promise that resolves when the test is complete.
+     */
+    testLeaveVoiceSlashCommand(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Test Text to Speech playback.
+     * @param {IAgentRuntime} runtime - The Agent Runtime instance.
+     * @throws {Error} - If voice channel is invalid, voice connection fails to become ready, or no text to speech service found.
+     */
+    testTextToSpeechPlayback(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Asynchronously tests sending a text message to a specified channel.
+     *
+     * @param {IAgentRuntime} runtime - The runtime for the agent.
+     * @returns {Promise<void>} A Promise that resolves when the message is sent successfully.
+     * @throws {Error} If there is an error in sending the text message.
+     */
+    testSendingTextMessage(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Asynchronously handles sending a test message using the given runtime and mock user data.
+     *
+     * @param {IAgentRuntime} runtime - The agent runtime object.
+     * @returns {Promise<void>} A Promise that resolves once the message is handled.
+     */
+    testHandlingMessage(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Asynchronously retrieves the test channel associated with the provided runtime.
+     *
+     * @param {IAgentRuntime} runtime - The runtime object containing necessary information.
+     * @returns {Promise<Channel>} The test channel retrieved from the Discord client.
+     * @throws {Error} If no test channel is found.
+     */
+    getTestChannel(runtime: IAgentRuntime): Promise<import("discord.js").Channel>;
+    /**
+     * Async function to send a message to a text-based channel.
+     *
+     * @param {TextChannel} channel - The text-based channel the message is being sent to.
+     * @param {string} messageContent - The content of the message being sent.
+     * @param {AttachmentBuilder[]} files - An array of files to include in the message.
+     * @throws {Error} If the channel is not a text-based channel or does not exist.
+     * @throws {Error} If there is an error sending the message.
+     */
+    sendMessageToChannel(channel: TextChannel, messageContent: string, files: AttachmentBuilder[]): Promise<void>;
+    /**
+     * Play an audio stream from a given response stream using the provided VoiceConnection.
+     *
+     * @param responseStream - The response stream to play as audio.
+     * @param connection - The VoiceConnection to use for playing the audio.
+     * @returns A Promise that resolves when the TTS playback is finished.
+     */
+    playAudioStream(responseStream: ReadableStream | NodeJS.ReadableStream | Readable, connection: VoiceConnection): Promise<void>;
+    /**
+     * Retrieves the active guild where the bot is currently connected to a voice channel.
+     *
+     * @param {DiscordService} discordClient The DiscordService instance used to interact with the Discord API.
+     * @returns {Promise<Guild>} The active guild where the bot is currently connected to a voice channel.
+     * @throws {Error} If no active voice connection is found for the bot.
+     */
+    getActiveGuild(discordClient: DiscordService): Promise<Guild>;
+    /**
+     * Waits for the VoiceManager in the Discord client to be ready.
+     *
+     * @param {DiscordService} discordClient - The Discord client to check for VoiceManager readiness.
+     * @throws {Error} If the Discord client is not initialized.
+     * @returns {Promise<void>} A promise that resolves when the VoiceManager is ready.
+     */
+    private waitForVoiceManagerReady;
+    /**
+     * Validates the Discord test channel ID by checking if it is set in the runtime or environment variables.
+     * If the test channel ID is not set, an error is thrown.
+     *
+     * @param {IAgentRuntime} runtime The runtime object containing the settings and environment variables.
+     * @returns {string} The validated Discord test channel ID.
+     */
+    private validateChannelId;
+}
+//# sourceMappingURL=tests.d.ts.map

package/dist/tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tests.d.ts","sourceRoot":"","sources":["../tests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAMN,KAAK,eAAe,EAEpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,KAAK,aAAa,EAGlB,KAAK,SAAS,EACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,iBAAiB,EAGjB,KAAK,KAAK,EAEV,KAAK,WAAW,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAOhD;;;;;;;GAOG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IACjD,IAAI,SAAa;IACjB,OAAO,CAAC,aAAa,CAAkB;IACvC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,EAAE,CAAC;IAEzE;;;;;OAKG;;IA8BH;;;;;;OAMG;IACG,yBAAyB,CAAC,OAAO,EAAE,aAAa;IAgCtD;;;;;;OAMG;IACG,yBAAyB,CAAC,OAAO,EAAE,aAAa;IAkDtD;;;;;OAKG;IACG,0BAA0B,CAAC,OAAO,EAAE,aAAa;IAqCvD;;;;OAIG;IACG,wBAAwB,CAAC,OAAO,EAAE,aAAa;IA0DrD;;;;;;OAMG;IACG,sBAAsB,CAAC,OAAO,EAAE,aAAa;IAoBnD;;;;;OAKG;IACG,mBAAmB,CAAC,OAAO,EAAE,aAAa;IA2DhD;;;;;;OAMG;IACG,cAAc,CAAC,OAAO,EAAE,aAAa;IAgB3C;;;;;;;;OAQG;IACG,oBAAoB,CACzB,OAAO,EAAE,WAAW,EACpB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,iBAAiB,EAAE;IAqB3B;;;;;;OAMG;IACG,eAAe,CACpB,cAAc,EAAE,cAAc,GAAG,MAAM,CAAC,cAAc,GAAG,QAAQ,EACjE,UAAU,EAAE,eAAe;IA4B5B;;;;;;OAMG;IACG,cAAc,CAAC,aAAa,EAAE,cAAc;IAiBlD;;;;;;OAMG;YACW,wBAAwB;IAqBtC;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;CAWzB"}