@elizaos/plugin-discord 2.0.0-alpha.8 → 2.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 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,532 @@
+# @elizaos/plugin-discord
+
+A Discord plugin implementation for ElizaOS, enabling rich integration with Discord servers for managing interactions, voice, and message handling.
+
+## Features
+
+- Handle server join events and manage initial configurations
+- Voice event management via the voice manager
+- Manage and process new messages with the message manager
+- Slash command registration and interaction handling
+- Support for Discord attachments and media files
+- Voice channel join/leave functionality
+- Conversation summarization
+- Media transcription capabilities
+- Channel state and voice state providers
+- Channel restriction support (limit bot to specific channels)
+- Robust permissions management and audit event tracking
+- Event-driven architecture with comprehensive event handling
+- History backfill with efficient batch processing
+
+## Installation
+
+As this is a workspace package, it's installed as part of the ElizaOS monorepo:
+
+```bash
+bun install
+```
+
+## Configuration
+
+The plugin requires the following environment variables:
+
+```bash
+# Discord API Credentials (Required)
+DISCORD_APPLICATION_ID=your_application_id
+DISCORD_API_TOKEN=your_api_token
+
+# Channel Restrictions (Optional)
+# Comma-separated list of Discord channel IDs to restrict the bot to.
+# If not set, the bot operates in all channels.
+# These channels cannot be removed via the leaveChannel action.
+CHANNEL_IDS=123456789012345678,987654321098765432
+
+# Listen-only channels (Optional)
+# Comma-separated list of channel IDs where the bot will only listen (not respond).
+DISCORD_LISTEN_CHANNEL_IDS=123456789012345678
+
+# Voice Channel (Optional)
+# ID of the voice channel the bot should auto-join when scanning a guild.
+# If not set, the bot selects based on member activity.
+DISCORD_VOICE_CHANNEL_ID=123456789012345678
+
+# Behavior Settings (Optional)
+# If true, ignore messages from other bots (default: true)
+DISCORD_SHOULD_IGNORE_BOT_MESSAGES=true
+
+# If true, ignore direct messages by default (default: true).
+# DMs can still be allowed explicitly via DISCORD_ALLOW_FROM / pairing allowlist.
+DISCORD_SHOULD_IGNORE_DIRECT_MESSAGES=true
+
+# If true, only respond when explicitly @mentioned (default: true)
+DISCORD_SHOULD_RESPOND_ONLY_TO_MENTIONS=true
+
+# Testing (Optional)
+DISCORD_TEST_CHANNEL_ID=123456789012345678
+```
+
+Settings can also be configured in your character file under `settings.discord`:
+
+```json
+{
+  "settings": {
+    "discord": {
+      "shouldIgnoreBotMessages": true,
+      "shouldIgnoreDirectMessages": true,
+      "shouldRespondOnlyToMentions": true,
+      "allowedChannelIds": ["123456789012345678"]
+    }
+  }
+}
+```
+
+## Usage
+
+```json
+{
+  "plugins": ["@elizaos/plugin-discord"]
+}
+```
+
+## Slash Command Permissions
+
+The plugin uses a hybrid permission system that combines Discord's native features with ElizaOS-specific controls.
+
+### Permission Layers
+
+Commands go through multiple permission checks in this order:
+
+1. **Discord Native Checks** (before interaction fires):
+   - User must have required Discord permissions
+   - Command must be available in the current context (guild vs DM)
+
+2. **ElizaOS Channel Whitelist** (if `CHANNEL_IDS` is set):
+   - Commands only work in whitelisted channels
+   - Unless command has `bypassChannelWhitelist: true`
+
+3. **Custom Validator** (if provided):
+   - Runs custom validation logic
+   - Full programmatic control
+
+### Registering Commands
+
+```typescript
+import { PermissionFlagsBits } from "discord.js";
+
+// Simple command (works everywhere)
+const helpCommand = {
+  name: "help",
+  description: "Show help information",
+};
+
+// Guild-only command
+const serverInfoCommand = {
+  name: "serverinfo",
+  description: "Show server information",
+  guildOnly: true,
+};
+
+// Requires Discord permission
+const configCommand = {
+  name: "config",
+  description: "Configure bot settings",
+  requiredPermissions: PermissionFlagsBits.ManageGuild,
+};
+
+// Bypasses channel whitelist
+const utilityCommand = {
+  name: "export",
+  description: "Export data",
+  bypassChannelWhitelist: true,
+};
+
+// Advanced: custom validation
+const adminCommand = {
+  name: "admin",
+  description: "Admin-only command",
+  validator: async (interaction, runtime) => {
+    const adminIds = runtime.getSetting("ADMIN_USER_IDS")?.split(",") ?? [];
+    return adminIds.includes(interaction.user.id);
+  },
+};
+
+// Register commands
+await runtime.emitEvent(["DISCORD_REGISTER_COMMANDS"], {
+  commands: [
+    helpCommand,
+    serverInfoCommand,
+    configCommand,
+    utilityCommand,
+    adminCommand,
+  ],
+});
+```
+
+### Permission Options
+
+| Option                   | Type               | Description                                                           |
+| ------------------------ | ------------------ | --------------------------------------------------------------------- |
+| `guildOnly`              | `boolean`          | If true, command only works in guilds (not DMs)                       |
+| `bypassChannelWhitelist` | `boolean`          | If true, bypasses `CHANNEL_IDS` restrictions                          |
+| `requiredPermissions`    | `bigint \| string` | Discord permission bitfield (e.g., `PermissionFlagsBits.ManageGuild`) |
+| `contexts`               | `number[]`         | Raw Discord contexts (0=Guild, 1=BotDM, 2=PrivateChannel)             |
+| `guildIds`               | `string[]`         | Register only in specific guilds (instant updates)                    |
+| `validator`              | `function`         | Custom validation function for advanced logic                         |
+
+### Common Permission Values
+
+From Discord.js `PermissionFlagsBits`:
+
+- `ManageGuild` - Server settings
+- `ManageChannels` - Channel management
+- `ManageMessages` - Delete messages
+- `BanMembers` - Ban users
+- `KickMembers` - Kick users
+- `ModerateMembers` - Timeout users
+- `ManageRoles` - Role management
+- `Administrator` - Full access
+
+### Design Rationale
+
+**Why Hybrid Approach?**
+
+- Discord's native permissions are powerful but limited to role-based access
+- ElizaOS needs programmatic control for channel restrictions and custom logic
+- Combining both gives developers the best of both worlds
+
+**Why Simple Flags?**
+
+- `guildOnly: true` is clearer than `contexts: [0]`
+- Abstracts Discord API details
+- Sensible defaults: zero config should "just work"
+
+**Why Keep Channel Whitelist?**
+
+- Discord's channel permissions are UI-based (Server Settings > Integrations)
+- Programmatic control is better for developer experience
+- Allows dynamic, runtime-based channel restrictions
+
+### Available Actions
+
+The plugin provides the following actions:
+
+| Action                           | Description                                              |
+| -------------------------------- | -------------------------------------------------------- |
+| **MESSAGE**                      | Send, read, search, list, react, edit, delete, pin, join, leave, or get user info through the Discord message connector |
+| **DISCORD_SETUP_CREDENTIALS**    | Set up Discord credential pairing                        |
+
+### Providers
+
+Discord message context is exposed through the MESSAGE connector hooks rather than Discord-specific prompt providers.
+
+### Event Types
+
+The plugin emits the following Discord-specific events:
+
+| Event                                 | Description                               |
+| ------------------------------------- | ----------------------------------------- |
+| `DISCORD_MESSAGE_RECEIVED`            | When a message is received                |
+| `DISCORD_MESSAGE_SENT`                | When a message is sent                    |
+| `DISCORD_SLASH_COMMAND`               | When a slash command is invoked           |
+| `DISCORD_MODAL_SUBMIT`                | When a modal form is submitted            |
+| `DISCORD_REACTION_RECEIVED`           | When a reaction is added to a message     |
+| `DISCORD_REACTION_REMOVED`            | When a reaction is removed from a message |
+| `DISCORD_WORLD_JOINED`                | When the bot joins a guild                |
+| `DISCORD_SERVER_CONNECTED`            | When connected to a server                |
+| `DISCORD_USER_JOINED`                 | When a user joins a guild                 |
+| `DISCORD_USER_LEFT`                   | When a user leaves a guild                |
+| `DISCORD_VOICE_STATE_CHANGED`         | When voice state changes                  |
+| `DISCORD_CHANNEL_PERMISSIONS_CHANGED` | When channel permissions change           |
+| `DISCORD_ROLE_PERMISSIONS_CHANGED`    | When role permissions change              |
+| `DISCORD_MEMBER_ROLES_CHANGED`        | When a member's roles change              |
+| `DISCORD_ROLE_CREATED`                | When a role is created                    |
+| `DISCORD_ROLE_DELETED`                | When a role is deleted                    |
+
+## Key Components
+
+### DiscordService
+
+Main service class that extends ElizaOS Service:
+
+- Handles authentication and session management
+- Manages Discord client connection
+- Processes events and interactions
+- Supports channel history backfill with efficient batch processing
+
+### MessageManager
+
+- Processes incoming messages and responses
+- Handles attachments and media files
+- Supports message formatting and templating
+- Manages conversation context
+
+### VoiceManager
+
+- Manages voice channel interactions
+- Handles joining and leaving voice channels
+- Processes voice events and audio streams
+- Integrates with transcription services
+
+### Attachment Handler
+
+- Downloads and processes Discord attachments
+- Supports various media types
+- Integrates with media transcription
+
+## Developer Guide
+
+### Custom Slash Commands
+
+Register slash commands via the `DISCORD_REGISTER_COMMANDS` event, then listen for interactions:
+
+```typescript
+// Register custom slash commands
+await runtime.emitEvent(["DISCORD_REGISTER_COMMANDS"], {
+  commands: [
+    {
+      name: "mycommand",
+      description: "My custom command",
+      options: [
+        {
+          name: "input",
+          description: "User input",
+          type: 3, // STRING type
+          required: true,
+        },
+      ],
+    },
+    {
+      name: "serverinfo",
+      description: "Get server information",
+      guildOnly: true, // Only works in guilds, not DMs
+    },
+  ],
+});
+
+// Listen for slash command events to handle the interaction
+runtime.registerEvent({
+  name: "DISCORD_SLASH_COMMAND",
+  handler: async (payload) => {
+    const { interaction, client, commands } = payload;
+
+    if (interaction.commandName === "mycommand") {
+      const input = interaction.options.getString("input");
+      await interaction.reply(`You said: ${input}`);
+    }
+  },
+});
+```
+
+### Building on the Listen System
+
+The `DISCORD_LISTEN_CHANNEL_IDS` setting creates "listen-only" channels where the bot receives messages but doesn't respond. This is useful for:
+
+- **Monitoring channels** - Track activity without interrupting conversations
+- **Data collection** - Gather messages for analysis or training
+- **Conditional responses** - Build custom logic that decides when to respond
+
+```typescript
+// Check if a channel is listen-only
+const listenChannels = runtime.getSetting("DISCORD_LISTEN_CHANNEL_IDS");
+const listenChannelIds = listenChannels?.split(",").map((s) => s.trim()) || [];
+
+runtime.registerEvent({
+  name: "DISCORD_MESSAGE_RECEIVED",
+  handler: async (payload) => {
+    const { message } = payload;
+    const channelId = message.content.channelId;
+
+    if (listenChannelIds.includes(channelId)) {
+      // This is a listen-only channel - process without responding
+      await processMessageSilently(message);
+    }
+  },
+});
+```
+
+### Handling Modal and Component Interactions
+
+Modal submits and message components (buttons, select menus) bypass channel whitelists to support multi-step UI flows:
+
+```typescript
+// Listen for modal submissions
+runtime.registerEvent({
+  name: "DISCORD_MODAL_SUBMIT",
+  handler: async (payload) => {
+    const { interaction } = payload;
+    const fieldValue = interaction.fields.getTextInputValue("myField");
+    await interaction.reply(`Received: ${fieldValue}`);
+  },
+});
+```
+
+### Permission Audit System
+
+The plugin includes a comprehensive permission audit system that tracks all permission changes with full audit log integration. This is useful for:
+
+- **Security monitoring** - Detect unauthorized permission escalations
+- **Compliance logging** - Maintain records of who changed what and when
+- **Bot self-protection** - Detect when the bot's permissions are modified
+
+#### Event Payloads
+
+**DISCORD_CHANNEL_PERMISSIONS_CHANGED** - When channel overwrites change:
+
+```typescript
+interface ChannelPermissionsChangedPayload {
+  runtime: IAgentRuntime;
+  guild: { id: string; name: string };
+  channel: { id: string; name: string };
+  target: { type: "role" | "user"; id: string; name: string };
+  action: "CREATE" | "UPDATE" | "DELETE";
+  changes: Array<{
+    permission: string; // e.g., 'ManageMessages', 'Administrator'
+    oldState: "ALLOW" | "DENY" | "NEUTRAL";
+    newState: "ALLOW" | "DENY" | "NEUTRAL";
+  }>;
+  audit: {
+    executorId: string;
+    executorTag: string;
+    reason: string | null;
+  } | null;
+}
+```
+
+**DISCORD_ROLE_PERMISSIONS_CHANGED** - When role permissions change:
+
+```typescript
+interface RolePermissionsChangedPayload {
+  runtime: IAgentRuntime;
+  guild: { id: string; name: string };
+  role: { id: string; name: string };
+  changes: PermissionDiff[];
+  audit: AuditInfo | null;
+}
+```
+
+**DISCORD_MEMBER_ROLES_CHANGED** - When a member's roles change:
+
+```typescript
+interface MemberRolesChangedPayload {
+  runtime: IAgentRuntime;
+  guild: { id: string; name: string };
+  member: { id: string; tag: string };
+  added: Array<{ id: string; name: string; permissions: string[] }>;
+  removed: Array<{ id: string; name: string; permissions: string[] }>;
+  audit: AuditInfo | null;
+}
+```
+
+**DISCORD_ROLE_CREATED / DISCORD_ROLE_DELETED** - Role lifecycle:
+
+```typescript
+interface RoleLifecyclePayload {
+  runtime: IAgentRuntime;
+  guild: { id: string; name: string };
+  role: { id: string; name: string; permissions: string[] };
+  audit: AuditInfo | null;
+}
+```
+
+#### Example: Security Monitoring
+
+```typescript
+import { DiscordEventTypes } from "@elizaos/plugin-discord";
+
+// Alert on dangerous permission grants
+runtime.registerEvent({
+  name: DiscordEventTypes.CHANNEL_PERMISSIONS_CHANGED,
+  handler: async (payload) => {
+    const dangerousPerms = ["Administrator", "ManageGuild", "ManageRoles"];
+
+    for (const change of payload.changes) {
+      if (
+        dangerousPerms.includes(change.permission) &&
+        change.newState === "ALLOW"
+      ) {
+        console.warn(`⚠️ Dangerous permission granted!`, {
+          channel: payload.channel.name,
+          target: payload.target.name,
+          permission: change.permission,
+          grantedBy: payload.audit?.executorTag || "Unknown",
+        });
+      }
+    }
+  },
+});
+
+// Track role escalations
+runtime.registerEvent({
+  name: DiscordEventTypes.MEMBER_ROLES_CHANGED,
+  handler: async (payload) => {
+    const adminRoles = payload.added.filter((r) =>
+      r.permissions.includes("Administrator"),
+    );
+
+    if (adminRoles.length > 0) {
+      console.warn(`⚠️ Admin role granted to ${payload.member.tag}`, {
+        roles: adminRoles.map((r) => r.name),
+        grantedBy: payload.audit?.executorTag || "Unknown",
+      });
+    }
+  },
+});
+
+// Log all role creations
+runtime.registerEvent({
+  name: DiscordEventTypes.ROLE_CREATED,
+  handler: async (payload) => {
+    console.log(`New role created: ${payload.role.name}`, {
+      permissions: payload.role.permissions,
+      createdBy: payload.audit?.executorTag || "Unknown",
+    });
+  },
+});
+```
+
+#### Bot Self-Protection
+
+Monitor when the bot's own permissions change:
+
+```typescript
+runtime.registerEvent({
+  name: DiscordEventTypes.MEMBER_ROLES_CHANGED,
+  handler: async (payload) => {
+    const botId = runtime.getSetting("DISCORD_APPLICATION_ID");
+
+    if (payload.member.id === botId && payload.removed.length > 0) {
+      console.error(`🚨 Bot roles removed!`, {
+        removed: payload.removed.map((r) => r.name),
+        by: payload.audit?.executorTag || "Unknown",
+      });
+      // Could trigger alerts, notifications, etc.
+    }
+  },
+});
+```
+
+## Cross-Core Compatibility
+
+This plugin includes a compatibility layer (`compat.ts`) that allows it to work with both old and new versions of `@elizaos/core`. The compatibility layer:
+
+- Automatically handles `serverId` vs `messageServerId` differences
+- Uses a runtime proxy to intercept and adapt API calls
+- Requires no changes to existing code
+
+When migrating to a new core version, see the comments in `compat.ts` for removal instructions.
+
+## Testing
+
+The plugin includes a test suite for validating functionality:
+
+```bash
+bun run test
+```
+
+## Notes
+
+- Ensure that your `.env` file includes the required `DISCORD_API_TOKEN`
+- The bot requires appropriate Discord permissions (send messages, connect to voice, etc.)
+- If no token is provided, the plugin will load but remain non-functional with appropriate warnings
+- The plugin uses Discord.js v14.18.0 with comprehensive intent support
+- Slash commands and modal/component interactions bypass channel whitelists

