@elizaos/plugin-discord 1.3.8 → 2.0.0-alpha.10

package/dist/attachments.d.ts

@@ -0,0 +1,92 @@
+import { type IAgentRuntime, type Media } from "@elizaos/core";
+import { type Attachment, Collection } from "discord.js";
+/**
+ * Class representing an Attachment Manager.
+ */
+export declare class AttachmentManager {
+    private attachmentCache;
+    private runtime;
+    /**
+     * Constructor for creating a new instance of the class.
+     *
+     * @param {IAgentRuntime} runtime The runtime object to be injected into the instance.
+     */
+    constructor(runtime: IAgentRuntime);
+    /**
+     * Processes attachments and returns an array of Media objects.
+     * @param {Collection<string, Attachment> | Attachment[]} attachments - The attachments to be processed
+     * @returns {Promise<Media[]>} - An array of processed Media objects
+     */
+    processAttachments(attachments: Collection<string, Attachment> | Attachment[]): Promise<Media[]>;
+    /**
+     * Processes the provided attachment to generate a media object.
+     * If the media for the attachment URL is already cached, it will return the cached media.
+     * Otherwise, it will determine the type of attachment (PDF, text, audio, video, image, generic)
+     * and call the corresponding processing method to generate the media object.
+     *
+     * @param attachment The attachment to process
+     * @returns A promise that resolves to a Media object representing the attachment, or null if the attachment could not be processed
+     */
+    processAttachment(attachment: Attachment): Promise<Media | null>;
+    /**
+     * Asynchronously processes an audio or video attachment provided as input and returns a Media object.
+     * @param {Attachment} attachment - The attachment object containing information about the audio/video file.
+     * @returns {Promise<Media>} A Promise that resolves to a Media object representing the processed audio/video attachment.
+     */
+    private processAudioVideoAttachment;
+    /**
+     * Extracts the audio stream from the provided MP4 data and converts it to MP3 format.
+     *
+     * @param {ArrayBuffer} mp4Data - The MP4 data to extract audio from
+     * @returns {Promise<Buffer>} - A Promise that resolves with the converted audio data as a Buffer
+     */
+    private extractAudioFromMP4;
+    /**
+     * Processes a PDF attachment by fetching the PDF file from the specified URL,
+     * converting it to text, generating a summary, and returning a Media object
+     * with the extracted information.
+     * If an error occurs during processing, a placeholder Media object is returned
+     * with an error message.
+     *
+     * @param {Attachment} attachment - The PDF attachment to process.
+     * @returns {Promise<Media>} A promise that resolves to a Media object representing
+     * the processed PDF attachment.
+     */
+    private processPdfAttachment;
+    /**
+     * Processes a plaintext attachment by fetching its content, generating a summary, and returning a Media object.
+     * @param {Attachment} attachment - The attachment object to process.
+     * @returns {Promise<Media>} A promise that resolves to a Media object representing the processed plaintext attachment.
+     */
+    private processPlaintextAttachment;
+    /**
+     * Process the image attachment by fetching description and title using the IMAGE_DESCRIPTION model.
+     * If successful, returns a Media object populated with the details. If unsuccessful, creates a fallback
+     * Media object and logs the error.
+     *
+     * @param {Attachment} attachment - The attachment object containing the image details.
+     * @returns {Promise<Media>} A promise that resolves to a Media object.
+     */
+    private processImageAttachment;
+    /**
+     * Creates a fallback Media object for image attachments that could not be recognized.
+     *
+     * @param {Attachment} attachment - The attachment object containing image details.
+     * @returns {Media} - The fallback Media object with basic information about the image attachment.
+     */
+    private createFallbackImageMedia;
+    /**
+     * Process a video attachment to extract video information.
+     * @param {Attachment} attachment - The attachment object containing video information.
+     * @returns {Promise<Media>} A promise that resolves to a Media object with video details.
+     * @throws {Error} If video service is not available.
+     */
+    private processVideoAttachment;
+    /**
+     * Process a generic attachment and return a Media object with specified properties.
+     * @param {Attachment} attachment - The attachment object to process.
+     * @returns {Promise<Media>} A Promise that resolves to a Media object with specified properties.
+     */
+    private processGenericAttachment;
+}
+//# sourceMappingURL=attachments.d.ts.map

package/dist/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../attachments.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,KAAK,EAIV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIzD;;GAEG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,OAAO,CAAgB;IAE/B;;;;OAIG;gBACS,OAAO,EAAE,aAAa;IAIlC;;;;OAIG;IACG,kBAAkB,CACvB,WAAW,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,UAAU,EAAE,GACxD,OAAO,CAAC,KAAK,EAAE,CAAC;IAiBnB;;;;;;;;OAQG;IACG,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAqCtE;;;;OAIG;YACW,2BAA2B;IAqIzC;;;;;OAKG;YACW,mBAAmB;IAwGjC;;;;;;;;;;OAUG;YACW,oBAAoB;IAqDlC;;;;OAIG;YACW,0BAA0B;IAgDxC;;;;;;;OAOG;YACW,sBAAsB;IA8BpC;;;;;OAKG;IAEH,OAAO,CAAC,wBAAwB;IAWhC;;;;;OAKG;YACW,sBAAsB;IAsDpC;;;;OAIG;YACW,wBAAwB;CAYtC"}

package/dist/banner.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Discord Plugin Settings Banner
+ * Beautiful ANSI art display for configuration on startup
+ * Includes tiered permission system for invite URLs
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import { type DiscordPermissionValues } from "./permissions";
+export interface PluginSetting {
+    name: string;
+    value: unknown;
+    defaultValue?: unknown;
+    sensitive?: boolean;
+    required?: boolean;
+}
+export interface BannerOptions {
+    pluginName: string;
+    description?: string;
+    settings: PluginSetting[];
+    runtime: IAgentRuntime;
+    /** Discord Application ID for generating invite URLs */
+    applicationId?: string;
+    /** Permission values for the 3x2 tier matrix */
+    discordPermissions?: DiscordPermissionValues;
+}
+/**
+ * Render a framed ANSI banner that displays plugin settings and, when available, tiered Discord invite URLs.
+ *
+ * The banner lists each setting with masked or truncated values, a status (custom/default/unset/required),
+ * and an optional Discord invite section generated from `applicationId` and `discordPermissions`.
+ *
+ * @param options - Configuration for the banner, including `settings`, the `runtime` used to emit the banner,
+ *                  and optional Discord invite data (`applicationId`, `discordPermissions`).
+ */
+export declare function printBanner(options: BannerOptions): void;
+/**
+ * Print the Discord plugin banner with current settings.
+ */
+export declare function printDiscordBanner(runtime: IAgentRuntime): void;
+//# sourceMappingURL=banner.d.ts.map

