agent-messenger 2.31.0 → 2.32.1

package/docs/content/docs/sdk/discord.mdx

@@ -144,8 +144,19 @@ const dm = await client.createDM(userId)
 const mentions = await client.getMentions()
 const filtered = await client.getMentions({ limit: 10, guildId: serverId })
 // → DiscordMention[]
+
+// Get only unread mentions — the messages behind Discord's unread-mention badge
+const unread = await client.getUnreadMentions()
+const scoped = await client.getUnreadMentions({ guildId: serverId, limit: 200 })
+// → DiscordUnreadMentionsResult { mentions, count, badgeCount, complete, windowDays }
+
+// Snapshot per-channel read state directly (one-shot gateway connect)
+const readState = await client.fetchReadState()
+// → DiscordReadState[] { channelId, lastMessageId, mentionCount }
 ```
 
+`getUnreadMentions` correlates recent mention history (Discord's 7-day window) with per-channel read state, returning only mentions newer than each channel's read marker. `count` is the number of enumerated unread mentions; `badgeCount` is Discord's own account-wide unread-mention badge total (not narrowed by `guildId`, since read states carry no guild association); `complete` is `true` when the scan exhausted all available mention history (Discord's 7-day window) and `false` when it stopped early at `limit` or a non-advancing cursor.
+
 ### User Notes
 
 ```typescript