package/dist/account-client-pool.d.ts

@@ -0,0 +1,35 @@
+import type { Client as DiscordJsClient } from "discord.js";
+import { type ResolvedDiscordAccount } from "./accounts";
+import type { ChannelDebouncer, MessageDebouncer } from "./debouncer";
+import type { MessageManager } from "./messages";
+import type { DiscordSettings } from "./types";
+import type { VoiceManager } from "./voice";
+export interface DiscordAccountClientState {
+    accountId: string;
+    account: ResolvedDiscordAccount;
+    client: DiscordJsClient | null;
+    settings: DiscordSettings;
+    allowedChannelIds?: string[];
+    listenChannelIds?: string[];
+    dynamicChannelIds: Set<string>;
+    clientReadyPromise: Promise<void> | null;
+    loginFailed: boolean;
+    messageManager?: MessageManager;
+    voiceManager?: VoiceManager;
+    messageDebouncer?: MessageDebouncer;
+    channelDebouncer?: ChannelDebouncer;
+}
+export declare class DiscordAccountClientPool {
+    private defaultAccountId;
+    private readonly clients;
+    constructor(defaultAccountId?: string);
+    setDefaultAccountId(accountId: string): void;
+    getDefaultAccountId(): string;
+    set(state: DiscordAccountClientState): void;
+    get(accountId?: string | null): DiscordAccountClientState | null;
+    getDefault(): DiscordAccountClientState | null;
+    list(): DiscordAccountClientState[];
+    listAccountIds(): string[];
+    clear(): void;
+}
+//# sourceMappingURL=account-client-pool.d.ts.map

