agent-messenger 2.6.3 → 2.8.0

package/docs/content/docs/sdk/slack.mdx

@@ -10,12 +10,7 @@ npm install agent-messenger
 ```
 
 ```typescript
-import {
-  SlackClient,
-  SlackListener,
-  SlackError,
-  SlackCredentialManager,
-} from 'agent-messenger/slack'
+import { SlackClient, SlackListener, SlackError, SlackCredentialManager } from 'agent-messenger/slack'
 ```
 
 ## SlackClient
@@ -81,8 +76,8 @@ const url = await client.getPermalink(channel, ts)
 
 // Search messages across workspace
 const results = await client.searchMessages('keyword', {
-  sort: 'timestamp',   // 'score' | 'timestamp'
-  sortDir: 'desc',     // 'asc' | 'desc'
+  sort: 'timestamp', // 'score' | 'timestamp'
+  sortDir: 'desc', // 'asc' | 'desc'
   count: 20,
 })
 // → SlackSearchResult[]
@@ -122,7 +117,7 @@ const channel = await client.getChannel(channelId)
 
 // Resolve channel name to ID (passes IDs through unchanged)
 const id = await client.resolveChannel('general')
-const id = await client.resolveChannel('C0ABC123')  // returned as-is
+const id = await client.resolveChannel('C0ABC123') // returned as-is
 
 // Open a DM (or group DM) — returns existing channel if already open
 const dm = await client.openConversation('U0ABC123')
@@ -384,25 +379,26 @@ listener.on('slack_event', (event) => {
 
 listener.on('error', (err) => console.error(err))
 
-await listener.start()  // connects via RTM WebSocket
+await listener.start() // connects via RTM WebSocket
 // listener.stop()      // clean shutdown
 ```
 
 ### Available Events
 
-| Event | Description |
-|-------|-------------|
-| `message` | New message, edit, delete, thread reply |
-| `reaction_added` / `reaction_removed` | Reaction changes |
-| `member_joined_channel` / `member_left_channel` | Member changes |
-| `user_typing` | Typing indicator |
-| `presence_change` | User active/away status |
-| `channel_created` / `channel_deleted` / `channel_rename` / `channel_archive` / `channel_unarchive` | Channel lifecycle |
-| `slack_event` | Catch-all for every RTM event |
-| `connected` / `disconnected` | Connection lifecycle |
-| `error` | Connection or API error |
+| Event                                                                                              | Description                             |
+| -------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| `message`                                                                                          | New message, edit, delete, thread reply |
+| `reaction_added` / `reaction_removed`                                                              | Reaction changes                        |
+| `member_joined_channel` / `member_left_channel`                                                    | Member changes                          |
+| `user_typing`                                                                                      | Typing indicator                        |
+| `presence_change`                                                                                  | User active/away status                 |
+| `channel_created` / `channel_deleted` / `channel_rename` / `channel_archive` / `channel_unarchive` | Channel lifecycle                       |
+| `slack_event`                                                                                      | Catch-all for every RTM event           |
+| `connected` / `disconnected`                                                                       | Connection lifecycle                    |
+| `error`                                                                                            | Connection or API error                 |
 
 Features:
+
 - No channel subscription needed — receives all workspace events
 - Auto-reconnect with exponential backoff
 - Ping/pong keepalive
@@ -514,13 +510,16 @@ await client.addBookmark(channel.id, 'Figma Designs', 'https://figma.com/file/ab
 })
 
 // Pin welcome message
-const welcome = await client.sendMessage(channel.id, [
-  'Welcome to *Project Alpha*! 🎉',
-  '',
-  '📋 *Resources* — check the bookmarks above',
-  '🧵 *Discussions* — use threads to keep things organized',
-  '📌 *Decisions* — pin important messages',
-].join('\n'))
+const welcome = await client.sendMessage(
+  channel.id,
+  [
+    'Welcome to *Project Alpha*! 🎉',
+    '',
+    '📋 *Resources* — check the bookmarks above',
+    '🧵 *Discussions* — use threads to keep things organized',
+    '📌 *Decisions* — pin important messages',
+  ].join('\n'),
+)
 await client.pinMessage(channel.id, welcome.ts)
 ```
 
@@ -549,11 +548,7 @@ listener.on('message', async (event) => {
 
 listener.on('reaction_added', async (event) => {
   if (event.reaction === 'ticket' && event.user !== auth.user_id) {
-    await client.sendMessage(
-      event.item.channel,
-      `Ticket created for <@${event.user}>'s message.`,
-      event.item.ts,
-    )
+    await client.sendMessage(event.item.channel, `Ticket created for <@${event.user}>'s message.`, event.item.ts)
   }
 })
 