@@ -345,6 +356,9 @@ import type {
   DiscordReaction,
   DiscordFile,
   DiscordMention,
+  DiscordReadState,
+  DiscordUnreadMention,
+  DiscordUnreadMentionsResult,
   DiscordUserNote,
   DiscordSearchResult,
   DiscordSearchResponse,
@@ -478,6 +492,30 @@ for (const mention of mentions) {
 }
 ```
 
+### Unread Mentions Digest
+
+Fetch only unread mentions, reply to each, and mark them read.
+
+```typescript
+import { DiscordClient } from 'agent-messenger/discord'
+
+const client = await new DiscordClient().login({ token })
+
+const { mentions, count, badgeCount, complete } = await client.getUnreadMentions()
+
+console.log(`${count} unread mentions fetched (badge shows ${badgeCount})`)
+if (!complete) {
+  console.log('The scan hit the limit — some unread mentions may not have been fetched')
+}
+
+for (const mention of mentions) {
+  await client.sendMessage(mention.channel_id, `On it <@${mention.author.id}>!`)
+
+  // Mark the message read so it drops off the unread badge
+  await client.ackMessage(mention.channel_id, mention.id)
+}
+```
+
 ### Search Triage
 
 Search for urgent messages, acknowledge with a reaction, and reply with a follow-up.

package/e2e/README.md

@@ -199,10 +199,10 @@ When triggering manually, you can select which platform to test:
 | ------------- | ------------------------------------------ |
 | `auth`        | status                                     |
 | `server`      | list, current, info                        |
-| `message`     | send, list, get\*, delete, ack, search     |
+| `message`     | send, list, get, delete, ack, search       |
 | `channel`     | list, info, history                        |
 | `user`        | list\*, me, info                           |
-| `reaction`    | add\*, list\*, remove\*                    |
+| `reaction`    | add, list, remove                           |
 | `file`        | upload, list, info                         |
 | `snapshot`    | default\*, --channels-only, --users-only\* |
 

package/e2e/discord.e2e.test.ts

@@ -83,7 +83,7 @@ describe('Discord E2E Tests', () => {
       expect(Array.isArray(data)).toBe(true)
     })
 
-    it.skip('message get retrieves specific message (requires bot token)', async () => {
+    it('message get retrieves specific message', async () => {
       const testId = generateTestId()
       const { id } = await createTestMessage('discord', DISCORD_TEST_CHANNEL_ID, `Get test ${testId}`)
       testMessages.push(id)
@@ -194,7 +194,7 @@ describe('Discord E2E Tests', () => {
   })
 
   describe('reaction', () => {
-    it.skip('reaction add/list/remove lifecycle (requires bot token)', async () => {
+    it('reaction add/list/remove lifecycle', async () => {
       const testId = generateTestId()
       const { id } = await createTestMessage('discord', DISCORD_TEST_CHANNEL_ID, `Reaction test ${testId}`)
       testMessages.push(id)
@@ -210,12 +210,26 @@ describe('Discord E2E Tests', () => {
       // List reactions
       const listResult = await runCLI('discord', ['reaction', 'list', DISCORD_TEST_CHANNEL_ID, id])
       expect(listResult.exitCode).toBe(0)
+      const listed = parseJSON<{ reactions: Array<{ emoji: { name: string | null }; count: number }> }>(
+        listResult.stdout,
+      )
+      const addedReaction = listed?.reactions.find((reaction) => reaction.emoji.name === '👍')
+      expect(addedReaction?.count).toBeGreaterThan(0)
 
       await waitForRateLimit()
 
       // Remove reaction
       const removeResult = await runCLI('discord', ['reaction', 'remove', DISCORD_TEST_CHANNEL_ID, id, '👍'])
       expect(removeResult.exitCode).toBe(0)
+
+      await waitForRateLimit()
+
+      const afterRemoveResult = await runCLI('discord', ['reaction', 'list', DISCORD_TEST_CHANNEL_ID, id])
+      expect(afterRemoveResult.exitCode).toBe(0)
+      const afterRemove = parseJSON<{ reactions: Array<{ emoji: { name: string | null }; count: number }> }>(
+        afterRemoveResult.stdout,
+      )
+      expect(afterRemove?.reactions.find((reaction) => reaction.emoji.name === '👍')).toBeUndefined()
     }, 15000) // Longer timeout for multiple operations
   })
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-messenger",
-  "version": "2.31.0",
+  "version": "2.32.1",
   "description": "Multi-platform messaging CLI for AI agents (Slack, Discord, Teams, Webex, Telegram, Telegram Bot, WhatsApp, LINE, iMessage, Instagram, KakaoTalk, Channel Talk)",
   "repository": {
     "type": "git",
@@ -193,6 +193,7 @@
     "pngjs": "^7.0.0",
     "qrcode": "^1.5.4",
     "thrift": "^0.20.0",
+    "tough-cookie": "^6.0.2",
     "tweetnacl": "^1.0.3",
     "webex-message-handler": "^0.6.10",
     "ws": "^8.19.0",

package/skills/agent-channeltalk/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-channeltalk
 description: Interact with Channel Talk using extracted desktop app or browser credentials - read chats, send messages, search messages, manage groups
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-channeltalk:*)
 metadata:
   openclaw:
@@ -438,14 +438,14 @@ npx -y agent-messenger channeltalk snapshot --pretty
 
 ### Channel Talk desktop app not found
 
-The CLI looks for the Channel Talk desktop app's cookie database in these locations:
+The CLI looks for the desktop app's cookie database in these locations. The app was rebranded from Channel Talk to Channel Works, so both names are probed, `Channel Works` first.
 
 **macOS:**
-1. `~/Library/Containers/com.zoyi.channel.desk.osx/Data/Library/Application Support/Channel Talk/Cookies` (Mac App Store version)
-2. `~/Library/Application Support/Channel Talk/Cookies` (direct download / Electron version)
+1. `~/Library/Containers/com.zoyi.channel.desk.osx/Data/Library/Application Support/{Channel Works,Channel Talk}/Cookies` (Mac App Store version)
+2. `~/Library/Application Support/{Channel Works,Channel Talk}/Cookies` (direct download / Electron version)
 
 **Windows:**
-1. `%APPDATA%\Channel Talk\Network\Cookies`
+1. `%APPDATA%\{Channel Works,Channel Talk}\Network\Cookies`
 
 If none exist, log in to Channel Talk in a supported Chromium browser (Chrome, Edge, Arc, Brave) or install the desktop app and log in.
 

package/skills/agent-channeltalk/references/authentication.md

@@ -29,7 +29,7 @@ Use `--browser-profile <path>` for agent-browser profiles, custom Chrome user da
 1. Locates the Channel Talk desktop app's SQLite cookie database
 2. Scans Chromium browser profiles for Channel Talk cookies when the desktop app isn't found, or when custom `--browser-profile` paths are provided
 3. Copies the database to a temp file (avoids locking the original)
-4. Reads `x-account` and `ch-session-1` cookies for `*.channel.io`
+4. Reads `x-account` and `ch-session-1` cookies for `*.channel.io` and `*.channel.works`
 5. Decrypts encrypted cookies if needed (macOS Keychain, Linux peanuts, Windows DPAPI)
 6. Validates cookies against the Channel Talk API
 7. Discovers ALL workspaces you belong to
@@ -48,15 +48,19 @@ When extracting from the desktop app, no Keychain prompt is needed (cookies are
 
 ### Platform-Specific Paths
 
+The desktop app was rebranded from Channel Talk to Channel Works. Both directory names are probed, `Channel Works` first, so upgraded and legacy installs both work.
+
 **macOS (Mac App Store / sandboxed):**
 
 ```
+~/Library/Containers/com.zoyi.channel.desk.osx/Data/Library/Application Support/Channel Works/Cookies
 ~/Library/Containers/com.zoyi.channel.desk.osx/Data/Library/Application Support/Channel Talk/Cookies
 ```
 
 **macOS (Electron / direct download):**
 
 ```
+~/Library/Application Support/Channel Works/Cookies
 ~/Library/Application Support/Channel Talk/Cookies
 ```
 
@@ -253,10 +257,10 @@ No credentials are configured and auto-extraction failed:
 
 The CLI first checks for the desktop app, then falls back to Chromium browsers.
 
-Desktop app paths:
-1. **macOS (Mac App Store)**: `~/Library/Containers/com.zoyi.channel.desk.osx/Data/Library/Application Support/Channel Talk/Cookies`
-2. **macOS (Electron)**: `~/Library/Application Support/Channel Talk/Cookies`
-3. **Windows**: `%APPDATA%/Channel Talk/Network/Cookies`
+Desktop app paths (`Channel Works` is the current name, `Channel Talk` the legacy one; both are probed):
+1. **macOS (Mac App Store)**: `~/Library/Containers/com.zoyi.channel.desk.osx/Data/Library/Application Support/{Channel Works,Channel Talk}/Cookies`
+2. **macOS (Electron)**: `~/Library/Application Support/{Channel Works,Channel Talk}/Cookies`
+3. **Windows**: `%APPDATA%/{Channel Works,Channel Talk}/Network/Cookies`
 
 If neither the desktop app nor browser cookies are found:
 

package/skills/agent-channeltalkbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-channeltalkbot
 description: Interact with Channel Talk workspaces using API credentials - send messages, read chats, manage groups and bots
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-channeltalkbot:*)
 metadata:
   openclaw:

package/skills/agent-discord/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-discord
 description: Interact with Discord servers - send messages, read channels, manage reactions
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-discord:*)
 metadata:
   openclaw:
@@ -212,7 +212,9 @@ agent-discord message search "hello" --channel <channel-id> --author <user-id>
 ### Channel Commands
 
 ```bash
-# List channels in current server (text channels only)
+# List channels in current server
+# Includes text, announcement, voice/stage (voice channels carry text chat),
+# forum, media, and directory channels. Categories and threads are excluded.
 agent-discord channel list
 
 # Get channel info
@@ -269,8 +271,20 @@ agent-discord dm create <user-id>
 agent-discord mention list
 agent-discord mention list --limit 50
 agent-discord mention list --guild <server-id>
+
+# List only unread mentions (the app's unread-mention badge)
+agent-discord mention unread
+agent-discord mention unread --guild <server-id>
+agent-discord mention unread --limit 200
 ```
 
+`mention unread` correlates your recent mention history (last 7 days) with Discord's
+per-channel read state, returning only mentions newer than each channel's read marker.
+Output includes `count` (enumerated unread mentions), `badge_count` (Discord's own
+account-wide unread-mention badge total — not narrowed by `--guild`), and `complete`
+(whether the scan reached the end of history within the 7-day window). `badge_count`
+can exceed `count` when unread mentions fall outside the 7-day window.
+
 ### Friend Commands
 
 ```bash
@@ -365,9 +379,11 @@ agent-discord snapshot --full --limit 10
 Default returns brief JSON with:
 
 - Server metadata (id, name)
-- Channels (id, name) — text channels only
+- Channels (id, name) — all listable channels (text, announcement, voice/stage, forum, media, directory; excludes categories and threads)
 - Hint for next commands
 
+> Not every listed channel accepts a direct `message list`. Forum, media, and directory channels are containers or hub views with no direct message timeline — their messages live in child posts/threads. Use text, announcement, voice, or stage channels for `message list`.
+
 With `--full`, returns comprehensive JSON with:
 
 - Server metadata (id, name)
@@ -503,6 +519,12 @@ const { results } = await client.searchMessages(serverId, 'deployment', {
   limit: 5,
 })
 
+// List unread mentions (correlates mention history with per-channel read state)
+const { mentions, count, badgeCount, complete } = await client.getUnreadMentions()
+// count = enumerated unread mentions; badgeCount = account-wide badge total;
+// complete = true when all available mentions (7-day window) were scanned,
+// false when the scan stopped early at the limit or a non-advancing cursor
+
 // Create a thread
 const thread = await client.createThread(channelId, 'Discussion Topic')
 await client.sendMessage(thread.id, 'First message in thread')
@@ -538,7 +560,7 @@ See the [Discord SDK documentation](https://agent-messenger.dev/docs/sdk/discord
 
 ## Limitations
 
-- No voice channel support
+- No voice audio support (voice/stage channels are listed and their embedded text chat is readable, but joining voice or streaming audio is unsupported)
 - No server management (create/delete channels, roles)
 - No slash commands
 - No webhook support

package/skills/agent-discord/references/common-patterns.md

@@ -87,12 +87,16 @@ CHANNEL_COUNT=$(echo "$SNAPSHOT" | jq -r '.channels | length')
 echo "Server: $SERVER_NAME"
 echo "Channels: $CHANNEL_COUNT"
 
-# List all text channels
+# List all channels
 echo -e "\nChannels:"
 echo "$SNAPSHOT" | jq -r '.channels[] | "  #\(.name) (\(.id))"'
 
-# Then drill into a specific channel for recent activity
-CHANNEL_ID=$(echo "$SNAPSHOT" | jq -r '.channels[0].id // empty')
+# Then drill into a specific channel for recent activity.
+# Only text (0), announcement (5), voice (2), and stage (13) channels accept
+# `message list`; forum (15), media (16), and directory (14) channels do not.
+# A full snapshot includes `type`, so pick the first message-readable channel.
+FULL=$(agent-discord snapshot --full)
+CHANNEL_ID=$(echo "$FULL" | jq -r '[.channels[] | select(.type == 0 or .type == 5 or .type == 2 or .type == 13)][0].id // empty')
 if [ -n "$CHANNEL_ID" ]; then
   echo -e "\nRecent messages:"
   agent-discord message list "$CHANNEL_ID" --limit 10

package/skills/agent-discordbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-discordbot
 description: Interact with Discord servers using bot tokens - send messages, read channels, manage reactions
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-discordbot:*)
 metadata:
   openclaw:

package/skills/agent-imessage/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-imessage
 description: Interact with iMessage on a Mac via the imsg tool - send messages, read chats, watch for new messages
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-imessage:*)
 metadata:
   openclaw:

