agent-messenger 2.7.0 → 2.9.0

package/docs/content/docs/sdk/kakaotalk.mdx

@@ -10,10 +10,7 @@ npm install agent-messenger
 ```
 
 ```typescript
-import {
-  KakaoTalkClient,
-  KakaoCredentialManager,
-} from 'agent-messenger/kakaotalk'
+import { KakaoTalkClient, KakaoCredentialManager } from 'agent-messenger/kakaotalk'
 ```
 
 ## KakaoTalkClient
@@ -119,16 +116,16 @@ await listener.start()
 
 ### Events
 
-| Event | Payload | Description |
-|-------|---------|-------------|
-| `message` | `KakaoTalkPushMessageEvent` | New message received |
-| `member_joined` | `KakaoTalkPushMemberEvent` | Member joined a chat |
-| `member_left` | `KakaoTalkPushMemberEvent` | Member left a chat |
-| `read` | `KakaoTalkPushReadEvent` | Read receipt (unread count decreased) |
-| `kakaotalk_event` | `KakaoTalkPushGenericEvent` | Catch-all for all push events |
-| `connected` | `{ userId: string }` | Connected to LOCO server |
-| `disconnected` | — | Disconnected (will auto-reconnect) |
-| `error` | `Error` | Connection or protocol error |
+| Event             | Payload                     | Description                           |
+| ----------------- | --------------------------- | ------------------------------------- |
+| `message`         | `KakaoTalkPushMessageEvent` | New message received                  |
+| `member_joined`   | `KakaoTalkPushMemberEvent`  | Member joined a chat                  |
+| `member_left`     | `KakaoTalkPushMemberEvent`  | Member left a chat                    |
+| `read`            | `KakaoTalkPushReadEvent`    | Read receipt (unread count decreased) |
+| `kakaotalk_event` | `KakaoTalkPushGenericEvent` | Catch-all for all push events         |
+| `connected`       | `{ userId: string }`        | Connected to LOCO server              |
+| `disconnected`    | —                           | Disconnected (will auto-reconnect)    |
+| `error`           | `Error`                     | Connection or protocol error          |
 
 ### Reconnection
 
@@ -211,11 +208,15 @@ const manager = new KakaoCredentialManager()
 const account = await manager.getAccount()
 if (!account) throw new Error('Not authenticated')
 
-const client = await new KakaoTalkClient().login({ oauthToken: account.oauth_token, userId: account.user_id, deviceUuid: account.device_uuid })
+const client = await new KakaoTalkClient().login({
+  oauthToken: account.oauth_token,
+  userId: account.user_id,
+  deviceUuid: account.device_uuid,
+})
 
 try {
   const chats = await client.getChats({ all: true })
-  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.display_name} — ${chat.unread_count} unread`)
@@ -236,7 +237,11 @@ const manager = new KakaoCredentialManager()
 const account = await manager.getAccount()
 if (!account) throw new Error('Not authenticated')
 
-const client = await new KakaoTalkClient().login({ oauthToken: account.oauth_token, userId: account.user_id, deviceUuid: account.device_uuid })
+const client = await new KakaoTalkClient().login({
+  oauthToken: account.oauth_token,
+  userId: account.user_id,
+  deviceUuid: account.device_uuid,
+})
 
 try {
   const chats = await client.getChats({ search: 'Team' })
@@ -262,7 +267,11 @@ const manager = new KakaoCredentialManager()
 const account = await manager.getAccount()
 if (!account) throw new Error('Not authenticated')
 
-const client = await new KakaoTalkClient().login({ oauthToken: account.oauth_token, userId: account.user_id, deviceUuid: account.device_uuid })
+const client = await new KakaoTalkClient().login({
+  oauthToken: account.oauth_token,
+  userId: account.user_id,
+  deviceUuid: account.device_uuid,
+})
 const chatId = '9876543210'
 
 let lastLogId: string | undefined

package/docs/content/docs/sdk/line.mdx

@@ -10,12 +10,7 @@ npm install agent-messenger
 ```
 
 ```typescript
-import {
-  LineClient,
-  LineListener,
-  LineError,
-  LineCredentialManager,
-} from 'agent-messenger/line'
+import { LineClient, LineListener, LineError, LineCredentialManager } from 'agent-messenger/line'
 ```
 
 ## LineClient
@@ -164,13 +159,13 @@ await listener.start()
 
 ### Events
 
-| Event | Payload | Description |
-|-------|---------|-------------|
-| `message` | `LinePushMessageEvent` | New message received |
-| `line_event` | `LinePushGenericEvent` | Catch-all for all LINE events |
-| `connected` | `{ account_id: string }` | Connected to LINE server |
-| `disconnected` | — | Disconnected (will auto-reconnect) |
-| `error` | `Error` | Connection or protocol error |
+| Event          | Payload                  | Description                        |
+| -------------- | ------------------------ | ---------------------------------- |
+| `message`      | `LinePushMessageEvent`   | New message received               |
+| `line_event`   | `LinePushGenericEvent`   | Catch-all for all LINE events      |
+| `connected`    | `{ account_id: string }` | Connected to LINE server           |
+| `disconnected` | —                        | Disconnected (will auto-reconnect) |
+| `error`        | `Error`                  | Connection or protocol error       |
 
 ### Reconnection
 

package/docs/content/docs/sdk/meta.json

@@ -1,4 +1,17 @@
 {
   "title": "TypeScript SDK",
-  "pages": ["slack", "discord", "teams", "webex", "whatsapp", "whatsappbot", "line", "wechatbot", "instagram", "kakaotalk", "channeltalk", "channeltalkbot"]
+  "pages": [
+    "slack",
+    "discord",
+    "teams",
+    "webex",
+    "whatsapp",
+    "whatsappbot",
+    "line",
+    "wechatbot",
+    "instagram",
+    "kakaotalk",
+    "channeltalk",
+    "channeltalkbot"
+  ]
 }

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