agent-messenger 1.3.0 → 1.3.2

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

@@ -74,6 +74,16 @@ agent-slackbot auth set xoxb-your-bot-token --bot deploy --name "Deploy Bot"
 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:
@@ -198,7 +208,7 @@ agent-slackbot reaction remove <channel> <ts> <emoji>
 
 ## AI Agent Integration
 
-See `skills/agent-slackbot/` directory for:
+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/package.json

@@ -1,28 +1,34 @@
 {
   "name": "agent-messenger",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Multi-platform messaging CLI for AI agents (Slack, Discord, Teams)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/devxoul/agent-messenger"
+  },
   "type": "module",
   "module": "dist/cli.js",
   "main": "dist/cli.js",
   "bin": {
-    "agent-messenger": "./src/cli.ts",
-    "amsg": "./src/cli.ts",
-    "agent-slack": "./src/platforms/slack/cli.ts",
-    "agent-discord": "./src/platforms/discord/cli.ts",
-    "agent-teams": "./src/platforms/teams/cli.ts",
-    "agent-slackbot": "./src/platforms/slackbot/cli.ts"
+    "agent-messenger": "dist/src/cli.js",
+    "amsg": "dist/src/cli.js",
+    "agent-slack": "dist/src/platforms/slack/cli.js",
+    "agent-discord": "dist/src/platforms/discord/cli.js",
+    "agent-teams": "dist/src/platforms/teams/cli.js",
+    "agent-slackbot": "dist/src/platforms/slackbot/cli.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && tsc-alias",
     "postbuild": "bun scripts/postbuild.ts",
     "test": "bun test src/",
     "test:e2e": "bun test e2e/",
     "typecheck": "tsc --noEmit",
     "lint": "biome check .",
+    "lint:fix": "biome check --write --unsafe .",
     "format": "biome format --write .",
     "dev": "bun --hot ./dist/cli.js",
-    "prepublishOnly": "bun run build"
+    "prepublishOnly": "bun run build && bun scripts/prepublish.ts",
+    "postpublish": "git checkout package.json"
   },
   "dependencies": {
     "@slack/web-api": "^6.9.0",
@@ -36,6 +42,7 @@
     "@types/better-sqlite3": "^7.6.8",
     "@types/bun": "latest",
     "@types/node": "^20.10.6",
+    "tsc-alias": "^1.8.16",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   }

package/scripts/prepublish.ts

