@cogenta/channels 0.1.0

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

@@ -0,0 +1,45 @@
+/**
+ * A minimal, hand-typed client for the two Slack Web API methods this
+ * adapter needs to send/edit a message — plain HTTPS/JSON, same
+ * zero-dependency reasoning as `providers/telegram/client.ts`.
+ */
+export interface SlackBlock {
+    readonly type: string;
+    readonly [key: string]: unknown;
+}
+export interface SlackPostMessageParams {
+    readonly channel: string;
+    readonly text: string;
+    readonly blocks?: readonly SlackBlock[];
+}
+export interface SlackUpdateMessageParams {
+    readonly channel: string;
+    readonly ts: string;
+    readonly text: string;
+    readonly blocks?: readonly SlackBlock[];
+}
+export interface SlackMessageResult {
+    readonly channel: string;
+    readonly ts: string;
+}
+export interface SlackClientConfig {
+    readonly botToken: string;
+    /** Overridable for tests; defaults to the real Slack 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 SlackClient {
+    postMessage(params: SlackPostMessageParams): Promise<SlackMessageResult>;
+    updateMessage(params: SlackUpdateMessageParams): Promise<void>;
+}
+/**
+ * Slack's rate-limit signal is an HTTP `Retry-After` header (seconds) on a
+ * 429, not a JSON body field like Telegram's `retry_after` — same "wait the
+ * value the platform actually gave us" principle either way (`## Pièges
+ * connus`: "Prévoir la file, le backoff et le regroupement dès le premier
+ * adaptateur").
+ */
+export declare function createSlackClient(config: SlackClientConfig): SlackClient;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/providers/slack/client.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;CACxC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB;AAeD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,kEAAkE;IAClE,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,WAAW;IAC1B,WAAW,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACxE,aAAa,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D;AAQD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CA6CxE"}

package/dist/providers/slack/client.js

@@ -0,0 +1,54 @@
+import { CogentaError } from '@cogenta/core';
+const DEFAULT_BASE_URL = 'https://slack.com/api';
+function defaultSleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Slack's rate-limit signal is an HTTP `Retry-After` header (seconds) on a
+ * 429, not a JSON body field like Telegram's `retry_after` — same "wait the
+ * value the platform actually gave us" principle either way (`## Pièges
+ * connus`: "Prévoir la file, le backoff et le regroupement dès le premier
+ * adaptateur").
+ */
+export function createSlackClient(config) {
+    const baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+    const fetchImpl = config.fetchImpl ?? fetch;
+    const sleepImpl = config.sleepImpl ?? defaultSleep;
+    async function call(method, body) {
+        for (;;) {
+            const response = await fetchImpl(`${baseUrl}/${method}`, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json; charset=utf-8',
+                    authorization: `Bearer ${config.botToken}`,
+                },
+                body: JSON.stringify(body),
+            });
+            if (response.status === 429) {
+                const retryAfterSeconds = Number(response.headers.get('retry-after') ?? '1');
+                await sleepImpl((Number.isFinite(retryAfterSeconds) ? retryAfterSeconds : 1) * 1000);
+                continue;
+            }
+            const json = (await response.json());
+            if (!json.ok) {
+                throw new CogentaError({
+                    code: 'CHANNEL_SLACK_API_ERROR',
+                    message: `Slack API call "${method}" failed: ${json.error}`,
+                    hint: 'Check the bot token, scopes, and that the channel this call references still exists.',
+                    details: { method, error: json.error },
+                });
+            }
+            return json;
+        }
+    }
+    return {
+        async postMessage(params) {
+            const result = await call('chat.postMessage', params);
+            return { channel: result.channel, ts: result.ts };
+        },
+        async updateMessage(params) {
+            await call('chat.update', params);
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/providers/slack/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AA0D5C,MAAM,gBAAgB,GAAG,uBAAuB,CAAA;AAEhD,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;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,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,CAAC,MAAc,EAAE,IAAa;QAC/C,SAAS,CAAC;YACR,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,OAAO,IAAI,MAAM,EAAE,EAAE;gBACvD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,iCAAiC;oBACjD,aAAa,EAAE,UAAU,MAAM,CAAC,QAAQ,EAAE;iBAC3C;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC3B,CAAC,CAAA;YAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,iBAAiB,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,CAAA;gBAC5E,MAAM,SAAS,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;gBACpF,SAAQ;YACV,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAqB,CAAA;YACxD,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACb,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,yBAAyB;oBAC/B,OAAO,EAAE,mBAAmB,MAAM,aAAa,IAAI,CAAC,KAAK,EAAE;oBAC3D,IAAI,EAAE,sFAAsF;oBAC5F,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;iBACvC,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,CAAC,WAAW,CAAC,MAAM;YACtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAA;YACrD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAA;QACnD,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,MAAM;YACxB,MAAM,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;QACnC,CAAC;KACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,23 @@
+import type { InboundHandler } from '../../adapter.js';
+import type { CommandRouter } from '../../inbound/router.js';
+import type { ChannelLinkStore } from '../../linking/store.js';
+import type { SlackClient } from './client.js';
+import type { SlackSocketEnvelope } from './socket.js';
+export interface SlackInboundDeps {
+    readonly client: SlackClient;
+    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 inbound Slack envelope —
+ * extracted from the adapter, same shape as
+ * `providers/telegram/inbound.ts`. Handles both a typed message
+ * (`events_api`) and a button press (`interactive`'s `block_actions`, whose
+ * `action_id`/`value` is itself a command string rendered by `render.ts`)
+ * through the exact same `CommandRouter.route()`, never a second, parallel
+ * authorization path.
+ */
+export declare function createSlackInboundHandler(deps: SlackInboundDeps): (envelope: SlackSocketEnvelope) => Promise<void>;
+//# sourceMappingURL=inbound.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../../src/providers/slack/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,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAsBtD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,sEAAsE;IACtE,kBAAkB,IAAI,cAAc,GAAG,SAAS,CAAA;CACjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,gBAAgB,GACrB,CAAC,QAAQ,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAqElD"}

package/dist/providers/slack/inbound.js

@@ -0,0 +1,76 @@
+const CHANNEL_NAME = 'slack';
+/**
+ * The real routing/authorization wiring for one inbound Slack envelope —
+ * extracted from the adapter, same shape as
+ * `providers/telegram/inbound.ts`. Handles both a typed message
+ * (`events_api`) and a button press (`interactive`'s `block_actions`, whose
+ * `action_id`/`value` is itself a command string rendered by `render.ts`)
+ * through the exact same `CommandRouter.route()`, never a second, parallel
+ * authorization path.
+ */
+export function createSlackInboundHandler(deps) {
+    async function resolveIdentity(channelUserId) {
+        return deps.linkStore.resolveIdentity(CHANNEL_NAME, channelUserId);
+    }
+    async function reply(channelId, text) {
+        await deps.client.postMessage({ channel: channelId, text });
+    }
+    async function handleText(channelId, channelUserId, text) {
+        let identity = await resolveIdentity(channelUserId);
+        if (identity.linkedUserId === null) {
+            // An unlinked identity gets exactly one thing to try: the message AS
+            // a linking code. Any other failure stays silent — "Une identité de
+            // canal non liée à un compte est ignorée, sans réponse."
+            try {
+                await deps.linkStore.verifyCode(text.trim(), CHANNEL_NAME, channelUserId);
+                identity = await resolveIdentity(channelUserId);
+                await reply(channelId, ':white_check_mark: Compte lié. Vous pouvez maintenant utiliser les commandes.');
+            }
+            catch {
+                // Wrong/expired/nonexistent code from an unlinked identity: silence.
+            }
+            const handler = deps.getExternalHandler();
+            if (handler !== undefined)
+                await handler({ text, identity });
+            return;
+        }
+        const handler = deps.getExternalHandler();
+        if (handler !== undefined)
+            await handler({ text, identity });
+        const result = await deps.router.route(text, identity);
+        if (!result.shouldReply)
+            return;
+        if (result.kind === 'forbidden') {
+            await reply(channelId, ":no_entry: Vous n'avez pas la permission d'exécuter cette commande.");
+        }
+        else if (result.kind === 'unrecognized') {
+            await reply(channelId, `Commande inconnue : ${result.commandName}`);
+        }
+    }
+    return async function handleEnvelope(envelope) {
+        if (envelope.type === 'events_api') {
+            const payload = envelope.payload;
+            const event = payload?.event;
+            if (event?.type === 'message' &&
+                event.bot_id === undefined &&
+                event.text !== undefined &&
+                event.user !== undefined &&
+                event.channel !== undefined) {
+                await handleText(event.channel, event.user, event.text);
+            }
+            return;
+        }
+        if (envelope.type === 'interactive') {
+            const payload = envelope.payload;
+            if (payload?.type !== 'block_actions')
+                return;
+            const channelId = payload.channel?.id;
+            const channelUserId = payload.user.id;
+            const action = payload.actions[0];
+            if (channelId === undefined || action?.action_id === undefined)
+                return;
+            await handleText(channelId, channelUserId, action.value ?? action.action_id);
+        }
+    };
+}
+//# sourceMappingURL=inbound.js.map

package/dist/providers/slack/inbound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.js","sourceRoot":"","sources":["../../../src/providers/slack/inbound.ts"],"names":[],"mappings":"AAMA,MAAM,YAAY,GAAG,OAAO,CAAA;AA4B5B;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAsB;IAEtB,KAAK,UAAU,eAAe,CAAC,aAAqB;QAClD,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,YAAY,EAAE,aAAa,CAAC,CAAA;IACpE,CAAC;IAED,KAAK,UAAU,KAAK,CAAC,SAAiB,EAAE,IAAY;QAClD,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED,KAAK,UAAU,UAAU,CAAC,SAAiB,EAAE,aAAqB,EAAE,IAAY;QAC9E,IAAI,QAAQ,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,CAAA;QAEnD,IAAI,QAAQ,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YACnC,qEAAqE;YACrE,oEAAoE;YACpE,yDAAyD;YACzD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,aAAa,CAAC,CAAA;gBACzE,QAAQ,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,CAAA;gBAC/C,MAAM,KAAK,CACT,SAAS,EACT,+EAA+E,CAChF,CAAA;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;YACvE,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAA;YACzC,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;YAC5D,OAAM;QACR,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAA;QACzC,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;QAE5D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QACtD,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAM;QAC/B,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,MAAM,KAAK,CAAC,SAAS,EAAE,qEAAqE,CAAC,CAAA;QAC/F,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC1C,MAAM,KAAK,CAAC,SAAS,EAAE,uBAAuB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;IAED,OAAO,KAAK,UAAU,cAAc,CAAC,QAA6B;QAChE,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAA4C,CAAA;YACrE,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,CAAA;YAC5B,IACE,KAAK,EAAE,IAAI,KAAK,SAAS;gBACzB,KAAK,CAAC,MAAM,KAAK,SAAS;gBAC1B,KAAK,CAAC,IAAI,KAAK,SAAS;gBACxB,KAAK,CAAC,IAAI,KAAK,SAAS;gBACxB,KAAK,CAAC,OAAO,KAAK,SAAS,EAC3B,CAAC;gBACD,MAAM,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YACzD,CAAC;YACD,OAAM;QACR,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAA+C,CAAA;YACxE,IAAI,OAAO,EAAE,IAAI,KAAK,eAAe;gBAAE,OAAM;YAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAA;YACrC,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAA;YACrC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;YACjC,IAAI,SAAS,KAAK,SAAS,IAAI,MAAM,EAAE,SAAS,KAAK,SAAS;gBAAE,OAAM;YACtE,MAAM,UAAU,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,SAAS,CAAC,CAAA;QAC9E,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/providers/slack/render.d.ts

@@ -0,0 +1,8 @@
+import type { ChannelMessage } from '../../adapter.js';
+import type { SlackBlock } from './client.js';
+export interface RenderedSlackMessage {
+    readonly text: string;
+    readonly blocks: readonly SlackBlock[];
+}
+export declare function renderSlackMessage(message: ChannelMessage): RenderedSlackMessage;
+//# sourceMappingURL=render.d.ts.map

package/dist/providers/slack/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/providers/slack/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAmB,MAAM,kBAAkB,CAAA;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AA8B7C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAA;CACvC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,oBAAoB,CA8ChF"}

package/dist/providers/slack/render.js

@@ -0,0 +1,72 @@
+/**
+ * "On n'écrit pas de Markdown Telegram dans le code métier" applies just as
+ * much to Slack's own Block Kit format — everything platform-specific lives
+ * in this module, `ChannelMessage` never knows Block Kit exists.
+ */
+const SEVERITY_PREFIX = {
+    info: ':information_source:',
+    warning: ':warning:',
+    critical: ':red_circle:',
+};
+function renderActionsBlock(actions) {
+    if (actions === undefined || actions.length === 0)
+        return undefined;
+    return {
+        type: 'actions',
+        elements: actions.map((action) => ({
+            type: 'button',
+            text: { type: 'plain_text', text: action.label },
+            // `value` is the command text a button press routes as (mirrors
+            // Telegram's `callback_data`) — the same `CommandRouter.route()`,
+            // never a second, parallel authorization path.
+            value: action.id,
+            action_id: action.id,
+        })),
+    };
+}
+export function renderSlackMessage(message) {
+    if (message.level === 'notification') {
+        return { text: message.text, blocks: [] };
+    }
+    if (message.level === 'alert') {
+        const prefix = SEVERITY_PREFIX[message.severity];
+        const blocks = [
+            { type: 'section', text: { type: 'mrkdwn', text: `${prefix} *${message.title}*` } },
+            { type: 'section', text: { type: 'mrkdwn', text: message.context } },
+            { type: 'section', text: { type: 'mrkdwn', text: `➡️ ${message.expectedAction}` } },
+            {
+                type: 'section',
+                text: { type: 'mrkdwn', text: `<${message.adminUrl}|Voir dans l'admin>` },
+            },
+        ];
+        const actionsBlock = renderActionsBlock(message.actions);
+        if (actionsBlock !== undefined)
+            blocks.push(actionsBlock);
+        return { text: `${prefix} ${message.title}`, blocks };
+    }
+    // 'report'
+    const blocks = [
+        { type: 'header', text: { type: 'plain_text', text: message.title } },
+    ];
+    if (message.keyFigures.length > 0) {
+        blocks.push({
+            type: 'section',
+            text: {
+                type: 'mrkdwn',
+                text: message.keyFigures.map((figure) => `*${figure.value}* ${figure.label}`).join('   '),
+            },
+        });
+    }
+    for (const section of message.sections) {
+        const text = section.heading === undefined ? section.body : `*${section.heading}*\n${section.body}`;
+        blocks.push({ type: 'section', text: { type: 'mrkdwn', text } });
+    }
+    if (message.moreUrl !== undefined) {
+        blocks.push({
+            type: 'section',
+            text: { type: 'mrkdwn', text: `<${message.moreUrl}|Voir le détail>` },
+        });
+    }
+    return { text: message.title, blocks };
+}
+//# sourceMappingURL=render.js.map

