agent-messenger 1.2.0 → 1.3.1

package/skills/agent-slackbot/templates/workspace-summary.sh

@@ -0,0 +1,113 @@
+#!/bin/bash
+#
+# workspace-summary.sh - Generate a workspace summary via bot token
+#
+# Usage:
+#   ./workspace-summary.sh [--json]
+#
+# Options:
+#   --json  Output raw JSON instead of formatted text
+#
+# Example:
+#   ./workspace-summary.sh
+#   ./workspace-summary.sh --json > summary.json
+
+set -euo pipefail
+
+OUTPUT_JSON=false
+if [ $# -gt 0 ] && [ "$1" = "--json" ]; then
+  OUTPUT_JSON=true
+fi
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+if ! command -v agent-slackbot &> /dev/null; then
+  echo -e "${RED}Error: agent-slackbot not found${NC}" >&2
+  echo "Install: npm install -g agent-messenger" >&2
+  exit 1
+fi
+
+AUTH_STATUS=$(agent-slackbot auth status 2>&1)
+VALID=$(echo "$AUTH_STATUS" | jq -r '.valid // false')
+
+if [ "$VALID" != "true" ]; then
+  echo -e "${RED}Not authenticated! Run: agent-slackbot auth set xoxb-your-token${NC}" >&2
+  exit 1
+fi
+
+WORKSPACE=$(echo "$AUTH_STATUS" | jq -r '.workspace_name // "Unknown"')
+WORKSPACE_ID=$(echo "$AUTH_STATUS" | jq -r '.workspace_id // "Unknown"')
+BOT_NAME=$(echo "$AUTH_STATUS" | jq -r '.user // "Unknown"')
+
+echo -e "${YELLOW}Fetching workspace data...${NC}" >&2
+
+CHANNELS=$(agent-slackbot channel list 2>&1)
+CHANNEL_COUNT=$(echo "$CHANNELS" | jq 'length')
+PUBLIC_COUNT=$(echo "$CHANNELS" | jq '[.[] | select(.is_private == false)] | length')
+PRIVATE_COUNT=$(echo "$CHANNELS" | jq '[.[] | select(.is_private == true)] | length')
+
+USERS=$(agent-slackbot user list 2>&1)
+USER_COUNT=$(echo "$USERS" | jq 'length')
+
+if [ "$OUTPUT_JSON" = true ]; then
+  jq -n \
+    --arg workspace "$WORKSPACE" \
+    --arg workspace_id "$WORKSPACE_ID" \
+    --arg bot "$BOT_NAME" \
+    --argjson channels "$CHANNELS" \
+    --argjson users "$USERS" \
+    '{
+      workspace: { name: $workspace, id: $workspace_id, bot: $bot },
+      channels: $channels,
+      users: $users
+    }'
+  exit 0
+fi
+
+echo ""
+echo -e "${BOLD}${BLUE}Workspace Summary${NC}"
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+echo -e "${BOLD}Workspace:${NC} $WORKSPACE"
+echo -e "${BOLD}ID:${NC}        $WORKSPACE_ID"
+echo -e "${BOLD}Bot:${NC}       $BOT_NAME"
+echo ""
+
+echo -e "${BOLD}${CYAN}Channels (${CHANNEL_COUNT} total)${NC}"
+echo -e "  Public:  $PUBLIC_COUNT"
+echo -e "  Private: $PRIVATE_COUNT"
+echo ""
+
+echo -e "${BOLD}${CYAN}Channel List:${NC}"
+echo "$CHANNELS" | jq -r '.[0:10] | .[] | "  #\(.name) (\(.id))"'
+if [ "$CHANNEL_COUNT" -gt 10 ]; then
+  echo "  ... and $((CHANNEL_COUNT - 10)) more"
+fi
+echo ""
+
+echo -e "${BOLD}${CYAN}Users (${USER_COUNT} total)${NC}"
+echo ""
+echo "$USERS" | jq -r '.[0:10] | .[] | "  \(.name) - \(.real_name // "N/A") (\(.id))"'
+if [ "$USER_COUNT" -gt 10 ]; then
+  echo "  ... and $((USER_COUNT - 10)) more"
+fi
+echo ""
+
+echo -e "${BOLD}${CYAN}Quick Actions:${NC}"
+echo ""
+FIRST_CHANNEL=$(echo "$CHANNELS" | jq -r '.[0].id // "C123"')
+FIRST_CHANNEL_NAME=$(echo "$CHANNELS" | jq -r '.[0].name // "general"')
+echo -e "  ${GREEN}# Send message to #$FIRST_CHANNEL_NAME${NC}"
+echo -e "  agent-slackbot message send $FIRST_CHANNEL \"Hello!\""
+echo ""
+echo -e "  ${GREEN}# List recent messages${NC}"
+echo -e "  agent-slackbot message list $FIRST_CHANNEL --limit 10"
+echo ""
+
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"

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([
     {

package/src/platforms/discord/commands/channel.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'
 
@@ -10,9 +10,7 @@ export async function listAction(options: { pretty?: boolean }): Promise<void> {
     const config = await credManager.load()
 
     if (!config.token || !config.current_server) {
-      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)
     }
 
@@ -41,9 +39,7 @@ export async function infoAction(channelId: string, options: { pretty?: boolean
     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)
     }
 
@@ -65,18 +61,13 @@ export async function infoAction(channelId: string, options: { pretty?: boolean
   }
 }
 
-export async function historyAction(
-  channelId: string,
-  options: { limit?: number; pretty?: boolean }
-): Promise<void> {
+export async function historyAction(channelId: string, options: { limit?: number; pretty?: boolean }): Promise<void> {
   try {
     const credManager = new DiscordCredentialManager()
     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)
     }
 
@@ -103,14 +94,14 @@ export const channelCommand = new Command('channel')
     new Command('list')
       .description('List channels in current server')
       .option('--pretty', 'Pretty print JSON output')
-      .action(listAction)
+      .action(listAction),
   )
   .addCommand(
     new Command('info')
       .description('Get channel info')
       .argument('<channel-id>', 'Channel ID')
       .option('--pretty', 'Pretty print JSON output')
-      .action(infoAction)
+      .action(infoAction),
   )
   .addCommand(
     new Command('history')
@@ -123,5 +114,5 @@ export const channelCommand = new Command('channel')
           limit: parseInt(options.limit, 10),
           pretty: options.pretty,
         })
-      })
+      }),
   )

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