@@ -0,0 +1,11 @@
+import { readFileSync, writeFileSync } from 'node:fs'
+
+const pkgPath = 'package.json'
+const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
+
+for (const [name, path] of Object.entries(pkg.bin as Record<string, string>)) {
+  pkg.bin[name] = path.replace(/^\.\/src\//, 'dist/src/').replace(/\.ts$/, '.js')
+}
+
+writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`)
+console.log('Rewrote bin paths for publish')

package/skills/agent-discord/SKILL.md

@@ -333,6 +333,20 @@ Format:
 - Plain text messages only (no embeds in v1)
 - User tokens only (no bot tokens)
 
+## Troubleshooting
+
+### `agent-discord: command not found`
+
+The `agent-messenger` package is not installed. Run it directly using a package runner. Ask the user which one to use:
+
+```bash
+npx -p agent-messenger agent-discord ...
+bunx -p agent-messenger agent-discord ...
+pnpm dlx --package agent-messenger agent-discord ...
+```
+
+If you already know the user's preferred package runner, use it directly instead of asking.
+
 ## References
 
 - [Authentication Guide](references/authentication.md)

package/skills/agent-slack/SKILL.md

@@ -315,6 +315,20 @@ Format:
 - No user presence features
 - Plain text messages only (no blocks/formatting in v1)
 
+## Troubleshooting
+
+### `agent-slack: command not found`
+
+The `agent-messenger` package is not installed. Run it directly using a package runner. Ask the user which one to use:
+
+```bash
+npx -p agent-messenger agent-slack ...
+bunx -p agent-messenger agent-slack ...
+pnpm dlx --package agent-messenger agent-slack ...
+```
+
+If you already know the user's preferred package runner, use it directly instead of asking.
+
 ## References
 
 - [Authentication Guide](references/authentication.md)

package/skills/agent-slackbot/SKILL.md

@@ -279,6 +279,20 @@ Format:
 - No scheduled messages
 - Plain text messages only (no blocks/formatting)
 
+## Troubleshooting
+
+### `agent-slackbot: command not found`
+
+The `agent-messenger` package is not installed. Run it directly using a package runner. Ask the user which one to use:
+
+```bash
+npx -p agent-messenger agent-slackbot ...
+bunx -p agent-messenger agent-slackbot ...
+pnpm dlx --package agent-messenger agent-slackbot ...
+```
+
+If you already know the user's preferred package runner, use it directly instead of asking.
+
 ## References
 
 - [Authentication Guide](references/authentication.md)

package/skills/agent-teams/SKILL.md

@@ -286,6 +286,20 @@ Format:
 - User tokens only (no app tokens)
 - **Token expires in 60-90 minutes** - must re-authenticate frequently
 
+## Troubleshooting
+
+### `agent-teams: command not found`
+
+The `agent-messenger` package is not installed. Run it directly using a package runner. Ask the user which one to use:
+
+```bash
+npx -p agent-messenger agent-teams ...
+bunx -p agent-messenger agent-teams ...
+pnpm dlx --package agent-messenger agent-teams ...
+```
+
+If you already know the user's preferred package runner, use it directly instead of asking.
+
 ## References
 
 - [Authentication Guide](references/authentication.md)

package/src/cli.ts

@@ -10,10 +10,7 @@ const __dirname = dirname(__filename)
 
 const program = new Command()
 
-program
-  .name('agent-messenger')
-  .description('Multi-platform messaging CLI for AI agents')
-  .version(pkg.version)
+program.name('agent-messenger').description('Multi-platform messaging CLI for AI agents').version(pkg.version)
 
 // Use absolute paths for CWD-independence
 program.command('slack', 'Interact with Slack workspaces', {

package/src/platforms/discord/client.test.ts

@@ -11,10 +11,7 @@ describe('DiscordClient', () => {
     fetchCalls = []
     fetchResponses = []
     fetchIndex = 0
-    ;(globalThis as any).fetch = async (
-      url: string | URL | Request,
-      options?: RequestInit
-    ): Promise<Response> => {
+    ;(globalThis as any).fetch = async (url: string | URL | Request, options?: RequestInit): Promise<Response> => {
       fetchCalls.push({ url: url.toString(), options })
       const response = fetchResponses[fetchIndex]
       fetchIndex++
@@ -45,7 +42,7 @@ describe('DiscordClient', () => {
       new Response(body === null ? null : JSON.stringify(body), {
         status,
         headers: defaultHeaders,
-      })
+      }),
     )
   }
 
@@ -236,7 +233,7 @@ describe('DiscordClient', () => {
       await client.addReaction('ch1', 'msg1', '👍')
 
       expect(fetchCalls[0].url).toBe(
-        'https://discord.com/api/v10/channels/ch1/messages/msg1/reactions/%F0%9F%91%8D/@me'
+        'https://discord.com/api/v10/channels/ch1/messages/msg1/reactions/%F0%9F%91%8D/@me',
       )
       expect(fetchCalls[0].options?.method).toBe('PUT')
     })
@@ -250,7 +247,7 @@ describe('DiscordClient', () => {
       await client.removeReaction('ch1', 'msg1', '👍')
 
       expect(fetchCalls[0].url).toBe(
-        'https://discord.com/api/v10/channels/ch1/messages/msg1/reactions/%F0%9F%91%8D/@me'
+        'https://discord.com/api/v10/channels/ch1/messages/msg1/reactions/%F0%9F%91%8D/@me',
       )
       expect(fetchCalls[0].options?.method).toBe('DELETE')
     })
@@ -258,10 +255,7 @@ describe('DiscordClient', () => {
 
   describe('listUsers', () => {
     test('returns list of server members', async () => {
-      mockResponse([
-        { user: { id: 'u1', username: 'user1' } },
-        { user: { id: 'u2', username: 'user2' } },
-      ])
+      mockResponse([{ user: { id: 'u1', username: 'user1' } }, { user: { id: 'u2', username: 'user2' } }])
 
       const client = new DiscordClient('test-token')
       const users = await client.listUsers('111')
@@ -324,9 +318,7 @@ describe('DiscordClient', () => {
           author: { id: '123', username: 'user1' },
           content: '',
           timestamp: '2024-01-01T00:00:00.000Z',
-          attachments: [
-            { id: 'att1', filename: 'file1.txt', size: 100, url: 'https://example.com/file1.txt' },
-          ],
+          attachments: [{ id: 'att1', filename: 'file1.txt', size: 100, url: 'https://example.com/file1.txt' }],
         },
         {
           id: 'msg2',

package/src/platforms/discord/client.ts

@@ -143,7 +143,7 @@ export class DiscordClient {
         const errorBody = await response.json().catch(() => ({}))
         throw new DiscordError(
           (errorBody as any).message || `HTTP ${response.status}`,
-          (errorBody as any).code?.toString() || `http_${response.status}`
+          (errorBody as any).code?.toString() || `http_${response.status}`,
         )
       }
 
@@ -176,7 +176,7 @@ export class DiscordClient {
       const errorBody = await response.json().catch(() => ({}))
       throw new DiscordError(
         (errorBody as any).message || `HTTP ${response.status}`,
-        (errorBody as any).code?.toString() || `http_${response.status}`
+        (errorBody as any).code?.toString() || `http_${response.status}`,
       )
     }
 
@@ -221,18 +221,12 @@ export class DiscordClient {
 
   async addReaction(channelId: string, messageId: string, emoji: string): Promise<void> {
     const encodedEmoji = encodeURIComponent(emoji)
-    return this.request<void>(
-      'PUT',
-      `/channels/${channelId}/messages/${messageId}/reactions/${encodedEmoji}/@me`
-    )
+    return this.request<void>('PUT', `/channels/${channelId}/messages/${messageId}/reactions/${encodedEmoji}/@me`)
   }
 
   async removeReaction(channelId: string, messageId: string, emoji: string): Promise<void> {
     const encodedEmoji = encodeURIComponent(emoji)
-    return this.request<void>(
-      'DELETE',
-      `/channels/${channelId}/messages/${messageId}/reactions/${encodedEmoji}/@me`
-    )
+    return this.request<void>('DELETE', `/channels/${channelId}/messages/${messageId}/reactions/${encodedEmoji}/@me`)
   }
 
   async ackMessage(channelId: string, messageId: string): Promise<void> {
@@ -245,10 +239,7 @@ export class DiscordClient {
     interface GuildMember {
       user: DiscordUser
     }
-    const members = await this.request<GuildMember[]>(
-      'GET',
-      `/guilds/${serverId}/members?limit=1000`
-    )
+    const members = await this.request<GuildMember[]>('GET', `/guilds/${serverId}/members?limit=1000`)
     return members.map((m) => m.user)
   }
 
@@ -266,10 +257,7 @@ export class DiscordClient {
     interface MessageWithAttachments extends DiscordMessage {
       attachments: DiscordFile[]
     }
-    const message = await this.requestFormData<MessageWithAttachments>(
-      `/channels/${channelId}/messages`,
-      formData
-    )
+    const message = await this.requestFormData<MessageWithAttachments>(`/channels/${channelId}/messages`, formData)
 
     return message.attachments[0]
   }
@@ -278,10 +266,7 @@ export class DiscordClient {
     interface MessageWithAttachments extends DiscordMessage {
       attachments: DiscordFile[]
     }
-    const messages = await this.request<MessageWithAttachments[]>(
-      'GET',
-      `/channels/${channelId}/messages?limit=100`
-    )
+    const messages = await this.request<MessageWithAttachments[]>('GET', `/channels/${channelId}/messages?limit=100`)
 
     const files: DiscordFile[] = []
     for (const msg of messages) {
@@ -334,25 +319,18 @@ export class DiscordClient {
     return this.request<DiscordRelationship[]>('GET', '/users/@me/relationships')
   }
 
-  async searchMembers(
-    guildId: string,
-    query: string,
-    limit: number = 10
-  ): Promise<DiscordGuildMember[]> {
+  async searchMembers(guildId: string, query: string, limit: number = 10): Promise<DiscordGuildMember[]> {
     const params = new URLSearchParams()
     params.set('query', query)
     params.set('limit', limit.toString())
 
-    return this.request<DiscordGuildMember[]>(
-      'GET',
-      `/guilds/${guildId}/members/search?${params.toString()}`
-    )
+    return this.request<DiscordGuildMember[]>('GET', `/guilds/${guildId}/members/search?${params.toString()}`)
   }
 
   async searchMessages(
     guildId: string,
     query: string,
-    options: DiscordSearchOptions = {}
+    options: DiscordSearchOptions = {},
   ): Promise<{ results: DiscordSearchResult[]; total: number }> {
     const params = new URLSearchParams()
     params.set('content', query)
@@ -381,7 +359,7 @@ export class DiscordClient {
 
     const response = await this.request<DiscordSearchResponse>(
       'GET',
-      `/guilds/${guildId}/messages/search?${params.toString()}`
+      `/guilds/${guildId}/messages/search?${params.toString()}`,
     )
 
     const results = response.messages
@@ -413,7 +391,7 @@ export class DiscordClient {
     options?: {
       auto_archive_duration?: number
       rate_limit_per_user?: number
-    }
+    },
   ): Promise<DiscordChannel> {
     return this.request<DiscordChannel>('POST', `/channels/${channelId}/threads`, {
       name,

package/src/platforms/discord/commands/auth.test.ts

@@ -34,14 +34,9 @@ beforeEach(() => {
     servers: {},
   })
 
-  credManagerSaveSpy = spyOn(DiscordCredentialManager.prototype, 'save').mockResolvedValue(
-    undefined
-  )
+  credManagerSaveSpy = spyOn(DiscordCredentialManager.prototype, 'save').mockResolvedValue(undefined)
 
-  credManagerClearTokenSpy = spyOn(
-    DiscordCredentialManager.prototype,
-    'clearToken'
-  ).mockResolvedValue(undefined)
+  credManagerClearTokenSpy = spyOn(DiscordCredentialManager.prototype, 'clearToken').mockResolvedValue(undefined)
 })
 
 afterEach(() => {

package/src/platforms/discord/commands/auth.ts

@@ -1,6 +1,6 @@
 import { Command } from 'commander'
-import { handleError } from '../../../shared/utils/error-handler'
-import { formatOutput } from '../../../shared/utils/output'
+import { handleError } from '@/shared/utils/error-handler'
+import { formatOutput } from '@/shared/utils/output'
 import { DiscordClient } from '../client'
 import { DiscordCredentialManager } from '../credential-manager'
 import { DiscordTokenExtractor } from '../token-extractor'
@@ -36,12 +36,11 @@ export async function extractAction(options: { pretty?: boolean; debug?: boolean
       console.log(
         formatOutput(
           {
-            error:
-              'No Discord token found. Make sure Discord desktop app is installed and logged in.',
+            error: 'No Discord token found. Make sure Discord desktop app is installed and logged in.',
             hint: options.debug ? undefined : 'Run with --debug for more info.',
           },
-          options.pretty
-        )
+          options.pretty,
+        ),
       )
       process.exit(1)
     }
@@ -76,8 +75,8 @@ export async function extractAction(options: { pretty?: boolean; debug?: boolean
             {
               error: 'No servers found. Make sure you are a member of at least one Discord server.',
             },
-            options.pretty
-          )
+            options.pretty,
+          ),
         )
         process.exit(1)
       }
@@ -117,8 +116,8 @@ export async function extractAction(options: { pretty?: boolean; debug?: boolean
             error: `Token validation failed: ${(error as Error).message}`,
             hint: 'Make sure your Discord token is valid and has not expired.',
           },
-          options.pretty
-        )
+          options.pretty,
+        ),
       )
       process.exit(1)
     }
@@ -133,9 +132,7 @@ export async function logoutAction(options: { pretty?: boolean }): Promise<void>
     const config = await credManager.load()
 
     if (!config.token) {
-      console.log(
-        formatOutput({ error: 'Not authenticated. Run "auth extract" first.' }, options.pretty)
-      )
+      console.log(formatOutput({ error: 'Not authenticated. Run "auth extract" first.' }, options.pretty))
       process.exit(1)
     }
 
@@ -153,9 +150,7 @@ export async function statusAction(options: { pretty?: boolean }): Promise<void>
     const config = await credManager.load()
 
     if (!config.token) {
-      console.log(
-        formatOutput({ error: 'Not authenticated. Run "auth extract" first.' }, options.pretty)
-      )
+      console.log(formatOutput({ error: 'Not authenticated. Run "auth extract" first.' }, options.pretty))
       process.exit(1)
     }
 
@@ -190,17 +185,17 @@ export const authCommand = new Command('auth')
       .description('Extract token from Discord desktop app')
       .option('--pretty', 'Pretty print JSON output')
       .option('--debug', 'Show debug output for troubleshooting')
-      .action(extractAction)
+      .action(extractAction),
   )
   .addCommand(
     new Command('logout')
       .description('Logout from Discord')
       .option('--pretty', 'Pretty print JSON output')
-      .action(logoutAction)
+      .action(logoutAction),
   )
   .addCommand(
     new Command('status')
       .description('Show authentication status')
       .option('--pretty', 'Pretty print JSON output')
-      .action(statusAction)
+      .action(statusAction),
   )

package/src/platforms/discord/commands/channel.test.ts

@@ -15,29 +15,27 @@ beforeEach(() => {
     { id: 'ch-3', guild_id: 'guild-1', name: 'voice-channel', type: 2, topic: undefined },
   ])
 
-  clientGetChannelSpy = spyOn(DiscordClient.prototype, 'getChannel').mockImplementation(
-    async (channelId: string) => {
-      if (channelId === 'ch-1') {
-        return {
-          id: 'ch-1',
-          guild_id: 'guild-1',
-          name: 'general',
-          type: 0,
-          topic: 'General discussion',
-        }
+  clientGetChannelSpy = spyOn(DiscordClient.prototype, 'getChannel').mockImplementation(async (channelId: string) => {
+    if (channelId === 'ch-1') {
+      return {
+        id: 'ch-1',
+        guild_id: 'guild-1',
+        name: 'general',
+        type: 0,
+        topic: 'General discussion',
       }
-      if (channelId === 'ch-2') {
-        return {
-          id: 'ch-2',
-          guild_id: 'guild-1',
-          name: 'announcements',
-          type: 0,
-          topic: 'Announcements',
-        }
+    }
+    if (channelId === 'ch-2') {
+      return {
+        id: 'ch-2',
+        guild_id: 'guild-1',
+        name: 'announcements',
+        type: 0,
+        topic: 'Announcements',
       }
-      throw new Error('Channel not found')
     }
-  )
+    throw new Error('Channel not found')
+  })
 
   clientGetMessagesSpy = spyOn(DiscordClient.prototype, 'getMessages').mockResolvedValue([
     {