@runcore-sh/runcore 0.1.2

package/dist/slack/types.d.ts

@@ -0,0 +1,271 @@
+/**
+ * Slack integration types.
+ * Covers API responses, events, messages, and message templates.
+ */
+export interface SlackAuthTestResult {
+    ok: boolean;
+    url?: string;
+    team?: string;
+    user?: string;
+    team_id?: string;
+    user_id?: string;
+    bot_id?: string;
+    is_enterprise_install?: boolean;
+    error?: string;
+}
+export interface SlackOAuthResponse {
+    ok: boolean;
+    access_token?: string;
+    token_type?: string;
+    scope?: string;
+    bot_user_id?: string;
+    app_id?: string;
+    team?: {
+        id: string;
+        name: string;
+    };
+    authed_user?: {
+        id: string;
+        scope?: string;
+        access_token?: string;
+        token_type?: string;
+    };
+    error?: string;
+}
+export interface SlackUser {
+    id: string;
+    name: string;
+    real_name?: string;
+    display_name?: string;
+    email?: string;
+    is_bot: boolean;
+    is_admin?: boolean;
+    tz?: string;
+    avatar?: string;
+}
+export interface SlackUserInfoResponse {
+    ok: boolean;
+    user?: {
+        id: string;
+        name: string;
+        real_name?: string;
+        profile?: {
+            display_name?: string;
+            email?: string;
+            image_48?: string;
+        };
+        is_bot?: boolean;
+        is_admin?: boolean;
+        tz?: string;
+    };
+    error?: string;
+}
+export interface SlackChannel {
+    id: string;
+    name: string;
+    is_channel: boolean;
+    is_im: boolean;
+    is_mpim: boolean;
+    is_private: boolean;
+    is_archived: boolean;
+    is_member: boolean;
+    num_members?: number;
+    topic?: string;
+    purpose?: string;
+}
+export interface SlackConversationInfoResponse {
+    ok: boolean;
+    channel?: {
+        id: string;
+        name: string;
+        is_channel?: boolean;
+        is_im?: boolean;
+        is_mpim?: boolean;
+        is_private?: boolean;
+        is_archived?: boolean;
+        is_member?: boolean;
+        num_members?: number;
+        topic?: {
+            value: string;
+        };
+        purpose?: {
+            value: string;
+        };
+    };
+    error?: string;
+}
+export interface SlackConversationListResponse {
+    ok: boolean;
+    channels?: Array<{
+        id: string;
+        name: string;
+        is_channel?: boolean;
+        is_im?: boolean;
+        is_mpim?: boolean;
+        is_private?: boolean;
+        is_archived?: boolean;
+        is_member?: boolean;
+        num_members?: number;
+        topic?: {
+            value: string;
+        };
+        purpose?: {
+            value: string;
+        };
+    }>;
+    response_metadata?: {
+        next_cursor?: string;
+    };
+    error?: string;
+}
+export interface SlackMessage {
+    ok: boolean;
+    channel: string;
+    ts: string;
+    message?: {
+        type: string;
+        text: string;
+        user?: string;
+        ts: string;
+        thread_ts?: string;
+    };
+    error?: string;
+}
+export interface SlackMessagePayload {
+    channel: string;
+    text: string;
+    thread_ts?: string;
+    blocks?: SlackBlock[];
+    unfurl_links?: boolean;
+    unfurl_media?: boolean;
+}
+export interface SlackFileUploadResult {
+    ok: boolean;
+    file?: {
+        id: string;
+        name: string;
+        mimetype: string;
+        url_private: string;
+        permalink: string;
+    };
+    error?: string;
+}
+export type SlackBlock = SlackSectionBlock | SlackDividerBlock | SlackHeaderBlock | SlackContextBlock | SlackActionsBlock;
+export interface SlackSectionBlock {
+    type: "section";
+    text: SlackTextObject;
+    accessory?: SlackBlockElement;
+    fields?: SlackTextObject[];
+}
+export interface SlackDividerBlock {
+    type: "divider";
+}
+export interface SlackHeaderBlock {
+    type: "header";
+    text: SlackTextObject;
+}
+export interface SlackContextBlock {
+    type: "context";
+    elements: Array<SlackTextObject | SlackImageElement>;
+}
+export interface SlackActionsBlock {
+    type: "actions";
+    elements: SlackBlockElement[];
+}
+export interface SlackTextObject {
+    type: "plain_text" | "mrkdwn";
+    text: string;
+    emoji?: boolean;
+}
+export type SlackBlockElement = SlackButtonElement | SlackImageElement;
+export interface SlackButtonElement {
+    type: "button";
+    text: SlackTextObject;
+    action_id: string;
+    url?: string;
+    value?: string;
+    style?: "primary" | "danger";
+}
+export interface SlackImageElement {
+    type: "image";
+    image_url: string;
+    alt_text: string;
+}
+export type SlackEventType = "app_mention" | "message" | "reaction_added" | "reaction_removed" | "member_joined_channel" | "member_left_channel" | "channel_created" | "app_home_opened";
+/** Outer envelope for Events API. */
+export interface SlackEventEnvelope {
+    token?: string;
+    type: "url_verification" | "event_callback" | "app_rate_limited";
+    challenge?: string;
+    team_id?: string;
+    api_app_id?: string;
+    event?: SlackEvent;
+    event_id?: string;
+    event_time?: number;
+}
+export interface SlackEvent {
+    type: SlackEventType;
+    subtype?: string;
+    user?: string;
+    text?: string;
+    channel?: string;
+    channel_type?: string;
+    ts?: string;
+    thread_ts?: string;
+    reaction?: string;
+    item?: {
+        type: string;
+        channel: string;
+        ts: string;
+    };
+    bot_id?: string;
+    tab?: string;
+}
+export interface SlackSlashCommand {
+    token: string;
+    team_id: string;
+    team_domain: string;
+    channel_id: string;
+    channel_name: string;
+    user_id: string;
+    user_name: string;
+    command: string;
+    text: string;
+    response_url: string;
+    trigger_id: string;
+    api_app_id: string;
+}
+export interface SlackInteractionPayload {
+    type: "block_actions" | "view_submission" | "shortcut";
+    trigger_id: string;
+    user: {
+        id: string;
+        username: string;
+        name: string;
+        team_id: string;
+    };
+    channel?: {
+        id: string;
+        name: string;
+    };
+    actions?: Array<{
+        action_id: string;
+        block_id: string;
+        type: string;
+        value?: string;
+        selected_option?: {
+            value: string;
+        };
+    }>;
+    response_url?: string;
+}
+/** Helper to build common Block Kit message shapes. */
+export declare const MessageTemplates: {
+    /** Simple text notification with optional header. */
+    readonly notification: (header: string, body: string) => SlackBlock[];
+    /** Status update with fields (key-value pairs). */
+    readonly statusUpdate: (title: string, fields: Record<string, string>) => SlackBlock[];
+    /** Task notification with action button. */
+    readonly taskNotification: (title: string, description: string, actionLabel: string, actionValue: string) => SlackBlock[];
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/slack/types.js

@@ -0,0 +1,52 @@
+/**
+ * Slack integration types.
+ * Covers API responses, events, messages, and message templates.
+ */
+// ── Message Templates ─────────────────────────────────────────────────────────
+/** Helper to build common Block Kit message shapes. */
+export const MessageTemplates = {
+    /** Simple text notification with optional header. */
+    notification(header, body) {
+        const blocks = [];
+        if (header) {
+            blocks.push({ type: "header", text: { type: "plain_text", text: header, emoji: true } });
+        }
+        blocks.push({ type: "section", text: { type: "mrkdwn", text: body } });
+        return blocks;
+    },
+    /** Status update with fields (key-value pairs). */
+    statusUpdate(title, fields) {
+        return [
+            { type: "header", text: { type: "plain_text", text: title, emoji: true } },
+            {
+                type: "section",
+                text: { type: "mrkdwn", text: " " },
+                fields: Object.entries(fields).map(([k, v]) => ({
+                    type: "mrkdwn",
+                    text: `*${k}*\n${v}`,
+                })),
+            },
+        ];
+    },
+    /** Task notification with action button. */
+    taskNotification(title, description, actionLabel, actionValue) {
+        return [
+            { type: "header", text: { type: "plain_text", text: title, emoji: true } },
+            { type: "section", text: { type: "mrkdwn", text: description } },
+            { type: "divider" },
+            {
+                type: "actions",
+                elements: [
+                    {
+                        type: "button",
+                        text: { type: "plain_text", text: actionLabel, emoji: true },
+                        action_id: "task_action",
+                        value: actionValue,
+                        style: "primary",
+                    },
+                ],
+            },
+        ];
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/slack/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/slack/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA+RH,iFAAiF;AAEjF,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,qDAAqD;IACrD,YAAY,CAAC,MAAc,EAAE,IAAY;QACvC,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACvE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,mDAAmD;IACnD,YAAY,CAAC,KAAa,EAAE,MAA8B;QACxD,OAAO;YACL,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC1E;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE;gBACnC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC9C,IAAI,EAAE,QAAiB;oBACvB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE;iBACrB,CAAC,CAAC;aACJ;SACF,CAAC;IACJ,CAAC;IAED,4CAA4C;IAC5C,gBAAgB,CACd,KAAa,EACb,WAAmB,EACnB,WAAmB,EACnB,WAAmB;QAEnB,OAAO;YACL,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC1E,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;YAChE,EAAE,IAAI,EAAE,SAAS,EAAE;YACnB;gBACE,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE;wBAC5D,SAAS,EAAE,aAAa;wBACxB,KAAK,EAAE,WAAW;wBAClB,KAAK,EAAE,SAAS;qBACjB;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACO,CAAC"}

package/dist/slack/webhooks.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Slack webhook signature verification, event processing, and slash command handling.
+ * Processes incoming Events API payloads, slash commands, and interactive payloads.
+ *
+ * Webhook setup: Configure in Slack App settings → Event Subscriptions.
+ * URL: https://<your-domain>/api/slack/events
+ * Slash commands: https://<your-domain>/api/slack/commands
+ * Interactivity: https://<your-domain>/api/slack/interactions
+ */
+import type { SlackEventEnvelope, SlackSlashCommand, SlackInteractionPayload } from "./types.js";
+/**
+ * Verify a Slack request signature using the signing secret.
+ * https://api.slack.com/authentication/verifying-requests-from-slack
+ *
+ * Slack sends:
+ * - X-Slack-Request-Timestamp: Unix timestamp
+ * - X-Slack-Signature: v0=<hmac-sha256>
+ *
+ * Base string: `v0:{timestamp}:{body}`
+ * Uses generic signature helpers from webhooks/registry.
+ */
+export declare function verifySignature(body: string, signature: string, timestamp: string, signingSecret: string): boolean;
+/**
+ * Process a Slack Events API payload.
+ * Handles URL verification challenge and routes events to handlers.
+ */
+export declare function processEvent(envelope: SlackEventEnvelope): Promise<{
+    handled: boolean;
+    message: string;
+    challenge?: string;
+}>;
+/**
+ * Process an incoming slash command.
+ * Returns the response text/blocks to send back to the user.
+ */
+export declare function processSlashCommand(cmd: SlackSlashCommand): Promise<{
+    ok: boolean;
+    response_type?: "in_channel" | "ephemeral";
+    text: string;
+    blocks?: any[];
+}>;
+/**
+ * Process an interactive payload (button clicks, menu selections, etc.).
+ */
+/** Slack Events API webhook provider (deferred registration). */
+export declare const slackEventsProvider: import("../webhooks/types.js").WebhookProvider;
+/** Slack slash commands webhook provider (deferred registration). */
+export declare const slackCommandsProvider: import("../webhooks/types.js").WebhookProvider;
+/** Slack interactions webhook provider (deferred registration). */
+export declare const slackInteractionsProvider: import("../webhooks/types.js").WebhookProvider;
+export declare function processInteraction(payload: SlackInteractionPayload): Promise<{
+    handled: boolean;
+    message: string;
+}>;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/slack/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/slack/webhooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAElB,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAOpB;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,OAAO,CAQT;AAID;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBpE;AAyGD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,YAAY,GAAG,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAA;CAAE,CAAC,CAmBpG;AA8DD;;GAEG;AAGH,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,gDAU9B,CAAC;AAEH,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,gDAuBhC,CAAC;AAEH,mEAAmE;AACnE,eAAO,MAAM,yBAAyB,gDAiBpC,CAAC;AAEH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBhD"}

package/dist/slack/webhooks.js

@@ -0,0 +1,285 @@
+/**
+ * Slack webhook signature verification, event processing, and slash command handling.
+ * Processes incoming Events API payloads, slash commands, and interactive payloads.
+ *
+ * Webhook setup: Configure in Slack App settings → Event Subscriptions.
+ * URL: https://<your-domain>/api/slack/events
+ * Slash commands: https://<your-domain>/api/slack/commands
+ * Interactivity: https://<your-domain>/api/slack/interactions
+ */
+import { logActivity } from "../activity/log.js";
+import { getClient } from "./client.js";
+import { hmacSha256Hex, timingSafeCompare, isTimestampFresh } from "../webhooks/registry.js";
+import { createSlackStyleProvider, safeHandler } from "../webhooks/handlers.js";
+import { getInstanceName, getInstanceNameLower } from "../instance.js";
+// ── Signature verification ────────────────────────────────────────────────────
+/**
+ * Verify a Slack request signature using the signing secret.
+ * https://api.slack.com/authentication/verifying-requests-from-slack
+ *
+ * Slack sends:
+ * - X-Slack-Request-Timestamp: Unix timestamp
+ * - X-Slack-Signature: v0=<hmac-sha256>
+ *
+ * Base string: `v0:{timestamp}:{body}`
+ * Uses generic signature helpers from webhooks/registry.
+ */
+export function verifySignature(body, signature, timestamp, signingSecret) {
+    // Reject requests older than 5 minutes (replay attack prevention)
+    const requestTime = parseInt(timestamp, 10);
+    if (!isTimestampFresh(requestTime))
+        return false;
+    const baseString = `v0:${timestamp}:${body}`;
+    const computed = `v0=${hmacSha256Hex(baseString, signingSecret)}`;
+    return timingSafeCompare(signature, computed);
+}
+// ── Event processing ──────────────────────────────────────────────────────────
+/**
+ * Process a Slack Events API payload.
+ * Handles URL verification challenge and routes events to handlers.
+ */
+export async function processEvent(envelope) {
+    // URL verification: return challenge immediately
+    if (envelope.type === "url_verification") {
+        return { handled: true, message: "URL verified", challenge: envelope.challenge };
+    }
+    // Rate limited notification
+    if (envelope.type === "app_rate_limited") {
+        logActivity({ source: "slack", summary: "App rate limited by Slack" });
+        return { handled: true, message: "Rate limit acknowledged" };
+    }
+    // Event callback
+    if (envelope.type !== "event_callback" || !envelope.event) {
+        return { handled: false, message: `Unknown envelope type: ${envelope.type}` };
+    }
+    return routeEvent(envelope.event);
+}
+/** Route an individual event to its handler. */
+async function routeEvent(event) {
+    // Ignore bot messages to prevent loops
+    if (event.bot_id || event.subtype === "bot_message") {
+        return { handled: true, message: "Ignored bot message" };
+    }
+    switch (event.type) {
+        case "app_mention":
+            return handleAppMention(event);
+        case "message":
+            return handleMessage(event);
+        case "reaction_added":
+            return handleReactionAdded(event);
+        case "reaction_removed":
+            return handleReactionRemoved(event);
+        case "member_joined_channel":
+            return handleMemberJoined(event);
+        case "app_home_opened":
+            return handleAppHomeOpened(event);
+        default:
+            return { handled: false, message: `Unhandled event type: ${event.type}` };
+    }
+}
+// ── Event handlers ────────────────────────────────────────────────────────────
+async function handleAppMention(event) {
+    const mentionText = (event.text ?? "").replace(/<@[^>]+>/g, "").trim();
+    logActivity({
+        source: "slack",
+        summary: `App mention from <@${event.user}>: "${mentionText}"`,
+        detail: `channel=${event.channel} ts=${event.ts}`,
+    });
+    // Auto-acknowledge with a reaction
+    const client = getClient();
+    if (client && event.channel && event.ts) {
+        await client.addReaction(event.channel, event.ts, "eyes");
+    }
+    return { handled: true, message: `App mention from ${event.user}` };
+}
+async function handleMessage(event) {
+    // Only process DMs (im) — channel messages are handled via app_mention
+    if (event.channel_type !== "im") {
+        return { handled: true, message: "Channel message (not DM), skipped" };
+    }
+    logActivity({
+        source: "slack",
+        summary: `DM from <@${event.user}>: "${event.text}"`,
+        detail: `channel=${event.channel} ts=${event.ts}`,
+    });
+    return { handled: true, message: `DM from ${event.user}` };
+}
+async function handleReactionAdded(event) {
+    logActivity({
+        source: "slack",
+        summary: `Reaction :${event.reaction}: added by <@${event.user}> in ${event.item?.channel}`,
+    });
+    return { handled: true, message: `Reaction added: ${event.reaction}` };
+}
+async function handleReactionRemoved(event) {
+    return { handled: true, message: `Reaction removed: ${event.reaction}` };
+}
+async function handleMemberJoined(event) {
+    logActivity({
+        source: "slack",
+        summary: `<@${event.user}> joined <#${event.channel}>`,
+    });
+    return { handled: true, message: `Member joined channel` };
+}
+async function handleAppHomeOpened(event) {
+    // Could publish an App Home view here using views.publish
+    return { handled: true, message: `App Home opened by ${event.user}` };
+}
+// ── Slash commands ────────────────────────────────────────────────────────────
+/**
+ * Process an incoming slash command.
+ * Returns the response text/blocks to send back to the user.
+ */
+export async function processSlashCommand(cmd) {
+    logActivity({
+        source: "slack",
+        summary: `Slash command ${cmd.command} from @${cmd.user_name}: "${cmd.text}"`,
+        detail: `channel=${cmd.channel_name} team=${cmd.team_domain}`,
+    });
+    switch (cmd.command) {
+        case `/${getInstanceNameLower()}`:
+            return handleDashCommand(cmd);
+        case "/status":
+            return handleStatusCommand(cmd);
+        default:
+            return {
+                ok: true,
+                response_type: "ephemeral",
+                text: `Unknown command: ${cmd.command}. Try /${getInstanceNameLower()} help`,
+            };
+    }
+}
+async function handleDashCommand(cmd) {
+    const args = cmd.text.trim().split(/\s+/);
+    const subcommand = args[0]?.toLowerCase() || "help";
+    switch (subcommand) {
+        case "help":
+            return {
+                ok: true,
+                response_type: "ephemeral",
+                text: [
+                    `*${getInstanceName()} Commands:*`,
+                    `\`/${getInstanceNameLower()} help\` — Show this help message`,
+                    `\`/${getInstanceNameLower()} status\` — Check ${getInstanceName()} connection status`,
+                    `\`/${getInstanceNameLower()} ping\` — Test connectivity`,
+                ].join("\n"),
+            };
+        case "ping":
+            return {
+                ok: true,
+                response_type: "ephemeral",
+                text: `Pong! ${getInstanceName()} is connected and listening.`,
+            };
+        case "status":
+            return handleStatusCommand(cmd);
+        default:
+            return {
+                ok: true,
+                response_type: "ephemeral",
+                text: `Unknown subcommand: ${subcommand}. Try \`/${getInstanceNameLower()} help\``,
+            };
+    }
+}
+async function handleStatusCommand(_cmd) {
+    const client = getClient();
+    if (!client) {
+        return { ok: true, response_type: "ephemeral", text: `${getInstanceName()} is not connected (no bot token).` };
+    }
+    const auth = await client.testAuth();
+    if (!auth.ok) {
+        return { ok: true, response_type: "ephemeral", text: `${getInstanceName()} connection error: ${auth.message}` };
+    }
+    return {
+        ok: true,
+        response_type: "ephemeral",
+        text: `${getInstanceName()} is connected to *${auth.team}* as <@${auth.userId}>.`,
+    };
+}
+// ── Interactive payloads ──────────────────────────────────────────────────────
+/**
+ * Process an interactive payload (button clicks, menu selections, etc.).
+ */
+// ── Registry integration ────────────────────────────────────────────────────
+/** Slack Events API webhook provider (deferred registration). */
+export const slackEventsProvider = createSlackStyleProvider({
+    name: "slack-events",
+    process: safeHandler("slack-events", async (payload) => {
+        const envelope = payload;
+        const result = await processEvent(envelope);
+        if (result.challenge !== undefined) {
+            return { handled: result.handled, message: result.message, data: { challenge: result.challenge } };
+        }
+        return result;
+    }),
+});
+/** Slack slash commands webhook provider (deferred registration). */
+export const slackCommandsProvider = createSlackStyleProvider({
+    name: "slack-commands",
+    process: safeHandler("slack-commands", async (payload) => {
+        // Slash command payloads arrive as URL-encoded form data.
+        // When routed via createWebhookRoute, parsed is Record<string, string>.
+        const raw = payload;
+        const cmd = {
+            token: raw.token ?? "",
+            team_id: raw.team_id ?? "",
+            team_domain: raw.team_domain ?? "",
+            channel_id: raw.channel_id ?? "",
+            channel_name: raw.channel_name ?? "",
+            user_id: raw.user_id ?? "",
+            user_name: raw.user_name ?? "",
+            command: raw.command ?? "",
+            text: raw.text ?? "",
+            response_url: raw.response_url ?? "",
+            trigger_id: raw.trigger_id ?? "",
+            api_app_id: raw.api_app_id ?? "",
+        };
+        const result = await processSlashCommand(cmd);
+        return { handled: result.ok, message: result.text, data: result };
+    }),
+});
+/** Slack interactions webhook provider (deferred registration). */
+export const slackInteractionsProvider = createSlackStyleProvider({
+    name: "slack-interactions",
+    process: safeHandler("slack-interactions", async (payload) => {
+        // Interactive payloads arrive as URL-encoded form with a "payload" JSON field.
+        // When routed via createWebhookRoute, parsed is Record<string, string>.
+        let interactionPayload;
+        const raw = payload;
+        if (typeof raw.payload === "string") {
+            interactionPayload = JSON.parse(raw.payload);
+        }
+        else if (raw.type && raw.user) {
+            // Already parsed (direct call)
+            interactionPayload = payload;
+        }
+        else {
+            return { handled: false, message: "Slack interactions: missing payload field" };
+        }
+        return processInteraction(interactionPayload);
+    }),
+});
+export async function processInteraction(payload) {
+    logActivity({
+        source: "slack",
+        summary: `Interaction (${payload.type}) from @${payload.user.username}`,
+        detail: payload.actions?.[0]?.action_id,
+    });
+    if (payload.type === "block_actions" && payload.actions) {
+        for (const action of payload.actions) {
+            switch (action.action_id) {
+                case "task_action":
+                    // Handle task-related button clicks
+                    logActivity({
+                        source: "slack",
+                        summary: `Task action: ${action.value} by ${payload.user.username}`,
+                    });
+                    break;
+                default:
+                    break;
+            }
+        }
+        return { handled: true, message: "Block actions processed" };
+    }
+    return { handled: false, message: `Unhandled interaction type: ${payload.type}` };
+}
+//# sourceMappingURL=webhooks.js.map