@elizaos/plugin-discord 2.0.0-alpha.1 → 2.0.0-alpha.11

package/dist/messages.d.ts

@@ -0,0 +1,55 @@
+import { type Media } from "@elizaos/core";
+import { type Message as DiscordMessage } from "discord.js";
+import type { ICompatRuntime } from "./compat";
+import type { IDiscordService } from "./types";
+/**
+ * Class representing a Message Manager for handling Discord messages.
+ */
+export declare class MessageManager {
+    private client;
+    private runtime;
+    private attachmentManager;
+    private getChannelType;
+    private discordSettings;
+    private discordService;
+    /**
+     * Constructor for a new instance of MessageManager.
+     * @param {IDiscordService} discordService - The Discord service instance.
+     * @param {ICompatRuntime} runtime - The agent runtime instance (with cross-core compat).
+     * @throws {Error} If the Discord client is not initialized
+     */
+    constructor(discordService: IDiscordService, runtime: ICompatRuntime);
+    /**
+     * Check DM access based on the configured dmPolicy.
+     *
+     * @param message - The Discord DM message
+     * @returns Access check result with allowed status and optional reply message
+     */
+    private checkDmAccess;
+    /**
+     * Handles incoming Discord messages and processes them accordingly.
+     *
+     * @param {DiscordMessage} message - The Discord message to be handled
+     */
+    handleMessage(message: DiscordMessage): Promise<void>;
+    /**
+     * Processes the message content, mentions, code blocks, attachments, and URLs to generate
+     * processed content and media attachments.
+     *
+     * @param {DiscordMessage} message The message to process
+     * @returns {Promise<{ processedContent: string; attachments: Media[] }>} Processed content and media attachments
+     */
+    processMessage(message: DiscordMessage): Promise<{
+        processedContent: string;
+        attachments: Media[];
+    }>;
+    /**
+     * Asynchronously fetches the bot's username and discriminator from Discord API.
+     *
+     * @param {string} botToken The token of the bot to authenticate the request
+     * @returns {Promise<string>} A promise that resolves with the bot's username and discriminator
+     * @throws {Error} If there is an error while fetching the bot details
+     */
+    fetchBotName(botToken: string): Promise<string>;
+}
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../messages.ts"],"names":[],"mappings":"AAAA,OAAO,EASN,KAAK,KAAK,EAMV,MAAM,eAAe,CAAC;AACvB,OAAO,EAKN,KAAK,OAAO,IAAI,cAAc,EAE9B,MAAM,YAAY,CAAC;AAKpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,SAAS,CAAC;AAUhE;;GAEG;AAEH,qBAAa,cAAc;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,cAAc,CAAkB;IACxC;;;;;OAKG;gBACS,cAAc,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc;IAqBpE;;;;;OAKG;YACW,aAAa;IAkG3B;;;;OAIG;IACG,aAAa,CAAC,OAAO,EAAE,cAAc;IAue3C;;;;;;OAMG;IACG,cAAc,CACnB,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,KAAK,EAAE,CAAA;KAAE,CAAC;IAoM9D;;;;;;OAMG;IAEG,YAAY,CAAC,QAAQ,EAAE,MAAM;CAoBnC"}

package/dist/messaging.d.ts

