agent-messenger 1.2.0 → 1.3.0

package/dist/src/platforms/slackbot/types.js

@@ -0,0 +1,114 @@
+import { z } from 'zod';
+// Error class for SlackBot operations
+export class SlackBotError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'SlackBotError';
+        this.code = code;
+    }
+}
+// Zod validation schemas
+export const SlackBotEntrySchema = z.object({
+    bot_id: z.string(),
+    bot_name: z.string(),
+    token: z.string().startsWith('xoxb-', 'Token must be a bot token (xoxb-)'),
+});
+export const SlackBotWorkspaceSchema = z.object({
+    workspace_id: z.string(),
+    workspace_name: z.string(),
+    bots: z.record(z.string(), SlackBotEntrySchema),
+});
+export const SlackBotCredentialsSchema = z.object({
+    token: z.string().startsWith('xoxb-', 'Token must be a bot token (xoxb-)'),
+    workspace_id: z.string(),
+    workspace_name: z.string(),
+    bot_id: z.string(),
+    bot_name: z.string(),
+});
+export const SlackBotConfigSchema = z.object({
+    current: z
+        .object({
+        workspace_id: z.string(),
+        bot_id: z.string(),
+    })
+        .nullable(),
+    workspaces: z.record(z.string(), SlackBotWorkspaceSchema),
+});
+export const SlackChannelSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    is_private: z.boolean(),
+    is_archived: z.boolean(),
+    created: z.number(),
+    creator: z.string(),
+    topic: z
+        .object({
+        value: z.string(),
+        creator: z.string(),
+        last_set: z.number(),
+    })
+        .optional(),
+    purpose: z
+        .object({
+        value: z.string(),
+        creator: z.string(),
+        last_set: z.number(),
+    })
+        .optional(),
+});
+export const SlackMessageSchema = z.object({
+    ts: z.string(),
+    text: z.string(),
+    user: z.string().optional(),
+    username: z.string().optional(),
+    type: z.string(),
+    thread_ts: z.string().optional(),
+    reply_count: z.number().optional(),
+    replies: z
+        .array(z.object({
+        user: z.string(),
+        ts: z.string(),
+    }))
+        .optional(),
+    edited: z
+        .object({
+        user: z.string(),
+        ts: z.string(),
+    })
+        .optional(),
+});
+export const SlackUserSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    real_name: z.string(),
+    is_admin: z.boolean(),
+    is_owner: z.boolean(),
+    is_bot: z.boolean(),
+    is_app_user: z.boolean(),
+    profile: z
+        .object({
+        email: z.string().optional(),
+        phone: z.string().optional(),
+        title: z.string().optional(),
+        status_text: z.string().optional(),
+    })
+        .optional(),
+});
+export const SlackReactionSchema = z.object({
+    name: z.string(),
+    count: z.number(),
+    users: z.array(z.string()),
+});
+export const SlackFileSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    title: z.string(),
+    mimetype: z.string(),
+    size: z.number(),
+    url_private: z.string(),
+    created: z.number(),
+    user: z.string(),
+    channels: z.array(z.string()).optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/src/platforms/slackbot/types.js.map

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

package/docs/content/docs/integrations/meta.json

@@ -1,5 +1,5 @@
 {
   "title": "Integrations",
   "icon": "Plug",
-  "pages": ["slack", "discord", "teams"]
+  "pages": ["slack", "slackbot", "discord", "teams"]
 }

package/docs/content/docs/integrations/slackbot.mdx