package/dist/providers/slack/render.js.map

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

package/dist/providers/slack/socket.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Socket Mode, not a webhook — Slack's own equivalent of Telegram's
+ * long-polling choice (`providers/telegram/adapter.ts`): a persistent
+ * outbound WebSocket connection to Slack, no public HTTPS endpoint or
+ * request-signature verification to half-build, works unchanged wherever
+ * `cogenta serve` already runs. Node's built-in `WebSocket` global (stable
+ * since Node 22, this package's minimum) means no dependency is needed for
+ * the transport itself.
+ */
+export interface SlackSocketEnvelope {
+    readonly type: string;
+    readonly envelope_id?: string;
+    readonly payload?: unknown;
+    readonly reason?: string;
+}
+export interface SlackSocketClientConfig {
+    readonly appToken: string;
+    readonly baseUrl?: string;
+    readonly fetchImpl?: typeof fetch;
+    /** Defaults to the global `WebSocket` (Node's built-in implementation). */
+    readonly webSocketImpl?: typeof WebSocket;
+}
+export interface SlackSocketClient {
+    /** Opens the connection and delivers every envelope Slack sends; acks each one automatically once `onEnvelope` resolves. Resolves once the initial connection is established. */
+    connect(onEnvelope: (envelope: SlackSocketEnvelope) => Promise<void>): Promise<void>;
+    disconnect(): void;
+}
+/**
+ * A `disconnect` envelope (`reason: 'refresh_requested' | 'warning' | ...`)
+ * means Slack is about to close this socket — reconnect once, exactly like
+ * Telegram's poll loop keeps calling `getUpdates` while `polling` is true.
+ */
+export declare function createSlackSocketClient(config: SlackSocketClientConfig): SlackSocketClient;
+//# sourceMappingURL=socket.d.ts.map

