@elizaos/plugin-slack 2.0.0-alpha.7 → 2.0.11-beta.7

package/LICENSE

@@ -0,0 +1 @@
+{"message":"Not Found","documentation_url":"https://docs.github.com/rest/repos/contents#get-repository-content","status":"404"}

package/README.md

@@ -0,0 +1,183 @@
+# @elizaos/plugin-slack
+
+Slack integration plugin for elizaOS agents with Socket Mode support.
+
+## Features
+
+- **Socket Mode**: Real-time event handling via Slack Socket Mode
+- **Message Operations**: Send, edit, delete, read messages
+- **Reactions**: Add and remove emoji reactions
+- **Pins**: Pin and unpin messages, list pinned items
+- **Channels**: List channels, read channel history
+- **User Info**: Get user profile information
+- **Threads**: Full thread support with reply tracking
+- **Media**: Handle file uploads and attachments
+- **Custom Emoji**: List workspace custom emoji
+
+## Installation
+
+```bash
+npm install @elizaos/plugin-slack
+# or
+bun add @elizaos/plugin-slack
+```
+
+## Configuration
+
+### Required Environment Variables
+
+```env
+# Bot Token (starts with xoxb-)
+SLACK_BOT_TOKEN=xoxb-your-bot-token
+
+# App Token for Socket Mode (starts with xapp-)
+SLACK_APP_TOKEN=xapp-your-app-token
+```
+
+### Optional Environment Variables
+
+```env
+# Signing Secret for request verification
+SLACK_SIGNING_SECRET=your-signing-secret
+
+# User Token for enhanced permissions (starts with xoxp-)
+SLACK_USER_TOKEN=xoxp-your-user-token
+
+# Comma-separated list of channel IDs to restrict bot to
+SLACK_CHANNEL_IDS=C123456789,C987654321
+
+# Ignore messages from other bots
+SLACK_SHOULD_IGNORE_BOT_MESSAGES=false
+
+# Only respond when mentioned
+SLACK_SHOULD_RESPOND_ONLY_TO_MENTIONS=false
+```
+
+## Slack App Setup
+
+1. Create a new Slack App at https://api.slack.com/apps
+2. Enable Socket Mode in your app settings
+3. Generate an App-Level Token with `connections:write` scope
+4. Add the following Bot Token Scopes:
+   - `channels:history` - Read messages in public channels
+   - `channels:read` - View basic channel information
+   - `chat:write` - Send messages
+   - `emoji:read` - View custom emoji
+   - `files:read` - View files
+   - `groups:history` - Read messages in private channels
+   - `groups:read` - View basic private channel information
+   - `im:history` - Read direct messages
+   - `im:read` - View basic direct message information
+   - `mpim:history` - Read group direct messages
+   - `mpim:read` - View basic group direct message information
+   - `pins:read` - View pinned items
+   - `pins:write` - Add and remove pinned items
+   - `reactions:read` - View reactions
+   - `reactions:write` - Add and remove reactions
+   - `team:read` - View workspace information
+   - `users:read` - View basic user information
+   - `users:read.email` - View user email addresses
+
+5. Enable Events and subscribe to:
+   - `message.channels` - Messages in public channels
+   - `message.groups` - Messages in private channels
+   - `message.im` - Direct messages
+   - `message.mpim` - Group direct messages
+   - `app_mention` - When the app is mentioned
+   - `member_joined_channel` - When a user joins a channel
+   - `member_left_channel` - When a user leaves a channel
+   - `reaction_added` - When a reaction is added
+   - `reaction_removed` - When a reaction is removed
+
+6. Install the app to your workspace
+
+## Usage
+
+### Add to your agent configuration
+
+```typescript
+import slackPlugin from "@elizaos/plugin-slack";
+
+const agent = {
+  // ... other configuration
+  plugins: [slackPlugin],
+};
+```
+
+### Character file configuration
+
+```json
+{
+  "name": "MyAgent",
+  "settings": {
+    "slack": {
+      "shouldIgnoreBotMessages": true,
+      "shouldRespondOnlyToMentions": false
+    }
+  }
+}
+```
+
+## Connector capabilities
+
+This plugin registers no elizaOS actions. Slack messaging is handled via the `MessageConnector` interface. The registered connector exposes these capabilities: `send_message`, `read_messages`, `search_messages`, `resolve_targets`, `list_rooms`, `list_servers`, `chat_context`, `user_context`, `react_message`, `edit_message`, `delete_message`, `pin_message`, `get_user`.
+
+## Events
+
+The plugin emits the following events:
+
+- `SLACK_MESSAGE_RECEIVED` - When a message is received
+- `SLACK_MESSAGE_SENT` - When a message is sent
+- `SLACK_REACTION_ADDED` - When a reaction is added
+- `SLACK_REACTION_REMOVED` - When a reaction is removed
+- `SLACK_APP_MENTION` - When the bot is mentioned
+- `SLACK_MEMBER_JOINED_CHANNEL` - When a member joins a channel
+- `SLACK_MEMBER_LEFT_CHANNEL` - When a member leaves a channel
+- `SLACK_FILE_SHARED` - When a file is shared
+
+## API Reference
+
+### SlackService
+
+The main service class providing direct access to Slack functionality:
+
+```typescript
+import { SlackService, SLACK_SERVICE_NAME } from "@elizaos/plugin-slack";
+
+// Get service from runtime
+const slackService = runtime.getService(SLACK_SERVICE_NAME) as SlackService;
+
+// Send a message
+await slackService.sendMessage(channelId, "Hello!", { threadTs: "..." });
+
+// Add a reaction
+await slackService.sendReaction(channelId, messageTs, "thumbsup");
+
+// Get user info
+const user = await slackService.getUser(userId);
+
+// List channels
+const channels = await slackService.listChannels();
+```
+
+## Troubleshooting
+
+### Bot not responding to messages
+
+1. Verify your `SLACK_BOT_TOKEN` and `SLACK_APP_TOKEN` are correct
+2. Check that Socket Mode is enabled in your Slack app
+3. Ensure the bot has been invited to the channel
+4. Check if `SLACK_SHOULD_RESPOND_ONLY_TO_MENTIONS` is enabled
+
+### Permission errors
+
+1. Verify the bot has all required OAuth scopes
+2. Reinstall the app to your workspace after adding new scopes
+3. Check if the channel is private and the bot is a member
+
+### Socket Mode connection issues
+
+1. Verify your `SLACK_APP_TOKEN` starts with `xapp-`
+2. Check that the app-level token has `connections:write` scope
+3. Ensure only one instance of the bot is running per token
+

