agent-messenger 2.10.1 → 2.11.0

package/src/platforms/slackbot/commands/file.ts

@@ -0,0 +1,212 @@
+import { readFileSync, statSync, writeFileSync } from 'node:fs'
+import { basename, join, resolve } from 'node:path'
+
+import { Command } from 'commander'
+
+import { handleError } from '@/shared/utils/error-handler'
+import { formatOutput } from '@/shared/utils/output'
+
+import { type BotOption, getClient } from './shared'
+
+async function uploadAction(
+  channelInput: string,
+  path: string,
+  options: BotOption & { filename?: string; thread?: string; title?: string; comment?: string },
+): Promise<void> {
+  try {
+    const client = await getClient(options)
+    const channel = await client.resolveChannel(channelInput)
+
+    const filePath = resolve(path)
+    const fileBuffer = readFileSync(filePath)
+    const filename = options.filename || basename(filePath) || 'file'
+
+    const file = await client.uploadFile(channel, fileBuffer, filename, {
+      thread_ts: options.thread,
+      title: options.title,
+      initial_comment: options.comment,
+    })
+
+    console.log(
+      formatOutput(
+        {
+          id: file.id,
+          name: file.name,
+          title: file.title,
+          mimetype: file.mimetype,
+          size: file.size,
+          url_private: file.url_private,
+          created: file.created,
+          user: file.user,
+          channels: file.channels,
+        },
+        options.pretty,
+      ),
+    )
+  } catch (error) {
+    handleError(error as Error)
+  }
+}
+
+async function listAction(options: BotOption & { channel?: string; user?: string; limit?: string }): Promise<void> {
+  try {
+    const client = await getClient(options)
+    const channel = options.channel ? await client.resolveChannel(options.channel) : undefined
+    const limit = options.limit ? parseInt(options.limit, 10) : undefined
+
+    const files = await client.listFiles({ channel, user: options.user, limit })
+
+    console.log(
+      formatOutput(
+        files.map((file) => ({
+          id: file.id,
+          name: file.name,
+          title: file.title,
+          mimetype: file.mimetype,
+          size: file.size,
+          url_private: file.url_private,
+          created: file.created,
+          user: file.user,
+          channels: file.channels,
+        })),
+        options.pretty,
+      ),
+    )
+  } catch (error) {
+    handleError(error as Error)
+  }
+}
+
+async function infoAction(fileId: string, options: BotOption): Promise<void> {
+  try {
+    const client = await getClient(options)
+    const file = await client.getFileInfo(fileId)
+
+    console.log(
+      formatOutput(
+        {
+          id: file.id,
+          name: file.name,
+          title: file.title,
+          mimetype: file.mimetype,
+          size: file.size,
+          url_private: file.url_private,
+          created: file.created,
+          user: file.user,
+          channels: file.channels,
+        },
+        options.pretty,
+      ),
+    )
+  } catch (error) {
+    handleError(error as Error)
+  }
+}
+
+async function downloadAction(fileId: string, outputPath: string | undefined, options: BotOption): Promise<void> {
+  try {
+    const client = await getClient(options)
+    const { buffer, file } = await client.downloadFile(fileId)
+
+    const safeName = basename(file.name.replace(/\\/g, '/'))
+    let destPath = outputPath ? resolve(outputPath) : resolve(safeName)
+    let isDirectory = false
+    try {
+      isDirectory = statSync(destPath).isDirectory()
+    } catch (error) {
+      const err = error as NodeJS.ErrnoException
+      if (err.code !== 'ENOENT') {
+        throw error
+      }
+    }
+
+    if (isDirectory) {
+      destPath = join(destPath, safeName)
+    }
+
+    writeFileSync(destPath, buffer)
+
+    console.log(
+      formatOutput(
+        {
+          id: file.id,
+          name: file.name,
+          mimetype: file.mimetype,
+          size: file.size,
+          path: destPath,
+        },
+        options.pretty,
+      ),
+    )
+  } catch (error) {
+    handleError(error as Error)
+  }
+}
+
+async function deleteAction(fileId: string, options: BotOption & { force?: boolean }): Promise<void> {
+  try {
+    if (!options.force) {
+      console.log(formatOutput({ warning: 'Use --force to confirm deletion', file_id: fileId }, options.pretty))
+      process.exit(1)
+    }
+
+    const client = await getClient(options)
+    await client.deleteFile(fileId)
+
+    console.log(formatOutput({ deleted: fileId }, options.pretty))
+  } catch (error) {
+    handleError(error as Error)
+  }
+}
+
+export const fileCommand = new Command('file')
+  .description('File commands')
+  .addCommand(
+    new Command('upload')
+      .description('Upload file to a channel')
+      .argument('<channel>', 'Channel ID or name')
+      .argument('<path>', 'File path')
+      .option('--filename <name>', 'Override filename')
+      .option('--thread <ts>', 'Upload as a reply to a thread')
+      .option('--title <title>', 'File title')
+      .option('--comment <text>', 'Initial comment posted with the file')
+      .option('--bot <id>', 'Use specific bot')
+      .option('--pretty', 'Pretty print JSON output')
+      .action(uploadAction),
+  )
+  .addCommand(
+    new Command('list')
+      .description('List files visible to the bot')
+      .option('--channel <id>', 'Filter by channel ID or name')
+      .option('--user <id>', 'Filter by user ID')
+      .option('--limit <n>', 'Number of files to fetch')
+      .option('--bot <id>', 'Use specific bot')
+      .option('--pretty', 'Pretty print JSON output')
+      .action(listAction),
+  )
+  .addCommand(
+    new Command('info')
+      .description('Show file details')
+      .argument('<file>', 'File ID')
+      .option('--bot <id>', 'Use specific bot')
+      .option('--pretty', 'Pretty print JSON output')
+      .action(infoAction),
+  )
+  .addCommand(
+    new Command('download')
+      .description('Download a file by ID')
+      .argument('<file>', 'File ID')
+      .argument('[output-path]', 'Output file path or directory')
+      .option('--bot <id>', 'Use specific bot')
+      .option('--pretty', 'Pretty print JSON output')
+      .action(downloadAction),
+  )
+  .addCommand(
+    new Command('delete')
+      .description("Delete a file (bot's own files only)")
+      .argument('<file>', 'File ID')
+      .option('--force', 'Skip confirmation')
+      .option('--bot <id>', 'Use specific bot')
+      .option('--pretty', 'Pretty print JSON output')
+      .action(deleteAction),
+  )