@@ -0,0 +1,129 @@
+import type { Guild, MessageReaction } from "discord.js";
+/**
+ * Options for chunking Discord text
+ */
+export interface ChunkDiscordTextOpts {
+    /** Max characters per Discord message. Default: 2000. */
+    maxChars?: number;
+    /**
+     * Soft max line count per message. Default: 17.
+     * Discord clients can clip/collapse very tall messages in the UI.
+     */
+    maxLines?: number;
+    /** Chunking mode: "length" (default) or "newline" */
+    chunkMode?: "length" | "newline";
+}
+/**
+ * Chunks outbound Discord text by both character count and (soft) line count,
+ * while keeping fenced code blocks balanced across chunks.
+ */
+export declare function chunkDiscordText(text: string, opts?: ChunkDiscordTextOpts): string[];
+/**
+ * Chunks Discord text with configurable chunking mode
+ */
+export declare function chunkDiscordTextWithMode(text: string, opts?: ChunkDiscordTextOpts): string[];
+/**
+ * Resolves the system location string for logging/display
+ */
+export declare function resolveDiscordSystemLocation(params: {
+    isDirectMessage: boolean;
+    isGroupDm: boolean;
+    guild?: Guild | null;
+    channelName: string;
+}): string;
+/**
+ * Formats a Discord reaction emoji for display
+ */
+export declare function formatDiscordReactionEmoji(emoji: {
+    id?: string | null;
+    name?: string | null;
+}): string;
+/**
+ * Formats a Discord reaction emoji from a MessageReaction
+ */
+export declare function formatMessageReactionEmoji(reaction: MessageReaction): string;
+/**
+ * Formats a Discord user mention
+ */
+export declare function formatDiscordUserMention(userId: string): string;
+/**
+ * Formats a Discord channel mention
+ */
+export declare function formatDiscordChannelMention(channelId: string): string;
+/**
+ * Formats a Discord role mention
+ */
+export declare function formatDiscordRoleMention(roleId: string): string;
+/**
+ * Extracts user ID from a mention string
+ */
+export declare function extractUserIdFromMention(mention: string): string | null;
+/**
+ * Extracts channel ID from a mention string
+ */
+export declare function extractChannelIdFromMention(mention: string): string | null;
+/**
+ * Extracts role ID from a mention string
+ */
+export declare function extractRoleIdFromMention(mention: string): string | null;
+/**
+ * Resolves a timestamp string to milliseconds
+ */
+export declare function resolveTimestampMs(timestamp?: string | null): number | undefined;
+/**
+ * Formats a timestamp for Discord (Discord timestamp format)
+ */
+export declare function formatDiscordTimestamp(timestamp: Date | number, format?: "t" | "T" | "d" | "D" | "f" | "F" | "R"): string;
+/**
+ * Strips Discord formatting from text
+ */
+export declare function stripDiscordFormatting(text: string): string;
+/**
+ * Escapes special Discord markdown characters
+ */
+export declare function escapeDiscordMarkdown(text: string): string;
+/**
+ * Truncates text to a maximum length with an ellipsis
+ */
+export declare function truncateText(text: string, maxLength: number, ellipsis?: string): string;
+/**
+ * Truncates text at a UTF-16 boundary safely
+ */
+export declare function truncateUtf16Safe(text: string, maxLength: number, ellipsis?: string): string;
+/**
+ * Checks if a message mentions a specific user
+ */
+export declare function messageContainsMention(text: string, userId: string): boolean;
+/**
+ * Extracts all user mentions from a message
+ */
+export declare function extractAllUserMentions(text: string): string[];
+/**
+ * Extracts all channel mentions from a message
+ */
+export declare function extractAllChannelMentions(text: string): string[];
+/**
+ * Extracts all role mentions from a message
+ */
+export declare function extractAllRoleMentions(text: string): string[];
+/**
+ * Sanitizes a thread name for Discord (max 100 chars, no invalid chars)
+ */
+export declare function sanitizeThreadName(name: string): string;
+/**
+ * Builds a message link URL
+ */
+export declare function buildMessageLink(guildId: string, channelId: string, messageId: string): string;
+/**
+ * Builds a channel link URL
+ */
+export declare function buildChannelLink(guildId: string, channelId: string): string;
+/**
+ * Parses a Discord message link URL
+ */
+export declare function parseMessageLink(url: string): {
+    guildId: string;
+    channelId: string;
+    messageId: string;
+} | null;
+//# sourceMappingURL=messaging.d.ts.map

package/dist/messaging.d.ts.map

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

package/dist/native-commands.d.ts