@@ -0,0 +1,204 @@
+---
+title: Slack Bot
+description: Complete reference for the agent-slackbot CLI.
+---
+
+> **Tip**: `agent-slackbot` uses bot tokens (xoxb-) instead of user tokens. Ideal for server-side and CI/CD integrations.
+
+## Quick Start
+
+```bash
+# 1. Set your bot token (from api.slack.com/apps)
+agent-slackbot auth set xoxb-your-bot-token
+
+# 2. Verify authentication
+agent-slackbot auth status
+
+# 3. Send a message
+agent-slackbot message send C0ACZKTDDC0 "Hello from bot!"
+```
+
+## Authentication
+
+### Create a Slack App
+
+The fastest way to get started is to create an app from the manifest below:
+
+1. Go to [api.slack.com/apps](https://api.slack.com/apps) → **Create New App** → **From an app manifest**
+2. Select your workspace
+3. Paste the manifest below (choose YAML tab) and click **Next** → **Create**
+4. Click **Install App** in the left sidebar, then hit **Install to Workspace**
+5. Copy the **Bot User OAuth Token** (starts with `xoxb-`) from the **Install App** page
+
+```yaml
+display_information:
+  name: Agent Messenger Bot
+  description: Bot for agent-messenger CLI integration
+  background_color: "#1a1a2e"
+
+features:
+  bot_user:
+    display_name: agent-messenger
+    always_online: false
+
+oauth_config:
+  scopes:
+    bot:
+      - chat:write
+      - channels:history
+      - channels:read
+      - channels:join
+      - groups:history
+      - groups:read
+      - users:read
+      - users:read.email
+      - reactions:write
+      - reactions:read
+
+settings:
+  org_deploy_enabled: false
+  socket_mode_enabled: false
+  token_rotation_enabled: false
+```
+
+Then set the token:
+
+```bash
+# Basic setup
+agent-slackbot auth set xoxb-your-bot-token
+
+# Or with a custom bot identifier for multi-bot setups
+agent-slackbot auth set xoxb-your-bot-token --bot deploy --name "Deploy Bot"
+
+# Verify it works
+agent-slackbot auth status
+```
+
+### Multi-Bot Support
+
+Store multiple bot tokens and switch between them:
+
+```bash
+# Add multiple bots
+agent-slackbot auth set xoxb-deploy-token --bot deploy --name "Deploy Bot"
+agent-slackbot auth set xoxb-alert-token --bot alert --name "Alert Bot"
+
+# List all stored bots
+agent-slackbot auth list
+
+# Switch active bot
+agent-slackbot auth use deploy
+
+# Use a specific bot for one command (without switching)
+agent-slackbot message send C0ACZKTDDC0 "Alert!" --bot alert
+
+# Remove a stored bot
+agent-slackbot auth remove deploy
+```
+
+### Scopes Reference
+
+| Scope | Used For |
+|-------|----------|
+| `chat:write` | Sending and updating messages |
+| `channels:history` | Reading public channel messages |
+| `channels:read` | Listing public channels |
+| `channels:join` | Joining public channels |
+| `groups:history` | Reading private channel messages |
+| `groups:read` | Listing private channels |
+| `users:read` | Listing users |
+| `users:read.email` | Reading user emails |
+| `reactions:write` | Adding/removing reactions |
+| `reactions:read` | Listing reactions |
+
+### Environment Variables (CI/CD)
+
+```bash
+export E2E_SLACKBOT_TOKEN=xoxb-your-bot-token
+export E2E_SLACKBOT_WORKSPACE_ID=T123456
+export E2E_SLACKBOT_WORKSPACE_NAME="My Workspace"
+```
+
+## Commands
+
+### Message Commands
+
+```bash
+# Send a message
+agent-slackbot message send <channel> <text>
+agent-slackbot message send C0ACZKTDDC0 "Hello world"
+
+# Send a threaded reply
+agent-slackbot message send C0ACZKTDDC0 "Reply" --thread <ts>
+
+# List messages
+agent-slackbot message list <channel>
+agent-slackbot message list C0ACZKTDDC0 --limit 50
+
+# Get a single message
+agent-slackbot message get <channel> <ts>
+
+# Get thread replies
+agent-slackbot message replies <channel> <thread_ts>
+agent-slackbot message replies C0ACZKTDDC0 1234567890.123456
+
+# Update a message (bot's own messages only)
+agent-slackbot message update <channel> <ts> <new-text>
+
+# Delete a message (bot's own messages only)
+agent-slackbot message delete <channel> <ts> --force
+```
+
+### Channel Commands
+
+```bash
+# List channels
+agent-slackbot channel list
+agent-slackbot channel list --limit 50
+
+# Get channel info
+agent-slackbot channel info <channel>
+agent-slackbot channel info C0ACZKTDDC0
+```
+
+### User Commands
+
+```bash
+# List users
+agent-slackbot user list
+agent-slackbot user list --limit 50
+
+# Get user info
+agent-slackbot user info <user-id>
+```
+
+### Reaction Commands
+
+```bash
+# Add reaction
+agent-slackbot reaction add <channel> <ts> <emoji>
+agent-slackbot reaction add C0ACZKTDDC0 1234567890.123456 thumbsup
+
+# Remove reaction
+agent-slackbot reaction remove <channel> <ts> <emoji>
+```
+
+## Key Differences from agent-slack
+
+| Feature | agent-slack | agent-slackbot |
+|---------|------------|----------------|
+| Token type | User token (xoxc-) | Bot token (xoxb-) |
+| Token source | Auto-extracted from desktop app | Manual from Slack App config |
+| Message search | Yes | No |
+| File operations | Yes | No |
+| Snapshot | Yes | No |
+| Edit/delete messages | Any message | Bot's own only |
+| Multi-bot support | N/A | Yes (`--bot` flag) |
+| CI/CD friendly | Requires desktop app | Yes |
+
+## AI Agent Integration
+
+See `skills/agent-slackbot/` directory for:
+- Complete skill documentation
+- Runnable templates
+- Common patterns for AI agents

package/docs/src/app/page.tsx

@@ -232,7 +232,24 @@ function ThemeToggle() {
   )
 }
 