package/src/platforms/slackbot/commands/index.ts

@@ -1,5 +1,6 @@
 export { authCommand } from './auth'
 export { channelCommand } from './channel'
+export { fileCommand } from './file'
 export { messageCommand } from './message'
 export { reactionCommand } from './reaction'
 export { userCommand } from './user'

package/src/platforms/slackbot/commands/message.test.ts

@@ -1,4 +1,4 @@
-import { beforeEach, describe, expect, mock, test } from 'bun:test'
+import { beforeEach, describe, expect, mock, it } from 'bun:test'
 
 const mockResolveChannel = mock((_channel: string) => Promise.resolve('C123456'))
 const mockPostMessage = mock(() =>
@@ -68,7 +68,7 @@ describe('message commands', () => {
   })
 
   describe('postMessage', () => {
-    test('sends message to channel', async () => {
+    it('sends message to channel', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -81,7 +81,7 @@ describe('message commands', () => {
       expect(result.type).toBe('message')
     })
 
-    test('sends message with thread_ts', async () => {
+    it('sends message with thread_ts', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -94,7 +94,7 @@ describe('message commands', () => {
   })
 
   describe('getConversationHistory', () => {
-    test('returns messages from channel', async () => {
+    it('returns messages from channel', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -107,7 +107,7 @@ describe('message commands', () => {
       expect(messages[1].text).toBe('World')
     })
 
-    test('passes limit option', async () => {
+    it('passes limit option', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -120,7 +120,7 @@ describe('message commands', () => {
   })
 
   describe('getMessage', () => {
-    test('returns single message by ts', async () => {
+    it('returns single message by ts', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -133,7 +133,7 @@ describe('message commands', () => {
       expect(message?.text).toBe('Hello world')
     })
 
-    test('returns null when message not found', async () => {
+    it('returns null when message not found', async () => {
       // given
       mockGetMessage.mockResolvedValueOnce(null)
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
@@ -147,7 +147,7 @@ describe('message commands', () => {
   })
 
   describe('updateMessage', () => {
-    test('updates message text', async () => {
+    it('updates message text', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -159,7 +159,7 @@ describe('message commands', () => {
       expect(result.text).toBe('Updated text')
     })
 
-    test('called with correct arguments', async () => {
+    it('passes correct arguments', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -172,7 +172,7 @@ describe('message commands', () => {
   })
 
   describe('deleteMessage', () => {
-    test('deletes message by ts', async () => {
+    it('deletes message by ts', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -185,7 +185,7 @@ describe('message commands', () => {
   })
 
   describe('getThreadReplies', () => {
-    test('returns thread replies', async () => {
+    it('returns thread replies', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -198,7 +198,7 @@ describe('message commands', () => {
       expect(replies[1].text).toBe('Thread reply 2')
     })
 
-    test('passes limit option', async () => {
+    it('passes limit option', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -211,7 +211,7 @@ describe('message commands', () => {
   })
 
   describe('resolveChannel', () => {
-    test('resolves channel name to ID', async () => {
+    it('resolves channel name to ID', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 

package/src/platforms/slackbot/commands/message.ts

@@ -98,6 +98,18 @@ async function deleteAction(channelInput: string, ts: string, options: BotOption
   }
 }
 
+async function typingAction(channelInput: string, threadTs: string, status: string, options: BotOption): Promise<void> {
+  try {
+    const client = await getClient(options)
+    const channel = await client.resolveChannel(channelInput)
+    await client.setAssistantStatus(channel, threadTs, status)
+
+    console.log(formatOutput({ channel, thread_ts: threadTs, status }, options.pretty))
+  } catch (error) {
+    handleError(error as Error)
+  }
+}
+
 async function repliesAction(
   channelInput: string,
   threadTs: string,
@@ -165,6 +177,16 @@ export const messageCommand = new Command('message')
       .option('--pretty', 'Pretty print JSON output')
       .action(deleteAction),
   )
+  .addCommand(
+    new Command('typing')
+      .description('Set typing status in an AI Assistant thread (e.g. "is typing...")')
+      .argument('<channel>', 'Channel ID or name')
+      .argument('<thread_ts>', 'Thread timestamp')
+      .argument('[status]', 'Status text (pass empty string to clear)', 'is typing...')
+      .option('--bot <id>', 'Use specific bot')
+      .option('--pretty', 'Pretty print JSON output')
+      .action(typingAction),
+  )
   .addCommand(
     new Command('replies')
       .description('Get thread replies')

package/src/platforms/slackbot/commands/reaction.test.ts

@@ -1,4 +1,4 @@
-import { beforeEach, describe, expect, mock, test } from 'bun:test'
+import { beforeEach, describe, expect, mock, it } from 'bun:test'
 
 const mockResolveChannel = mock((_channel: string) => Promise.resolve('C123456'))
 const mockAddReaction = mock(() => Promise.resolve())
@@ -25,7 +25,7 @@ describe('reaction commands', () => {
   })
 
   describe('addReaction', () => {
-    test('adds emoji reaction to message', async () => {
+    it('adds emoji reaction to message', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -36,7 +36,7 @@ describe('reaction commands', () => {
       expect(mockAddReaction).toHaveBeenCalledWith('C123456', '1234567890.000100', 'thumbsup')
     })
 
-    test('called with correct arguments', async () => {
+    it('passes correct arguments', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -50,7 +50,7 @@ describe('reaction commands', () => {
   })
 
   describe('removeReaction', () => {
-    test('removes emoji reaction from message', async () => {
+    it('removes emoji reaction from message', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -61,7 +61,7 @@ describe('reaction commands', () => {
       expect(mockRemoveReaction).toHaveBeenCalledWith('C123456', '1234567890.000100', 'thumbsup')
     })
 
-    test('called with correct arguments', async () => {
+    it('passes correct arguments', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -75,7 +75,7 @@ describe('reaction commands', () => {
   })
 
   describe('resolveChannel', () => {
-    test('resolves channel name before reaction', async () => {
+    it('resolves channel name before reaction', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 

package/src/platforms/slackbot/commands/user.test.ts

@@ -1,4 +1,4 @@
-import { beforeEach, describe, expect, mock, test } from 'bun:test'
+import { beforeEach, describe, expect, mock, it } from 'bun:test'
 
 const mockListUsers = mock(() =>
   Promise.resolve([
@@ -61,7 +61,7 @@ describe('user commands', () => {
   })
 
   describe('listUsers', () => {
-    test('returns list of users', async () => {
+    it('returns list of users', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -74,7 +74,7 @@ describe('user commands', () => {
       expect(users[1].name).toBe('bob')
     })
 
-    test('includes user metadata', async () => {
+    it('includes user metadata', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -90,7 +90,7 @@ describe('user commands', () => {
       expect(user.is_admin).toBe(false)
     })
 
-    test('passes limit option', async () => {
+    it('passes limit option', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -103,7 +103,7 @@ describe('user commands', () => {
   })
 
   describe('getUserInfo', () => {
-    test('returns user details by ID', async () => {
+    it('returns user details by ID', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -116,7 +116,7 @@ describe('user commands', () => {
       expect(user.real_name).toBe('Alice Smith')
     })
 
-    test('includes profile information', async () => {
+    it('includes profile information', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 
@@ -129,7 +129,7 @@ describe('user commands', () => {
       expect(user.profile?.status_text).toBe('Working from home')
     })
 
-    test('called with correct user ID', async () => {
+    it('passes the user ID to getUserInfo', async () => {
       // given
       const client = await new SlackBotClient().login({ token: 'xoxb-test-token' })
 

package/src/platforms/slackbot/commands/whoami.test.ts

@@ -1,4 +1,4 @@
-import { afterEach, beforeEach, describe, expect, mock, test } from 'bun:test'
+import { afterEach, beforeEach, describe, expect, mock, it } from 'bun:test'
 import { existsSync, rmSync } from 'node:fs'
 import { mkdir } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
@@ -45,7 +45,7 @@ describe('whoami command', () => {
     process.env = originalEnv
   })
 
-  test('returns auth info for current bot', async () => {
+  it('returns auth info for current bot', async () => {
     const manager = new SlackBotCredentialManager(tempDir)
     await manager.setCredentials({
       token: 'xoxb-test-token',
@@ -65,7 +65,7 @@ describe('whoami command', () => {
     expect(result.error).toBeUndefined()
   })
 
-  test('returns auth info for specific --bot', async () => {
+  it('returns auth info for specific --bot', async () => {
     const manager = new SlackBotCredentialManager(tempDir)
     await manager.setCredentials({
       token: 'xoxb-test-token',
@@ -82,7 +82,7 @@ describe('whoami command', () => {
     expect(mockTestAuth).toHaveBeenCalledTimes(1)
   })
 
-  test('returns error when client throws', async () => {
+  it('returns error when client throws', async () => {
     mockTestAuth.mockImplementationOnce(() => Promise.reject(new Error('API Error')))
 
     const manager = new SlackBotCredentialManager(tempDir)

package/src/platforms/slackbot/commands/whoami.ts

@@ -1,6 +1,6 @@
 import { Command } from 'commander'
 
-import { formatOutput } from '@/shared/utils/output'
+import { cliOutput } from '@/shared/utils/cli-output'
 
 import type { BotOption } from './shared'
 import { getClient } from './shared'
@@ -30,11 +30,6 @@ export async function whoamiAction(options: BotOption): Promise<WhoamiResult> {
   }
 }
 
-function cliOutput(result: WhoamiResult, pretty?: boolean): void {
-  console.log(formatOutput(result, pretty))
-  if (result.error) process.exit(1)
-}
-
 export const whoamiCommand = new Command('whoami')
   .description('Show current authenticated bot')
   .option('--bot <id>', 'Bot ID to use')