@@ -626,11 +621,7 @@ for (const result of results) {
   await client.addReaction(result.channel.id, result.ts, 'eyes')
 
   // Reply in thread
-  await client.sendMessage(
-    result.channel.id,
-    'Flagged for review — will follow up shortly.',
-    result.ts,
-  )
+  await client.sendMessage(result.channel.id, 'Flagged for review — will follow up shortly.', result.ts)
 
   // Schedule a follow-up reminder
   const inOneHour = Math.floor(Date.now() / 1000) + 3600
@@ -663,9 +654,12 @@ for (const file of files.slice(0, 5)) {
   // Re-upload to archive
   const uploaded = await client.uploadFile([target], buffer, file.name)
 
-  await client.sendMessage(target, [
-    `📎 Archived *${file.name}* from <#${source}>`,
-    `Original uploader: <@${file.user}> · ${(file.size / 1024).toFixed(0)} KB`,
-  ].join('\n'))
+  await client.sendMessage(
+    target,
+    [
+      `📎 Archived *${file.name}* from <#${source}>`,
+      `Original uploader: <@${file.user}> · ${(file.size / 1024).toFixed(0)} KB`,
+    ].join('\n'),
+  )
 }
 ```

package/docs/content/docs/sdk/teams.mdx

@@ -10,11 +10,7 @@ npm install agent-messenger
 ```
 
 ```typescript
-import {
-  TeamsClient,
-  TeamsCredentialManager,
-  TeamsError,
-} from 'agent-messenger/teams'
+import { TeamsClient, TeamsCredentialManager, TeamsError } from 'agent-messenger/teams'
 ```
 
 ## TeamsClient
@@ -306,9 +302,7 @@ for (const channel of channels.slice(0, 5)) {
   const messages = await client.getMessages(teamId, channel.id, 1)
   const latest = messages[0]
   if (latest) {
-    console.log(
-      `#${channel.name}: "${latest.content.slice(0, 60)}" — ${latest.author.displayName}`,
-    )
+    console.log(`#${channel.name}: "${latest.content.slice(0, 60)}" — ${latest.author.displayName}`)
   } else {
     console.log(`#${channel.name}: (no messages)`)
   }

package/docs/content/docs/sdk/webex.mdx

@@ -10,11 +10,7 @@ npm install agent-messenger
 ```
 
 ```typescript
-import {
-  WebexClient,
-  WebexCredentialManager,
-  WebexError,
-} from 'agent-messenger/webex'
+import { WebexClient, WebexCredentialManager, WebexError } from 'agent-messenger/webex'
 ```
 
 ## WebexClient
@@ -150,13 +146,7 @@ await manager.clearCredentials()
 ## Types
 
 ```typescript
-import type {
-  WebexSpace,
-  WebexMessage,
-  WebexPerson,
-  WebexMembership,
-  WebexConfig,
-} from 'agent-messenger/webex'
+import type { WebexSpace, WebexMessage, WebexPerson, WebexMembership, WebexConfig } from 'agent-messenger/webex'
 ```
 
 ### Zod Schemas

package/docs/content/docs/sdk/wechatbot.mdx

@@ -10,11 +10,7 @@ npm install agent-messenger
 ```
 
 ```typescript
-import {
-  WeChatBotClient,
-  WeChatBotCredentialManager,
-  WeChatBotError,
-} from 'agent-messenger/wechatbot'
+import { WeChatBotClient, WeChatBotCredentialManager, WeChatBotError } from 'agent-messenger/wechatbot'
 ```
 
 ## WeChatBotClient

package/docs/content/docs/sdk/whatsapp.mdx

@@ -10,10 +10,7 @@ npm install agent-messenger
 ```
 
 ```typescript
-import {
-  WhatsAppClient,
-  WhatsAppCredentialManager,
-} from 'agent-messenger/whatsapp'
+import { WhatsAppClient, WhatsAppCredentialManager } from 'agent-messenger/whatsapp'
 ```
 
 ## WhatsAppClient
@@ -195,22 +192,16 @@ import type {
 ## Exported Utilities
 
 ```typescript
-import {
-  createAccountId,
-  extractMessageText,
-  getMessageType,
-  jidToType,
-  WhatsAppError,
-} from 'agent-messenger/whatsapp'
+import { createAccountId, extractMessageText, getMessageType, jidToType, WhatsAppError } from 'agent-messenger/whatsapp'
 ```
 
-| Export | Description |
-|--------|-------------|
-| `createAccountId(input)` | Normalizes a phone number or string into a safe account ID |
-| `extractMessageText(message)` | Pulls the text content from a Baileys `proto.IMessage` |
-| `getMessageType(message)` | Returns the message type (`text`, `image`, `video`, etc.) from a Baileys `proto.IMessage` |
-| `jidToType(jid)` | Maps a JID to its chat type: `individual`, `group`, `broadcast`, or `status` |
-| `WhatsAppError` | Error class with a `code` property for programmatic error handling |
+| Export                        | Description                                                                               |
+| ----------------------------- | ----------------------------------------------------------------------------------------- |
+| `createAccountId(input)`      | Normalizes a phone number or string into a safe account ID                                |
+| `extractMessageText(message)` | Pulls the text content from a Baileys `proto.IMessage`                                    |
+| `getMessageType(message)`     | Returns the message type (`text`, `image`, `video`, etc.) from a Baileys `proto.IMessage` |
+| `jidToType(jid)`              | Maps a JID to its chat type: `individual`, `group`, `broadcast`, or `status`              |
+| `WhatsAppError`               | Error class with a `code` property for programmatic error handling                        |
 
 ## Examples
 
@@ -226,7 +217,7 @@ await client.connect()
 
 try {
   const chats = await client.listChats()
-  const unread = chats.filter(c => c.unread_count > 0)
+  const unread = chats.filter((c) => c.unread_count > 0)
   console.log(`${unread.length} chats with unread messages:`)
   for (const chat of unread) {
     console.log(`  ${chat.name} (${chat.type}) — ${chat.unread_count} unread`)

package/docs/content/docs/sdk/whatsappbot.mdx

@@ -10,11 +10,7 @@ npm install agent-messenger
 ```
 
 ```typescript
-import {
-  WhatsAppBotClient,
-  WhatsAppBotCredentialManager,
-  WhatsAppBotError,
-} from 'agent-messenger/whatsappbot'
+import { WhatsAppBotClient, WhatsAppBotCredentialManager, WhatsAppBotError } from 'agent-messenger/whatsappbot'
 ```
 
 ## WhatsAppBotClient
@@ -66,11 +62,7 @@ const reaction = await client.sendReaction('12025551234', 'wamid.abc123', '\u{1F
 
 // Send an image message
 const image = await client.sendImageMessage('12025551234', 'https://example.com/photo.jpg')
-const captioned = await client.sendImageMessage(
-  '12025551234',
-  'https://example.com/photo.jpg',
-  'Product screenshot',
-)
+const captioned = await client.sendImageMessage('12025551234', 'https://example.com/photo.jpg', 'Product screenshot')
 // → WhatsAppBotMessageResponse
 
 // Send a document message

package/docs/content/docs/tui.mdx

@@ -28,35 +28,35 @@ The TUI has three navigation levels and three input modes.
 
 ### Navigation Levels
 
-| Level | What it shows | How to enter |
-| --- | --- | --- |
-| **Platform** | All 10 platforms with online/offline status | Launch or press `Esc` from workspace level |
-| **Workspace** | Workspaces for the selected platform (skipped if only one) | Select a platform |
-| **Channel** | Channels in the current workspace | Select a workspace |
+| Level         | What it shows                                              | How to enter                               |
+| ------------- | ---------------------------------------------------------- | ------------------------------------------ |
+| **Platform**  | All 10 platforms with online/offline status                | Launch or press `Esc` from workspace level |
+| **Workspace** | Workspaces for the selected platform (skipped if only one) | Select a platform                          |
+| **Channel**   | Channels in the current workspace                          | Select a workspace                         |
 
 ### Input Modes
 
-| Mode | Focus | What you can do |
-| --- | --- | --- |
-| **Selection** | Sidebar | Navigate platforms, workspaces, and channels |
-| **Read** | Message log | Scroll through messages, switch to write mode |
-| **Write** | Input box | Type and send messages |
+| Mode          | Focus       | What you can do                               |
+| ------------- | ----------- | --------------------------------------------- |
+| **Selection** | Sidebar     | Navigate platforms, workspaces, and channels  |
+| **Read**      | Message log | Scroll through messages, switch to write mode |
+| **Write**     | Input box   | Type and send messages                        |
 
 ## Keybindings
 
-| Key | Context | Action |
-| --- | --- | --- |
-| `↑` `↓` | Sidebar | Navigate items |
-| `Enter` / `→` | Sidebar | Drill into selected item |
-| `←` / `Esc` | Sidebar | Go back one level |
-| `Enter` | Read mode | Switch to write mode |
-| `Esc` | Read mode | Switch to selection mode |
-| `Enter` | Write mode | Send message |
-| `Esc` / `Tab` | Write mode | Switch to read mode |
-| `Tab` / `Shift+Tab` | Read/Write | Toggle between read and write |
-| `Ctrl+K` | Any (non-auth) | Fuzzy channel picker |
-| `Ctrl+W` | Read/Write | Fuzzy workspace picker |
-| `Ctrl+C` | Any | Quit |
+| Key                 | Context        | Action                        |
+| ------------------- | -------------- | ----------------------------- |
+| `↑` `↓`             | Sidebar        | Navigate items                |
+| `Enter` / `→`       | Sidebar        | Drill into selected item      |
+| `←` / `Esc`         | Sidebar        | Go back one level             |
+| `Enter`             | Read mode      | Switch to write mode          |
+| `Esc`               | Read mode      | Switch to selection mode      |
+| `Enter`             | Write mode     | Send message                  |
+| `Esc` / `Tab`       | Write mode     | Switch to read mode           |
+| `Tab` / `Shift+Tab` | Read/Write     | Toggle between read and write |
+| `Ctrl+K`            | Any (non-auth) | Fuzzy channel picker          |
+| `Ctrl+W`            | Read/Write     | Fuzzy workspace picker        |
+| `Ctrl+C`            | Any            | Quit                          |
 
 ## Features