@spinabot/brigade 1.6.0 → 1.7.0

package/dist/agents/channels/discord/account-config.js

@@ -0,0 +1,349 @@
+/**
+ * Discord config-shape helpers (multi-ACCOUNT aware; mirrors Slack's
+ * `account-config.ts`).
+ *
+ * Discord needs ONE secret per account — the bot token (every Gateway login +
+ * REST call uses it). Unlike Slack (bot + app + signing tokens), there is no
+ * second credential: the Gateway opens a websocket with the bot token, and the
+ * same token drives the REST outbound. So this module is closer to Telegram's
+ * single-token shape than Slack's three-token one, but it keeps Slack's
+ * multi-account discovery so an operator can run >1 bot at once.
+ *
+ * Two config shapes are recognised so the surface lines up with WhatsApp /
+ * Telegram / Slack:
+ *
+ *   Legacy (single-account):
+ *     channels.discord = { enabled: true, botToken: "…" }
+ *
+ *   Multi-account:
+ *     channels.discord = {
+ *       enabled: true,
+ *       accounts: [
+ *         { id: "main", botToken: "…AAA" },
+ *         { id: "labs", botToken: "…BBB" },
+ *       ],
+ *     }
+ *
+ * A legacy config with no `accounts[]` reads as `[{ id: "default" }]`.
+ *
+ * Token resolution mirrors Slack/Telegram: a `${VAR}` ref expands against
+ * `process.env`; otherwise the literal passes through; then a DURABLE sealed
+ * token (written by `connect_channel`) is consulted so the channel survives a
+ * reboot; finally the per-secret env var `DISCORD_BOT_TOKEN` is the last-resort
+ * fallback. A leading `Bot ` prefix (Discord's REST scheme prefix) is stripped
+ * so an operator who pasted the whole `Authorization` header still works.
+ */
+import { readSealedChannelToken } from "../channel-secrets.js";
+const CHANNEL_ID = "discord";
+const DEFAULT_ACCOUNT_ID = "default";
+/** Per-secret env var consulted as a last-resort fallback. */
+const BOT_TOKEN_ENV_VAR = "DISCORD_BOT_TOKEN";
+/**
+ * Standard proxy env vars consulted as a last-resort proxy fallback, in
+ * precedence order. Lower-case wins over upper-case (curl/undici convention),
+ * and a TLS-oriented `https_proxy` outranks the catch-all `ALL_PROXY`. Mirrors
+ * the keys Slack/Telegram honour.
+ */
+const PROXY_ENV_VARS = ["https_proxy", "HTTPS_PROXY", "all_proxy", "ALL_PROXY"];
+/**
+ * Sealed-token key for the bot token (`channel:discord`) — the secret
+ * `connect_channel` seals. The bot token is the only Discord credential, so it
+ * is the one that gets the sealed-read fallback.
+ */
+const SEAL_KEY_BOT = CHANNEL_ID; // `channel:discord`
+/** `${VAR}` secret-ref form — identical to `config/io.ts`'s SECRET_REF_PATTERN. */
+const SECRET_REF_PATTERN = /^\$\{([A-Z_][A-Z0-9_]*)\}$/;
+/** discord.js `ActivityType` numeric codes, keyed by the config string. */
+const ACTIVITY_TYPE_CODE = {
+    playing: 0,
+    streaming: 1,
+    listening: 2,
+    watching: 3,
+    custom: 4,
+    competing: 5,
+};
+/** Valid auto-archive durations Discord accepts (minutes). */
+const AUTO_ARCHIVE_DURATIONS = new Set([60, 1440, 4320, 10080]);
+const DEFAULT_AUTO_ARCHIVE_MINUTES = 1440;
+/** Read `channels.discord` loosely (schema keeps it open). */
+function discordChannelConfig(cfg) {
+    return cfg.channels?.[CHANNEL_ID];
+}
+/**
+ * Resolve a single token-ish string: a `${VAR}` ref expands against
+ * `process.env`; any other non-empty string passes through verbatim; empty /
+ * missing returns "".
+ */
+function resolveTokenRef(raw, env) {
+    if (typeof raw !== "string")
+        return "";
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return "";
+    const m = SECRET_REF_PATTERN.exec(trimmed);
+    if (m && m[1])
+        return (env[m[1]] ?? "").trim();
+    return trimmed;
+}
+/**
+ * Strip a leading `Bot ` scheme prefix from a Discord token. Discord's REST
+ * `Authorization` header is `Bot <token>`; an operator who pasted the whole
+ * header still gets a clean token. Idempotent + case-insensitive.
+ */
+export function stripBotPrefix(token) {
+    return token.replace(/^Bot\s+/i, "").trim();
+}
+/** Is the Discord channel switched on at all (any shape)? */
+export function discordChannelEnabled(cfg) {
+    return discordChannelConfig(cfg)?.enabled === true;
+}
+/** List configured account ids. Legacy single-account configs surface `["default"]`. */
+export function listDiscordAccountIds(cfg) {
+    const slot = discordChannelConfig(cfg);
+    if (!slot || slot.enabled !== true)
+        return [];
+    const accounts = Array.isArray(slot.accounts) ? slot.accounts : undefined;
+    if (!accounts || accounts.length === 0)
+        return [DEFAULT_ACCOUNT_ID];
+    const ids = [];
+    const seen = new Set();
+    for (const entry of accounts) {
+        const id = typeof entry?.id === "string" ? entry.id.trim() : "";
+        if (!id || seen.has(id))
+            continue;
+        seen.add(id);
+        ids.push(id);
+    }
+    // A half-typed `accounts:[]` still degrades to the default account so the
+    // channel isn't silently disabled.
+    return ids.length === 0 ? [DEFAULT_ACCOUNT_ID] : ids;
+}
+/** Look up the raw account entry from config (or null when missing). */
+function findAccountEntry(cfg, accountId) {
+    const slot = discordChannelConfig(cfg);
+    if (!slot)
+        return null;
+    const accounts = Array.isArray(slot.accounts) ? slot.accounts : undefined;
+    if (!accounts)
+        return null;
+    for (const entry of accounts) {
+        const id = typeof entry?.id === "string" ? entry.id.trim() : "";
+        if (id === accountId)
+            return entry;
+    }
+    return null;
+}
+/**
+ * Resolve the Discord bot token for an account. Precedence (mirrors Slack's
+ * token resolution): per-account config `${VAR}`/literal → top-level config →
+ * durable sealed token → per-secret env var. The `Bot ` scheme prefix is
+ * stripped from whichever source wins. Returns `""` when nothing resolves.
+ */
+export function resolveDiscordBotToken(cfg, accountId, env = process.env) {
+    const id = accountId?.trim() || DEFAULT_ACCOUNT_ID;
+    const slot = discordChannelConfig(cfg);
+    const entry = findAccountEntry(cfg, id);
+    const perAccount = resolveTokenRef(entry?.botToken, env);
+    if (perAccount)
+        return stripBotPrefix(perAccount);
+    const topLevel = resolveTokenRef(slot?.botToken, env);
+    if (topLevel)
+        return stripBotPrefix(topLevel);
+    const sealed = readSealedChannelToken(SEAL_KEY_BOT);
+    if (sealed)
+        return stripBotPrefix(sealed);
+    const fromEnv = (env[BOT_TOKEN_ENV_VAR] ?? "").trim();
+    if (fromEnv)
+        return stripBotPrefix(fromEnv);
+    return "";
+}
+/**
+ * Resolve the proxy URL all Discord REST calls (+ the Gateway websocket) should
+ * route through. Precedence (mirrors Slack's `resolveSlackProxyUrl`):
+ *   1. The per-account `accounts[].proxy` (multi-account shape), `${VAR}`-resolved.
+ *   2. The top-level `channels.discord.proxy`, `${VAR}`-resolved.
+ *   3. The first set standard proxy env var (`https_proxy` / `HTTPS_PROXY` /
+ *      `all_proxy` / `ALL_PROXY`) — last-resort fallback.
+ * Returns `""` when none is configured → a DIRECT connection (the default).
+ *
+ * `${VAR}` refs are resolved here the same way `botToken` is, so an operator can
+ * keep the proxy (which may carry `user:pass@` creds) out of the committed
+ * config as `channels.discord.proxy: "${DISCORD_PROXY}"`.
+ */
+export function resolveDiscordProxyUrl(cfg, accountId, env = process.env) {
+    const id = accountId?.trim() || DEFAULT_ACCOUNT_ID;
+    const slot = discordChannelConfig(cfg);
+    const entry = findAccountEntry(cfg, id);
+    const perAccount = resolveTokenRef(entry?.proxy, env);
+    if (perAccount)
+        return perAccount;
+    const topLevel = resolveTokenRef(slot?.proxy, env);
+    if (topLevel)
+        return topLevel;
+    for (const key of PROXY_ENV_VARS) {
+        const value = (env[key] ?? "").trim();
+        if (value)
+            return value;
+    }
+    return "";
+}
+/**
+ * Mask a proxy URL down to `scheme://host:port` (creds + path dropped) so it is
+ * safe to log. A malformed URL is reduced to its scheme only; an empty input
+ * returns "". NEVER log a raw proxy URL — it may embed `user:pass@`.
+ */
+export function maskProxyUrl(proxyUrl) {
+    const raw = (proxyUrl ?? "").trim();
+    if (!raw)
+        return "";
+    try {
+        const u = new URL(raw);
+        return `${u.protocol}//${u.host}`; // host includes :port; userinfo + path/query dropped
+    }
+    catch {
+        const scheme = /^([a-z][a-z0-9+.-]*):\/\//i.exec(raw)?.[1];
+        return scheme ? `${scheme}://<masked>` : "<masked>";
+    }
+}
+/** Resolve a per-account view of the config (defaults + token resolution filled in). */
+export function resolveDiscordAccount(cfg, accountId, env = process.env) {
+    const slot = discordChannelConfig(cfg);
+    const id = accountId?.trim() || DEFAULT_ACCOUNT_ID;
+    const entry = findAccountEntry(cfg, id);
+    const enabled = entry?.enabled !== false && slot?.enabled === true;
+    return {
+        accountId: id,
+        enabled,
+        botToken: resolveDiscordBotToken(cfg, id, env),
+        proxyUrl: resolveDiscordProxyUrl(cfg, id, env),
+        verbose: slot?.verbose === true,
+    };
+}
+/* ───────────────────────── lifecycle / streaming config ───────────────────────── */
+/**
+ * True when live reply-streaming is enabled (`channels.discord.liveStream`).
+ * Default OFF — the adapter delivers one final chunked message.
+ */
+export function discordLiveStreamEnabled(cfg) {
+    return discordChannelConfig(cfg)?.liveStream === true;
+}
+/**
+ * Resolve the streaming edit throttle in ms. Reads
+ * `channels.discord.streamThrottleMs`; falls back to 1000ms (floored at 250ms by
+ * the draft-stream).
+ */
+export function discordStreamThrottleMs(cfg) {
+    const raw = discordChannelConfig(cfg)?.streamThrottleMs;
+    return typeof raw === "number" && raw > 0 ? raw : 1000;
+}
+/**
+ * True when reasoning surfacing is enabled (`channels.discord.surfaceReasoning`).
+ * Default OFF — `<think>` reasoning is stripped from channel replies as today.
+ */
+export function discordSurfaceReasoning(cfg) {
+    return discordChannelConfig(cfg)?.surfaceReasoning === true;
+}
+/**
+ * Resolve the reaction-notification mode (`channels.discord.reactionNotifications`).
+ * Defaults to `"own"` (only reactions on the bot's own messages wake the agent) so
+ * a stranger's reaction in an admitted channel no longer spams a turn. An invalid /
+ * unset value degrades to the `"own"` default.
+ */
+export function discordReactionNotifications(cfg) {
+    const raw = discordChannelConfig(cfg)?.reactionNotifications;
+    if (raw === "off" || raw === "own" || raw === "all" || raw === "allowlist")
+        return raw;
+    return "own";
+}
+/**
+ * Resolve the idle-thread-session TTL in ms, or `null` when unset / disabled.
+ * Accepts a number (ms) or a duration string (`"6h"`, `"30m"`, …). The cron
+ * session-reaper uses this to age out idle Discord thread sessions.
+ */
+export function discordThreadIdleTtlMs(cfg) {
+    const raw = discordChannelConfig(cfg)?.threadIdleTtlMs;
+    if (typeof raw === "number")
+        return raw > 0 ? raw : null;
+    if (typeof raw !== "string")
+        return null;
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    const m = /^(\d+)\s*(s|m|h|d|w)?$/i.exec(trimmed);
+    if (!m)
+        return null;
+    const n = Number(m[1]);
+    if (!Number.isFinite(n) || n <= 0)
+        return null;
+    const unit = (m[2] ?? "ms").toLowerCase();
+    const mult = { s: 1_000, m: 60_000, h: 3_600_000, d: 86_400_000, w: 604_800_000, ms: 1 };
+    const factor = mult[unit] ?? 1;
+    return n * factor;
+}
+/* ───────────────────────── presence / auto-thread config ───────────────────────── */
+/**
+ * Resolve the bot presence to apply on (re)connect, or `null` when none is
+ * configured (`channels.discord.presence` absent / empty → keep Discord's
+ * default). A `status`-only block (no activity) still resolves so the operator
+ * can set just the online dot. An invalid `status` / `activityType` is dropped
+ * (degrades to the default), never throwing. The activity type is mapped to its
+ * discord.js `ActivityType` numeric code here so the connection stays
+ * discord.js-agnostic.
+ *
+ * Multi-account aware (mirrors the other per-account resolvers): the per-account
+ * `accounts[id].presence` wins, falling back to the top-level
+ * `channels.discord.presence`. Without this fallback a per-account
+ * `set-presence` write was a silent no-op (it read only the top-level slot).
+ */
+export function resolveDiscordPresence(cfg, accountId) {
+    const id = accountId?.trim() || DEFAULT_ACCOUNT_ID;
+    const entry = findAccountEntry(cfg, id);
+    const slot = (entry?.presence && typeof entry.presence === "object" ? entry.presence : undefined) ??
+        discordChannelConfig(cfg)?.presence;
+    if (!slot || typeof slot !== "object")
+        return null;
+    const statusRaw = typeof slot.status === "string" ? slot.status.trim().toLowerCase() : "";
+    const status = statusRaw === "online" || statusRaw === "idle" || statusRaw === "dnd" || statusRaw === "invisible"
+        ? statusRaw
+        : "online";
+    const activityText = typeof slot.activityText === "string" ? slot.activityText.trim() : "";
+    const activityTypeRaw = typeof slot.activityType === "string" ? slot.activityType.trim().toLowerCase() : undefined;
+    const activityType = activityTypeRaw && activityTypeRaw in ACTIVITY_TYPE_CODE ? activityTypeRaw : undefined;
+    const activityUrl = typeof slot.activityUrl === "string" ? slot.activityUrl.trim() : "";
+    // Nothing meaningful configured (no status, no activity) → no presence.
+    const hasStatus = statusRaw !== "";
+    const hasActivity = activityText !== "" || activityType !== undefined;
+    if (!hasStatus && !hasActivity)
+        return null;
+    const resolved = { status };
+    if (hasActivity) {
+        // An activity row needs at least a type; default to `custom` (the status
+        // STATE line) when only text was given.
+        const type = activityType ?? "custom";
+        resolved.activityType = type;
+        resolved.activityTypeCode = ACTIVITY_TYPE_CODE[type];
+        if (activityText)
+            resolved.activityText = activityText;
+        if (type === "streaming" && activityUrl)
+            resolved.activityUrl = activityUrl;
+    }
+    return resolved;
+}
+/**
+ * Resolve the auto-thread policy (`channels.discord.autoThread*`). Returns a
+ * resolved view with `enabled` false when the feature is off (the default). The
+ * name mode defaults to `"first-message"`; `autoArchiveDuration` is clamped to
+ * one of Discord's accepted values (60 / 1440 / 4320 / 10080), defaulting to
+ * 1440 (24h).
+ */
+export function resolveDiscordAutoThread(cfg) {
+    const slot = discordChannelConfig(cfg);
+    const enabled = slot?.autoThread === true;
+    const nameRaw = typeof slot?.autoThreadName === "string" ? slot.autoThreadName.trim().toLowerCase() : "";
+    const nameMode = nameRaw === "generated" ? "generated" : "first-message";
+    const rawDuration = typeof slot?.autoArchiveDuration === "number" ? Math.round(slot.autoArchiveDuration) : NaN;
+    const autoArchiveMinutes = AUTO_ARCHIVE_DURATIONS.has(rawDuration) ? rawDuration : DEFAULT_AUTO_ARCHIVE_MINUTES;
+    return { enabled, nameMode, autoArchiveMinutes };
+}
+export { CHANNEL_ID as DISCORD_CHANNEL_ID, DEFAULT_ACCOUNT_ID as DISCORD_DEFAULT_ACCOUNT_ID, BOT_TOKEN_ENV_VAR as DISCORD_BOT_TOKEN_ENV_VAR, };
+//# sourceMappingURL=account-config.js.map