package/skills/agent-instagram/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-instagram
 description: Interact with Instagram DMs - send messages, read conversations, manage accounts
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-instagram:*)
 metadata:
   openclaw:

package/skills/agent-kakaotalk/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-kakaotalk
 description: Interact with KakaoTalk - send messages, read chats, manage conversations
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-kakaotalk:*)
 metadata:
   openclaw:

package/skills/agent-line/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-line
 description: Interact with LINE - send messages, read chats, manage conversations
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-line:*)
 metadata:
   openclaw:

package/skills/agent-slack/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-slack
 description: Interact with Slack workspaces - send messages, read channels, manage reactions
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-slack:*)
 metadata:
   openclaw:
@@ -607,7 +607,30 @@ await new SlackCredentialManager().setWorkspace({
 })
 ```
 
-`loginWithQr(dataUrl, options)` accepts an optional `{ debug, fetchImpl, maxRedirects }`. It throws `SlackError` with codes `qr_session_failed` (link expired / no session) or `qr_token_failed` (token could not be retrieved). To decode the QR without logging in, use `decodeSlackQr(dataUrl)` which returns `{ url, workspace, teamId, userId }`.
+`loginWithQr(dataUrl, options)` accepts an optional `{ debug, fetchImpl, maxRedirects, requestConfirmationCode }`. It throws `SlackError` with codes `qr_session_failed` (link expired / no session) or `qr_token_failed` (token could not be retrieved). To decode the QR without logging in, use `decodeSlackQr(dataUrl)` which returns `{ url, workspace, teamId, userId }`.
+
+### Handling Slack confirmation codes (workspace 2FA)
+
+Some workspaces make a QR sign-in surface a confirmation-code page (email code, SMS, TOTP, etc.) before issuing the session cookie. Pass `requestConfirmationCode` to complete that step. The callback is only invoked when Slack actually shows a confirmation page — ordinary QR logins that receive the session cookie directly stay prompt-free.
+
+```typescript
+import { loginWithQr, type SlackConfirmationChallenge } from 'agent-messenger/slack'
+
+const session = await loginWithQr(dataUrl, {
+  requestConfirmationCode: async (challenge: SlackConfirmationChallenge) => {
+    // challenge.email is the address Slack sent the code to.
+    // challenge.type is the mechanism ("email", "sms", "totp", ...) or null if unknown.
+    return await promptUserForCode(challenge)
+  },
+})
+```
+
+Contract:
+
+- Return the raw code as a `string`. Whitespace is trimmed before submission.
+- Return an empty string (or all whitespace) to abort — `loginWithQr` throws `qr_session_failed` and no code is posted.
+- The code is submitted to the exact `https://<workspace>.slack.com/login/<qrSecret>` endpoint bound to the QR payload. Redirects to a different workspace host or an unexpected pathname reject the flow before the callback is invoked.
+- The callback and `email`/`type` fields never appear in `debug` output.
 
 ## SDK: Real-Time Events
 

