@cogenta/channels 0.1.0

package/dist/preferences/types.d.ts

@@ -0,0 +1,37 @@
+import type { ChannelSeverity } from '../adapter.js';
+/**
+ * An open, but real, typed set of event kinds a producer (an approval
+ * dispatch, a future SEO/security/performance agent report) can notify
+ * about — "quels types d'événements" (lot doc) needs something a user can
+ * actually opt into, not a bare unvalidated string.
+ */
+export declare const CHANNEL_EVENT_TYPES: readonly ['approval-request', 'security-alert', 'seo-report', 'performance-report', 'content-report'];
+export type ChannelEventType = (typeof CHANNEL_EVENT_TYPES)[number];
+export type GroupingMode = 'immediate' | 'hourly' | 'daily';
+/** Minutes since local midnight, `0..1439`. */
+export interface QuietHours {
+    readonly startMinute: number;
+    readonly endMinute: number;
+}
+/**
+ * "Par utilisateur et par canal : quels types d'événements, quelle gravité
+ * minimale, quelle plage horaire, quel regroupement." One row per
+ * `(userId, channelName)` — the same user can want immediate critical
+ * alerts on one channel and a daily digest on another.
+ */
+export interface ChannelPreferences {
+    readonly eventTypes: readonly ChannelEventType[];
+    readonly minSeverity: ChannelSeverity;
+    /** `null` — no quiet hours configured, nothing is ever deferred by time of day. */
+    readonly quietHours: QuietHours | null;
+    readonly grouping: GroupingMode;
+}
+/**
+ * The safe default for a `(userId, channelName)` with no stored row —
+ * "receive everything immediately" until the user tunes it down, matching
+ * this codebase's R2-style rule that an unconfigured state must still work,
+ * never silently drop something the user never asked to suppress.
+ */
+export declare const DEFAULT_CHANNEL_PREFERENCES: ChannelPreferences;
+export declare const SEVERITY_RANK: Readonly<Record<ChannelSeverity, number>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/preferences/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/preferences/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,YAC9B,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,CACR,CAAA;AAEV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE3D,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAChD,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAA;IACrC,mFAAmF;IACnF,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;CAChC;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,kBAKzC,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAInE,CAAA"}

package/dist/preferences/types.js

@@ -0,0 +1,31 @@
+/**
+ * An open, but real, typed set of event kinds a producer (an approval
+ * dispatch, a future SEO/security/performance agent report) can notify
+ * about — "quels types d'événements" (lot doc) needs something a user can
+ * actually opt into, not a bare unvalidated string.
+ */
+export const CHANNEL_EVENT_TYPES = [
+    'approval-request',
+    'security-alert',
+    'seo-report',
+    'performance-report',
+    'content-report',
+];
+/**
+ * The safe default for a `(userId, channelName)` with no stored row —
+ * "receive everything immediately" until the user tunes it down, matching
+ * this codebase's R2-style rule that an unconfigured state must still work,
+ * never silently drop something the user never asked to suppress.
+ */
+export const DEFAULT_CHANNEL_PREFERENCES = {
+    eventTypes: CHANNEL_EVENT_TYPES,
+    minSeverity: 'info',
+    quietHours: null,
+    grouping: 'immediate',
+};
+export const SEVERITY_RANK = {
+    info: 0,
+    warning: 1,
+    critical: 2,
+};
+//# sourceMappingURL=types.js.map

package/dist/preferences/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/preferences/types.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,kBAAkB;IAClB,gBAAgB;IAChB,YAAY;IACZ,oBAAoB;IACpB,gBAAgB;CACR,CAAA;AA0BV;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAuB;IAC7D,UAAU,EAAE,mBAAmB;IAC/B,WAAW,EAAE,MAAM;IACnB,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,WAAW;CACtB,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAA8C;IACtE,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;CACZ,CAAA"}

package/dist/providers/discord/adapter.d.ts