@@ -0,0 +1,142 @@
+import { ApplicationCommandOptionType, ButtonStyle, type RESTPostAPIChatInputApplicationCommandsJSONBody } from "discord-api-types/v10";
+/**
+ * Command argument definition
+ */
+export interface CommandArgDefinition {
+    name: string;
+    description: string;
+    type: "string" | "number" | "boolean";
+    required?: boolean;
+    choices?: Array<{
+        label: string;
+        value: string;
+    }>;
+}
+/**
+ * Native command specification
+ */
+export interface NativeCommandSpec {
+    name: string;
+    description: string;
+    acceptsArgs?: boolean;
+    args?: CommandArgDefinition[];
+    ephemeralDefault?: boolean;
+}
+/**
+ * Command argument values
+ */
+export type CommandArgValues = Record<string, string | number | boolean>;
+/**
+ * Parsed command arguments
+ */
+export interface CommandArgs {
+    values: CommandArgValues;
+    raw?: string;
+}
+/**
+ * Result of building command options
+ */
+export interface BuiltCommandOption {
+    name: string;
+    description: string;
+    type: ApplicationCommandOptionType;
+    required?: boolean;
+    choices?: Array<{
+        name: string;
+        value: string | number;
+    }>;
+}
+/**
+ * Button specification for argument menus
+ */
+export interface CommandArgButton {
+    label: string;
+    customId: string;
+    style: ButtonStyle;
+}
+/**
+ * Row of buttons for argument menus
+ */
+export interface CommandArgButtonRow {
+    buttons: CommandArgButton[];
+}
+/**
+ * Argument menu specification
+ */
+export interface CommandArgMenu {
+    content: string;
+    rows: CommandArgButtonRow[];
+}
+/**
+ * Key for command argument custom IDs
+ */
+export declare const COMMAND_ARG_CUSTOM_ID_KEY = "cmdarg";
+/**
+ * Builds Discord command options from argument definitions
+ */
+export declare function buildDiscordCommandOptions(args?: CommandArgDefinition[]): BuiltCommandOption[] | undefined;
+/**
+ * Builds a complete Discord slash command JSON body
+ */
+export declare function buildDiscordSlashCommand(spec: NativeCommandSpec): RESTPostAPIChatInputApplicationCommandsJSONBody;
+/**
+ * Encodes a command argument value for use in custom IDs
+ */
+export declare function encodeCommandArgValue(value: string): string;
+/**
+ * Decodes a command argument value from a custom ID
+ */
+export declare function decodeCommandArgValue(value: string): string;
+/**
+ * Builds a custom ID for a command argument button
+ */
+export declare function buildCommandArgCustomId(params: {
+    command: string;
+    arg: string;
+    value: string;
+    userId: string;
+}): string;
+/**
+ * Parses command argument data from a custom ID
+ */
+export declare function parseCommandArgCustomId(customId: string): {
+    command: string;
+    arg: string;
+    value: string;
+    userId: string;
+} | null;
+/**
+ * Builds an argument menu with buttons for command selection
+ */
+export declare function buildCommandArgMenu(params: {
+    commandName: string;
+    arg: CommandArgDefinition;
+    choices: Array<{
+        value: string;
+        label: string;
+    }>;
+    userId: string;
+    title?: string;
+    buttonsPerRow?: number;
+}): CommandArgMenu;
+/**
+ * Checks if an error is a Discord "Unknown Interaction" error
+ */
+export declare function isUnknownInteractionError(error: unknown): boolean;
+/**
+ * Safely executes a Discord interaction call, catching expired interaction errors
+ */
+export declare function safeInteractionCall<T>(fn: () => Promise<T>, onExpired?: () => void): Promise<T | null>;
+/**
+ * Creates command arguments from a single value
+ */
+export declare function createCommandArgs(argName: string, value: string | number | boolean): CommandArgs;
+/**
+ * Serializes command arguments to a string
+ */
+export declare function serializeCommandArgs(args?: CommandArgs): string;
+/**
+ * Builds the full command text from arguments
+ */
+export declare function buildCommandText(commandName: string, args?: CommandArgs): string;
+//# sourceMappingURL=native-commands.d.ts.map

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

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

package/dist/permissionEvents.d.ts