package/dist/account-client-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-client-pool.d.ts","sourceRoot":"","sources":["../account-client-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAGN,KAAK,sBAAsB,EAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,WAAW,yBAAyB;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,sBAAsB,CAAC;IAChC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,eAAe,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED,qBAAa,wBAAwB;IACpC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgD;gBAE5D,gBAAgB,SAAqB;IAIjD,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI5C,mBAAmB,IAAI,MAAM;IAI7B,GAAG,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI;IAM3C,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,yBAAyB,GAAG,IAAI;IAKhE,UAAU,IAAI,yBAAyB,GAAG,IAAI;IAI9C,IAAI,IAAI,yBAAyB,EAAE;IAInC,cAAc,IAAI,MAAM,EAAE;IAI1B,KAAK,IAAI,IAAI;CAGb"}

package/dist/accounts.d.ts.map

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

package/dist/actions/actionResultSemantics.d.ts

@@ -0,0 +1,9 @@
+import type { ActionResult } from "@elizaos/core";
+type ActionResultData = NonNullable<ActionResult["data"]>;
+export declare const terminalActionInteractionSemantics: {
+    readonly suppressPostActionContinuation: true;
+    readonly suppressActionResultClipboard: true;
+};
+export declare function terminalActionResultData(data?: ActionResultData): ActionResultData;
+export {};
+//# sourceMappingURL=actionResultSemantics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actionResultSemantics.d.ts","sourceRoot":"","sources":["../../actions/actionResultSemantics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,KAAK,gBAAgB,GAAG,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;AAE1D,eAAO,MAAM,kCAAkC;;;CAGrC,CAAC;AAEX,wBAAgB,wBAAwB,CACvC,IAAI,GAAE,gBAAqB,GACzB,gBAAgB,CAMlB"}