@@ -0,0 +1,38 @@
+import type { ChannelAdapter, ChannelMessage, InboundHandler, MessageId } from '../../adapter.js';
+import type { CommandRouter } from '../../inbound/router.js';
+import type { ChannelLinkStore } from '../../linking/store.js';
+import { type DiscordClientConfig } from './client.js';
+import { type DiscordGatewayClient } from './gateway.js';
+export interface DiscordLinkProof {
+    readonly code: string;
+    readonly channelUserId: string;
+}
+export interface DiscordAdapterOptions extends DiscordClientConfig {
+    readonly linkStore: ChannelLinkStore;
+    readonly router: CommandRouter;
+    readonly intents?: number;
+    readonly gatewayClient?: DiscordGatewayClient;
+}
+/**
+ * A live channel adapter beyond the generic interface: `start()`/`stop()`
+ * manage the Gateway connection, which has no counterpart in
+ * `ChannelAdapter` — same shape as `TelegramAdapter`'s polling lifecycle and
+ * `SlackAdapter`'s Socket Mode lifecycle.
+ */
+export interface DiscordAdapter extends ChannelAdapter {
+    update(id: MessageId, message: ChannelMessage): Promise<void>;
+    onInbound(handler: InboundHandler): void;
+    start(): Promise<void>;
+    stop(): void;
+}
+/**
+ * "Adaptateur Discord." The Gateway (a persistent WebSocket), not the
+ * Interactions Endpoint URL webhook — Discord offers no polling REST
+ * alternative for real-time messages (unlike Telegram's `getUpdates`), and
+ * the webhook path needs a public HTTPS endpoint plus Ed25519 signature
+ * verification this project has nowhere to receive yet (no plane of this
+ * project is deployed publicly). The Gateway is Discord's own real,
+ * officially-supported answer to "no public URL."
+ */
+export declare function createDiscordAdapter(options: DiscordAdapterOptions): DiscordAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/providers/discord/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/discord/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EAEd,cAAc,EAEd,cAAc,EACd,SAAS,EACV,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAA2C,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAC/F,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAA;AASpF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAWD,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAA;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,IAAI,IAAI,IAAI,CAAA;CACb;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAkFnF"}

package/dist/providers/discord/adapter.js

