@spinabot/brigade 1.5.0 → 1.6.1

package/dist/agents/channels/discord/inbound-extras.js

@@ -0,0 +1,351 @@
+/**
+ * Pure extractors that turn a discord.js message / reaction / interaction into
+ * the normalized fields Brigade's `InboundMessage` carries. No network, no side
+ * effects — every function here is deterministic over its argument so they're
+ * trivial to unit-test without a live gateway.
+ *
+ * Discord's wire shape (rich discord.js objects, not raw JSON like Slack's
+ * Events API) differs from Slack/Telegram in load-bearing ways, so the logic is
+ * a Brigade-native re-implementation that models the SHAPE of
+ * `slack/inbound-extras.ts` (raw payload → normalized signals) while speaking
+ * Discord semantics:
+ *
+ *   - Text arrives as `message.content` peppered with Discord TOKENS: `<@123>`
+ *     / `<@!123>` (user/member), `<@&456>` (role), `<#789>` (channel),
+ *     `<:name:111>` / `<a:name:111>` (custom emoji). {@link extractDiscordText}
+ *     expands user/channel/role mentions into readable plain text the agent can
+ *     parse (`@alex`, `#general`), resolving names via an injected cache when one
+ *     is supplied (the cached guild/client primes them in the background).
+ *   - The bot is "addressed" when its own user id appears as a `<@123>` mention.
+ *     {@link extractDiscordMentions} surfaces the bot's id when addressed so the
+ *     central group ACL admits the message — exactly as Slack surfaces the bot's
+ *     id. Every OTHER user mention is surfaced too.
+ *   - Channel kind: a DM channel → `direct`; a guild text channel / thread →
+ *     `group` (see {@link discordChannelType}).
+ *   - Threads ride on the channel being a thread (`threadId` = the thread
+ *     channel id); the parent text channel is the conversation root.
+ *   - Reply context rides on `message.reference.messageId`.
+ *   - Attachments arrive as `message.attachments` (each a CDN `url` + metadata);
+ *     the connection layer DEFERS the byte download until the access gate admits
+ *     the sender (mirrors Slack/Telegram's deferred-media discipline).
+ *
+ * Brigade's CENTRAL inbound pipeline owns the actual ACL / mention / routing
+ * decision — these helpers only surface the raw signals it reads.
+ */
+/* ───────────────────────── small helpers ───────────────────────── */
+/**
+ * Reject control-byte payloads (a binary blob masquerading as text). Tab / LF /
+ * CR are allowed; any other C0 control char marks the run as non-text and it's
+ * dropped so the agent never ingests raw binary. Mirrors Slack's
+ * `isBinaryContent`.
+ */
+function isBinaryContent(text) {
+    for (let i = 0; i < text.length; i++) {
+        const code = text.charCodeAt(i);
+        if (code <= 0x1f && code !== 0x09 && code !== 0x0a && code !== 0x0d)
+            return true;
+    }
+    return false;
+}
+/** Normalize a discord.js Collection / Map / iterable / array into a plain array. */
+function toArray(coll) {
+    if (!coll)
+        return [];
+    if (Array.isArray(coll))
+        return coll;
+    if (coll instanceof Map)
+        return [...coll.values()];
+    // A discord.js Collection extends Map, so the branch above catches it; this is
+    // the generic-iterable fallback for any other shape.
+    if (typeof coll[Symbol.iterator] === "function")
+        return [...coll];
+    return [];
+}
+/* ───────────────────────── token expansion ───────────────────────── */
+/**
+ * Expand the Discord message TOKENS in a run of text into readable plain text:
+ *   - `<@123>` / `<@!123>`     → `@alex` (resolved name) or `@123`
+ *   - `<@&456>`                → `@role` (resolved) or `@&456`
+ *   - `<#789>`                 → `#general` (resolved) or `#789`
+ *   - `<:name:111>` / `<a:name:111>` → `:name:` (the readable emoji shortcode)
+ *
+ * Names resolve via the injected lookups (the connection primes them from the
+ * cached guild/client); without a resolver the bare id is surfaced. Pure +
+ * deterministic.
+ */
+export function expandDiscordTokens(text, resolve) {
+    if (!text)
+        return "";
+    return text.replace(/<(a?):([A-Za-z0-9_]{2,32}):\d+>|<@&(\d+)>|<@!?(\d+)>|<#(\d+)>/g, (whole, _anim, emojiName, roleId, userId, channelId) => {
+        if (typeof emojiName === "string" && emojiName)
+            return `:${emojiName}:`;
+        if (typeof roleId === "string" && roleId) {
+            const name = resolve?.role?.(roleId);
+            return name ? `@${name}` : `@&${roleId}`;
+        }
+        if (typeof userId === "string" && userId) {
+            const name = resolve?.user?.(userId);
+            return name ? `@${name}` : `@${userId}`;
+        }
+        if (typeof channelId === "string" && channelId) {
+            const name = resolve?.channel?.(channelId);
+            return name ? `#${name}` : `#${channelId}`;
+        }
+        return whole;
+    });
+}
+/**
+ * The agent-facing plain text of a Discord message. Token-expanded (mentions /
+ * channels / roles / emoji → readable text). Binary blobs are dropped to "".
+ */
+export function extractDiscordText(message, resolve) {
+    const raw = typeof message.content === "string" ? message.content : "";
+    if (!raw || isBinaryContent(raw))
+        return "";
+    return expandDiscordTokens(raw, resolve).trim();
+}
+/* ───────────────────────── chat type + thread + reply ───────────────────────── */
+/** Discord channel-type enum values Brigade distinguishes. */
+const CHANNEL_TYPE_DM = 1;
+const CHANNEL_TYPE_GROUP_DM = 3;
+const THREAD_TYPE_VALUES = new Set([10, 11, 12]); // announcement / public / private thread
+/** True when a discord.js channel is a thread (uses `isThread()` when present, else the type enum). */
+export function isThreadChannel(channel) {
+    if (!channel)
+        return false;
+    if (typeof channel.isThread === "function")
+        return channel.isThread();
+    return typeof channel.type === "number" && THREAD_TYPE_VALUES.has(channel.type);
+}
+/** True when a discord.js channel is a DM (uses `isDMBased()` when present, else the type enum). */
+export function isDmChannel(channel) {
+    if (!channel)
+        return false;
+    if (typeof channel.isDMBased === "function")
+        return channel.isDMBased();
+    return channel.type === CHANNEL_TYPE_DM || channel.type === CHANNEL_TYPE_GROUP_DM;
+}
+/**
+ * Discord channel → Brigade chat type. A 1:1 DM → `direct`; a guild text channel
+ * or a thread → `group`. A group DM (rare for bots) → `group`. When no channel
+ * object is available, a missing `guildId` implies a DM.
+ */
+export function discordChannelType(message) {
+    const channel = message.channel;
+    if (channel) {
+        if (isDmChannel(channel) && channel.type !== CHANNEL_TYPE_GROUP_DM)
+            return "direct";
+        return "group";
+    }
+    // No channel object: a message with no guild is a DM.
+    return message.guildId ? "group" : "direct";
+}
+/**
+ * The thread channel id when the message landed in a thread, else undefined. The
+ * thread's own channel id is the thread id (Discord threads ARE channels).
+ */
+export function discordThreadId(message) {
+    const channel = message.channel;
+    if (channel && isThreadChannel(channel)) {
+        return typeof channel.id === "string" ? channel.id : typeof message.channelId === "string" ? message.channelId : undefined;
+    }
+    return undefined;
+}
+/**
+ * Reply-context (what message this inbound quotes), when it's a reply. Discord
+ * carries `message.reference.messageId` (the replied-to message id) but does NOT
+ * inline that message's text — so the context surfaces the parent message id and
+ * leaves `body` undefined (the connection can fetch the parent if it needs the
+ * excerpt). Returns undefined for a non-reply.
+ */
+export function extractDiscordReplyContext(message) {
+    const ref = message.reference;
+    const id = ref?.messageId;
+    if (typeof id !== "string" || !id)
+        return undefined;
+    return { messageId: id };
+}
+/* ───────────────────────── mentions ───────────────────────── */
+/**
+ * Channel-native ids of users addressed in this message. Brigade's central group
+ * ACL treats a group message as "addressed to the bot" when the bot's own id
+ * appears in `mentions`; without this a group message never reaches the agent.
+ * So when the bot's own `<@id>` mention appears in the text we surface the bot's
+ * id (passed in). Every OTHER user mention is surfaced too so the pipeline sees
+ * who else was tagged.
+ *
+ * We scan BOTH the resolved `message.mentions.users` collection (when present)
+ * AND the raw `<@id>` / `<@!id>` tokens in the content, unioned + deduped — the
+ * collection is authoritative on a live message, the token scan is the fallback
+ * for a fake / a partial.
+ *
+ * @param botUserId the bot's own user id, surfaced when the bot is mentioned so
+ *                  the ACL admits the group message.
+ */
+export function extractDiscordMentions(message, botUserId) {
+    const out = [];
+    const seen = new Set();
+    let botMentioned = false;
+    const push = (id) => {
+        if (!id || seen.has(id))
+            return;
+        if (botUserId && id === botUserId) {
+            botMentioned = true;
+            return; // the bot's own id is pushed LAST (after the addressed check)
+        }
+        seen.add(id);
+        out.push(id);
+    };
+    for (const u of toArray(message.mentions?.users)) {
+        if (typeof u?.id === "string")
+            push(u.id);
+    }
+    const content = typeof message.content === "string" ? message.content : "";
+    const re = /<@!?(\d+)>/g;
+    let m;
+    while ((m = re.exec(content)) !== null) {
+        if (m[1])
+            push(m[1]);
+    }
+    if (botMentioned && botUserId) {
+        out.push(botUserId);
+    }
+    return out;
+}
+/**
+ * The guild-role ids the sending member holds, surfaced so the 8-tier route
+ * resolver's `binding.guild+roles` tier can match. Role NAMES are never used —
+ * only ids. Returns `[]` for a DM (no member) or when no roles resolve.
+ *
+ * Handles the three shapes the `member.roles` value can take:
+ *   - discord.js `GuildMemberRoleManager` — a `.cache` Collection (Map subclass)
+ *     keyed by role id; we read the keys (the role ids).
+ *   - a plain array / iterable of role-id strings (a fake / partial).
+ *   - absent / null (a DM, or a message with no resolved member) → `[]`.
+ *
+ * Pure + deterministic; deduped, with the `@everyone` role (whose id equals the
+ * guild id and is implicit for everyone) left in as-is — the resolver only
+ * matches ids a binding explicitly lists, so a stray everyone id is harmless.
+ */
+export function extractDiscordMemberRoleIds(message) {
+    const roles = message.member?.roles;
+    if (!roles)
+        return [];
+    const out = [];
+    const seen = new Set();
+    const push = (id) => {
+        if (typeof id !== "string")
+            return;
+        const trimmed = id.trim();
+        if (!trimmed || seen.has(trimmed))
+            return;
+        seen.add(trimmed);
+        out.push(trimmed);
+    };
+    // Plain string array / iterable of ids (a fake or a partial).
+    if (Array.isArray(roles)) {
+        for (const id of roles)
+            push(id);
+        return out;
+    }
+    // A `GuildMemberRoleManager` exposes `.cache` (a Collection ⊂ Map keyed by id).
+    const cache = roles.cache;
+    if (cache) {
+        if (cache instanceof Map) {
+            for (const key of cache.keys())
+                push(key);
+            return out;
+        }
+        if (typeof cache[Symbol.iterator] === "function") {
+            // A Collection iterates `[key, value]` pairs; a bare value-iterable yields
+            // role-ish objects. Read the id off whichever shape arrives.
+            for (const item of cache) {
+                if (Array.isArray(item))
+                    push(item[0]);
+                else if (item && typeof item === "object" && "id" in item)
+                    push(item.id);
+                else
+                    push(item);
+            }
+            return out;
+        }
+    }
+    // A bare iterable of ids on the manager itself (some fakes).
+    if (typeof roles[Symbol.iterator] === "function") {
+        for (const id of roles)
+            push(id);
+    }
+    return out;
+}
+/**
+ * A short display name for the sender. A guild nickname wins (most specific),
+ * then the member/global display name, then the username, then the raw id.
+ */
+export function buildDiscordSenderName(message) {
+    const nickname = message.member?.nickname;
+    if (typeof nickname === "string" && nickname.trim())
+        return nickname.trim();
+    const memberDisplay = message.member?.displayName;
+    if (typeof memberDisplay === "string" && memberDisplay.trim())
+        return memberDisplay.trim();
+    const author = message.author;
+    const display = author?.displayName ?? author?.globalName;
+    if (typeof display === "string" && display.trim())
+        return display.trim();
+    const username = author?.username;
+    if (typeof username === "string" && username.trim())
+        return username.trim();
+    return typeof author?.id === "string" ? author.id : undefined;
+}
+/* ───────────────────────── media detection ───────────────────────── */
+/** The Discord voice-message flag bit (1 << 13). discord.js exposes `flags.has(...)`; we also accept the raw number. */
+const VOICE_MESSAGE_FLAG = 1 << 13;
+/** A downloadable attachment is one carrying a url. */
+function isDownloadableAttachment(a) {
+    return Boolean(a && (a.url || a.proxyURL));
+}
+/**
+ * Cheap presence probe — does this message carry a downloadable attachment?
+ * Walks `message.attachments` but never touches the network, so the connection
+ * layer can DEFER the actual download until AFTER the central access gate admits
+ * the sender (mirrors Slack/Telegram). Mirrors `hasInboundMedia`.
+ */
+export function hasInboundMedia(message) {
+    return toArray(message.attachments).some(isDownloadableAttachment);
+}
+/** The list of downloadable attachments on a message. */
+export function resolveInboundAttachments(message) {
+    return toArray(message.attachments).filter(isDownloadableAttachment);
+}
+/** True when an attachment carries the Discord voice-message flag. */
+function isVoiceAttachment(a) {
+    const flags = a.flags;
+    if (typeof flags === "number")
+        return (flags & VOICE_MESSAGE_FLAG) !== 0;
+    if (flags && typeof flags.has === "function") {
+        try {
+            return Boolean(flags.has(VOICE_MESSAGE_FLAG));
+        }
+        catch {
+            return false;
+        }
+    }
+    return false;
+}
+/** The Brigade media-kind of a Discord attachment, from its contentType / filename / voice flag. */
+export function resolveDiscordAttachmentKind(a) {
+    if (isVoiceAttachment(a))
+        return "voice";
+    const mime = (a.contentType ?? "").toLowerCase();
+    const name = (a.name ?? "").toLowerCase();
+    const ext = name.includes(".") ? name.slice(name.lastIndexOf(".") + 1) : "";
+    if (mime.startsWith("image/") || /^(png|jpg|jpeg|gif|webp|bmp|heic)$/.test(ext))
+        return "image";
+    if (mime.startsWith("video/") || /^(mp4|mov|webm|mkv|avi)$/.test(ext))
+        return "video";
+    if (mime.startsWith("audio/") || /^(mp3|m4a|ogg|wav|flac|aac)$/.test(ext)) {
+        return ext === "ogg" || ext === "m4a" ? "voice" : "audio";
+    }
+    return "document";
+}
+//# sourceMappingURL=inbound-extras.js.map