package/skills/agent-slackbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-slackbot
 description: Interact with Slack workspaces using bot tokens - send messages, read channels, manage reactions
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-slackbot:*)
 metadata:
   openclaw:

package/skills/agent-teams/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-teams
 description: Interact with Microsoft Teams - send messages, read channels, manage reactions
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-teams:*)
 metadata:
   openclaw:

package/skills/agent-telegram/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-telegram
 description: Interact with Telegram through TDLib - authenticate, inspect chats, and send messages
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-telegram:*)
 ---
 

package/skills/agent-telegrambot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-telegrambot
 description: Interact with Telegram using bot tokens - send messages, read chats, manage reactions
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-telegrambot:*)
 metadata:
   openclaw:

package/skills/agent-webex/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-webex
 description: Interact with Cisco Webex - send messages, read spaces, manage memberships
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-webex:*)
 metadata:
   openclaw:

package/skills/agent-webexbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-webexbot
 description: Interact with Cisco Webex using bot tokens - send messages, reply in threads, upload and download files, look up people, read spaces, manage memberships, stream real-time events
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-webexbot:*)
 metadata:
   openclaw:

package/skills/agent-wechatbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-wechatbot
 description: Interact with WeChat Official Account using API credentials - send messages, manage templates, list followers
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-wechatbot:*)
 metadata:
   openclaw:

package/skills/agent-whatsapp/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-whatsapp
 description: Interact with WhatsApp - send messages, read chats, manage conversations
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-whatsapp:*)
 metadata:
   openclaw:

package/skills/agent-whatsappbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-whatsappbot
 description: Interact with WhatsApp using Cloud API credentials - send messages, manage templates
-version: 2.31.0
+version: 2.32.1
 allowed-tools: Bash(agent-whatsappbot:*)
 metadata:
   openclaw: