agent-messenger 1.2.0 → 1.3.1

package/docs/content/docs/index.mdx

@@ -4,27 +4,18 @@ description: Give your AI agent the power to read and send messages across Slack
 icon: Info
 ---
 
-Agent Messenger is a unified, agent-friendly CLI for messaging platforms. It automatically extracts credentials from your desktop apps—no OAuth flows, no API keys, no admin approval needed.
+Agent Messenger is a unified, agent-friendly CLI for messaging platforms. Zero-config credential extraction from your desktop apps—no OAuth flows, no API keys, no admin approval needed. Works out of the box.
 
 ## Why Agent Messenger?
 
-### For AI Agents
+Messaging platforms only offer Bot tokens for API access—your AI agent can never act **as you**. Agent Messenger extracts user credentials directly from your installed desktop apps, letting your agent operate on your behalf. Bot tokens are fully supported too for server-side and CI/CD use cases.
 
-AI agents need to communicate with humans through messaging platforms. But integrating with Slack, Discord, or Teams traditionally requires:
-
-- **OAuth setup** - Creating apps, getting admin approval, managing tokens
-- **API keys** - Storing secrets, handling rotation, security concerns
-- **Platform-specific code** - Learning different APIs for each platform
-
-Agent Messenger eliminates all of this. Your agent can start sending messages in seconds.
-
-### For Developers
-
-Building AI-powered workflows that interact with messaging platforms shouldn't require a week of OAuth debugging. Agent Messenger provides:
-
-- **Zero configuration** - Extract tokens from your existing desktop apps
-- **Unified interface** - Same commands work across all platforms
-- **JSON output** - Perfect for piping into other tools or LLMs
+- **Act as yourself, not a bot** — Extracted user tokens let your agent operate on your behalf
+- **No API keys needed** — Automatically extracts credentials from your installed desktop apps
+- **One interface, multiple platforms** — Learn once, use everywhere (Slack, Discord, Teams)
+- **AI-agent friendly** — JSON output by default, perfect for LLM tool use
+- **Human friendly too** — Add `--pretty` for readable output
+- **Token efficient** — CLI, not MCP. Load only what you need
 
 ## How It Works
 
@@ -49,6 +40,7 @@ No app creation. No admin approval. No waiting.
 | **Multi-workspace** | Switch between workspaces/servers easily |
 | **JSON output** | Machine-readable by default, `--pretty` for humans |
 | **Comprehensive** | Messages, channels, users, reactions, files |
+| **Bot support** | [`agent-slackbot`](/docs/integrations/slackbot) for server-side and CI/CD |
 
 ## Why Not MCP?
 
@@ -88,7 +80,7 @@ OAuth is better when you need:
 - **Multi-user applications** - Many users authenticating separately
 - **Granular permissions** - Fine-tuned access control
 
-Bot support is on our roadmap for these use cases.
+For these use cases, Agent Messenger also supports bot tokens via [`agent-slackbot`](/docs/integrations/slackbot).
 
 ## Design Principles
 
@@ -116,6 +108,7 @@ Tokens stay on your machine. Nothing is sent to external servers. Your credentia
 
 - [Quick Start](/docs/quick-start) - Get running in 30 seconds
 - [Slack](/docs/integrations/slack) - Full Slack command reference
+- [Slack Bot](/docs/integrations/slackbot) - Bot token integration for server-side and CI/CD
 - [Discord](/docs/integrations/discord) - Full Discord command reference
 - [Teams](/docs/integrations/teams) - Full Teams command reference
 

package/docs/content/docs/integrations/discord.mdx

@@ -200,8 +200,72 @@ All commands support these options:
 | User ID | Alphanumeric (U01234567) | Numeric snowflake (123456789012345678) |
 | Threads | Thread timestamps | Thread channels |
 