@@ -0,0 +1,97 @@
+import { CogentaError } from '@cogenta/core';
+import { createDiscordClient } from './client.js';
+import { createDiscordGatewayClient } from './gateway.js';
+import { createDiscordInboundHandler } from './inbound.js';
+import { renderDiscordMessage } from './render.js';
+const CHANNEL_NAME = 'discord';
+/** `GUILD_MESSAGES | MESSAGE_CONTENT` — the minimum needed to read `MESSAGE_CREATE.content`; no more requested than this adapter actually uses. */
+const DEFAULT_INTENTS = (1 << 9) | (1 << 15);
+function isDiscordLinkProof(proof) {
+    return (typeof proof === 'object' &&
+        proof !== null &&
+        typeof proof.code === 'string' &&
+        typeof proof.channelUserId === 'string');
+}
+/**
+ * "Adaptateur Discord." The Gateway (a persistent WebSocket), not the
+ * Interactions Endpoint URL webhook — Discord offers no polling REST
+ * alternative for real-time messages (unlike Telegram's `getUpdates`), and
+ * the webhook path needs a public HTTPS endpoint plus Ed25519 signature
+ * verification this project has nowhere to receive yet (no plane of this
+ * project is deployed publicly). The Gateway is Discord's own real,
+ * officially-supported answer to "no public URL."
+ */
+export function createDiscordAdapter(options) {
+    const client = createDiscordClient(options);
+    const gateway = options.gatewayClient ??
+        createDiscordGatewayClient({
+            token: options.botToken,
+            intents: options.intents ?? DEFAULT_INTENTS,
+        });
+    let inboundHandler;
+    const handleDispatch = createDiscordInboundHandler({
+        client,
+        linkStore: options.linkStore,
+        router: options.router,
+        getExternalHandler: () => inboundHandler,
+    });
+    return {
+        name: CHANNEL_NAME,
+        capabilities: {
+            richText: true,
+            buttons: true,
+            threads: false,
+            attachments: false,
+            inbound: true,
+        },
+        async send(target, message) {
+            const rendered = renderDiscordMessage(message);
+            const sent = await client.sendMessage({
+                channelId: target.id,
+                ...(rendered.content === undefined ? {} : { content: rendered.content }),
+                ...(rendered.embeds.length > 0 ? { embeds: rendered.embeds } : {}),
+                ...(rendered.components.length > 0 ? { components: rendered.components } : {}),
+            });
+            return `${sent.channelId}:${sent.messageId}`;
+        },
+        async update(id, message) {
+            const [channelId, messageId] = id.split(':');
+            if (channelId === undefined || messageId === undefined) {
+                throw new CogentaError({
+                    code: 'CHANNEL_DISCORD_API_ERROR',
+                    message: `"${id}" is not a message id this adapter produced.`,
+                    hint: "Only pass a MessageId returned by this adapter's own send() to update().",
+                });
+            }
+            const rendered = renderDiscordMessage(message);
+            await client.updateMessage({
+                channelId,
+                messageId,
+                ...(rendered.content === undefined ? {} : { content: rendered.content }),
+                ...(rendered.embeds.length > 0 ? { embeds: rendered.embeds } : {}),
+                ...(rendered.components.length > 0 ? { components: rendered.components } : {}),
+            });
+        },
+        onInbound(handler) {
+            inboundHandler = handler;
+        },
+        async verifyIdentity(proof) {
+            if (!isDiscordLinkProof(proof)) {
+                throw new CogentaError({
+                    code: 'CHANNEL_DISCORD_API_ERROR',
+                    message: 'Discord identity proof must be { code, channelUserId }.',
+                    hint: 'Pass the linking code submitted in the channel and the Discord user id it came from.',
+                });
+            }
+            await options.linkStore.verifyCode(proof.code, CHANNEL_NAME, proof.channelUserId);
+            return options.linkStore.resolveIdentity(CHANNEL_NAME, proof.channelUserId);
+        },
+        async start() {
+            await gateway.connect(handleDispatch);
+        },
+        stop() {
+            gateway.disconnect();
+        },
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/providers/discord/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/discord/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAW5C,OAAO,EAAE,mBAAmB,EAAgD,MAAM,aAAa,CAAA;AAC/F,OAAO,EAAE,0BAA0B,EAA6B,MAAM,cAAc,CAAA;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAA;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,YAAY,GAAG,SAAS,CAAA;AAE9B,mJAAmJ;AACnJ,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;AAO5C,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAmC,CAAC,IAAI,KAAK,QAAQ;QAC7D,OAAQ,KAAmC,CAAC,aAAa,KAAK,QAAQ,CACvE,CAAA;AACH,CAAC;AAsBD;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,MAAM,MAAM,GAAkB,mBAAmB,CAAC,OAAO,CAAC,CAAA;IAC1D,MAAM,OAAO,GACX,OAAO,CAAC,aAAa;QACrB,0BAA0B,CAAC;YACzB,KAAK,EAAE,OAAO,CAAC,QAAQ;YACvB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe;SAC5C,CAAC,CAAA;IAEJ,IAAI,cAA0C,CAAA;IAE9C,MAAM,cAAc,GAAG,2BAA2B,CAAC;QACjD,MAAM;QACN,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,kBAAkB,EAAE,GAAG,EAAE,CAAC,cAAc;KACzC,CAAC,CAAA;IAEF,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE;YACZ,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,KAAK;YAClB,OAAO,EAAE,IAAI;SACd;QAED,KAAK,CAAC,IAAI,CAAC,MAAqB,EAAE,OAAuB;YACvD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAA;YAC9C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;gBACpC,SAAS,EAAE,MAAM,CAAC,EAAE;gBACpB,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACxE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/E,CAAC,CAAA;YACF,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,CAAA;QAC9C,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAa,EAAE,OAAuB;YACjD,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAC5C,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBACvD,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,2BAA2B;oBACjC,OAAO,EAAE,IAAI,EAAE,8CAA8C;oBAC7D,IAAI,EAAE,0EAA0E;iBACjF,CAAC,CAAA;YACJ,CAAC;YACD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAA;YAC9C,MAAM,MAAM,CAAC,aAAa,CAAC;gBACzB,SAAS;gBACT,SAAS;gBACT,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACxE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/E,CAAC,CAAA;QACJ,CAAC;QAED,SAAS,CAAC,OAAuB;YAC/B,cAAc,GAAG,OAAO,CAAA;QAC1B,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,KAAc;YACjC,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,2BAA2B;oBACjC,OAAO,EAAE,yDAAyD;oBAClE,IAAI,EAAE,sFAAsF;iBAC7F,CAAC,CAAA;YACJ,CAAC;YACD,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;YACjF,OAAO,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,YAAY,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;QAC7E,CAAC;QAED,KAAK,CAAC,KAAK;YACT,MAAM,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;QACvC,CAAC;QAED,IAAI;YACF,OAAO,CAAC,UAAU,EAAE,CAAA;QACtB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/providers/discord/client.d.ts

@@ -0,0 +1,67 @@
+/**
+ * A minimal, hand-typed client for the Discord REST methods this adapter
+ * needs to send/edit a message and acknowledge a component interaction —
+ * plain HTTPS/JSON, same zero-dependency reasoning as
+ * `providers/telegram/client.ts` and `providers/slack/client.ts`.
+ */
+export interface DiscordEmbedField {
+    readonly name: string;
+    readonly value: string;
+    readonly inline?: boolean;
+}
+export interface DiscordEmbed {
+    readonly title?: string;
+    readonly description?: string;
+    readonly url?: string;
+    readonly color?: number;
+    readonly fields?: readonly DiscordEmbedField[];
+}
+export interface DiscordButtonComponent {
+    readonly type: 2;
+    readonly style: 1;
+    readonly label: string;
+    readonly custom_id: string;
+}
+export interface DiscordActionRow {
+    readonly type: 1;
+    readonly components: readonly DiscordButtonComponent[];
+}
+export interface DiscordSendMessageParams {
+    readonly channelId: string;
+    readonly content?: string;
+    readonly embeds?: readonly DiscordEmbed[];
+    readonly components?: readonly DiscordActionRow[];
+}
+export interface DiscordUpdateMessageParams {
+    readonly channelId: string;
+    readonly messageId: string;
+    readonly content?: string;
+    readonly embeds?: readonly DiscordEmbed[];
+    readonly components?: readonly DiscordActionRow[];
+}
+export interface DiscordMessageResult {
+    readonly channelId: string;
+    readonly messageId: string;
+}
+export interface DiscordClientConfig {
+    readonly botToken: string;
+    /** Overridable for tests; defaults to the real Discord API host. */
+    readonly baseUrl?: string;
+    readonly fetchImpl?: typeof fetch;
+    /** Overridable for tests, so a 429 retry doesn't really wait. */
+    readonly sleepImpl?: (ms: number) => Promise<void>;
+}
+export interface DiscordClient {
+    sendMessage(params: DiscordSendMessageParams): Promise<DiscordMessageResult>;
+    updateMessage(params: DiscordUpdateMessageParams): Promise<void>;
+    /**
+     * Discord requires an interaction be acknowledged within 3 seconds or the
+     * component shows "This interaction failed" to the user — a deferred
+     * update (type 6, `DEFERRED_UPDATE_MESSAGE`) acks with no visible change;
+     * any real reply this adapter needs to send goes through a normal
+     * `sendMessage` call afterwards, same shape as Telegram/Slack's reply flow.
+     */
+    acknowledgeInteraction(interactionId: string, interactionToken: string): Promise<void>;
+}
+export declare function createDiscordClient(config: DiscordClientConfig): DiscordClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/providers/discord/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/providers/discord/client.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAC/C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAChB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAChB,QAAQ,CAAC,UAAU,EAAE,SAAS,sBAAsB,EAAE,CAAA;CACvD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAClD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAClD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAkBD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACjC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACnD;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAC5E,aAAa,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE;;;;;;OAMG;IACH,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvF;AASD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAkF9E"}

package/dist/providers/discord/client.js

@@ -0,0 +1,65 @@
+import { CogentaError } from '@cogenta/core';
+const DEFAULT_BASE_URL = 'https://discord.com/api/v10';
+const DEFERRED_UPDATE_MESSAGE = 6;
+function defaultSleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export function createDiscordClient(config) {
+    const baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+    const fetchImpl = config.fetchImpl ?? fetch;
+    const sleepImpl = config.sleepImpl ?? defaultSleep;
+    async function call(method, path, body, expectBody = true) {
+        for (;;) {
+            const response = await fetchImpl(`${baseUrl}${path}`, {
+                method,
+                headers: {
+                    'content-type': 'application/json',
+                    authorization: `Bot ${config.botToken}`,
+                },
+                ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+            });
+            if (response.status === 429) {
+                const rateLimit = (await response.json());
+                const retryAfterSeconds = Number.isFinite(rateLimit.retry_after) ? rateLimit.retry_after : 1;
+                await sleepImpl(retryAfterSeconds * 1000);
+                continue;
+            }
+            if (!response.ok) {
+                const error = (await response.json());
+                throw new CogentaError({
+                    code: 'CHANNEL_DISCORD_API_ERROR',
+                    message: `Discord API call "${method} ${path}" failed: ${error.message}`,
+                    hint: 'Check the bot token, that it was invited to the guild, and that the channel/message this call references still exists.',
+                    details: { method, path, discordCode: error.code, error: error.message },
+                });
+            }
+            if (!expectBody)
+                return undefined;
+            return (await response.json());
+        }
+    }
+    return {
+        async sendMessage(params) {
+            const result = await call('POST', `/channels/${params.channelId}/messages`, {
+                content: params.content,
+                embeds: params.embeds,
+                components: params.components,
+            });
+            if (result === undefined) {
+                throw new CogentaError({
+                    code: 'CHANNEL_DISCORD_API_ERROR',
+                    message: 'Discord did not return the sent message.',
+                    hint: 'This should not happen — the send-message endpoint always returns the created message.',
+                });
+            }
+            return { channelId: result.channel_id, messageId: result.id };
+        },
+        async updateMessage(params) {
+            await call('PATCH', `/channels/${params.channelId}/messages/${params.messageId}`, { content: params.content, embeds: params.embeds, components: params.components }, false);
+        },
+        async acknowledgeInteraction(interactionId, interactionToken) {
+            await call('POST', `/interactions/${interactionId}/${interactionToken}/callback`, { type: DEFERRED_UPDATE_MESSAGE }, false);
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/providers/discord/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/providers/discord/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AA6F5C,MAAM,gBAAgB,GAAG,6BAA6B,CAAA;AACtD,MAAM,uBAAuB,GAAG,CAAC,CAAA;AAEjC,SAAS,YAAY,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAA2B;IAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAA;IAClD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,CAAA;IAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,YAAY,CAAA;IAElD,KAAK,UAAU,IAAI,CACjB,MAAc,EACd,IAAY,EACZ,IAAc,EACd,UAAU,GAAG,IAAI;QAEjB,SAAS,CAAC;YACR,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,OAAO,GAAG,IAAI,EAAE,EAAE;gBACpD,MAAM;gBACN,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,OAAO,MAAM,CAAC,QAAQ,EAAE;iBACxC;gBACD,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;aAC9D,CAAC,CAAA;YAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA6B,CAAA;gBACrE,MAAM,iBAAiB,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC5F,MAAM,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;gBACzC,SAAQ;YACV,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyB,CAAA;gBAC7D,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,2BAA2B;oBACjC,OAAO,EAAE,qBAAqB,MAAM,IAAI,IAAI,aAAa,KAAK,CAAC,OAAO,EAAE;oBACxE,IAAI,EAAE,wHAAwH;oBAC9H,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE;iBACzE,CAAC,CAAA;YACJ,CAAC;YAED,IAAI,CAAC,UAAU;gBAAE,OAAO,SAAS,CAAA;YACjC,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAA;QACrC,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,CAAC,WAAW,CAAC,MAAM;YACtB,MAAM,MAAM,GAAG,MAAM,IAAI,CACvB,MAAM,EACN,aAAa,MAAM,CAAC,SAAS,WAAW,EACxC;gBACE,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CACF,CAAA;YACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,2BAA2B;oBACjC,OAAO,EAAE,0CAA0C;oBACnD,IAAI,EAAE,wFAAwF;iBAC/F,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,CAAA;QAC/D,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,MAAM;YACxB,MAAM,IAAI,CACR,OAAO,EACP,aAAa,MAAM,CAAC,SAAS,aAAa,MAAM,CAAC,SAAS,EAAE,EAC5D,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,EACjF,KAAK,CACN,CAAA;QACH,CAAC;QAED,KAAK,CAAC,sBAAsB,CAAC,aAAa,EAAE,gBAAgB;YAC1D,MAAM,IAAI,CACR,MAAM,EACN,iBAAiB,aAAa,IAAI,gBAAgB,WAAW,EAC7D,EAAE,IAAI,EAAE,uBAAuB,EAAE,EACjC,KAAK,CACN,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/providers/discord/gateway.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Discord's real-time Gateway — a persistent WebSocket, the only real
+ * mechanism for a bot with no public HTTPS endpoint to receive messages and
+ * interactions (unlike Telegram, Discord has no polling REST alternative;
+ * the alternative, an "Interactions Endpoint URL" webhook, needs a public
+ * HTTPS endpoint plus Ed25519 signature verification — the same "no public
+ * plane deployed" problem `providers/telegram/adapter.ts` and
+ * `providers/slack/socket.ts` already resolved by choosing a persistent
+ * outbound connection). Node's built-in `WebSocket` global (stable since
+ * Node 22, this package's minimum) means no dependency is needed here
+ * either.
+ *
+ * Unlike Slack's Socket Mode (an envelope arrives, you ack it — no other
+ * protocol state), the Gateway requires real heartbeating: on `HELLO` (op
+ * 10) the server names a `heartbeat_interval`, and the client must send a
+ * `HEARTBEAT` (op 1) on that cadence or get disconnected. `scheduleHeartbeat`
+ * is injected (defaulting to real `setInterval`) specifically so a test can
+ * capture the interval and the send callback and invoke it manually —
+ * deterministic, no real timers, same spirit as this codebase's injectable
+ * clocks elsewhere (`runAgentLoop`'s `now()`) but shaped for a recurring
+ * schedule rather than an elapsed-duration check.
+ *
+ * Session resumption (op 6 `RESUME`) is not implemented — a lost connection
+ * reconnects fresh with a new `IDENTIFY`, exactly like Telegram's poll loop
+ * and Slack's Socket Mode reconnect both start clean rather than resuming
+ * mid-stream. Real, honest, and proportionate: resumption exists to avoid
+ * re-fetching guild state after a brief blip, which this adapter (no guild
+ * cache) has no use for.
+ */
+export interface DiscordGatewayPayload {
+    readonly op: number;
+    readonly d?: unknown;
+    readonly s?: number | null;
+    readonly t?: string | null;
+}
+export interface DiscordDispatchEvent {
+    readonly type: string;
+    readonly data: unknown;
+}
+export interface DiscordGatewayClientConfig {
+    readonly token: string;
+    readonly intents: number;
+    /** Overridable for tests; defaults to the real Discord Gateway. */
+    readonly gatewayUrl?: string;
+    readonly webSocketImpl?: typeof WebSocket;
+    /** Overridable for tests — real default uses `setInterval`/`clearInterval`. */
+    readonly scheduleHeartbeat?: (intervalMs: number, send: () => void) => () => void;
+}
+export interface DiscordGatewayClient {
+    /** Opens the connection and delivers every dispatch event. Resolves once `READY` (or the first dispatch) confirms the session is live. */
+    connect(onDispatch: (event: DiscordDispatchEvent) => Promise<void>): Promise<void>;
+    disconnect(): void;
+}
+export declare function createDiscordGatewayClient(config: DiscordGatewayClientConfig): DiscordGatewayClient;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/providers/discord/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../../src/providers/discord/gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AASH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,SAAS,CAAA;IACzC,+EAA+E;IAC/E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;CAClF;AAED,MAAM,WAAW,oBAAoB;IACnC,0IAA0I;IAC1I,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClF,UAAU,IAAI,IAAI,CAAA;CACnB;AASD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,0BAA0B,GACjC,oBAAoB,CAsFtB"}

package/dist/providers/discord/gateway.js

@@ -0,0 +1,114 @@
+/**
+ * Discord's real-time Gateway — a persistent WebSocket, the only real
+ * mechanism for a bot with no public HTTPS endpoint to receive messages and
+ * interactions (unlike Telegram, Discord has no polling REST alternative;
+ * the alternative, an "Interactions Endpoint URL" webhook, needs a public
+ * HTTPS endpoint plus Ed25519 signature verification — the same "no public
+ * plane deployed" problem `providers/telegram/adapter.ts` and
+ * `providers/slack/socket.ts` already resolved by choosing a persistent
+ * outbound connection). Node's built-in `WebSocket` global (stable since
+ * Node 22, this package's minimum) means no dependency is needed here
+ * either.
+ *
+ * Unlike Slack's Socket Mode (an envelope arrives, you ack it — no other
+ * protocol state), the Gateway requires real heartbeating: on `HELLO` (op
+ * 10) the server names a `heartbeat_interval`, and the client must send a
+ * `HEARTBEAT` (op 1) on that cadence or get disconnected. `scheduleHeartbeat`
+ * is injected (defaulting to real `setInterval`) specifically so a test can
+ * capture the interval and the send callback and invoke it manually —
+ * deterministic, no real timers, same spirit as this codebase's injectable
+ * clocks elsewhere (`runAgentLoop`'s `now()`) but shaped for a recurring
+ * schedule rather than an elapsed-duration check.
+ *
+ * Session resumption (op 6 `RESUME`) is not implemented — a lost connection
+ * reconnects fresh with a new `IDENTIFY`, exactly like Telegram's poll loop
+ * and Slack's Socket Mode reconnect both start clean rather than resuming
+ * mid-stream. Real, honest, and proportionate: resumption exists to avoid
+ * re-fetching guild state after a brief blip, which this adapter (no guild
+ * cache) has no use for.
+ */
+const OP_DISPATCH = 0;
+const OP_HEARTBEAT = 1;
+const OP_IDENTIFY = 2;
+const OP_RECONNECT = 7;
+const OP_INVALID_SESSION = 9;
+const OP_HELLO = 10;
+const DEFAULT_GATEWAY_URL = 'wss://gateway.discord.gg/?v=10&encoding=json';
+function defaultScheduleHeartbeat(intervalMs, send) {
+    const id = setInterval(send, intervalMs);
+    return () => clearInterval(id);
+}
+export function createDiscordGatewayClient(config) {
+    const gatewayUrl = config.gatewayUrl ?? DEFAULT_GATEWAY_URL;
+    const WebSocketImpl = config.webSocketImpl ?? WebSocket;
+    const scheduleHeartbeat = config.scheduleHeartbeat ?? defaultScheduleHeartbeat;
+    let socket;
+    let stopHeartbeat;
+    let lastSequence = null;
+    let connected = false;
+    function send(payload) {
+        socket?.send(JSON.stringify(payload));
+    }
+    function identify() {
+        send({
+            op: OP_IDENTIFY,
+            d: {
+                token: config.token,
+                intents: config.intents,
+                properties: { os: 'linux', browser: 'cogenta', device: 'cogenta' },
+            },
+        });
+    }
+    async function openSocket(onDispatch) {
+        const ws = new WebSocketImpl(gatewayUrl);
+        socket = ws;
+        await new Promise((resolve, reject) => {
+            ws.addEventListener('open', () => resolve());
+            ws.addEventListener('error', () => reject(new Error('Discord Gateway connection failed to open.')));
+        });
+        ws.addEventListener('close', () => {
+            stopHeartbeat?.();
+            stopHeartbeat = undefined;
+            if (connected)
+                void openSocket(onDispatch);
+        });
+        ws.addEventListener('message', (event) => {
+            const raw = typeof event.data === 'string' ? event.data : String(event.data);
+            const payload = JSON.parse(raw);
+            if (payload.s !== undefined && payload.s !== null)
+                lastSequence = payload.s;
+            void (async () => {
+                if (payload.op === OP_HELLO) {
+                    const hello = payload.d;
+                    stopHeartbeat?.();
+                    stopHeartbeat = scheduleHeartbeat(hello.heartbeat_interval, () => {
+                        send({ op: OP_HEARTBEAT, d: lastSequence });
+                    });
+                    identify();
+                    return;
+                }
+                if (payload.op === OP_RECONNECT || payload.op === OP_INVALID_SESSION) {
+                    ws.close();
+                    return;
+                }
+                if (payload.op === OP_DISPATCH && payload.t !== null && payload.t !== undefined) {
+                    await onDispatch({ type: payload.t, data: payload.d });
+                }
+            })();
+        });
+    }
+    return {
+        async connect(onDispatch) {
+            connected = true;
+            await openSocket(onDispatch);
+        },
+        disconnect() {
+            connected = false;
+            stopHeartbeat?.();
+            stopHeartbeat = undefined;
+            socket?.close();
+            socket = undefined;
+        },
+    };
+}
+//# sourceMappingURL=gateway.js.map

package/dist/providers/discord/gateway.js.map

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

package/dist/providers/discord/inbound.d.ts

@@ -0,0 +1,22 @@
+import type { InboundHandler } from '../../adapter.js';
+import type { CommandRouter } from '../../inbound/router.js';
+import type { ChannelLinkStore } from '../../linking/store.js';
+import type { DiscordClient } from './client.js';
+import type { DiscordDispatchEvent } from './gateway.js';
+export interface DiscordInboundDeps {
+    readonly client: DiscordClient;
+    readonly linkStore: ChannelLinkStore;
+    readonly router: CommandRouter;
+    /** The handler registered via the adapter's `onInbound()`, if any. */
+    getExternalHandler(): InboundHandler | undefined;
+}
+/**
+ * The real routing/authorization wiring for one Discord dispatch event —
+ * extracted from the adapter, same shape as `providers/slack/inbound.ts`.
+ * Handles both a typed message (`MESSAGE_CREATE`) and a button press
+ * (`INTERACTION_CREATE` with `type: MESSAGE_COMPONENT`, whose `custom_id` is
+ * itself a command string rendered by `render.ts`) through the exact same
+ * `CommandRouter.route()`, never a second, parallel authorization path.
+ */
+export declare function createDiscordInboundHandler(deps: DiscordInboundDeps): (event: DiscordDispatchEvent) => Promise<void>;
+//# sourceMappingURL=inbound.d.ts.map

package/dist/providers/discord/inbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../../src/providers/discord/inbound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAqBxD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,sEAAsE;IACtE,kBAAkB,IAAI,cAAc,GAAG,SAAS,CAAA;CACjD;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,kBAAkB,GACvB,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CA+DhD"}