package/auto-enable.ts

@@ -0,0 +1,21 @@
+// Auto-enable check for @elizaos/plugin-slack.
+//
+// Plugin manifest entry-point — referenced by package.json's
+// `elizaos.plugin.autoEnableModule`. Keep this module light: env reads only,
+// no service init, no transitive imports of the full plugin runtime. The
+// auto-enable engine loads dozens of these per boot.
+import type { PluginAutoEnableContext } from "@elizaos/core";
+
+/** Enable when a `slack` connector block is present and not explicitly disabled. */
+export function shouldEnable(ctx: PluginAutoEnableContext): boolean {
+  const c = (ctx.config.connectors as Record<string, unknown> | undefined)
+    ?.slack;
+  if (!c || typeof c !== "object") return false;
+  const config = c as Record<string, unknown>;
+  if (config.enabled === false) return false;
+  // The full per-connector field check (botToken/appToken) lives in the
+  // central engine's isConnectorConfigured. We delegate to a simple "block
+  // present + not explicitly disabled" check here; the central engine's
+  // stricter check remains as a fallback during migration.
+  return true;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elizaos/plugin-slack",
-  "version": "2.0.0-alpha.7",
-  "description": "Slack integration plugin for ElizaOS agents with Socket Mode support",
+  "version": "2.0.11-beta.7",
+  "description": "Slack integration plugin for elizaOS agents with Socket Mode support",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -15,13 +15,38 @@
     "./package.json": "./package.json",
     ".": {
       "types": "./dist/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "auto-enable.ts"
   ],
+  "elizaos": {
+    "plugin": {
+      "autoEnableModule": "./auto-enable.ts",
+      "capabilities": [
+        "messaging"
+      ]
+    }
+  },
   "keywords": [
     "elizaos",
     "plugin",
@@ -35,27 +60,28 @@
     "build": "bun run build.ts",
     "build:ts": "bun run build.ts",
     "dev": "bun --hot build.ts",
-    "clean": "rm -rf dist .turbo node_modules",
-    "test": "vitest run --passWithNoTests",
-    "typecheck": "echo \"Typecheck skipped for release\"",
-    "lint": "echo \"Lint skipped for release\"",
-    "lint:check": "bun run lint",
+    "clean": "rm -rf dist .turbo",
+    "test": "vitest run",
+    "typecheck": "tsgo --noEmit",
+    "lint": "bunx @biomejs/biome check --write --unsafe .",
+    "lint:check": "bunx @biomejs/biome check .",
     "format": "bunx @biomejs/biome format --write .",
     "format:check": "bunx @biomejs/biome format ."
   },
   "dependencies": {
+    "@elizaos/core": "2.0.11-beta.7",
     "@slack/bolt": "^4.1.0",
-    "@slack/web-api": "^7.7.0",
-    "@elizaos/core": "2.0.0-alpha.3",
-    "zod": "^4.3.6"
+    "@slack/web-api": "^7.15.2"
   },
   "devDependencies": {
+    "@biomejs/biome": "^2.4.14",
     "@types/node": "^25.0.3",
-    "typescript": "^5.9.3",
-    "@biomejs/biome": "^2.3.11"
+    "bun-types": "^1.2.25",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.4"
   },
   "peerDependencies": {
-    "@elizaos/core": "2.0.0-alpha.3"
+    "@elizaos/core": "2.0.11-beta.7"
   },
   "publishConfig": {
     "access": "public"
@@ -107,13 +133,5 @@
       }
     }
   },
-  "milady": {
-    "platforms": [
-      "node"
-    ],
-    "runtime": "node",
-    "platformDetails": {
-      "node": "Default export (Node.js)"
-    }
-  }
+  "gitHead": "cdbc876f793d96073d7eb0d09715a031ce0cd32e"
 }