package/dist/actions/setup-credentials.d.ts

@@ -0,0 +1,25 @@
+import { type Action } from "@elizaos/core";
+export interface CredentialPreset {
+    name: string;
+    displayName: string;
+    fields: CredentialField[];
+    helpUrl: string;
+    helpText: string;
+    validate: (credentials: Record<string, string>) => Promise<{
+        valid: boolean;
+        identity?: string;
+        error?: string;
+    }>;
+}
+export interface CredentialField {
+    key: string;
+    label: string;
+    secret: boolean;
+}
+export declare function registerPreset(preset: CredentialPreset): void;
+export declare function getPreset(name: string): CredentialPreset | undefined;
+export declare function listPresets(): string[];
+export declare function loadCredentials(service: string): Record<string, string> | null;
+export declare const setupCredentials: Action;
+export default setupCredentials;
+//# sourceMappingURL=setup-credentials.d.ts.map

package/dist/actions/setup-credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-credentials.d.ts","sourceRoot":"","sources":["../../actions/setup-credentials.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,KAAK,MAAM,EASX,MAAM,eAAe,CAAC;AASvB,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CACT,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC/B,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CAChB;AA4CD,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAQ7D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEpE;AAED,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AA8PD,wBAAgB,eAAe,CAC9B,OAAO,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAa/B;AAuID,eAAO,MAAM,gBAAgB,EAAE,MAoY9B,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/addressing.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Discord-native addressing helper.
+ *
+ * A bot can be mentioned as the subject of a message addressed to someone else.
+ * Connector routing should only treat the bot as directly addressed when the
+ * platform facts say so: the message replies to the bot, or the first user
+ * mention in the raw Discord content is the bot.
+ */
+export declare function isDiscordUserAddressed({ text, userId, hasMessageReference, repliedUserId, }: {
+    text?: string | null;
+    userId?: string | null;
+    hasMessageReference?: boolean;
+    repliedUserId?: string | null;
+}): boolean;
+//# sourceMappingURL=addressing.d.ts.map

package/dist/addressing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addressing.d.ts","sourceRoot":"","sources":["../addressing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyBH,wBAAgB,sBAAsB,CAAC,EACtC,IAAI,EACJ,MAAM,EACN,mBAA2B,EAC3B,aAAa,GACb,EAAE;IACF,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAKV"}