package/dist/agents/channels/discord/account-config.js.map

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

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

@@ -0,0 +1,79 @@
+/**
+ * Discord channel adapter.
+ *
+ * Implements the Brigade `ChannelAdapter` contract on top of the discord.js
+ * Gateway + REST connection. Like Slack, Discord is TOKEN-based: the operator
+ * pastes a bot token from the Discord Developer Portal, so this adapter declares
+ * a `setup` wizard (one credential) and has NO QR/link flow. Enablement is
+ * explicit — `channels.discord.enabled: true` plus a resolvable bot token.
+ *
+ * Modeled directly on `slack/adapter.ts`: same health-flag mirroring, same
+ * deferred-media passthrough on inbound, same chunk-then-send outbound shape
+ * (chunk markdown ≤2000, convert each chunk to Discord markup, send). Discord
+ * markup never "fails to parse" the way Telegram HTML can, so the outbound path
+ * is simple — an empty rendered chunk falls back to the raw chunk.
+ *
+ * Capabilities: edit (message.edit), unsend (message.delete), reactions
+ * (message.react), reply (reply reference + threads), threads, media
+ * (AttachmentBuilder), buttons (ActionRow + Button), and NATIVE slash commands
+ * (registered via REST application commands on connect). Unlike Slack, Discord's
+ * command menu IS pushed programmatically — `nativeCommands: true`.
+ */
+import type { BrigadeConfig } from "../../../config/io.js";
+import { type ChannelAdapter, type ChannelCapabilities } from "../sdk.js";
+import { type ResolvedDiscordPresence } from "./account-config.js";
+import { type ConnectDiscordArgs, type DiscordConnection, type DiscordInboundMessage, type DiscordPresencePayload } from "./connection.js";
+/**
+ * Map a resolved presence config into the discord.js `PresenceData` payload the
+ * connection applies on (re)connect (Phase 5). A `custom` activity (type 4)
+ * carries its text in the `state` field (Discord renders custom status from the
+ * state); every other type uses `name`. A `streaming` activity (type 1) adds the
+ * `url`. Returns `null` when no presence is configured.
+ */
+export declare function mapDiscordPresencePayload(presence: ResolvedDiscordPresence | null): DiscordPresencePayload | null;
+/** Adapter construction options — all optional for back-compat. */
+export interface CreateDiscordAdapterOptions {
+    /** Per-account scope. Defaults to `"default"` (single-account). */
+    accountId?: string;
+    /**
+     * TEST SEAM: override how the connection is built. Production leaves this
+     * undefined and `connectDiscord` lazy-loads discord.js. Tests inject a fake.
+     */
+    connectImpl?: (args: ConnectDiscordArgs) => Promise<DiscordConnection>;
+}
+export declare function createDiscordAdapter(opts?: CreateDiscordAdapterOptions): ChannelAdapter;
+/**
+ * Decide whether an inbound reaction-add should wake the agent, per the
+ * `channels.discord.reactionNotifications` mode (default `"own"`):
+ *   - `"off"`       → never;
+ *   - `"own"`       → only when the reacted message was authored by the bot
+ *                     (`reaction.targetAuthorId === selfId`);
+ *   - `"all"`       → always (legacy behavior);
+ *   - `"allowlist"` → only when the reactor (`msg.from`) is on the channel
+ *                     allow-list — the central store list ∪ config `allowFrom`.
+ * A null config defensively falls back to `"own"`. Reaction-REMOVE is unaffected
+ * (handled in the connection's dedupe-release path).
+ */
+export declare function shouldNotifyReaction(msg: DiscordInboundMessage, cfg: BrigadeConfig | null, selfId: string | undefined, accountId?: string): boolean;
+/**
+ * Synthesise the agent-facing note for an inbound reaction. The reaction itself
+ * carries no text, so the note ("<who> reacted :emoji: to message <id>") is what
+ * the central pipeline routes through dispatchTurn so the agent has context.
+ */
+export declare function buildReactionNote(emojis: string[], targetMessageId: string, fromName?: string): string;
+/** Static Discord capability flags (shared by the legacy adapter + plugin meta). */
+export declare const DISCORD_CAPABILITIES: ChannelCapabilities;
+/**
+ * The Discord adapter shape with its liveness extension. `createDiscordAdapter`
+ * returns a `ChannelAdapter`, but the concrete object ALSO carries `lastEventAt`
+ * (not in the base contract). Callers that need it cast through this type.
+ */
+export interface DiscordAdapter extends ChannelAdapter {
+    /**
+     * Epoch ms of the most recent inbound event (liveness diagnostic), or null
+     * before the first event / when not started. Observability only — never flips
+     * health to "down" (a quiet channel is legitimately idle).
+     */
+    lastEventAt(): number | null;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/discord/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAK3D,OAAO,EAGN,KAAK,cAAc,EAEnB,KAAK,mBAAmB,EAQxB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAaN,KAAK,uBAAuB,EAC5B,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EAGN,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,MAAM,iBAAiB,CAAC;AASzB;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,GAAG,sBAAsB,GAAG,IAAI,CAiBjH;AAED,mEAAmE;AACnE,MAAM,WAAW,2BAA2B;IAC3C,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACvE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,2BAAgC,GAAG,cAAc,CAwiB3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,qBAAqB,EAC1B,GAAG,EAAE,aAAa,GAAG,IAAI,EACzB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAsBT;AASD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAKtG;AAED,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,EAAE,mBASlC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,cAAe,SAAQ,cAAc;IACrD;;;;OAIG;IACH,WAAW,IAAI,MAAM,GAAG,IAAI,CAAC;CAC7B"}