package/dist/agents/channels/discord/inbound-extras.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-extras.js","sourceRoot":"","sources":["../../../../src/agents/channels/discord/inbound-extras.ts"],"names":[],"mappings":"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"}

package/dist/agents/channels/discord/index.d.ts

@@ -0,0 +1,14 @@
+/** Discord channel — public surface. */
+export { createDiscordAdapter, buildReactionNote, DISCORD_CAPABILITIES, type CreateDiscordAdapterOptions, type DiscordAdapter, } from "./adapter.js";
+export { listDiscordAccountIds, resolveDiscordAccount, resolveDiscordBotToken, resolveDiscordProxyUrl, discordChannelEnabled, discordLiveStreamEnabled, discordStreamThrottleMs, discordSurfaceReasoning, discordThreadIdleTtlMs, maskProxyUrl, stripBotPrefix, DISCORD_BOT_TOKEN_ENV_VAR, DISCORD_CHANNEL_ID, DISCORD_DEFAULT_ACCOUNT_ID, type ResolvedDiscordAccount, } from "./account-config.js";
+export { buildDiscordApprovalMessage, buildDiscordApprovalText, parseDiscordApprovalAction, type DiscordApprovalMessage, } from "./approval-native.js";
+export { resolveDiscordApprover } from "./approval-authorize.js";
+export { buildDiscordApprovalRows, buildDiscordButtonRows, sanitizeDiscordCustomId, DISCORD_BUTTON_STYLE, DISCORD_BUTTONS_PER_ROW, DISCORD_CUSTOM_ID_MAX_CHARS, DISCORD_MAX_ROWS, type DiscordActionRow, type DiscordButtonSpec, } from "./components.js";
+export { buildDiscordCommandManifest, normalizeDiscordCommandName, type DiscordApplicationCommand, } from "./command-menu.js";
+export { connectDiscord, discordBackoffDelay, isDiscordUnauthorized, redactDiscordToken, type ConnectDiscordArgs, type DiscordConnection, type DiscordInboundMessage, } from "./connection.js";
+export { downloadDiscordAttachment, buildDiscordAttachment, isAllowedDiscordAttachmentUrl, type DiscordOutboundAttachment, } from "./media.js";
+export { markdownToDiscord, discordTextIsEmpty, DISCORD_MESSAGE_LIMIT } from "./format.js";
+export { createDiscordPlugin, type DiscordPluginDeps, type DiscordPluginHandle } from "./plugin.js";
+export { probeDiscord, decodeMessageContentIntent, MESSAGE_CONTENT_DISABLED_WARNING, type DiscordProbeResult, type DiscordProbeBot, type MessageContentIntentState, } from "./probe.js";
+export { discordModule } from "./module.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/channels/discord/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/discord/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EACN,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,cAAc,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACZ,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,sBAAsB,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,EAC1B,KAAK,sBAAsB,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACN,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,2BAA2B,EAC3B,2BAA2B,EAC3B,KAAK,yBAAyB,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,yBAAyB,EACzB,sBAAsB,EACtB,6BAA6B,EAC7B,KAAK,yBAAyB,GAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACpG,OAAO,EACN,YAAY,EACZ,0BAA0B,EAC1B,gCAAgC,EAChC,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,yBAAyB,GAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/agents/channels/discord/index.js