@@ -0,0 +1,42 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import type { AuditLogEvent, Guild, GuildMember, PermissionOverwrites, Role } from "discord.js";
+import type { AuditInfo, PermissionDiff } from "./types";
+/**
+ * Permissions that indicate moderation/admin capabilities.
+ * Changes to these permissions are considered elevated and worth tracking.
+ */
+export declare const ELEVATED_PERMISSIONS: readonly ["Administrator", "ManageGuild", "ManageChannels", "ManageRoles", "KickMembers", "BanMembers", "ModerateMembers", "ManageMessages", "ManageWebhooks", "ManageNicknames", "MuteMembers", "DeafenMembers", "MoveMembers", "ManageEvents", "ManageThreads"];
+/**
+ * Check if a role has any elevated (moderation/admin) permissions
+ */
+export declare function isElevatedRole(role: Role): boolean;
+/**
+ * Check if an array of permission names contains any elevated permissions
+ */
+export declare function hasElevatedPermissions(permissions: string[]): boolean;
+/**
+ * Fetch the most recent matching audit log entry for an action.
+ * Matches by target ID and filters to entries within 10 seconds.
+ * Returns null gracefully on errors (rate limits, missing permissions, etc.)
+ */
+export declare function fetchAuditEntry(guild: Guild, actionType: AuditLogEvent, target: string, runtime: IAgentRuntime): Promise<AuditInfo | null>;
+/**
+ * Diff two permission overwrites and determine what changed.
+ * Returns the list of changes and the action type (CREATE/UPDATE/DELETE).
+ */
+export declare function diffOverwrites(oldOw: PermissionOverwrites | undefined | null, newOw: PermissionOverwrites | undefined | null): {
+    changes: PermissionDiff[];
+    action: "CREATE" | "UPDATE" | "DELETE";
+};
+/**
+ * Diff two role permission sets and return what changed.
+ */
+export declare function diffRolePermissions(oldRole: Role, newRole: Role): PermissionDiff[];
+/**
+ * Diff member roles to find added and removed roles.
+ */
+export declare function diffMemberRoles(oldMember: GuildMember, newMember: GuildMember): {
+    added: Role[];
+    removed: Role[];
+};
+//# sourceMappingURL=permissionEvents.d.ts.map

package/dist/permissionEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionEvents.d.ts","sourceRoot":"","sources":["../permissionEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EACX,aAAa,EACb,KAAK,EACL,WAAW,EACX,oBAAoB,EACpB,IAAI,EACJ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAmB,MAAM,SAAS,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,oBAAoB,mQAgBvB,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAIrE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACpC,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,aAAa,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACpB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAuB3B;AA8CD;;;GAGG;AACH,wBAAgB,cAAc,CAC7B,KAAK,EAAE,oBAAoB,GAAG,SAAS,GAAG,IAAI,EAC9C,KAAK,EAAE,oBAAoB,GAAG,SAAS,GAAG,IAAI,GAC5C;IAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;CAAE,CAmCvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,IAAI,EACb,OAAO,EAAE,IAAI,GACX,cAAc,EAAE,CAoBlB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,SAAS,EAAE,WAAW,EACtB,SAAS,EAAE,WAAW,GACpB;IAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAAC,OAAO,EAAE,IAAI,EAAE,CAAA;CAAE,CAQpC"}

package/dist/permissions.d.ts

@@ -0,0 +1,36 @@
+export declare const PERMISSIONS_BASIC: bigint;
+export declare const PERMISSIONS_BASIC_VOICE: bigint;
+export declare const PERMISSIONS_MODERATOR: bigint;
+export declare const PERMISSIONS_MODERATOR_VOICE: bigint;
+export declare const PERMISSIONS_ADMIN: bigint;
+export declare const PERMISSIONS_ADMIN_VOICE: bigint;
+export declare const DiscordPermissionTiers: {
+    readonly BASIC: number;
+    readonly BASIC_VOICE: number;
+    readonly MODERATOR: number;
+    readonly MODERATOR_VOICE: number;
+    readonly ADMIN: number;
+    readonly ADMIN_VOICE: number;
+};
+export type DiscordPermissionTier = keyof typeof DiscordPermissionTiers;
+export declare function generateInviteUrl(applicationId: string, tier?: DiscordPermissionTier): string;
+export interface DiscordPermissionValues {
+    basic: number;
+    basicVoice: number;
+    moderator: number;
+    moderatorVoice: number;
+    admin: number;
+    adminVoice: number;
+}
+export declare function getPermissionValues(): DiscordPermissionValues;
+export interface DiscordInviteUrls {
+    basic: string;
+    basicVoice: string;
+    moderator: string;
+    moderatorVoice: string;
+    admin: string;
+    adminVoice: string;
+}
+export declare function generateAllInviteUrls(applicationId: string): DiscordInviteUrls;
+export declare const REQUIRED_PERMISSIONS: bigint;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../permissions.ts"],"names":[],"mappings":"AAqFA,eAAO,MAAM,iBAAiB,QAAa,CAAC;AAC5C,eAAO,MAAM,uBAAuB,QAA2B,CAAC;AAChE,eAAO,MAAM,qBAAqB,QAAiB,CAAC;AACpD,eAAO,MAAM,2BAA2B,QAA+B,CAAC;AACxE,eAAO,MAAM,iBAAiB,QAAa,CAAC;AAC5C,eAAO,MAAM,uBAAuB,QAAiC,CAAC;AAEtE,eAAO,MAAM,sBAAsB;;;;;;;CAOzB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAExE,wBAAgB,iBAAiB,CAChC,aAAa,EAAE,MAAM,EACrB,IAAI,GAAE,qBAAyC,GAC7C,MAAM,CAGR;AAED,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,IAAI,uBAAuB,CAS7D;AAED,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CACpC,aAAa,EAAE,MAAM,GACnB,iBAAiB,CASnB;AAED,eAAO,MAAM,oBAAoB,QAA8B,CAAC"}