+### DM Commands
+
+```bash
+# List DM channels
+agent-discord dm list
+
+# Create a DM channel with a user
+agent-discord dm create <user-id>
+```
+
+### Thread Commands
+
+```bash
+# Create a thread in a channel
+agent-discord thread create <channel-id> <name>
+agent-discord thread create 123456789 "Bug Discussion" --auto-archive-duration 1440
+
+# Archive a thread
+agent-discord thread archive <thread-id>
+```
+
+### Mention Commands
+
+```bash
+# List recent mentions
+agent-discord mention list
+agent-discord mention list --limit 10
+
+# Filter by guild
+agent-discord mention list --guild <guild-id>
+```
+
+### Member Commands
+
+```bash
+# Search guild members
+agent-discord member search <guild-id> <query>
+agent-discord member search 123456789 "john" --limit 20
+```
+
+### Friend Commands
+
+```bash
+# List friends and relationships
+agent-discord friend list
+```
+
+### Profile Commands
+
+```bash
+# Get a user's profile
+agent-discord profile get <user-id>
+```
+
+### Note Commands
+
+```bash
+# Get your note on a user
+agent-discord note get <user-id>
+
+# Set a note on a user
+agent-discord note set <user-id> "Met at conference"
+```
+
 ## AI Agent Integration
 
-See `skills/agent-messenger/` directory for:
+See [`skills/agent-discord/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-discord) for:
 - Complete skill documentation
 - Runnable templates

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/slack.mdx

@@ -154,8 +154,58 @@ agent-slack snapshot --users-only
 agent-slack snapshot --limit 10
 ```
 
+### Activity Commands
+
+```bash
+# List activity feed
+agent-slack activity list
+agent-slack activity list --limit 50
+
+# Show only unread activity
+agent-slack activity list --unread
+
+# Filter by activity types
+agent-slack activity list --types thread_reply,message_reaction,at_user,at_channel,keyword
+```
+
+### Unread Commands
+
+```bash
+# Get unread counts for all channels
+agent-slack unread counts
+
+# Get thread subscription details
+agent-slack unread threads <channel> <thread_ts>
+
+# Mark channel as read up to a timestamp
+agent-slack unread mark <channel> <ts>
+```
+
+### Drafts Commands
+
+```bash
+# List message drafts
+agent-slack drafts list
+agent-slack drafts list --limit 10
+```
+
+### Saved Items Commands
+
+```bash
+# List saved items
+agent-slack saved list
+agent-slack saved list --limit 10
+```
+
+### Sections Commands
+
+```bash
+# List channel sections (sidebar folders)
+agent-slack sections list
+```
+
 ## AI Agent Integration
 
-See `skills/agent-messenger/` directory for:
+See [`skills/agent-slack/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-slack) for:
 - Complete skill documentation
 - Runnable templates

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

@@ -0,0 +1,214 @@
+---
+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
+```
+
+### Authentication Commands
+
+```bash
+# Check bot auth status
+agent-slackbot auth status
+
+# Clear all stored credentials
+agent-slackbot auth clear
+```
+
+### 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/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-slackbot) for:
+- Complete skill documentation
+- Runnable templates
+- Common patterns for AI agents

package/docs/content/docs/integrations/teams.mdx

@@ -109,6 +109,9 @@ agent-teams team current
 
 # Get team info
 agent-teams team info <team-id>
+
+# Remove a stored team
+agent-teams team remove <team-id>
 ```
 
 ## Commands
@@ -283,7 +286,7 @@ Some operations require specific Microsoft 365 permissions. Check with your IT a
 
 ## AI Agent Integration
 
-See `skills/agent-messenger/` directory for:
+See [`skills/agent-teams/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-teams) for:
 - Complete skill documentation
 - Runnable templates
 

package/docs/content/docs/quick-start.mdx

@@ -23,8 +23,9 @@ yarn global add agent-messenger
 bun add -g agent-messenger
 ```
 
-This installs three CLI tools:
-- `agent-slack` — Slack CLI
+This installs four CLI tools:
+- `agent-slack` — Slack CLI (user token, zero-config)
+- `agent-slackbot` — Slack Bot CLI (bot token, for server-side/CI/CD)
 - `agent-discord` — Discord CLI
 - `agent-teams` — Microsoft Teams CLI
 

package/docs/src/app/layout.config.tsx

@@ -1,7 +1,14 @@
 import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared'
+import Image from 'next/image'
+import icon from './icon.png'
 
 export const baseOptions: BaseLayoutProps = {
   nav: {
-    title: 'Agent Messenger',
+    title: (
+      <>
+        <Image src={icon} alt="Agent Messenger" width={24} height={24} />
+        Agent Messenger
+      </>
+    ),
   },
 }

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()