@crewhaus/channel-adapter-slack 0.1.7 → 0.2.0

package/dist/index.d.ts

@@ -48,6 +48,24 @@ export type InboundEvent = {
     readonly text: string;
     readonly subtype: "app_mention" | "message";
 };
+/**
+ * A 👍/👎 reaction a user placed on one of the bot's messages. Normalised from
+ * Slack's `reaction_added` event. `messageTs` is the reacted-to message's ts;
+ * `vote` is the emoji mapped to a thumbs direction. The session-router records
+ * this as a `user_feedback` event-log line rather than driving a model turn.
+ * Only meaningful emojis (👍/👎) reach here — the bot's own status reactions
+ * (👀/✅/⚠️) never map to a vote, so they never produce feedback.
+ */
+export type InboundReaction = {
+    readonly idempotencyKey: string;
+    readonly workspaceId: string;
+    readonly channelId: string;
+    /** ts of the reacted-to message (typically the bot's reply). */
+    readonly messageTs: string;
+    /** the user who added the reaction. */
+    readonly userId: string;
+    readonly vote: "up" | "down";
+};
 /**
  * The result of `parseInbound`. Three shapes:
  *   - { kind: "event", event } — a real inbound message to route
@@ -59,6 +77,9 @@ export type InboundEvent = {
 export type ParsedInbound = {
     readonly kind: "event";
     readonly event: InboundEvent;
+} | {
+    readonly kind: "reaction";
+    readonly reaction: InboundReaction;
 } | {
     readonly kind: "challenge";
     readonly challenge: string;

package/dist/index.js

@@ -31,6 +31,19 @@ export class SlackAdapterError extends CrewhausError {
         super("channel", message, cause);
     }
 }
+/** Map a Slack reaction name to a thumbs vote, or undefined when the emoji is
+ *  not a 👍/👎 (which then produces no feedback). Slack delivers a skin-toned
+ *  reaction as `+1::skin-tone-4`, so the base name is taken before matching. */
+function reactionToVote(name) {
+    if (typeof name !== "string")
+        return undefined;
+    const base = name.replace(/^:|:$/g, "").split("::")[0] ?? "";
+    if (base === "+1" || base === "thumbsup")
+        return "up";
+    if (base === "-1" || base === "thumbsdown")
+        return "down";
+    return undefined;
+}
 const DEFAULT_API_BASE_URL = "https://slack.com/api";
 export function createSlackAdapter(config, opts = {}) {
     const apiBaseUrl = opts.apiBaseUrl ?? process.env["SLACK_API_BASE_URL"] ?? DEFAULT_API_BASE_URL;
@@ -63,6 +76,40 @@ export function createSlackAdapter(config, opts = {}) {
                 return { kind: "skip" };
             const e = ev;
             const evType = e["type"];
+            // Inbound 👍/👎 reaction on one of the bot's messages → feedback. Only
+            // reaction_added produces feedback (a removed reaction does not retract
+            // an append-only event-log line). Non-vote emojis (incl. the bot's own
+            // 👀/✅/⚠️ status reactions) map to no vote and are skipped.
+            if (evType === "reaction_added") {
+                const vote = reactionToVote(e["reaction"]);
+                if (vote === undefined)
+                    return { kind: "skip" };
+                const item = e["item"];
+                if (typeof item !== "object" || item === null)
+                    return { kind: "skip" };
+                const it = item;
+                if (it["type"] !== "message")
+                    return { kind: "skip" };
+                const rChannelId = typeof it["channel"] === "string" ? it["channel"] : undefined;
+                const rMessageTs = typeof it["ts"] === "string" ? it["ts"] : undefined;
+                const rUserId = typeof e["user"] === "string" ? e["user"] : undefined;
+                const rIdemp = typeof p["event_id"] === "string" ? p["event_id"] : undefined;
+                const rWorkspace = typeof p["team_id"] === "string" ? p["team_id"] : undefined;
+                if (!rChannelId || !rMessageTs || !rUserId || !rIdemp || !rWorkspace) {
+                    return { kind: "skip" };
+                }
+                return {
+                    kind: "reaction",
+                    reaction: {
+                        idempotencyKey: rIdemp,
+                        workspaceId: rWorkspace,
+                        channelId: rChannelId,
+                        messageTs: rMessageTs,
+                        userId: rUserId,
+                        vote,
+                    },
+                };
+            }
             if (evType !== "app_mention" && evType !== "message")
                 return { kind: "skip" };
             // Skip self/bot loops. `bot_id` is present on Slack's bot-authored

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewhaus/channel-adapter-slack",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "type": "module",
   "description": "Slack channel adapter: webhook signature verification, event parsing, reply-to-thread (Section 12)",
   "main": "dist/index.js",
@@ -15,7 +15,7 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@crewhaus/errors": "0.1.7"
+    "@crewhaus/errors": "0.2.0"
   },
   "license": "Apache-2.0",
   "author": {