package/dist/providers/slack/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../src/providers/slack/socket.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,SAAS,CAAA;CAC1C;AAED,MAAM,WAAW,iBAAiB;IAChC,iLAAiL;IACjL,OAAO,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpF,UAAU,IAAI,IAAI,CAAA;CACnB;AAgCD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAsD1F"}

package/dist/providers/slack/socket.js

@@ -0,0 +1,70 @@
+import { CogentaError } from '@cogenta/core';
+const DEFAULT_BASE_URL = 'https://slack.com/api';
+async function openConnection(fetchImpl, baseUrl, appToken) {
+    const response = await fetchImpl(`${baseUrl}/apps.connections.open`, {
+        method: 'POST',
+        headers: { authorization: `Bearer ${appToken}` },
+    });
+    const json = (await response.json());
+    if (!json.ok) {
+        throw new CogentaError({
+            code: 'CHANNEL_SLACK_API_ERROR',
+            message: `Slack Socket Mode connection failed: ${json.error}`,
+            hint: 'Check the app-level token (xapp-...) has the connections:write scope.',
+            details: { error: json.error },
+        });
+    }
+    return json.url;
+}
+/**
+ * A `disconnect` envelope (`reason: 'refresh_requested' | 'warning' | ...`)
+ * means Slack is about to close this socket — reconnect once, exactly like
+ * Telegram's poll loop keeps calling `getUpdates` while `polling` is true.
+ */
+export function createSlackSocketClient(config) {
+    const baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+    const fetchImpl = config.fetchImpl ?? fetch;
+    const WebSocketImpl = config.webSocketImpl ?? WebSocket;
+    let socket;
+    let connected = false;
+    function ack(envelopeId) {
+        if (envelopeId === undefined || socket === undefined)
+            return;
+        socket.send(JSON.stringify({ envelope_id: envelopeId }));
+    }
+    async function openSocket(onEnvelope) {
+        const url = await openConnection(fetchImpl, baseUrl, config.appToken);
+        const ws = new WebSocketImpl(url);
+        socket = ws;
+        await new Promise((resolve, reject) => {
+            ws.addEventListener('open', () => resolve());
+            ws.addEventListener('error', () => reject(new Error('Slack Socket Mode connection failed to open.')));
+        });
+        ws.addEventListener('message', (event) => {
+            const raw = typeof event.data === 'string' ? event.data : String(event.data);
+            const envelope = JSON.parse(raw);
+            void (async () => {
+                if (envelope.type === 'disconnect') {
+                    ws.close();
+                    if (connected)
+                        await openSocket(onEnvelope);
+                    return;
+                }
+                await onEnvelope(envelope);
+                ack(envelope.envelope_id);
+            })();
+        });
+    }
+    return {
+        async connect(onEnvelope) {
+            connected = true;
+            await openSocket(onEnvelope);
+        },
+        disconnect() {
+            connected = false;
+            socket?.close();
+            socket = undefined;
+        },
+    };
+}
+//# sourceMappingURL=socket.js.map