@@ -37,9 +37,7 @@ const mockChannels: DiscordDMChannel[] = [
 ]
 
 beforeEach(() => {
-  clientListDMChannelsSpy = spyOn(DiscordClient.prototype, 'listDMChannels').mockResolvedValue(
-    mockChannels
-  )
+  clientListDMChannelsSpy = spyOn(DiscordClient.prototype, 'listDMChannels').mockResolvedValue(mockChannels)
 
   clientCreateDMSpy = spyOn(DiscordClient.prototype, 'createDM').mockResolvedValue({
     id: '999',

package/src/platforms/discord/commands/dm.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 type { DiscordDMChannel } from '../types'
@@ -11,9 +11,7 @@ export async function listAction(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)
     }
 
@@ -43,9 +41,7 @@ export async function createAction(userId: string, options: { pretty?: boolean }
     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)
     }
 
@@ -74,12 +70,12 @@ export const dmCommand = new Command('dm')
     new Command('list')
       .description('List DM channels')
       .option('--pretty', 'Pretty print JSON output')
-      .action(listAction)
+      .action(listAction),
   )
   .addCommand(
     new Command('create')
       .description('Create a DM channel')
       .argument('<user-id>', 'User ID to create DM with')
       .option('--pretty', 'Pretty print JSON output')
-      .action(createAction)
+      .action(createAction),
   )