claude-threads 1.31.2 → 1.32.0

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.32.0] - 2026-09-01
+
+### Added
+- **Slack: shared event source — one Socket Mode connection per app** (#502, thanks @kaza). Slack round-robins Socket Mode envelopes across all of an app's open connections, so a second `SlackClient` on the same app token silently steals events from the first. Now exactly one client (the parent) owns the socket; other clients register as secondaries and receive their channels' events injected by the parent — Web API calls stay independent per instance. The parent mirrors connection state onto secondaries (idempotently re-armed across disconnects), and on reconnect, missed-message recovery runs for the parent and every registered secondary. Zero behavior change for existing single-channel configs; this is the mechanism that unblocks DM auto-discovery on Slack and other multi-channel consumers.
+
 ## [1.31.2] - 2026-08-30
 
 ### Added

package/dist/index.js

@@ -71941,8 +71941,13 @@ class SlackClient extends BasePlatformClient {
   rateLimitRetryAfter = 0;
   outboundFiles;
   formatter = new SlackFormatter;
-  constructor(platformConfig) {
+  channelClients = new Map;
+  sharedEventSource;
+  socketConnected = false;
+  constructor(platformConfig, sharedEventSource) {
     super();
+    this.sharedEventSource = sharedEventSource;
+    this.installStateMirror();
     this.platformId = platformConfig.id;
     this.displayName = platformConfig.displayName;
     this.botToken = platformConfig.botToken;
@@ -71956,6 +71961,55 @@ class SlackClient extends BasePlatformClient {
     this.approvals = platformConfig.approvals;
     this.ackReaction = normalizeAckReaction(platformConfig.ackReaction, `platforms[${platformConfig.id}].ackReaction`);
   }
+  stateMirrors = ["connected", "disconnected", "reconnecting"].map((state) => ({
+    state,
+    handler: (...args) => {
+      for (const secondary of this.channelClients.values()) {
+        secondary.emit(state, ...args);
+      }
+    }
+  }));
+  installStateMirror() {
+    for (const { state, handler: handler2 } of this.stateMirrors) {
+      this.off(state, handler2);
+      this.on(state, handler2);
+    }
+  }
+  onConnectionEstablished() {
+    const wasReconnecting = this.isReconnecting;
+    super.onConnectionEstablished();
+    if (!wasReconnecting)
+      return;
+    for (const secondary of this.channelClients.values()) {
+      secondary.recoverMissedMessages().catch((err) => {
+        log40.warn(`Failed to recover missed messages for ${secondary.platformId}: ${err}`);
+      });
+    }
+  }
+  registerChannelClient(channelId, client) {
+    if (channelId === this.channelId) {
+      throw new Error(`registerChannelClient: ${channelId} is the parent's own channel — a secondary there can never receive events`);
+    }
+    this.channelClients.set(channelId, client);
+  }
+  unregisterChannelClient(channelId, client) {
+    if (client && this.channelClients.get(channelId) !== client)
+      return;
+    this.channelClients.delete(channelId);
+  }
+  _injectSlackEvent(event) {
+    this.handleSlackEvent(event);
+  }
+  disconnect() {
+    if (this.sharedEventSource) {
+      this.sharedEventSource.unregisterChannelClient(this.channelId, this);
+    }
+    try {
+      return super.disconnect();
+    } finally {
+      this.installStateMirror();
+    }
+  }
   normalizePlatformUser(slackUser) {
     const displayName = slackUser.profile?.display_name || slackUser.profile?.real_name || slackUser.real_name || slackUser.name;
     return {
@@ -72059,6 +72113,16 @@ class SlackClient extends BasePlatformClient {
     return data;
   }
   async connect() {
+    if (this.sharedEventSource) {
+      await this.fetchBotUser();
+      if (this.isIntentionalDisconnect)
+        return;
+      this.sharedEventSource.registerChannelClient(this.channelId, this);
+      if (this.sharedEventSource.socketConnected) {
+        this.emit("connected");
+      }
+      return;
+    }
     await this.fetchBotUser();
     wsLogger.debug(`Slack bot user ID: ${this.botUserId}`);
     const response = await this.appApi("POST", "apps.connections.open");
@@ -72098,12 +72162,8 @@ class SlackClient extends BasePlatformClient {
           this.handleSocketModeEvent(envelope);
           if (envelope.type === "hello") {
             clearTimeout(connectionTimeout);
+            this.socketConnected = true;
             this.onConnectionEstablished();
-            if (this.isReconnecting && this.lastProcessedTs) {
-              this.recoverMissedMessages().catch((err) => {
-                log40.warn(`Failed to recover missed messages: ${err}`);
-              });
-            }
             doResolve();
           }
         } catch (err) {
@@ -72111,6 +72171,7 @@ class SlackClient extends BasePlatformClient {
         }
       };
       this.ws.onclose = (event) => {
+        this.socketConnected = false;
         clearTimeout(connectionTimeout);
         wsLogger.info(`Socket Mode: WebSocket disconnected (code: ${event.code}, reason: ${event.reason || "none"}, clean: ${event.wasClean})`);
         if (!settled) {
@@ -72162,6 +72223,14 @@ class SlackClient extends BasePlatformClient {
     }
   }
   handleSlackEvent(event) {
+    const eventChannel = event.channel || event.item?.channel;
+    if (eventChannel && eventChannel !== this.channelId) {
+      const secondary = this.channelClients.get(eventChannel);
+      if (secondary) {
+        secondary._injectSlackEvent(event);
+        return;
+      }
+    }
     if (event.type === "message" && (!event.subtype || event.subtype === "file_share")) {
       if (event.user === this.botUserId || event.bot_id) {
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-threads",
-  "version": "1.31.2",
+  "version": "1.32.0",
   "description": "Run Claude Code from Slack or Mattermost. Sessions stream live into threads where your whole team can watch and steer.",
   "main": "dist/index.js",
   "type": "module",