@@ -0,0 +1,14 @@
+/** Discord channel — public surface. */
+export { createDiscordAdapter, buildReactionNote, DISCORD_CAPABILITIES, } from "./adapter.js";
+export { listDiscordAccountIds, resolveDiscordAccount, resolveDiscordBotToken, resolveDiscordProxyUrl, discordChannelEnabled, discordLiveStreamEnabled, discordStreamThrottleMs, discordSurfaceReasoning, discordThreadIdleTtlMs, maskProxyUrl, stripBotPrefix, DISCORD_BOT_TOKEN_ENV_VAR, DISCORD_CHANNEL_ID, DISCORD_DEFAULT_ACCOUNT_ID, } from "./account-config.js";
+export { buildDiscordApprovalMessage, buildDiscordApprovalText, parseDiscordApprovalAction, } from "./approval-native.js";
+export { resolveDiscordApprover } from "./approval-authorize.js";
+export { buildDiscordApprovalRows, buildDiscordButtonRows, sanitizeDiscordCustomId, DISCORD_BUTTON_STYLE, DISCORD_BUTTONS_PER_ROW, DISCORD_CUSTOM_ID_MAX_CHARS, DISCORD_MAX_ROWS, } from "./components.js";
+export { buildDiscordCommandManifest, normalizeDiscordCommandName, } from "./command-menu.js";
+export { connectDiscord, discordBackoffDelay, isDiscordUnauthorized, redactDiscordToken, } from "./connection.js";
+export { downloadDiscordAttachment, buildDiscordAttachment, isAllowedDiscordAttachmentUrl, } from "./media.js";
+export { markdownToDiscord, discordTextIsEmpty, DISCORD_MESSAGE_LIMIT } from "./format.js";
+export { createDiscordPlugin } from "./plugin.js";
+export { probeDiscord, decodeMessageContentIntent, MESSAGE_CONTENT_DISABLED_WARNING, } from "./probe.js";
+export { discordModule } from "./module.js";
+//# sourceMappingURL=index.js.map

