@spinabot/brigade 1.6.0 → 1.6.1

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

@@ -0,0 +1,247 @@
+/**
+ * Convert agent-style markdown (Brigade agents output this by default) into
+ * Discord's message markup.
+ *
+ * Discord renders a near-CommonMark dialect natively, so — unlike Slack's
+ * `mrkdwn` (single-asterisk bold) or Telegram's strict HTML — most agent
+ * markdown passes through UNCHANGED:
+ *   - **bold** / __underline__   → kept (Discord: `**bold**`, `__underline__`)
+ *   - *italic* / _italic_        → kept
+ *   - ~~strike~~                 → kept
+ *   - `code`                     → kept (interior verbatim)
+ *   - ```fenced```               → kept (interior verbatim, language tag kept)
+ *   - > quote                    → kept
+ *   - `-`/`*`/`+` bullets        → kept
+ *   - 1. numbered lists          → kept
+ *   - # headings                 → kept (Discord renders `#`/`##`/`###` headers)
+ *
+ * The ONE load-bearing transform: a markdown link `[label](url)` renders
+ * LITERALLY in a normal Discord message (Discord only auto-links bare URLs and
+ * honours `[label](url)` in embeds, not plain content). So a plain-message link
+ * is rewritten to `label (url)` — the same readable fallback Slack/Telegram use
+ * when a link can't be a native token. A bare URL is left as-is (Discord
+ * auto-links it).
+ *
+ * MENTION PASSTHROUGH (critical): an agent that authored a Discord mention token
+ * means it to PING. Discord's tokens are `<@123>` (user), `<@!123>` (member
+ * nickname), `<@&123>` (role), `<#123>` (channel), `<:name:123>` / `<a:name:123>`
+ * (custom / animated emoji), and the literal `@everyone` / `@here`. Those are
+ * passed through VERBATIM so the mention actually resolves; everything else is
+ * left as Discord-native markdown. We do NOT entity-escape (Discord has no HTML
+ * entities) — we only neutralize a STRAY markdown link.
+ *
+ * Pure / deterministic — no I/O, no globals. Models the SHAPE of
+ * `slack/format.ts` (markdown in → channel-native formatting out) but emits
+ * Discord markup.
+ */
+/** Discord's hard per-message content limit (chars). Sends chunk under this. */
+export const DISCORD_MESSAGE_LIMIT = 2000;
+/**
+ * A pre-formed Discord token that must pass through verbatim so it resolves:
+ *   - `<@123>` / `<@!123>`  user / member mention
+ *   - `<@&123>`             role mention
+ *   - `<#123>`              channel mention
+ *   - `<:name:123>` / `<a:name:123>`  custom / animated emoji
+ *   - `<t:123>` / `<t:123:R>`         timestamp
+ * Anchored at the `<` the scanner is sitting on. Returns the matched token
+ * length, or 0 when the `<…>` isn't a recognised Discord token.
+ */
+function matchDiscordToken(text, start) {
+    // Find the closing `>` for this `<`.
+    const close = text.indexOf(">", start + 1);
+    if (close === -1)
+        return 0;
+    const inner = text.slice(start + 1, close);
+    // user / member: @123 or @!123 ; role: @&123 ; channel: #123
+    if (/^@!?\d+$/.test(inner))
+        return close - start + 1;
+    if (/^@&\d+$/.test(inner))
+        return close - start + 1;
+    if (/^#\d+$/.test(inner))
+        return close - start + 1;
+    // custom / animated emoji: :name:123 or a:name:123
+    if (/^a?:[A-Za-z0-9_]{2,32}:\d+$/.test(inner))
+        return close - start + 1;
+    // timestamp: t:123 or t:123:R
+    if (/^t:\d+(?::[tTdDfFR])?$/.test(inner))
+        return close - start + 1;
+    return 0;
+}
+/** Try to match a `[label](url)` link starting at `start` (the `[`). */
+function matchMarkdownLink(text, start) {
+    const labelEnd = text.indexOf("]", start + 1);
+    if (labelEnd === -1)
+        return null;
+    if (text[labelEnd + 1] !== "(")
+        return null;
+    // Balanced-paren scan from just after the opening `(` so a URL that itself
+    // contains parentheses (e.g. `…/Mercury_(planet)`) keeps its closing `)`. A
+    // plain `indexOf(")")` would truncate at the FIRST `)`, dropping the rest.
+    let depth = 1;
+    let urlEnd = -1;
+    for (let j = labelEnd + 2; j < text.length; j++) {
+        const c = text[j];
+        if (c === "(")
+            depth += 1;
+        else if (c === ")") {
+            depth -= 1;
+            if (depth === 0) {
+                urlEnd = j;
+                break;
+            }
+        }
+    }
+    if (urlEnd === -1)
+        return null;
+    const label = text.slice(start + 1, labelEnd);
+    const url = text.slice(labelEnd + 2, urlEnd).trim();
+    // Only honour http/https/mailto/tel links — anything else stays literal so we
+    // never linkify a path / fragment that wasn't a real URL.
+    if (!/^(https?:\/\/|mailto:|tel:)/i.test(url))
+        return null;
+    if (!label)
+        return null;
+    return { label, url, end: urlEnd + 1 };
+}
+/**
+ * Render the INLINE span markup of one already-newline-free run into Discord
+ * markup. Inline code is preserved verbatim (its interior is never rewritten),
+ * Discord mention/emoji tokens pass through verbatim, and a markdown link is
+ * rewritten to the readable `label (url)` fallback. Everything else is passed
+ * through unchanged (Discord renders **bold** / *italic* / ~~strike~~ natively).
+ */
+function renderInlineSpans(text) {
+    const out = [];
+    let i = 0;
+    const n = text.length;
+    while (i < n) {
+        const ch = text[i];
+        // Inline code: `…` — interior is verbatim (no link rewrite inside code).
+        if (ch === "`") {
+            // Support a run of backticks (`` `x` `` / ``` ``y`` ``` ) — match the
+            // same-length closing fence so an interior backtick doesn't close early.
+            const fenceMatch = /^`+/.exec(text.slice(i));
+            const fence = fenceMatch ? fenceMatch[0] : "`";
+            const close = text.indexOf(fence, i + fence.length);
+            if (close !== -1) {
+                out.push(text.slice(i, close + fence.length));
+                i = close + fence.length;
+                continue;
+            }
+        }
+        // Pre-formed Discord token (mention / channel / role / emoji / timestamp) —
+        // pass through verbatim so it actually resolves on Discord.
+        if (ch === "<") {
+            const len = matchDiscordToken(text, i);
+            if (len > 0) {
+                out.push(text.slice(i, i + len));
+                i += len;
+                continue;
+            }
+        }
+        // Markdown link: [label](url) → "label (url)" (a plain Discord message
+        // renders the markdown-link form literally, so we degrade to readable text).
+        if (ch === "[") {
+            const link = matchMarkdownLink(text, i);
+            if (link) {
+                // When the label already equals the url, just emit the bare url
+                // (Discord auto-links it) to avoid the noisy "url (url)".
+                out.push(link.label === link.url ? link.url : `${link.label} (${link.url})`);
+                i = link.end;
+                continue;
+            }
+        }
+        out.push(ch ?? "");
+        i += 1;
+    }
+    return out.join("");
+}
+/** Render a markdown pipe-table block as flat "cell | cell" lines. */
+function renderTableBlock(block) {
+    const rows = [];
+    for (const row of block) {
+        // Drop the separator row (`| --- | :--: |`).
+        if (/^\s*\|?[\s|:-]+\|?\s*$/.test(row))
+            continue;
+        const cells = row
+            .trim()
+            .replace(/^\||\|$/g, "")
+            .split("|")
+            .map((c) => c.trim())
+            .filter(Boolean);
+        if (cells.length)
+            rows.push(cells.map((c) => renderInlineSpans(c)).join(" | "));
+    }
+    return rows.join("\n");
+}
+/**
+ * Convert agent-style markdown into Discord markup. Block structure (fenced code,
+ * tables) is handled line-by-line so a link inside a code fence is never
+ * rewritten; inline markup (links, mentions, code) is handled per-line by
+ * {@link renderInlineSpans}. Headings / bullets / numbered lists / blockquotes
+ * render natively on Discord, so they pass through with only their inline spans
+ * rewritten.
+ */
+export function markdownToDiscord(markdown) {
+    if (!markdown)
+        return "";
+    const lines = markdown.split("\n");
+    const out = [];
+    let i = 0;
+    const n = lines.length;
+    while (i < n) {
+        const line = lines[i] ?? "";
+        // Fenced code block: ```lang … ``` — kept VERBATIM (language tag + interior),
+        // Discord renders it natively and a link inside must not be rewritten.
+        const fenceOpen = /^\s*```/.exec(line);
+        if (fenceOpen) {
+            out.push(line);
+            i += 1;
+            while (i < n) {
+                const inner = lines[i] ?? "";
+                out.push(inner);
+                i += 1;
+                if (/^\s*```\s*$/.test(inner))
+                    break;
+            }
+            continue;
+        }
+        // Pipe-table block: ≥2 contiguous lines that start+end with `|`. Discord has
+        // no table rendering, so flatten to "cell | cell" lines (parity w/ Slack).
+        if (/^\s*\|.*\|\s*$/.test(line)) {
+            const start = i;
+            while (i < n && /^\s*\|.*\|\s*$/.test(lines[i] ?? ""))
+                i += 1;
+            if (i - start >= 2) {
+                out.push(renderTableBlock(lines.slice(start, i)));
+                continue;
+            }
+            i = start;
+        }
+        // Plain / heading / bullet / quote line — render inline spans; the block
+        // markers (`#`, `-`, `>`, `1.`) are left in place for Discord to render.
+        out.push(renderInlineSpans(line));
+        i += 1;
+    }
+    return out.join("\n");
+}
+/**
+ * True when the rendered Discord text carries no visible content — only
+ * whitespace and/or markdown markers. Discord rejects an empty message body, so
+ * the send path falls back / skips when this returns true. Mirrors
+ * `slackMrkdwnIsEmpty` intent.
+ */
+export function discordTextIsEmpty(text) {
+    if (!text)
+        return true;
+    const stripped = text
+        // Mentions / channels / roles / emoji ARE content.
+        .replace(/<a?:[A-Za-z0-9_]+:\d+>/g, "x")
+        .replace(/<@[!&]?\d+>/g, "x")
+        .replace(/<#\d+>/g, "x")
+        .replace(/<t:\d+(?::[tTdDfFR])?>/g, "x")
+        .replace(/[*_~`>#|.\-\s]/g, "")
+        .trim();
+    return stripped.length === 0;
+}
+//# sourceMappingURL=format.js.map

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

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

package/dist/agents/channels/discord/inbound-extras.d.ts

@@ -0,0 +1,220 @@
+/**
+ * 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.
+ */
+import type { InboundReplyContext } from "../sdk.js";
+/** One attachment discord.js exposes on a message (the subset we read). */
+export interface DiscordAttachmentLike {
+    id?: string;
+    name?: string | null;
+    /** CDN download URL (cdn.discordapp.com / media.discordapp.net). */
+    url?: string;
+    proxyURL?: string;
+    contentType?: string | null;
+    size?: number;
+    /** Discord marks voice messages with this flag-bit set; we treat them as voice. */
+    flags?: {
+        has?: (bit: unknown) => boolean;
+    } | number;
+    [key: string]: unknown;
+}
+/** A discord.js channel (the subset Brigade reads). `isThread()`/`isDMBased()` may be absent on a fake. */
+export interface DiscordChannelLike {
+    id?: string;
+    /** Discord channel type enum value (0 = guild text, 1 = DM, 11/12 = thread, …). */
+    type?: number;
+    isThread?: () => boolean;
+    isDMBased?: () => boolean;
+    /** Parent text-channel id when this channel is a thread. */
+    parentId?: string | null;
+    [key: string]: unknown;
+}
+/** A discord.js guild (the subset Brigade reads). */
+export interface DiscordGuildLike {
+    id?: string;
+    [key: string]: unknown;
+}
+/**
+ * The member's roles as Brigade reads them. On a live message discord.js hands
+ * a `GuildMemberRoleManager` whose `.cache` is a Collection (a Map subclass)
+ * keyed by role id; a fake / partial may pass a plain array of role ids. Both
+ * shapes (and an absent value) are honoured by {@link extractDiscordMemberRoleIds}.
+ */
+export type DiscordMemberRolesLike = {
+    cache?: Map<string, unknown> | Iterable<[string, unknown]> | Iterable<{
+        id?: string;
+    }>;
+} | Iterable<string> | string[] | null | undefined;
+/** A discord.js user / author (the subset Brigade reads). */
+export interface DiscordUserLike {
+    id?: string;
+    bot?: boolean;
+    username?: string;
+    globalName?: string | null;
+    /** Cached member display name (guild nickname), when discord.js resolved one. */
+    displayName?: string;
+    [key: string]: unknown;
+}
+/**
+ * A discord.js Message (the subset Brigade consumes). Only the fields used are
+ * typed; the live object carries far more.
+ */
+export interface DiscordMessageLike {
+    id?: string;
+    content?: string;
+    author?: DiscordUserLike;
+    /**
+     * The member who sent it (guild nickname lives here). `roles` is discord.js's
+     * `GuildMemberRoleManager` (a `.cache` Collection keyed by role id) on a live
+     * message; a fake / partial may instead carry a plain array of role ids.
+     */
+    member?: {
+        nickname?: string | null;
+        displayName?: string;
+        roles?: DiscordMemberRolesLike;
+    } | null;
+    channelId?: string;
+    channel?: DiscordChannelLike;
+    guildId?: string | null;
+    guild?: DiscordGuildLike | null;
+    /** Epoch ms the message was created. */
+    createdTimestamp?: number;
+    /** Set when the message was edited (epoch ms), else null. */
+    editedTimestamp?: number | null;
+    /** Reply pointer — `messageId` is the message being replied to. */
+    reference?: {
+        messageId?: string | null;
+        channelId?: string | null;
+        guildId?: string | null;
+    } | null;
+    attachments?: Iterable<DiscordAttachmentLike> | Map<string, DiscordAttachmentLike> | DiscordAttachmentLike[];
+    /** A resolved Collection of mentioned users, or a plain array on a fake. */
+    mentions?: {
+        users?: Iterable<DiscordUserLike> | Map<string, DiscordUserLike> | DiscordUserLike[];
+    };
+    [key: string]: unknown;
+}
+/**
+ * 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 declare function expandDiscordTokens(text: string, resolve?: {
+    user?: (id: string) => string | undefined;
+    role?: (id: string) => string | undefined;
+    channel?: (id: string) => string | undefined;
+}): string;
+/**
+ * The agent-facing plain text of a Discord message. Token-expanded (mentions /
+ * channels / roles / emoji → readable text). Binary blobs are dropped to "".
+ */
+export declare function extractDiscordText(message: Pick<DiscordMessageLike, "content">, resolve?: Parameters<typeof expandDiscordTokens>[1]): string;
+/** True when a discord.js channel is a thread (uses `isThread()` when present, else the type enum). */
+export declare function isThreadChannel(channel: DiscordChannelLike | undefined | null): boolean;
+/** True when a discord.js channel is a DM (uses `isDMBased()` when present, else the type enum). */
+export declare function isDmChannel(channel: DiscordChannelLike | undefined | null): boolean;
+/**
+ * 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 declare function discordChannelType(message: Pick<DiscordMessageLike, "channel" | "guildId">): "direct" | "group";
+/**
+ * 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 declare function discordThreadId(message: Pick<DiscordMessageLike, "channel" | "channelId">): string | 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 declare function extractDiscordReplyContext(message: Pick<DiscordMessageLike, "reference">): InboundReplyContext | undefined;
+/**
+ * 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 declare function extractDiscordMentions(message: DiscordMessageLike, botUserId?: string): string[];
+/**
+ * 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 declare function extractDiscordMemberRoleIds(message: Pick<DiscordMessageLike, "member">): string[];
+/**
+ * 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 declare function buildDiscordSenderName(message: DiscordMessageLike): string | undefined;
+/**
+ * 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 declare function hasInboundMedia(message: Pick<DiscordMessageLike, "attachments">): boolean;
+/** The list of downloadable attachments on a message. */
+export declare function resolveInboundAttachments(message: Pick<DiscordMessageLike, "attachments">): DiscordAttachmentLike[];
+/** The Brigade media-kind of a Discord attachment, from its contentType / filename / voice flag. */
+export declare function resolveDiscordAttachmentKind(a: DiscordAttachmentLike): "image" | "video" | "audio" | "voice" | "document";
+//# sourceMappingURL=inbound-extras.d.ts.map

package/dist/agents/channels/discord/inbound-extras.d.ts.map

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