package/dist/providers/channelState.d.ts

@@ -0,0 +1,14 @@
+import type { Provider } from "@elizaos/core";
+/**
+ * Represents a provider for retrieving channel state information.
+ * @type {Provider}
+ * @property {string} name - The name of the channel state provider.
+ * @property {Function} get - Asynchronous function that retrieves channel state information based on the provided runtime, message, and optional state parameters.
+ * @param {IAgentRuntime} runtime - The agent runtime.
+ * @param {Memory} message - The message object.
+ * @param {State} [state] - Optional state object.
+ * @returns {Promise<Object>} A promise that resolves to an object containing channel state data, values, and text.
+ */
+export declare const channelStateProvider: Provider;
+export default channelStateProvider;
+//# sourceMappingURL=channelState.d.ts.map

package/dist/providers/channelState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channelState.d.ts","sourceRoot":"","sources":["../../providers/channelState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,QAAQ,EAAS,MAAM,eAAe,CAAC;AAS5E;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAoJlC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/providers/guildInfo.d.ts

@@ -0,0 +1,15 @@
+import type { Provider } from "@elizaos/core";
+/**
+ * Represents a provider for retrieving guild/server information.
+ * @type {Provider}
+ * @property {string} name - The name of the guild info provider.
+ * @property {Function} get - Asynchronous function that retrieves guild information
+ *   based on the provided runtime, message, and optional state parameters.
+ * @param {IAgentRuntime} runtime - The agent runtime.
+ * @param {Memory} message - The message object.
+ * @param {State} [state] - Optional state object.
+ * @returns {Promise<Object>} A promise that resolves to an object containing guild data, values, and text.
+ */
+export declare const guildInfoProvider: Provider;
+export default guildInfoProvider;
+//# sourceMappingURL=guildInfo.d.ts.map

package/dist/providers/guildInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guildInfo.d.ts","sourceRoot":"","sources":["../../providers/guildInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,QAAQ,EAAS,MAAM,eAAe,CAAC;AAQ5E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAyG/B,CAAC;AA4HF,eAAe,iBAAiB,CAAC"}

package/dist/providers/voiceState.d.ts

@@ -0,0 +1,12 @@
+import type { Provider } from "@elizaos/core";
+/**
+ * Provides information about the voice state of the user, including whether they are currently in a voice channel.
+ *
+ * @param {IAgentRuntime} runtime - The runtime object for the agent
+ * @param {Memory} message - The message object containing room ID
+ * @param {State} [state] - Optional state object for the user
+ * @returns {Object} An object containing information about the voice state of the user
+ */
+export declare const voiceStateProvider: Provider;
+export default voiceStateProvider;
+//# sourceMappingURL=voiceState.d.ts.map

package/dist/providers/voiceState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voiceState.d.ts","sourceRoot":"","sources":["../../providers/voiceState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGX,QAAQ,EAIR,MAAM,eAAe,CAAC;AASvB;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,QA2JhC,CAAC;AAEF,eAAe,kBAAkB,CAAC"}