package/dist/agents/channels/discord/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/agents/channels/discord/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EACN,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,GAGpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACZ,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,0BAA0B,GAE1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,GAE1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACN,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,GAGhB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,2BAA2B,EAC3B,2BAA2B,GAE3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GAIlB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,yBAAyB,EACzB,sBAAsB,EACtB,6BAA6B,GAE7B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAoD,MAAM,aAAa,CAAC;AACpG,OAAO,EACN,YAAY,EACZ,0BAA0B,EAC1B,gCAAgC,GAIhC,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/agents/channels/discord/media.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Discord media helpers — inbound download + outbound upload construction.
+ *
+ * INBOUND: a Discord message attachment carries a public CDN `url`
+ * (cdn.discordapp.com / media.discordapp.net). We GET that URL (NO auth header —
+ * Discord attachment URLs are public, unlike Slack's `url_private`) and save the
+ * bytes under `~/.brigade/channels/discord/media/<YYYY-MM-DD>/<id>.<ext>` so the
+ * agent can `read` the attachment by path. In convex mode the cache relocates to
+ * the OS cache dir (never under ~/.brigade, to respect the strict-zero guard).
+ *
+ * OUTBOUND: `buildDiscordAttachment` validates a local path through Brigade's
+ * outbound media-path guard (so a prompt-injected "send ~/.ssh/id_rsa" can't
+ * exfiltrate a secret), then returns the `{ path, name }` the connection wraps
+ * in a discord.js `AttachmentBuilder`. The builder itself lives in the
+ * connection (which imports discord.js); this module stays dependency-light +
+ * unit-testable.
+ *
+ * SSRF GUARD: even though Discord URLs are public, we REQUIRE https + a Discord
+ * CDN host before fetching. Without this a prompt-injected / spoofed message
+ * could carry `http://169.254.169.254/…` (cloud metadata) or any attacker host
+ * and Brigade would fetch it — a classic SSRF. Mirrors `slack/media.ts`.
+ */
+import { type InboundMediaAttachment, type OutboundMedia } from "../sdk.js";
+import { type DiscordAttachmentLike } from "./inbound-extras.js";
+/**
+ * Defensive ceiling on an inbound attachment download. Discord's own per-file
+ * limit is generous (and tiered by server boost); we cap at 50 MB so a huge
+ * upload can't blow out memory. Anything larger is skipped (the message still
+ * reaches the agent without the attachment).
+ */
+declare const MAX_BYTES: number;
+/**
+ * True when `rawUrl` is an https URL whose host is a Discord CDN host (or a
+ * subdomain of one). Anything else (non-https, a non-Discord host, or an
+ * unparseable URL) returns false so the caller refuses to fetch.
+ */
+export declare function isAllowedDiscordAttachmentUrl(rawUrl: string): boolean;
+/**
+ * Bounded retry for the transient attachment fetch. Discord's CDN occasionally
+ * blips on a 5xx or a network reset; one or two quick retries turn a dropped
+ * attachment into a delivered one. The caller still wraps the whole thing in a
+ * try/catch that degrades to `null`, so an exhausted retry never breaks message
+ * delivery. Mirrors `slack/media.ts`'s `withSlackRetry`.
+ */
+export declare function withDiscordRetry<T>(fn: () => Promise<T>, attempts?: number): Promise<T>;
+export interface DownloadDiscordAttachmentArgs {
+    /** The Discord attachment object (from the message's `attachments`). */
+    attachment: DiscordAttachmentLike;
+    /** Injectable fetch (defaults to global fetch) — lets tests stub the download. */
+    fetchImpl?: typeof fetch;
+    /** Logger so a failed download logs without crashing the inbound flow. */
+    log?: (msg: string, meta?: Record<string, unknown>) => void;
+}
+/**
+ * Download one inbound Discord attachment to disk and return its normalized
+ * descriptor, or `null` when it couldn't be fetched (no url / too big / network
+ * error / non-Discord host). Never throws — a download glitch must not break
+ * message delivery.
+ */
+export declare function downloadDiscordAttachment(args: DownloadDiscordAttachmentArgs): Promise<InboundMediaAttachment | null>;
+/** The validated outbound attachment shape the connection wraps in an `AttachmentBuilder`. */
+export interface DiscordOutboundAttachment {
+    /** Local filesystem path (guard-validated). */
+    path: string;
+    /** Display filename. */
+    name: string;
+    /** Optional caption — sent as the message content alongside the file. */
+    caption?: string;
+}
+/**
+ * Validate + shape a local file for outbound upload. Runs the path through
+ * Brigade's outbound media-path guard and throws a clear operator-facing error
+ * when the guard refuses it (the `send_media` tool surfaces it). Returns the
+ * `{ path, name, caption? }` the connection turns into a discord.js
+ * `AttachmentBuilder`.
+ *
+ * Filename precedence: an explicit `media.fileName` wins; otherwise the path's
+ * basename. When the chosen name has NO extension we append one inferred from
+ * `media.kind` (image→png, video→mp4, audio→mp3, voice→ogg) so Discord detects
+ * the file type instead of treating it as an opaque blob (an extensionless
+ * `image` upload otherwise renders as a generic file, not an inline preview).
+ */
+export declare function buildDiscordAttachment(media: OutboundMedia): DiscordOutboundAttachment;
+export { MAX_BYTES as DISCORD_MEDIA_MAX_BYTES };
+//# sourceMappingURL=media.d.ts.map

package/dist/agents/channels/discord/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/discord/media.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAUH,OAAO,EAA6B,KAAK,sBAAsB,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACvG,OAAO,EAAgC,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAI/F;;;;;GAKG;AACH,QAAA,MAAM,SAAS,QAAmB,CAAC;AAUnC;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAUrE;AAuCD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,SAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAWxF;AAED,MAAM,WAAW,6BAA6B;IAC7C,wEAAwE;IACxE,UAAU,EAAE,qBAAqB,CAAC;IAClC,kFAAkF;IAClF,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC5D;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CA4D3H;AAED,8FAA8F;AAC9F,MAAM,WAAW,yBAAyB;IACzC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAoBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,yBAAyB,CAiBtF;AAED,OAAO,EAAE,SAAS,IAAI,uBAAuB,EAAE,CAAC"}