+async function fetchNpmVersion(): Promise<string | null> {
+  try {
+    const res = await fetch('https://registry.npmjs.org/agent-messenger/latest')
+    if (!res.ok) return null
+    const data = await res.json()
+    return data.version ?? null
+  } catch {
+    return null
+  }
+}
+
 export default function Home() {
+  const [npmVersion, setNpmVersion] = useState<string | null>(null)
+
+  useEffect(() => {
+    fetchNpmVersion().then(setNpmVersion)
+  }, [])
+
   return (
     <div className="flex min-h-screen flex-col bg-zinc-50 dark:bg-black">
       <header className="sticky top-0 z-50 border-b border-zinc-200 bg-zinc-50/80 backdrop-blur-sm dark:border-zinc-800 dark:bg-black/80">
@@ -266,7 +283,7 @@ export default function Home() {
             <span className="animate-ping absolute inline-flex h-full w-full rounded-full bg-green-400 opacity-75"></span>
             <span className="relative inline-flex rounded-full h-2 w-2 bg-green-500"></span>
           </span>
-          v1.1.0 Available Now
+          {npmVersion ? `v${npmVersion} Available Now` : 'Available Now'}
         </div>
         <h1 className="max-w-4xl text-5xl font-extrabold tracking-tight text-zinc-900 dark:text-white sm:text-6xl md:text-7xl">
           Give your AI agent the power to <br className="hidden sm:block" />

package/e2e/config.ts

@@ -29,6 +29,32 @@ export async function validateSlackEnvironment() {
   }
 }
 
+// SlackBot Test Environment (same workspace as Slack, bot token)
+export const SLACKBOT_TEST_WORKSPACE_ID = 'T0AC55BSF6E'
+export const SLACKBOT_TEST_WORKSPACE_NAME = 'Agent Messenger'
+export const SLACKBOT_TEST_CHANNEL_ID = 'C0ACZKTDDC0'
+export const SLACKBOT_TEST_CHANNEL = 'e2e-test'
+
+export async function validateSlackBotEnvironment() {
+  const { runCLI, parseJSON } = await import('./helpers')
+
+  const result = await runCLI('slackbot', ['auth', 'status'])
+  if (result.exitCode !== 0) {
+    throw new Error('SlackBot authentication failed. Please run: agent-slackbot auth set <token>')
+  }
+
+  const data = parseJSON<{ workspace_id: string; valid: boolean }>(result.stdout)
+  if (!data?.valid) {
+    throw new Error('SlackBot token is invalid or expired. Please run: agent-slackbot auth set <token>')
+  }
+  if (data?.workspace_id !== SLACKBOT_TEST_WORKSPACE_ID) {
+    throw new Error(
+      `Wrong SlackBot workspace. Expected: ${SLACKBOT_TEST_WORKSPACE_NAME} (${SLACKBOT_TEST_WORKSPACE_ID}), ` +
+      `Got: ${data?.workspace_id}`
+    )
+  }
+}
+
 export async function validateDiscordEnvironment() {
   const { runCLI, parseJSON } = await import('./helpers')
   

package/e2e/helpers.ts

@@ -7,7 +7,12 @@ export interface CLIResult {
 }
 
 export async function runCLI(platform: string, args: string[]): Promise<CLIResult> {
-  const command = platform === 'slack' ? 'agent-slack' : 'agent-discord'
+  const commandMap: Record<string, string> = {
+    slack: 'agent-slack',
+    discord: 'agent-discord',
+    slackbot: 'agent-slackbot',
+  }
+  const command = commandMap[platform] || platform
   
   try {
     const result = await $`${command} ${args}`.quiet()