package/dist/providers/slack/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../../src/providers/slack/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAiC5C,MAAM,gBAAgB,GAAG,uBAAuB,CAAA;AAOhD,KAAK,UAAU,cAAc,CAC3B,SAAuB,EACvB,OAAe,EACf,QAAgB;IAEhB,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,OAAO,wBAAwB,EAAE;QACnE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,QAAQ,EAAE,EAAE;KACjD,CAAC,CAAA;IACF,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAEe,CAAA;IAClD,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,wCAAwC,IAAI,CAAC,KAAK,EAAE;YAC7D,IAAI,EAAE,uEAAuE;YAC7E,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;SAC/B,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAA;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA+B;IACrE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAA;IAClD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,CAAA;IAC3C,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,SAAS,CAAA;IAEvD,IAAI,MAA6B,CAAA;IACjC,IAAI,SAAS,GAAG,KAAK,CAAA;IAErB,SAAS,GAAG,CAAC,UAA8B;QACzC,IAAI,UAAU,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;YAAE,OAAM;QAC5D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;IAC1D,CAAC;IAED,KAAK,UAAU,UAAU,CACvB,UAA4D;QAE5D,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;QACrE,MAAM,EAAE,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAA;QACjC,MAAM,GAAG,EAAE,CAAA;QAEX,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;YAC5C,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAChC,MAAM,CAAC,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC,CAClE,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YACvC,MAAM,GAAG,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAA;YACvD,KAAK,CAAC,KAAK,IAAI,EAAE;gBACf,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBACnC,EAAE,CAAC,KAAK,EAAE,CAAA;oBACV,IAAI,SAAS;wBAAE,MAAM,UAAU,CAAC,UAAU,CAAC,CAAA;oBAC3C,OAAM;gBACR,CAAC;gBACD,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAA;gBAC1B,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;YAC3B,CAAC,CAAC,EAAE,CAAA;QACN,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,UAAU;YACtB,SAAS,GAAG,IAAI,CAAA;YAChB,MAAM,UAAU,CAAC,UAAU,CAAC,CAAA;QAC9B,CAAC;QAED,UAAU;YACR,SAAS,GAAG,KAAK,CAAA;YACjB,MAAM,EAAE,KAAK,EAAE,CAAA;YACf,MAAM,GAAG,SAAS,CAAA;QACpB,CAAC;KACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,35 @@
+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 TelegramClientConfig } from './client.js';
+export interface TelegramLinkProof {
+    readonly code: string;
+    readonly channelUserId: string;
+}
+export interface TelegramAdapterOptions extends TelegramClientConfig {
+    readonly linkStore: ChannelLinkStore;
+    readonly router: CommandRouter;
+    readonly pollTimeoutSeconds?: number;
+}
+/**
+ * A live channel adapter beyond the generic interface: `start()`/`stop()`
+ * manage the long-polling loop, which has no counterpart in `ChannelAdapter`
+ * (a webhook-based provider would have no need for it) — platform-specific
+ * lifecycle concerns live on the concrete adapter, not the shared interface.
+ */
+export interface TelegramAdapter extends ChannelAdapter {
+    update(id: MessageId, message: ChannelMessage): Promise<void>;
+    onInbound(handler: InboundHandler): void;
+    start(): void;
+    stop(): Promise<void>;
+}
+/**
+ * "Telegram en premier, complet." Long-polling (`getUpdates`), not a
+ * webhook: a webhook needs a real public HTTPS endpoint and Telegram's own
+ * `X-Telegram-Bot-Api-Secret-Token` signature verification, and no plane of
+ * this project is deployed publicly yet (L9 task 12's scoping). Polling
+ * works unchanged wherever `cogenta serve` already runs — locally, on a
+ * VPS, in CI — with no exposure and no signing infrastructure to half-build.
+ */
+export declare function createTelegramAdapter(options: TelegramAdapterOptions): TelegramAdapter;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/telegram/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,EAA6C,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAOlG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAWD,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CACrC;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IAGrD,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,IAAI,CAAA;IACb,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAgGtF"}

