@spinabot/brigade 1.6.0 → 1.7.0

package/dist/agents/channels/discord/draft-stream.js

@@ -0,0 +1,213 @@
+/**
+ * Discord live-streaming draft message.
+ *
+ * Brigade agents normally deliver one FINAL chunked reply (see
+ * `inbound-pipeline.dispatchTurn` → `adapter.sendText`). This module adds the
+ * OPTIONAL progressive-edit behavior: post a placeholder message on the first
+ * content, then `message.edit` it with the accumulating answer as tokens arrive —
+ * THROTTLED to roughly one edit per second so a long reply doesn't hammer the
+ * REST API. When the running text outgrows the per-message limit the stream
+ * FINALIZES the current message at its last safe chunk boundary and ROLLS to a
+ * fresh message for the overflow, so a multi-message reply streams naturally.
+ *
+ * Design notes (vs the simpler one-shot send):
+ *   - Transport-agnostic + pure-ish: the two Discord calls (`postMessage`,
+ *     `editMessage`) are INJECTED, so the throttle / roll / finalize state
+ *     machine is unit-tested with fakes and never imports `discord.js`.
+ *   - Throttle window: edits coalesce — `update(text)` only records the latest
+ *     text; the loop flushes at most once per `throttleMs`. `flush()` forces an
+ *     immediate delivery.
+ *   - Char-limit roll: when an edit would exceed the limit, the current message
+ *     is finalized to the largest chunk that fits (split on a paragraph /
+ *     newline / space boundary) and the remainder starts a NEW message.
+ *   - Render hook: `renderText` converts a markdown chunk to Discord markup
+ *     (same `markdownToDiscord` the final path uses). A render that throws or
+ *     yields empty text falls back to the plain chunk so a half-streamed code
+ *     fence never wedges the stream.
+ *   - Idempotent finalize: `finalize(text)` is safe to call once at turn end —
+ *     it flushes the final text and stops the loop. After finalize the stream is
+ *     inert.
+ *
+ * Discord-native analogue of `slack/draft-stream.ts` — the same state machine,
+ * with Discord's string message ids and its 2000-char content limit.
+ */
+/** Discord's hard per-message content limit (chars). */
+export const DISCORD_STREAM_MAX_CHARS = 2000;
+/** Default minimum gap between edits (≈ 1 edit/sec, REST friendly). */
+export const DEFAULT_THROTTLE_MS = 1000;
+/** Floor on the throttle so a misconfig can't spam the API. */
+const MIN_THROTTLE_MS = 250;
+/**
+ * Split `text` so the head fits within `limit` chars, preferring (in order) a
+ * paragraph break, a newline, then a space, falling back to a hard cut. Returns
+ * `[head, rest]`; `rest` is "" when the whole text fits.
+ */
+export function splitAtBoundary(text, limit) {
+    if (text.length <= limit)
+        return [text, ""];
+    const window = text.slice(0, limit);
+    const candidates = [window.lastIndexOf("\n\n"), window.lastIndexOf("\n"), window.lastIndexOf(" ")];
+    for (const idx of candidates) {
+        // Require the boundary to land past the half-way mark so we don't emit a
+        // tiny head and shove almost everything into the overflow message.
+        if (idx > limit * 0.5) {
+            return [text.slice(0, idx).trimEnd(), text.slice(idx).trimStart()];
+        }
+    }
+    return [text.slice(0, limit), text.slice(limit)];
+}
+export function createDraftStream(params) {
+    const throttleMs = Math.max(MIN_THROTTLE_MS, params.throttleMs ?? DEFAULT_THROTTLE_MS);
+    const maxChars = Math.min(DISCORD_STREAM_MAX_CHARS, Math.max(1, params.maxChars ?? DISCORD_STREAM_MAX_CHARS));
+    const render = params.renderText ?? ((t) => ({ text: t }));
+    const warn = params.warn ?? (() => { });
+    // Full accumulated answer text the agent has produced so far.
+    let pending = "";
+    // Text of the CURRENT (live) message that's already been delivered — used to
+    // skip no-op edits and to know how much of `pending` belongs to this message.
+    let liveDelivered = "";
+    // Char offset into `pending` where the current live message STARTS. Each roll
+    // advances this past the finalized head.
+    let baseOffset = 0;
+    const sentIds = [];
+    let liveId;
+    let done = false;
+    let inFlight = false;
+    let lastSentAt = 0;
+    let timer;
+    const clearTimer = () => {
+        if (timer) {
+            clearTimeout(timer);
+            timer = undefined;
+        }
+    };
+    /** The slice of `pending` that belongs to the current live message. */
+    const liveSlice = () => pending.slice(baseOffset);
+    /**
+     * Deliver the current live slice: post a placeholder on first content, edit
+     * thereafter, and roll to a new message when the slice exceeds `maxChars`.
+     * Re-entrancy guarded by `inFlight` so overlapping flushes serialize.
+     */
+    const deliver = async (isFinal) => {
+        if (done && !isFinal)
+            return;
+        if (inFlight)
+            return;
+        if (!liveSlice().trim())
+            return;
+        inFlight = true;
+        try {
+            // Roll: finalize the current message at a boundary, start a new one for
+            // the overflow. Loop because a very long burst can overflow twice. We
+            // work against the UNTRIMMED live slice so `baseOffset` advances by the
+            // exact number of `pending` chars consumed (including the boundary
+            // whitespace `splitAtBoundary` drops), keeping the next message aligned.
+            let rawSlice = liveSlice();
+            while (rawSlice.trimEnd().length > maxChars) {
+                const [head] = splitAtBoundary(rawSlice.trimEnd(), maxChars);
+                await deliverOne(head);
+                const headEnd = rawSlice.indexOf(head) + head.length;
+                let advance = headEnd;
+                while (advance < rawSlice.length && /\s/.test(rawSlice[advance] ?? ""))
+                    advance++;
+                baseOffset += advance;
+                liveDelivered = "";
+                liveId = undefined;
+                rawSlice = liveSlice();
+            }
+            const slice = rawSlice.trimEnd();
+            if (slice && (slice !== liveDelivered || isFinal)) {
+                await deliverOne(slice);
+            }
+            lastSentAt = Date.now();
+        }
+        finally {
+            inFlight = false;
+        }
+    };
+    /** Post-or-edit a single message body (≤ maxChars). */
+    const deliverOne = async (body) => {
+        let rendered;
+        try {
+            rendered = render(body);
+            if (!rendered.text.trim())
+                rendered = { text: body };
+        }
+        catch {
+            rendered = { text: body };
+        }
+        // A render can inflate length; guard the hard cap.
+        if (rendered.text.length > DISCORD_STREAM_MAX_CHARS) {
+            rendered = { text: body.slice(0, maxChars) };
+        }
+        try {
+            if (typeof liveId === "string") {
+                if (rendered.text === liveDelivered)
+                    return;
+                await params.transport.editMessage(liveId, rendered.text);
+            }
+            else {
+                const sent = await params.transport.postMessage(rendered.text, {
+                    ...(params.threadId !== undefined ? { threadId: params.threadId } : {}),
+                });
+                liveId = sent.id;
+                sentIds.push(sent.id);
+            }
+            liveDelivered = rendered.text;
+        }
+        catch (err) {
+            // A post / edit failure must never wedge the turn — the final-only
+            // fallback in the pipeline still delivers the complete reply.
+            warn(`discord stream deliver failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    };
+    /** Schedule a throttled flush if one isn't already pending. */
+    const scheduleFlush = () => {
+        if (done || timer || inFlight)
+            return;
+        const elapsed = Date.now() - lastSentAt;
+        const wait = elapsed >= throttleMs ? 0 : throttleMs - elapsed;
+        timer = setTimeout(() => {
+            timer = undefined;
+            void deliver(false);
+        }, wait);
+    };
+    return {
+        update(fullText) {
+            if (done)
+                return;
+            if (typeof fullText !== "string")
+                return;
+            pending = fullText;
+            scheduleFlush();
+        },
+        async flush() {
+            if (done)
+                return;
+            clearTimer();
+            await deliver(false);
+        },
+        async finalize(fullText) {
+            if (done)
+                return;
+            clearTimer();
+            if (typeof fullText === "string")
+                pending = fullText;
+            // Drain: deliver until the live slice is fully sent (handles a final burst
+            // that rolls into one or more new messages).
+            await deliver(true);
+            done = true;
+        },
+        stop() {
+            clearTimer();
+            done = true;
+        },
+        messageIds() {
+            return [...sentIds];
+        },
+        isDone() {
+            return done;
+        },
+    };
+}
+//# sourceMappingURL=draft-stream.js.map

package/dist/agents/channels/discord/draft-stream.js.map

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

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

@@ -0,0 +1,70 @@
+/**
+ * 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 declare const DISCORD_MESSAGE_LIMIT = 2000;
+/**
+ * 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 declare function markdownToDiscord(markdown: string): string;
+/**
+ * Rewrite a plain `@handle` to its `<@id>` mention token — but ONLY when
+ * `resolve(handle)` returns a known user id. An unknown handle stays literal
+ * (we never invent a ping). Skips:
+ *   - code spans / fenced blocks (an `@alex` there is verbatim, not a mention);
+ *   - `@everyone` / `@here` (Discord-reserved, and `<@…>`-safe-mentions never
+ *     parse "everyone" anyway);
+ *   - a handle already sitting inside a `<@…>` token (the boundary group means
+ *     the `@` after `<` is never a candidate start).
+ *
+ * Called by the adapter BEFORE `markdownToDiscord` so a freshly-minted `<@id>`
+ * passes through the converter as a verbatim mention token. Pure over its
+ * `resolve` argument — the resolver carries the account-scoped directory cache.
+ */
+export declare function rewriteKnownMentions(text: string, resolve: (handle: string) => string | undefined): string;
+/**
+ * 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 declare function discordTextIsEmpty(text: string): boolean;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/discord/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAmI1C;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA4C1D;AAqBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,MAAM,CAuB1G;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWxD"}

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

@@ -0,0 +1,303 @@
+/**
+ * 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");
+}
+/**
+ * Code-span matcher: a fenced ```…``` block OR an inline `…` span. Used by
+ * {@link rewriteKnownMentions} to SKIP rewriting handles that live inside code
+ * (where an `@alex` is verbatim text, not a mention the author wants pinged).
+ */
+const CODE_SEGMENT_PATTERN = /```[\s\S]*?```|`[^`\n]*`/g;
+/**
+ * A plain `@handle` candidate OUTSIDE a code span. Group 1 is the preceding
+ * boundary char (start-of-string or a separator) so we never match an `@` glued
+ * to a word (an email's `@`, or a `<@id>` token's `@`); group 2 is the handle
+ * body (Discord usernames: letters/digits/underscore/dot/hyphen, 2–32 chars,
+ * with an optional legacy `#1234` discriminator).
+ */
+const MENTION_CANDIDATE_PATTERN = /(^|[\s([{"'.,;:!?])@([a-z0-9_.-]{2,32}(?:#[0-9]{4})?)/gi;
+/** Discord resolves these itself — never rewrite them to a user token. */
+const RESERVED_MENTIONS = new Set(["everyone", "here"]);
+/**
+ * Rewrite a plain `@handle` to its `<@id>` mention token — but ONLY when
+ * `resolve(handle)` returns a known user id. An unknown handle stays literal
+ * (we never invent a ping). Skips:
+ *   - code spans / fenced blocks (an `@alex` there is verbatim, not a mention);
+ *   - `@everyone` / `@here` (Discord-reserved, and `<@…>`-safe-mentions never
+ *     parse "everyone" anyway);
+ *   - a handle already sitting inside a `<@…>` token (the boundary group means
+ *     the `@` after `<` is never a candidate start).
+ *
+ * Called by the adapter BEFORE `markdownToDiscord` so a freshly-minted `<@id>`
+ * passes through the converter as a verbatim mention token. Pure over its
+ * `resolve` argument — the resolver carries the account-scoped directory cache.
+ */
+export function rewriteKnownMentions(text, resolve) {
+    if (!text || !text.includes("@"))
+        return text;
+    const rewriteOutsideCode = (segment) => segment.replace(MENTION_CANDIDATE_PATTERN, (match, boundary, handle) => {
+        const lookup = handle.toLowerCase();
+        if (RESERVED_MENTIONS.has(lookup.replace(/#[0-9]{4}$/, "")))
+            return match;
+        const id = resolve(handle);
+        if (!id || !/^\d+$/.test(id))
+            return match;
+        return `${boundary}<@${id}>`;
+    });
+    // Walk the string, leaving every code segment untouched and rewriting the
+    // gaps between them.
+    let out = "";
+    let offset = 0;
+    CODE_SEGMENT_PATTERN.lastIndex = 0;
+    for (const m of text.matchAll(CODE_SEGMENT_PATTERN)) {
+        const idx = m.index ?? 0;
+        out += rewriteOutsideCode(text.slice(offset, idx));
+        out += m[0];
+        offset = idx + m[0].length;
+    }
+    out += rewriteOutsideCode(text.slice(offset));
+    return out;
+}
+/**
+ * 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/guilds.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Discord guild listing — the cheap `GET /users/@me/guilds` call the directory
+ * + diagnostics build on.
+ *
+ * Like `probe.ts` this is a SELF-CONTAINED REST call (no `discord.js`, no
+ * Gateway socket): a single authenticated GET that returns the bot's joined
+ * guilds. The directory walks these to enumerate members + channels; the
+ * permission audit doesn't need them but other diagnostics might. Injectable
+ * fetch (tests stub it); never throws — a failed call returns `[]`.
+ */
+/** One guild the bot belongs to (the subset callers read). */
+export interface DiscordGuildSummary {
+    /** Guild (server) id (snowflake). */
+    id: string;
+    /** Guild name. */
+    name: string;
+}
+/**
+ * List the guilds the bot is a member of via `GET /users/@me/guilds`. Returns
+ * `{ id, name }` rows, skipping malformed entries. Best-effort: a network error
+ * / non-ok / unparseable body returns `[]` (the caller degrades gracefully).
+ * The token rides in the `Authorization: Bot <token>` header; never logged.
+ */
+export declare function listDiscordGuilds(token: string, fetchImpl?: typeof fetch): Promise<DiscordGuildSummary[]>;
+//# sourceMappingURL=guilds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guilds.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/discord/guilds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IACnC,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACtC,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,OAAO,KAAa,GAC7B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAsBhC"}