package/dist/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../banner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACN,KAAK,uBAAuB,EAE5B,MAAM,eAAe,CAAC;AAgBvB,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,uBAAuB,CAAC;CAC7C;AAoFD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAoIxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CA6C/D"}

package/dist/compat.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Runtime compatibility layer for old/new core.
+ *
+ * Automatically adds serverId when messageServerId is provided,
+ * making plugin code work with both core versions unchanged.
+ *
+ * Old core expects: serverId (string)
+ * New core expects: messageServerId (UUID)
+ *
+ * NOTE: UUID function usage for Discord IDs:
+ * - `stringToUuid(str)` - CONVERTS any string to a deterministic UUID by hashing.
+ *   Use this for Discord snowflake IDs (always succeeds, same input = same output).
+ * - `asUUID(str)` - VALIDATES that string is already a valid UUID format.
+ *   Throws if not a valid UUID. Only use when input is already a UUID.
+ *
+ * REMOVAL: Delete this file and remove createCompatRuntime() call in service.ts
+ */
+import type { ChannelType, Entity, IAgentRuntime, Room, UUID, World } from "@elizaos/core";
+/**
+ * Extended types that support messageServerId for cross-core compatibility.
+ * These allow TypeScript to accept messageServerId in object literals.
+ */
+export type WorldCompat = Omit<World, "serverId"> & {
+    serverId?: string;
+    messageServerId?: UUID;
+};
+export type RoomCompat = Omit<Room, "serverId"> & {
+    serverId?: string;
+    messageServerId?: UUID;
+};
+export interface EnsureConnectionParams {
+    entityId: UUID;
+    roomId: UUID;
+    userName?: string;
+    name?: string;
+    worldName?: string;
+    source?: string;
+    channelId?: string;
+    serverId?: string;
+    messageServerId?: UUID;
+    type?: ChannelType | string;
+    worldId: UUID;
+    userId?: UUID;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Extended runtime interface that accepts messageServerId in method parameters.
+ */
+export interface ICompatRuntime extends Omit<IAgentRuntime, "ensureWorldExists" | "ensureRoomExists" | "ensureConnection" | "ensureConnections"> {
+    ensureWorldExists(world: WorldCompat): Promise<void>;
+    ensureRoomExists(room: RoomCompat): Promise<void>;
+    ensureConnection(params: EnsureConnectionParams): Promise<void>;
+    ensureConnections(entities: Entity[], rooms: RoomCompat[], source: string, world: WorldCompat): Promise<void>;
+}
+export declare function createCompatRuntime(runtime: IAgentRuntime): ICompatRuntime;
+//# sourceMappingURL=compat.d.ts.map

package/dist/compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EACX,WAAW,EACX,MAAM,EACN,aAAa,EACb,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,MAAM,eAAe,CAAC;AAEvB;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACtC,QAAQ,EAAE,IAAI,CAAC;IACf,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC5B,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,cAChB,SAAQ,IAAI,CACX,aAAa,EACX,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,CACrB;IACD,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,iBAAiB,CAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,EAAE,UAAU,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,WAAW,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC;CACjB;AASD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAuC1E"}

package/dist/config.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Discord plugin configuration types.
+ *
+ * These types define the configuration schema for the Discord plugin.
+ * Shared base types are imported from @elizaos/core.
+ */
+import type { BlockStreamingCoalesceConfig, ChannelHeartbeatVisibilityConfig, DmConfig, DmPolicy, GroupPolicy, GroupToolPolicyBySenderConfig, GroupToolPolicyConfig, MarkdownConfig, OutboundRetryConfig, ProviderCommandsConfig, ReplyToMode } from "@elizaos/core";
+export type DiscordPluralKitConfig = {
+    enabled?: boolean;
+    detectProxied?: boolean;
+    cacheUsers?: boolean;
+};
+export type DiscordDmConfig = {
+    /** If false, ignore all incoming Discord DMs. Default: true. */
+    enabled?: boolean;
+    /** Direct message access policy (default: pairing). */
+    policy?: DmPolicy;
+    /** Allowlist for DM senders (ids or names). */
+    allowFrom?: Array<string | number>;
+    /** If true, allow group DMs (default: false). */
+    groupEnabled?: boolean;
+    /** Optional allowlist for group DM channels (ids or slugs). */
+    groupChannels?: Array<string | number>;
+};
+export type DiscordGuildChannelConfig = {
+    allow?: boolean;
+    requireMention?: boolean;
+    /** Optional tool policy overrides for this channel. */
+    tools?: GroupToolPolicyConfig;
+    toolsBySender?: GroupToolPolicyBySenderConfig;
+    /** If specified, only load these skills for this channel. Omit = all skills; empty = no skills. */
+    skills?: string[];
+    /** If false, disable the bot for this channel. */
+    enabled?: boolean;
+    /** Optional allowlist for channel senders (ids or names). */
+    users?: Array<string | number>;
+    /** Optional system prompt snippet for this channel. */
+    systemPrompt?: string;
+};
+export type DiscordReactionNotificationMode = "off" | "own" | "all" | "allowlist";
+export type DiscordGuildEntry = {
+    slug?: string;
+    requireMention?: boolean;
+    /** Optional tool policy overrides for this guild (used when channel override is missing). */
+    tools?: GroupToolPolicyConfig;
+    toolsBySender?: GroupToolPolicyBySenderConfig;
+    /** Reaction notification mode (off|own|all|allowlist). Default: own. */
+    reactionNotifications?: DiscordReactionNotificationMode;
+    users?: Array<string | number>;
+    channels?: Record<string, DiscordGuildChannelConfig>;
+};
+export type DiscordActionConfig = {
+    reactions?: boolean;
+    stickers?: boolean;
+    polls?: boolean;
+    permissions?: boolean;
+    messages?: boolean;
+    threads?: boolean;
+    pins?: boolean;
+    search?: boolean;
+    memberInfo?: boolean;
+    roleInfo?: boolean;
+    roles?: boolean;
+    channelInfo?: boolean;
+    voiceStatus?: boolean;
+    events?: boolean;
+    moderation?: boolean;
+    emojiUploads?: boolean;
+    stickerUploads?: boolean;
+    channels?: boolean;
+    /** Enable bot presence/activity changes (default: false). */
+    presence?: boolean;
+};
+export type DiscordIntentsConfig = {
+    /** Enable Guild Presences privileged intent (requires Portal opt-in). Default: false. */
+    presence?: boolean;
+    /** Enable Guild Members privileged intent (requires Portal opt-in). Default: false. */
+    guildMembers?: boolean;
+};
+export type DiscordExecApprovalConfig = {
+    /** Enable exec approval forwarding to Discord DMs. Default: false. */
+    enabled?: boolean;
+    /** Discord user IDs to receive approval prompts. Required if enabled. */
+    approvers?: Array<string | number>;
+    /** Only forward approvals for these agent IDs. Omit = all agents. */
+    agentFilter?: string[];
+    /** Only forward approvals matching these session key patterns (substring or regex). */
+    sessionFilter?: string[];
+};
+export type DiscordAccountConfig = {
+    /** 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 Discord (bool or "auto"). */
+    commands?: ProviderCommandsConfig;
+    /** Allow channel-initiated config writes (default: true). */
+    configWrites?: boolean;
+    /** If false, do not start this Discord account. Default: true. */
+    enabled?: boolean;
+    token?: string;
+    /** Allow bot-authored messages to trigger replies (default: false). */
+    allowBots?: boolean;
+    /**
+     * Controls how guild channel messages are handled:
+     * - "open": guild channels bypass allowlists; mention-gating applies
+     * - "disabled": block all guild channel messages
+     * - "allowlist": only allow channels present in discord.guilds.*.channels
+     */
+    groupPolicy?: GroupPolicy;
+    /** Outbound text chunk size (chars). Default: 2000. */
+    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;
+    /**
+     * Soft max line count per Discord message.
+     * Discord clients can clip/collapse very tall messages; splitting by lines
+     * keeps replies readable in-channel. Default: 17.
+     */
+    maxLinesPerMessage?: number;
+    mediaMaxMb?: number;
+    historyLimit?: number;
+    /** Max DM turns to keep as history context. */
+    dmHistoryLimit?: number;
+    /** Per-DM config overrides keyed by user ID. */
+    dms?: Record<string, DmConfig>;
+    /** Retry policy for outbound Discord API calls. */
+    retry?: OutboundRetryConfig;
+    /** Per-action tool gating (default: true for all). */
+    actions?: DiscordActionConfig;
+    /** Control reply threading when reply tags are present (off|first|all). */
+    replyToMode?: ReplyToMode;
+    dm?: DiscordDmConfig;
+    /** New per-guild config keyed by guild id or slug. */
+    guilds?: Record<string, DiscordGuildEntry>;
+    /** Heartbeat visibility settings for this channel. */
+    heartbeat?: ChannelHeartbeatVisibilityConfig;
+    /** Exec approval forwarding configuration. */
+    execApprovals?: DiscordExecApprovalConfig;
+    /** Privileged Gateway Intents (must also be enabled in Discord Developer Portal). */
+    intents?: DiscordIntentsConfig;
+    /** PluralKit identity resolution for proxied messages. */
+    pluralkit?: DiscordPluralKitConfig;
+};
+export type DiscordChannelConfig = {
+    /** Optional per-account Discord configuration (multi-account). */
+    accounts?: Record<string, DiscordAccountConfig>;
+} & DiscordAccountConfig;
+export type { DiscordChannelConfig as DiscordConfig };
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,4BAA4B,EAC5B,gCAAgC,EAChC,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,6BAA6B,EAC7B,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EACX,MAAM,eAAe,CAAC;AAMvB,MAAM,MAAM,sBAAsB,GAAG;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAMF,MAAM,MAAM,eAAe,GAAG;IAC7B,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACnC,iDAAiD;IACjD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CACvC,CAAC;AAMF,MAAM,MAAM,yBAAyB,GAAG;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uDAAuD;IACvD,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,aAAa,CAAC,EAAE,6BAA6B,CAAC;IAC9C,mGAAmG;IACnG,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/B,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GACxC,KAAK,GACL,KAAK,GACL,KAAK,GACL,WAAW,CAAC;AAEf,MAAM,MAAM,iBAAiB,GAAG;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,aAAa,CAAC,EAAE,6BAA6B,CAAC;IAC9C,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,+BAA+B,CAAC;IACxD,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;CACrD,CAAC;AAMF,MAAM,MAAM,mBAAmB,GAAG;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAMF,MAAM,MAAM,oBAAoB,GAAG;IAClC,yFAAyF;IACzF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uFAAuF;IACvF,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAMF,MAAM,MAAM,yBAAyB,GAAG;IACvC,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACnC,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAMF,MAAM,MAAM,oBAAoB,GAAG;IAClC,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjC,gDAAgD;IAChD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,sBAAsB,CAAC,EAAE,4BAA4B,CAAC;IACtD;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/B,mDAAmD;IACnD,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,sDAAsD;IACtD,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,EAAE,CAAC,EAAE,eAAe,CAAC;IACrB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,sDAAsD;IACtD,SAAS,CAAC,EAAE,gCAAgC,CAAC;IAC7C,8CAA8C;IAC9C,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,qFAAqF;IACrF,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACnC,CAAC;AAMF,MAAM,MAAM,oBAAoB,GAAG;IAClC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAChD,GAAG,oBAAoB,CAAC;AAGzB,YAAY,EAAE,oBAAoB,IAAI,aAAa,EAAE,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const DISCORD_SERVICE_NAME = "discord";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,YAAY,CAAC"}

package/dist/environment.d.ts

@@ -0,0 +1,22 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import { z } from "zod";
+import type { DiscordSettings } from "./types";
+export declare const DISCORD_DEFAULTS: {
+    readonly SHOULD_IGNORE_BOT_MESSAGES: boolean;
+    readonly SHOULD_IGNORE_DIRECT_MESSAGES: boolean;
+    readonly SHOULD_RESPOND_ONLY_TO_MENTIONS: boolean;
+    readonly ALLOWED_CHANNEL_IDS: string[];
+    readonly DM_POLICY: "open" | "allowlist" | "pairing" | "disabled";
+    readonly ALLOW_FROM: string[];
+};
+export declare const discordEnvSchema: z.ZodObject<{
+    DISCORD_API_TOKEN: z.ZodString;
+    CHANNEL_IDS: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string[], string>>;
+    DISCORD_SHOULD_IGNORE_BOT_MESSAGES: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<boolean, string>>;
+    DISCORD_SHOULD_IGNORE_DIRECT_MESSAGES: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<boolean, string>>;
+    DISCORD_SHOULD_RESPOND_ONLY_TO_MENTIONS: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<boolean, string>>;
+}, z.core.$strip>;
+export type DiscordConfig = z.infer<typeof discordEnvSchema>;
+export declare function getDiscordSettings(runtime: IAgentRuntime): DiscordSettings;
+export declare function validateDiscordConfig(runtime: IAgentRuntime): Promise<DiscordConfig>;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAqB/C,eAAO,MAAM,gBAAgB;;;;;wBAezB,MAAM,GACN,WAAW,GACX,SAAS,GACT,UAAU;;CAEJ,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;;;iBAyB3B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,CAoF1E;AAED,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/dist/generated/prompts/typescript/prompts.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Auto-generated prompt templates
+ * DO NOT EDIT - Generated from ../../../../prompts/*.txt
+ *
+ * These prompts use Handlebars-style template syntax:
+ * - {{variableName}} for simple substitution
+ * - {{#each items}}...{{/each}} for iteration
+ * - {{#if condition}}...{{/if}} for conditionals
+ */
+export declare const attachmentIdsTemplate = "# Messages we are summarizing\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting a summary of specific attachments. Your goal is to determine their objective, along with the list of attachment IDs to summarize.\nThe \"objective\" is a detailed description of what the user wants to summarize based on the conversation.\nThe \"attachmentIds\" is an array of attachment IDs that the user wants to summarize. If not specified, default to including all attachments from the conversation.\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"objective\": \"<What the user wants to summarize>\",\n  \"attachmentIds\": [\"<Attachment ID 1>\", \"<Attachment ID 2>\", ...]\n}\n```";
+export declare const ATTACHMENT_IDS_TEMPLATE = "# Messages we are summarizing\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting a summary of specific attachments. Your goal is to determine their objective, along with the list of attachment IDs to summarize.\nThe \"objective\" is a detailed description of what the user wants to summarize based on the conversation.\nThe \"attachmentIds\" is an array of attachment IDs that the user wants to summarize. If not specified, default to including all attachments from the conversation.\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"objective\": \"<What the user wants to summarize>\",\n  \"attachmentIds\": [\"<Attachment ID 1>\", \"<Attachment ID 2>\", ...]\n}\n```";
+export declare const attachmentSummarizationTemplate = "# Summarized so far (we are adding to this)\n{{currentSummary}}\n\n# Current attachments we are summarizing\n{{attachmentsWithText}}\n\nSummarization objective: {{objective}}\n\n# Instructions: Summarize the attachments. Return the summary. Do not acknowledge this request, just summarize and continue the existing summary if there is one. Capture any important details based on the objective. Only respond with the new summary text.";
+export declare const ATTACHMENT_SUMMARIZATION_TEMPLATE = "# Summarized so far (we are adding to this)\n{{currentSummary}}\n\n# Current attachments we are summarizing\n{{attachmentsWithText}}\n\nSummarization objective: {{objective}}\n\n# Instructions: Summarize the attachments. Return the summary. Do not acknowledge this request, just summarize and continue the existing summary if there is one. Capture any important details based on the objective. Only respond with the new summary text.";
+export declare const channelInfoTemplate = "# Messages we are searching for channel information\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting to read messages from a specific Discord channel. Your goal is to determine:\n1. The channel they want to read from (could be the current channel or a mentioned channel)\n2. How many messages they want to read (default to 10 if not specified)\n3. Whether they want a summary or just the messages\n4. If they're looking for messages from a specific person\n\nIf they say \"this channel\" or \"here\", use the current channel.\nIf they mention a specific channel name or ID, extract that.\nIf they ask to \"summarize\" or mention what someone is \"talking about\", set summarize to true.\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"channelIdentifier\": \"<current|channel-name|channel-id>\",\n  \"messageCount\": <number between 1 and 50>,\n  \"summarize\": true/false,\n  \"focusUser\": \"<username or null>\"\n}\n```";
+export declare const CHANNEL_INFO_TEMPLATE = "# Messages we are searching for channel information\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting to read messages from a specific Discord channel. Your goal is to determine:\n1. The channel they want to read from (could be the current channel or a mentioned channel)\n2. How many messages they want to read (default to 10 if not specified)\n3. Whether they want a summary or just the messages\n4. If they're looking for messages from a specific person\n\nIf they say \"this channel\" or \"here\", use the current channel.\nIf they mention a specific channel name or ID, extract that.\nIf they ask to \"summarize\" or mention what someone is \"talking about\", set summarize to true.\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"channelIdentifier\": \"<current|channel-name|channel-id>\",\n  \"messageCount\": <number between 1 and 50>,\n  \"summarize\": true/false,\n  \"focusUser\": \"<username or null>\"\n}\n```";
+export declare const createPollTemplate = "# Creating a Discord poll\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting to create a poll. Extract:\n1. The poll question\n2. The poll options (2-10 options)\n3. Whether to use emoji reactions (default: true)\n\nExamples:\n- \"create a poll: What game should we play? Options: Minecraft, Fortnite, Among Us\" \n  -> question: \"What game should we play?\", options: [\"Minecraft\", \"Fortnite\", \"Among Us\"]\n- \"poll: Should we have a meeting tomorrow? Yes/No\"\n  -> question: \"Should we have a meeting tomorrow?\", options: [\"Yes\", \"No\"]\n\nYour response must be formatted as a JSON block:\n```json\n{\n  \"question\": \"<poll question>\",\n  \"options\": [\"<option1>\", \"<option2>\", ...],\n  \"useEmojis\": true/false\n}\n```";
+export declare const CREATE_POLL_TEMPLATE = "# Creating a Discord poll\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting to create a poll. Extract:\n1. The poll question\n2. The poll options (2-10 options)\n3. Whether to use emoji reactions (default: true)\n\nExamples:\n- \"create a poll: What game should we play? Options: Minecraft, Fortnite, Among Us\" \n  -> question: \"What game should we play?\", options: [\"Minecraft\", \"Fortnite\", \"Among Us\"]\n- \"poll: Should we have a meeting tomorrow? Yes/No\"\n  -> question: \"Should we have a meeting tomorrow?\", options: [\"Yes\", \"No\"]\n\nYour response must be formatted as a JSON block:\n```json\n{\n  \"question\": \"<poll question>\",\n  \"options\": [\"<option1>\", \"<option2>\", ...],\n  \"useEmojis\": true/false\n}\n```";
+export declare const dateRangeTemplate = "# Messages we are summarizing (the conversation is continued after this)\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting a summary of the conversation. Your goal is to determine their objective, along with the range of dates that their request covers.\nThe \"objective\" is a detailed description of what the user wants to summarize based on the conversation. If they just ask for a general summary, you can either base it off the conversation if the summary range is very recent, or set the object to be general, like \"a detailed summary of the conversation between all users\".\nThe \"start\" and \"end\" are the range of dates that the user wants to summarize, relative to the current time. The start and end should be relative to the current time, and measured in seconds, minutes, hours and days. The format is \"2 days ago\" or \"3 hours ago\" or \"4 minutes ago\" or \"5 seconds ago\", i.e. \"<integer> <unit> ago\".\nIf you aren't sure, you can use a default range of \"0 minutes ago\" to \"2 hours ago\" or more. Better to err on the side of including too much than too little.\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"objective\": \"<What the user wants to summarize>\",\n  \"start\": \"0 minutes ago\",\n  \"end\": \"2 hours ago\"\n}\n```";
+export declare const DATE_RANGE_TEMPLATE = "# Messages we are summarizing (the conversation is continued after this)\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting a summary of the conversation. Your goal is to determine their objective, along with the range of dates that their request covers.\nThe \"objective\" is a detailed description of what the user wants to summarize based on the conversation. If they just ask for a general summary, you can either base it off the conversation if the summary range is very recent, or set the object to be general, like \"a detailed summary of the conversation between all users\".\nThe \"start\" and \"end\" are the range of dates that the user wants to summarize, relative to the current time. The start and end should be relative to the current time, and measured in seconds, minutes, hours and days. The format is \"2 days ago\" or \"3 hours ago\" or \"4 minutes ago\" or \"5 seconds ago\", i.e. \"<integer> <unit> ago\".\nIf you aren't sure, you can use a default range of \"0 minutes ago\" to \"2 hours ago\" or more. Better to err on the side of including too much than too little.\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"objective\": \"<What the user wants to summarize>\",\n  \"start\": \"0 minutes ago\",\n  \"end\": \"2 hours ago\"\n}\n```";
+export declare const getUserInfoTemplate = "# Getting Discord user information\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting information about a Discord user. Extract:\n1. The user identifier (username, user ID, or mention)\n2. Whether they want detailed server-specific info\n\nExamples:\n- \"who is @john?\" -> userIdentifier: \"john\", detailed: false\n- \"tell me about user 123456789\" -> userIdentifier: \"123456789\", detailed: false  \n- \"get detailed info on @admin\" -> userIdentifier: \"admin\", detailed: true\n- \"who am I?\" -> userIdentifier: \"self\", detailed: false\n\nYour response must be formatted as a JSON block:\n```json\n{\n  \"userIdentifier\": \"<username|user-id|mention|self>\",\n  \"detailed\": true/false\n}\n```";
+export declare const GET_USER_INFO_TEMPLATE = "# Getting Discord user information\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting information about a Discord user. Extract:\n1. The user identifier (username, user ID, or mention)\n2. Whether they want detailed server-specific info\n\nExamples:\n- \"who is @john?\" -> userIdentifier: \"john\", detailed: false\n- \"tell me about user 123456789\" -> userIdentifier: \"123456789\", detailed: false  \n- \"get detailed info on @admin\" -> userIdentifier: \"admin\", detailed: true\n- \"who am I?\" -> userIdentifier: \"self\", detailed: false\n\nYour response must be formatted as a JSON block:\n```json\n{\n  \"userIdentifier\": \"<username|user-id|mention|self>\",\n  \"detailed\": true/false\n}\n```";
+export declare const joinChannelTemplate = "# Messages we are searching for channel join information\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting the bot to join a specific Discord channel (text or voice). Your goal is to determine which channel they want to join.\n\nExtract the channel identifier from their request:\n- If they mention a channel like #general or <#channelid>, extract that\n- If they provide a channel name, extract that\n- If they provide a channel ID (long number), extract that\n- If they mention \"voice\", \"vc\", \"voice channel\", include that as a hint\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"channelIdentifier\": \"<channel-name|channel-id|#mention>\",\n  \"isVoiceChannel\": true/false\n}\n```";
+export declare const JOIN_CHANNEL_TEMPLATE = "# Messages we are searching for channel join information\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting the bot to join a specific Discord channel (text or voice). Your goal is to determine which channel they want to join.\n\nExtract the channel identifier from their request:\n- If they mention a channel like #general or <#channelid>, extract that\n- If they provide a channel name, extract that\n- If they provide a channel ID (long number), extract that\n- If they mention \"voice\", \"vc\", \"voice channel\", include that as a hint\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"channelIdentifier\": \"<channel-name|channel-id|#mention>\",\n  \"isVoiceChannel\": true/false\n}\n```";
+export declare const leaveChannelTemplate = "# Messages we are searching for channel leave information\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting the bot to leave a specific Discord channel (text or voice). Your goal is to determine which channel they want to leave.\n\nExtract the channel identifier from their request:\n- If they mention a channel like #general or <#channelid>, extract that\n- If they provide a channel name (like \"dev-voice\" or \"general\"), extract just the name\n- If they provide a channel ID (long number), extract that\n- If they say \"this channel\" or \"here\", use \"current\"\n- If they don't specify a channel but mention \"voice\", \"vc\", use \"current\" and mark as voice\n\nExamples:\n- \"leave the dev-voice channel\" -> channelIdentifier: \"dev-voice\", isVoiceChannel: true\n- \"leave #general\" -> channelIdentifier: \"general\", isVoiceChannel: false\n- \"leave voice\" -> channelIdentifier: \"current\", isVoiceChannel: true\n- \"stop listening to this channel\" -> channelIdentifier: \"current\", isVoiceChannel: false\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"channelIdentifier\": \"<actual-channel-name-or-id-or-current>\",\n  \"isVoiceChannel\": true/false\n}\n```";
+export declare const LEAVE_CHANNEL_TEMPLATE = "# Messages we are searching for channel leave information\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting the bot to leave a specific Discord channel (text or voice). Your goal is to determine which channel they want to leave.\n\nExtract the channel identifier from their request:\n- If they mention a channel like #general or <#channelid>, extract that\n- If they provide a channel name (like \"dev-voice\" or \"general\"), extract just the name\n- If they provide a channel ID (long number), extract that\n- If they say \"this channel\" or \"here\", use \"current\"\n- If they don't specify a channel but mention \"voice\", \"vc\", use \"current\" and mark as voice\n\nExamples:\n- \"leave the dev-voice channel\" -> channelIdentifier: \"dev-voice\", isVoiceChannel: true\n- \"leave #general\" -> channelIdentifier: \"general\", isVoiceChannel: false\n- \"leave voice\" -> channelIdentifier: \"current\", isVoiceChannel: true\n- \"stop listening to this channel\" -> channelIdentifier: \"current\", isVoiceChannel: false\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"channelIdentifier\": \"<actual-channel-name-or-id-or-current>\",\n  \"isVoiceChannel\": true/false\n}\n```";
+export declare const mediaAttachmentIdTemplate = "# Messages we are transcribing\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting a transcription of a specific media file (audio or video). Your goal is to determine the ID of the attachment they want transcribed.\nThe \"attachmentId\" is the ID of the media file attachment that the user wants transcribed. If not specified, return null.\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"attachmentId\": \"<Attachment ID>\"\n}\n```";
+export declare const MEDIA_ATTACHMENT_ID_TEMPLATE = "# Messages we are transcribing\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting a transcription of a specific media file (audio or video). Your goal is to determine the ID of the attachment they want transcribed.\nThe \"attachmentId\" is the ID of the media file attachment that the user wants transcribed. If not specified, return null.\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"attachmentId\": \"<Attachment ID>\"\n}\n```";
+export declare const mediaUrlTemplate = "# Messages we are searching for a media URL\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting to download a specific media file (video or audio). Your goal is to determine the URL of the media they want to download.\nThe \"mediaUrl\" is the URL of the media file that the user wants downloaded. If not specified, return null.\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"mediaUrl\": \"<Media URL>\"\n}\n```";
+export declare const MEDIA_URL_TEMPLATE = "# Messages we are searching for a media URL\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting to download a specific media file (video or audio). Your goal is to determine the URL of the media they want to download.\nThe \"mediaUrl\" is the URL of the media file that the user wants downloaded. If not specified, return null.\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"mediaUrl\": \"<Media URL>\"\n}\n```";
+export declare const pinMessageTemplate = "# Pinning a Discord message\n{{recentMessages}}\n\n# Instructions: {{senderName}} wants to pin a message. Extract which message they want to pin.\n\nExamples:\n- \"pin that message\" -> messageRef: \"last\"\n- \"pin the last message\" -> messageRef: \"last\"\n- \"pin john's message about the meeting\" -> messageRef: \"john meeting\"\n- \"pin message 123456789\" -> messageRef: \"123456789\"\n\nYour response must be formatted as a JSON block:\n```json\n{\n  \"messageRef\": \"<last|previous|message-id|search-text>\"\n}\n```";
+export declare const PIN_MESSAGE_TEMPLATE = "# Pinning a Discord message\n{{recentMessages}}\n\n# Instructions: {{senderName}} wants to pin a message. Extract which message they want to pin.\n\nExamples:\n- \"pin that message\" -> messageRef: \"last\"\n- \"pin the last message\" -> messageRef: \"last\"\n- \"pin john's message about the meeting\" -> messageRef: \"john meeting\"\n- \"pin message 123456789\" -> messageRef: \"123456789\"\n\nYour response must be formatted as a JSON block:\n```json\n{\n  \"messageRef\": \"<last|previous|message-id|search-text>\"\n}\n```";
+export declare const reactToMessageTemplate = "# Adding reactions to Discord messages\n{{recentMessages}}\n\n# Instructions: {{senderName}} wants to add a reaction to a message. Extract:\n1. Which message to react to (last, specific message reference, or by content)\n2. What emoji/reaction to add\n\nExamples:\n- \"react with \uD83D\uDC4D to the last message\" -> messageRef: \"last\", emoji: \"\uD83D\uDC4D\"\n- \"add :fire: reaction\" -> messageRef: \"last\", emoji: \"\uD83D\uDD25\" or \":fire:\"\n- \"react to that message with \u2764\uFE0F\" -> messageRef: \"previous\", emoji: \"\u2764\uFE0F\"\n- \"add a thumbs up to john's message about the meeting\" -> messageRef: \"john meeting\", emoji: \"\uD83D\uDC4D\"\n\nYour response must be formatted as a JSON block:\n```json\n{\n  \"messageRef\": \"<last|previous|message-id|search-text>\",\n  \"emoji\": \"<emoji-character|:emoji-name:>\"\n}\n```";
+export declare const REACT_TO_MESSAGE_TEMPLATE = "# Adding reactions to Discord messages\n{{recentMessages}}\n\n# Instructions: {{senderName}} wants to add a reaction to a message. Extract:\n1. Which message to react to (last, specific message reference, or by content)\n2. What emoji/reaction to add\n\nExamples:\n- \"react with \uD83D\uDC4D to the last message\" -> messageRef: \"last\", emoji: \"\uD83D\uDC4D\"\n- \"add :fire: reaction\" -> messageRef: \"last\", emoji: \"\uD83D\uDD25\" or \":fire:\"\n- \"react to that message with \u2764\uFE0F\" -> messageRef: \"previous\", emoji: \"\u2764\uFE0F\"\n- \"add a thumbs up to john's message about the meeting\" -> messageRef: \"john meeting\", emoji: \"\uD83D\uDC4D\"\n\nYour response must be formatted as a JSON block:\n```json\n{\n  \"messageRef\": \"<last|previous|message-id|search-text>\",\n  \"emoji\": \"<emoji-character|:emoji-name:>\"\n}\n```";
+export declare const searchMessagesTemplate = "# Searching for Discord messages\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting to search for messages in Discord. Extract:\n1. The search query/keywords\n2. The channel to search in (current if not specified)\n3. Optional filters like author, time range, or message count\n\nExamples:\n- \"search for messages containing 'meeting'\" -> query: \"meeting\", channelIdentifier: \"current\", NO author field\n- \"find messages from @user about bugs\" -> query: \"bugs\", channelIdentifier: \"current\", author: \"user\"\n- \"search #general for links from last week\" -> query: \"links\", channelIdentifier: \"general\", timeRange: \"week\"\n- \"search for messages about 'spartan' in this channel\" -> query: \"spartan\", channelIdentifier: \"current\"\n\nYour response must be formatted as a JSON block:\n```json\n{\n  \"query\": \"<search keywords>\",\n  \"channelIdentifier\": \"<channel-name|channel-id|current>\",\n  \"author\": \"<username>\",\n  \"timeRange\": \"<hour|day|week|month>\",\n  \"limit\": <number between 1-100, default 20>\n}\n```";
+export declare const SEARCH_MESSAGES_TEMPLATE = "# Searching for Discord messages\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting to search for messages in Discord. Extract:\n1. The search query/keywords\n2. The channel to search in (current if not specified)\n3. Optional filters like author, time range, or message count\n\nExamples:\n- \"search for messages containing 'meeting'\" -> query: \"meeting\", channelIdentifier: \"current\", NO author field\n- \"find messages from @user about bugs\" -> query: \"bugs\", channelIdentifier: \"current\", author: \"user\"\n- \"search #general for links from last week\" -> query: \"links\", channelIdentifier: \"general\", timeRange: \"week\"\n- \"search for messages about 'spartan' in this channel\" -> query: \"spartan\", channelIdentifier: \"current\"\n\nYour response must be formatted as a JSON block:\n```json\n{\n  \"query\": \"<search keywords>\",\n  \"channelIdentifier\": \"<channel-name|channel-id|current>\",\n  \"author\": \"<username>\",\n  \"timeRange\": \"<hour|day|week|month>\",\n  \"limit\": <number between 1-100, default 20>\n}\n```";
+export declare const sendDmTemplate = "# Messages we are searching for DM information\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting to send a direct message to a specific Discord user. Your goal is to determine:\n1. The recipient they want to message (could be a username, user ID, or mentioned user)\n2. The message content they want to send\n\nExtract the recipient identifier and the message content from their request.\n- If they mention a user like @username or <@userid>, extract that\n- If they provide a username or display name, extract that\n- If they provide a user ID (long number), extract that\n- Extract the complete message they want to send\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"recipientIdentifier\": \"<username|user-id|@mention>\",\n  \"messageContent\": \"<the message to send>\"\n}\n```";
+export declare const SEND_DM_TEMPLATE = "# Messages we are searching for DM information\n{{recentMessages}}\n\n# Instructions: {{senderName}} is requesting to send a direct message to a specific Discord user. Your goal is to determine:\n1. The recipient they want to message (could be a username, user ID, or mentioned user)\n2. The message content they want to send\n\nExtract the recipient identifier and the message content from their request.\n- If they mention a user like @username or <@userid>, extract that\n- If they provide a username or display name, extract that\n- If they provide a user ID (long number), extract that\n- Extract the complete message they want to send\n\nYour response must be formatted as a JSON block with this structure:\n```json\n{\n  \"recipientIdentifier\": \"<username|user-id|@mention>\",\n  \"messageContent\": \"<the message to send>\"\n}\n```";
+export declare const summarizationTemplate = "# Summarized so far (we are adding to this)\n{{currentSummary}}\n\n# Current conversation chunk we are summarizing (includes attachments)\n{{memoriesWithAttachments}}\n\nSummarization objective: {{objective}}\n\n# Instructions: Summarize the conversation so far. Return the summary. Do not acknowledge this request, just summarize and continue the existing summary if there is one. Capture any important details to the objective. Only respond with the new summary text.\nYour response should be extremely detailed and include any and all relevant information.";
+export declare const SUMMARIZATION_TEMPLATE = "# Summarized so far (we are adding to this)\n{{currentSummary}}\n\n# Current conversation chunk we are summarizing (includes attachments)\n{{memoriesWithAttachments}}\n\nSummarization objective: {{objective}}\n\n# Instructions: Summarize the conversation so far. Return the summary. Do not acknowledge this request, just summarize and continue the existing summary if there is one. Capture any important details to the objective. Only respond with the new summary text.\nYour response should be extremely detailed and include any and all relevant information.";
+export declare const transcriptionTemplate = "# Transcription of media file\n{{mediaTranscript}}\n\n# Instructions: Return only the full transcript of the media file without any additional prompt or commentary.";
+export declare const TRANSCRIPTION_TEMPLATE = "# Transcription of media file\n{{mediaTranscript}}\n\n# Instructions: Return only the full transcript of the media file without any additional prompt or commentary.";
+export declare const unpinMessageTemplate = "# Unpinning a Discord message\n{{recentMessages}}\n\n# Instructions: {{senderName}} wants to unpin a message. Extract which message they want to unpin.\n\nExamples:\n- \"unpin that message\" -> messageRef: \"last_pinned\"\n- \"unpin the last pinned message\" -> messageRef: \"last_pinned\"\n- \"unpin john's message\" -> messageRef: \"john\"\n- \"unpin message about the meeting\" -> messageRef: \"meeting\"\n\nYour response must be formatted as a JSON block:\n```json\n{\n  \"messageRef\": \"<last_pinned|message-id|search-text>\"\n}\n```";
+export declare const UNPIN_MESSAGE_TEMPLATE = "# Unpinning a Discord message\n{{recentMessages}}\n\n# Instructions: {{senderName}} wants to unpin a message. Extract which message they want to unpin.\n\nExamples:\n- \"unpin that message\" -> messageRef: \"last_pinned\"\n- \"unpin the last pinned message\" -> messageRef: \"last_pinned\"\n- \"unpin john's message\" -> messageRef: \"john\"\n- \"unpin message about the meeting\" -> messageRef: \"meeting\"\n\nYour response must be formatted as a JSON block:\n```json\n{\n  \"messageRef\": \"<last_pinned|message-id|search-text>\"\n}\n```";
+//# sourceMappingURL=prompts.d.ts.map

package/dist/generated/prompts/typescript/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../../generated/prompts/typescript/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,qBAAqB,ytBAa3B,CAAC;AAER,eAAO,MAAM,uBAAuB,ytBAAwB,CAAC;AAE7D,eAAO,MAAM,+BAA+B,sbAQoN,CAAC;AAEjQ,eAAO,MAAM,iCAAiC,sbACd,CAAC;AAEjC,eAAO,MAAM,mBAAmB,09BAqBzB,CAAC;AAER,eAAO,MAAM,qBAAqB,09BAAsB,CAAC;AAEzD,eAAO,MAAM,kBAAkB,6vBAqBxB,CAAC;AAER,eAAO,MAAM,oBAAoB,6vBAAqB,CAAC;AAEvD,eAAO,MAAM,iBAAiB,2yCAevB,CAAC;AAER,eAAO,MAAM,mBAAmB,2yCAAoB,CAAC;AAErD,eAAO,MAAM,mBAAmB,utBAmBzB,CAAC;AAER,eAAO,MAAM,sBAAsB,utBAAsB,CAAC;AAE1D,eAAO,MAAM,mBAAmB,mvBAiBzB,CAAC;AAER,eAAO,MAAM,qBAAqB,mvBAAsB,CAAC;AAEzD,eAAO,MAAM,oBAAoB,2tCAwB1B,CAAC;AAER,eAAO,MAAM,sBAAsB,2tCAAuB,CAAC;AAE3D,eAAO,MAAM,yBAAyB,8eAW/B,CAAC;AAER,eAAO,MAAM,4BAA4B,8eAA4B,CAAC;AAEtE,eAAO,MAAM,gBAAgB,ydAWtB,CAAC;AAER,eAAO,MAAM,kBAAkB,ydAAmB,CAAC;AAEnD,eAAO,MAAM,kBAAkB,mhBAgBxB,CAAC;AAER,eAAO,MAAM,oBAAoB,mhBAAqB,CAAC;AAEvD,eAAO,MAAM,sBAAsB,01BAmB5B,CAAC;AAER,eAAO,MAAM,yBAAyB,01BAAyB,CAAC;AAEhE,eAAO,MAAM,sBAAsB,mjCAuB5B,CAAC;AAER,eAAO,MAAM,wBAAwB,mjCAAyB,CAAC;AAE/D,eAAO,MAAM,cAAc,+0BAmBpB,CAAC;AAER,eAAO,MAAM,gBAAgB,+0BAAiB,CAAC;AAE/C,eAAO,MAAM,qBAAqB,ojBASuD,CAAC;AAE1F,eAAO,MAAM,sBAAsB,ojBAAwB,CAAC;AAE5D,eAAO,MAAM,qBAAqB,yKAG6E,CAAC;AAEhH,eAAO,MAAM,sBAAsB,yKAAwB,CAAC;AAE5D,eAAO,MAAM,oBAAoB,giBAgB1B,CAAC;AAER,eAAO,MAAM,sBAAsB,giBAAuB,CAAC"}

package/dist/generated/specs/spec-helpers.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Helper functions to lookup action/provider/evaluator specs by name.
+ * These allow language-specific implementations to import their text content
+ * (description, similes, examples) from the centralized specs.
+ *
+ * DO NOT EDIT the spec data - update prompts/actions.json, prompts/providers.json, prompts/evaluators.json and regenerate.
+ */
+import { type ActionDoc, type EvaluatorDoc, type ProviderDoc } from "./specs";
+/**
+ * Get an action spec by name from the core specs.
+ * @param name - The action name
+ * @returns The action spec or undefined if not found
+ */
+export declare function getActionSpec(name: string): ActionDoc | undefined;
+/**
+ * Get an action spec by name, throwing if not found.
+ * @param name - The action name
+ * @returns The action spec
+ * @throws Error if the action is not found
+ */
+export declare function requireActionSpec(name: string): ActionDoc;
+/**
+ * Get a provider spec by name from the core specs.
+ * @param name - The provider name
+ * @returns The provider spec or undefined if not found
+ */
+export declare function getProviderSpec(name: string): ProviderDoc | undefined;
+/**
+ * Get a provider spec by name, throwing if not found.
+ * @param name - The provider name
+ * @returns The provider spec
+ * @throws Error if the provider is not found
+ */
+export declare function requireProviderSpec(name: string): ProviderDoc;
+/**
+ * Get an evaluator spec by name from the core specs.
+ * @param name - The evaluator name
+ * @returns The evaluator spec or undefined if not found
+ */
+export declare function getEvaluatorSpec(name: string): EvaluatorDoc | undefined;
+/**
+ * Get an evaluator spec by name, throwing if not found.
+ * @param name - The evaluator name
+ * @returns The evaluator spec
+ * @throws Error if the evaluator is not found
+ */
+export declare function requireEvaluatorSpec(name: string): EvaluatorDoc;
+export type { ActionDoc, ProviderDoc, EvaluatorDoc };
+//# sourceMappingURL=spec-helpers.d.ts.map

package/dist/generated/specs/spec-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-helpers.d.ts","sourceRoot":"","sources":["../../../generated/specs/spec-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACN,KAAK,SAAS,EAOd,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,MAAM,SAAS,CAAC;AAsBjB;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAWzD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAM7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAM/D;AAGD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC"}