package/dist/providers/telegram/adapter.js

@@ -0,0 +1,109 @@
+import { CogentaError } from '@cogenta/core';
+import { createTelegramClient } from './client.js';
+import { createTelegramInboundHandler } from './inbound.js';
+import { renderTelegramMessage } from './render.js';
+const CHANNEL_NAME = 'telegram';
+const DEFAULT_POLL_TIMEOUT_SECONDS = 30;
+function isTelegramLinkProof(proof) {
+    return (typeof proof === 'object' &&
+        proof !== null &&
+        typeof proof.code === 'string' &&
+        typeof proof.channelUserId === 'string');
+}
+/**
+ * "Telegram en premier, complet." Long-polling (`getUpdates`), not a
+ * webhook: a webhook needs a real public HTTPS endpoint and Telegram's own
+ * `X-Telegram-Bot-Api-Secret-Token` signature verification, and no plane of
+ * this project is deployed publicly yet (L9 task 12's scoping). Polling
+ * works unchanged wherever `cogenta serve` already runs — locally, on a
+ * VPS, in CI — with no exposure and no signing infrastructure to half-build.
+ */
+export function createTelegramAdapter(options) {
+    const client = createTelegramClient(options);
+    const pollTimeoutSeconds = options.pollTimeoutSeconds ?? DEFAULT_POLL_TIMEOUT_SECONDS;
+    let inboundHandler;
+    let polling = false;
+    let pollLoop;
+    let updateOffset = 0;
+    const handleUpdate = createTelegramInboundHandler({
+        client,
+        linkStore: options.linkStore,
+        router: options.router,
+        getExternalHandler: () => inboundHandler,
+    });
+    async function pollOnce() {
+        const updates = await client.getUpdates(updateOffset, pollTimeoutSeconds);
+        for (const update of updates) {
+            updateOffset = update.update_id + 1;
+            await handleUpdate(update);
+        }
+    }
+    return {
+        name: CHANNEL_NAME,
+        capabilities: {
+            richText: true,
+            buttons: true,
+            threads: false,
+            attachments: false,
+            inbound: true,
+        },
+        async send(target, message) {
+            const rendered = renderTelegramMessage(message);
+            const sent = await client.sendMessage({
+                chat_id: target.id,
+                text: rendered.text,
+                parse_mode: 'MarkdownV2',
+                ...(rendered.replyMarkup === undefined ? {} : { reply_markup: rendered.replyMarkup }),
+            });
+            return `${sent.chat.id}:${sent.message_id}`;
+        },
+        async update(id, message) {
+            const [chatId, messageIdPart] = id.split(':');
+            if (chatId === undefined || messageIdPart === undefined) {
+                throw new CogentaError({
+                    code: 'CHANNEL_TELEGRAM_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 = renderTelegramMessage(message);
+            await client.editMessageText({
+                chat_id: chatId,
+                message_id: Number(messageIdPart),
+                text: rendered.text,
+                parse_mode: 'MarkdownV2',
+                ...(rendered.replyMarkup === undefined ? {} : { reply_markup: rendered.replyMarkup }),
+            });
+        },
+        onInbound(handler) {
+            inboundHandler = handler;
+        },
+        async verifyIdentity(proof) {
+            if (!isTelegramLinkProof(proof)) {
+                throw new CogentaError({
+                    code: 'CHANNEL_TELEGRAM_API_ERROR',
+                    message: 'Telegram identity proof must be { code, channelUserId }.',
+                    hint: 'Pass the linking code submitted in the channel and the Telegram user id it came from.',
+                });
+            }
+            await options.linkStore.verifyCode(proof.code, CHANNEL_NAME, proof.channelUserId);
+            return options.linkStore.resolveIdentity(CHANNEL_NAME, proof.channelUserId);
+        },
+        start() {
+            if (polling)
+                return;
+            polling = true;
+            pollLoop = (async () => {
+                while (polling) {
+                    await pollOnce();
+                }
+            })();
+        },
+        async stop() {
+            polling = false;
+            await pollLoop;
+            pollLoop = undefined;
+        },
+    };
+}
+//# sourceMappingURL=adapter.js.map

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

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