agent-messenger 2.38.0 → 2.39.0

package/e2e/discordbot.e2e.test.ts

@@ -1,4 +1,7 @@
 import { describe, it, expect, beforeAll, afterEach } from 'bun:test'
+import { rm } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
 
 import { DiscordBotClient } from '../src/platforms/discordbot/client'
 import { DiscordBotCredentialManager } from '../src/platforms/discordbot/credential-manager'
@@ -16,6 +19,7 @@ interface TrackedMessage {
 }
 
 let testMessages: TrackedMessage[] = []
+let testThreads: string[] = []
 let cleanupClient: DiscordBotClient
 
 async function getClient(): Promise<DiscordBotClient> {
@@ -36,10 +40,29 @@ async function cleanupBotMessages(messages: TrackedMessage[]) {
   }
 }
 
+async function cleanupBotThreads(threads: string[]) {
+  for (const threadId of threads) {
+    try {
+      await cleanupClient.archiveThread(threadId)
+      await waitForRateLimit(500)
+    } catch {
+      // best-effort cleanup
+    }
+  }
+}
+
 function trackMessage(id: string, channelId: string = DISCORDBOT_TEST_CHANNEL_ID) {
   testMessages.push({ id, channelId })
 }
 
+function trackThread(id: string) {
+  testThreads.push(id)
+}
+
+function untrackThread(id: string) {
+  testThreads = testThreads.filter((threadId) => threadId !== id)
+}
+
 describe('DiscordBot E2E Tests', () => {
   beforeAll(async () => {
     await validateDiscordBotEnvironment()
@@ -51,6 +74,10 @@ describe('DiscordBot E2E Tests', () => {
       await cleanupBotMessages(testMessages)
       testMessages = []
     }
+    if (testThreads.length > 0) {
+      await cleanupBotThreads(testThreads)
+      testThreads = []
+    }
     await waitForRateLimit()
   })
 
@@ -161,12 +188,20 @@ describe('DiscordBot E2E Tests', () => {
       expect(result.exitCode).toBe(0)
     })
 
-    it('message send with --thread creates reply', async () => {
+    it('message send with --thread creates reply in the thread', async () => {
       const testId = generateTestId()
-      const sendResult = await runCLI('discordbot', ['message', 'send', DISCORDBOT_TEST_CHANNEL_ID, `Parent ${testId}`])
-      const parent = parseJSON<{ id: string }>(sendResult.stdout)
-      expect(parent?.id).toBeTruthy()
-      if (parent?.id) trackMessage(parent.id)
+      const threadResult = await runCLI('discordbot', [
+        'thread',
+        'create',
+        DISCORDBOT_TEST_CHANNEL_ID,
+        `E2E Thread ${testId}`,
+      ])
+      expect(threadResult.exitCode).toBe(0)
+
+      const thread = parseJSON<{ thread: { id: string } }>(threadResult.stdout)
+      expect(thread?.thread?.id).toBeTruthy()
+      const threadId = thread!.thread.id
+      trackThread(threadId)
 
       await waitForRateLimit()
 
@@ -176,15 +211,14 @@ describe('DiscordBot E2E Tests', () => {
         DISCORDBOT_TEST_CHANNEL_ID,
         `Reply ${testId}`,
         '--thread',
-        parent!.id,
+        threadId,
       ])
       expect(replyResult.exitCode).toBe(0)
 
-      const reply = parseJSON<{ id: string; thread_id: string }>(replyResult.stdout)
+      const reply = parseJSON<{ id: string; channel_id: string }>(replyResult.stdout)
       expect(reply?.id).toBeTruthy()
-
-      const replyChannel = reply?.thread_id || DISCORDBOT_TEST_CHANNEL_ID
-      if (reply?.id) trackMessage(reply.id, replyChannel)
+      expect(reply?.channel_id).toBe(threadId)
+      if (reply?.id) trackMessage(reply.id, threadId)
     }, 30000)
 
     it('message replies gets thread messages', async () => {
@@ -201,6 +235,7 @@ describe('DiscordBot E2E Tests', () => {
       const thread = parseJSON<{ thread: { id: string } }>(threadResult.stdout)
       expect(thread?.thread?.id).toBeTruthy()
       const threadId = thread!.thread.id
+      trackThread(threadId)
 
       await waitForRateLimit()
 
@@ -222,9 +257,155 @@ describe('DiscordBot E2E Tests', () => {
 
       // cleanup: archive the thread
       await runCLI('discordbot', ['thread', 'archive', threadId])
+      untrackThread(threadId)
     })
   })
 
+  describe('file', () => {
+    it('uploads a file into a thread and round-trips its metadata', async () => {
+      const testId = generateTestId()
+      const filePath = join(tmpdir(), `e2e-${testId}.txt`)
+      await Bun.write(filePath, testId)
+
+      try {
+        const threadResult = await runCLI('discordbot', [
+          'thread',
+          'create',
+          DISCORDBOT_TEST_CHANNEL_ID,
+          `E2E Thread ${testId}`,
+        ])
+        expect(threadResult.exitCode).toBe(0)
+        const thread = parseJSON<{ thread: { id: string } }>(threadResult.stdout)
+        expect(thread?.thread?.id).toBeTruthy()
+        const threadId = thread!.thread.id
+        trackThread(threadId)
+
+        await waitForRateLimit()
+
+        const uploadResult = await runCLI('discordbot', [
+          'file',
+          'upload',
+          DISCORDBOT_TEST_CHANNEL_ID,
+          filePath,
+          '--text',
+          `File ${testId}`,
+          '--thread',
+          threadId,
+        ])
+        expect(uploadResult.exitCode).toBe(0)
+        const upload = parseJSON<{
+          channel_id: string
+          message_id: string
+          file: { id: string; filename: string }
+          files: Array<{ filename: string }>
+        }>(uploadResult.stdout)
+        expect(upload?.channel_id).toBe(threadId)
+        expect(upload?.message_id).toBeTruthy()
+        expect(upload?.file?.filename).toBe(`e2e-${testId}.txt`)
+        expect(upload?.files).toHaveLength(1)
+        trackMessage(upload!.message_id, threadId)
+
+        await waitForRateLimit()
+
+        const messageResult = await runCLI('discordbot', ['message', 'get', threadId, upload!.message_id])
+        expect(messageResult.exitCode).toBe(0)
+        const message = parseJSON<{
+          channel_id: string
+          content: string
+          attachments: Array<{ id: string; filename: string; size: number }>
+        }>(messageResult.stdout)
+        expect(message?.channel_id).toBe(threadId)
+        expect(message?.content).toBe(`File ${testId}`)
+        expect(message?.attachments).toHaveLength(1)
+        expect(message!.attachments[0].filename).toBe(`e2e-${testId}.txt`)
+        expect(message!.attachments[0].size).toBe(Buffer.byteLength(testId))
+
+        await waitForRateLimit()
+
+        const namedResult = await runCLI('discordbot', [
+          'message',
+          'send',
+          DISCORDBOT_TEST_CHANNEL_ID,
+          `Reply ${testId}`,
+          '--thread',
+          `E2E Thread ${testId}`,
+        ])
+        expect(namedResult.exitCode).toBe(0)
+        const named = parseJSON<{ id: string; channel_id: string }>(namedResult.stdout)
+        expect(named?.channel_id).toBe(threadId)
+        if (named?.id) trackMessage(named.id, threadId)
+
+        await waitForRateLimit()
+
+        const missingNameResult = await runCLI('discordbot', [
+          'message',
+          'send',
+          DISCORDBOT_TEST_CHANNEL_ID,
+          'x',
+          '--thread',
+          `no-such-thread-${testId}`,
+        ])
+        expect(missingNameResult.exitCode).toBe(1)
+        const missingName = parseJSON<{ error: string }>(missingNameResult.stdout)
+        expect(missingName?.error).toContain('thread list')
+        expect(missingNameResult.stderr).toBe('')
+
+        await waitForRateLimit()
+
+        const activeListResult = await runCLI('discordbot', ['thread', 'list', DISCORDBOT_TEST_CHANNEL_ID])
+        expect(activeListResult.exitCode).toBe(0)
+        const activeList = parseJSON<{
+          threads: Array<{ id: string; parent_id?: string; archived?: boolean }>
+        }>(activeListResult.stdout)
+        expect(
+          activeList?.threads?.some(
+            (item) => item.id === threadId && item.parent_id === DISCORDBOT_TEST_CHANNEL_ID && item.archived === false,
+          ),
+        ).toBe(true)
+
+        await waitForRateLimit()
+
+        const infoResult = await runCLI('discordbot', ['file', 'info', threadId, upload!.file.id])
+        expect(infoResult.exitCode).toBe(0)
+        const info = parseJSON<{ id: string; filename: string }>(infoResult.stdout)
+        expect(info?.id).toBe(upload!.file.id)
+        expect(info?.filename).toBe(`e2e-${testId}.txt`)
+
+        const missingInfoResult = await runCLI('discordbot', [
+          'file',
+          'info',
+          DISCORDBOT_TEST_CHANNEL_ID,
+          '000000000000000000',
+        ])
+        expect(missingInfoResult.exitCode).toBe(0)
+        const missingInfo = parseJSON<{ error: string }>(missingInfoResult.stdout)
+        expect(missingInfo?.error).toContain('File not found')
+
+        await waitForRateLimit()
+
+        const parentMessagesResult = await runCLI('discordbot', [
+          'message',
+          'list',
+          DISCORDBOT_TEST_CHANNEL_ID,
+          '--limit',
+          '5',
+        ])
+        expect(parentMessagesResult.exitCode).toBe(0)
+        const parentMessages = parseJSON<{ messages: Array<{ content: string }> }>(parentMessagesResult.stdout)
+        expect(parentMessages?.messages?.some((item) => item.content === 'x')).toBe(false)
+
+        const archiveResult = await runCLI('discordbot', ['thread', 'archive', threadId])
+        expect(archiveResult.exitCode).toBe(0)
+        untrackThread(threadId)
+
+        // Discord's archived-thread index is eventually consistent; active listing above is the stable proof.
+        await waitForRateLimit(2000)
+      } finally {
+        await rm(filePath, { force: true })
+      }
+    }, 60000)
+  })
+
   describe('channel', () => {
     it('channel list returns channels array', async () => {
       const result = await runCLI('discordbot', ['channel', 'list'])
@@ -288,6 +469,11 @@ describe('DiscordBot E2E Tests', () => {
 
       await waitForRateLimit(2000)
 
+      const emptyListResult = await runCLI('discordbot', ['reaction', 'list', DISCORDBOT_TEST_CHANNEL_ID, sent!.id])
+      expect(emptyListResult.exitCode).toBe(0)
+      const emptyList = parseJSON<{ reactions: unknown[] }>(emptyListResult.stdout)
+      expect(emptyList?.reactions).toEqual([])
+
       // when: add reaction
       const addResult = await runCLI('discordbot', ['reaction', 'add', DISCORDBOT_TEST_CHANNEL_ID, sent!.id, '👍'])
       expect(addResult.exitCode).toBe(0)
@@ -297,6 +483,15 @@ describe('DiscordBot E2E Tests', () => {
 
       await waitForRateLimit(2000)
 
+      const listResult = await runCLI('discordbot', ['reaction', 'list', DISCORDBOT_TEST_CHANNEL_ID, sent!.id])
+      expect(listResult.exitCode).toBe(0)
+      const listed = parseJSON<{
+        reactions: Array<{ emoji: { name: string }; count: number; me: boolean }>
+      }>(listResult.stdout)
+      expect(listed?.reactions?.[0]?.emoji?.name).toBe('👍')
+      expect(listed?.reactions?.[0]?.count).toBe(1)
+      expect(listed?.reactions?.[0]?.me).toBe(true)
+
       // then: remove reaction
       const removeResult = await runCLI('discordbot', [
         'reaction',
@@ -309,7 +504,7 @@ describe('DiscordBot E2E Tests', () => {
 
       const removeData = parseJSON<{ success: boolean }>(removeResult.stdout)
       expect(removeData?.success).toBe(true)
-    }, 15000)
+    }, 30000)
   })
 
   describe('server', () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-messenger",
-  "version": "2.38.0",
+  "version": "2.39.0",
   "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",

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.38.0
+version: 2.39.0
 allowed-tools: Bash(agent-channeltalk:*)
 metadata:
   openclaw:

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.38.0
+version: 2.39.0
 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.38.0
+version: 2.39.0
 allowed-tools: Bash(agent-discord:*)
 metadata:
   openclaw:

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.38.0
+version: 2.39.0
 allowed-tools: Bash(agent-discordbot:*)
 metadata:
   openclaw:
@@ -27,7 +27,9 @@ Before diving in, a few things about Discord Bot integration:
 - **Privileged intents** — `MessageContent`, `GuildMembers`, and `GuildPresences` are privileged and must be enabled in the Developer Portal before they can be used by the SDK listener.
 - **Permission gates** — Bot capabilities depend on the role's permission flags in each server. Missing permissions return 403 errors.
 - **Real-time events** — Available via the SDK's Gateway listener, not via the CLI.
-- **Channel resolution** — Use channel IDs (snowflake numbers) directly. The CLI does not resolve `#channel-name` syntax.
+- **Channel resolution** — Every `<channel>` argument accepts a channel ID (snowflake) or an exact channel name (`general` or `#general`). IDs skip the lookup and are faster; names fail with `Channel not found` when nothing matches exactly.
+- **Thread targeting** — `--thread <id|name>` on `message send` and `file upload` posts into a thread. A numeric value is used as the thread ID; a name is matched against the active threads of that channel (`thread_not_found` / `thread_ambiguous` otherwise). Archived threads must be targeted by ID (find it with `thread list <channel> --archived`); posting to an archived thread unarchives it unless it's locked.
+- **`thread_id` vs `channel_id` in output** — For a message posted inside a thread, `channel_id` IS the thread ID. `thread_id` is only set when a thread was started from that message; otherwise it's `null`.
 
 ## Quick Start
 
@@ -56,7 +58,7 @@ agent-discordbot uses Discord Bot tokens which you create in the Discord Develop
 agent-discordbot auth set your-bot-token
 
 # Set with a custom bot identifier
-agent-discordbot auth set your-bot-token --bot deploy --name "Deploy Bot"
+agent-discordbot auth set your-bot-token --bot deploy
 
 # Check auth status
 agent-discordbot auth status
@@ -151,7 +153,7 @@ If a memorized ID returns an error (channel not found, server not found), remove
 ```bash
 # Set bot token
 agent-discordbot auth set <token>
-agent-discordbot auth set <token> --bot deploy --name "Deploy Bot"
+agent-discordbot auth set <token> --bot deploy
 
 # Check auth status
 agent-discordbot auth status
@@ -205,9 +207,13 @@ agent-discordbot message send 1234567890123456789 "Hello world"
 agent-discordbot message send <channel-id> <content> --reply <message-id>
 agent-discordbot message send 1234567890123456789 "On it!" --reply 9876543210987654321
 
-# Send a message into a thread
-agent-discordbot message send <channel-id> <content> --thread <thread-id>
+# Send a message into a thread (by ID or by active-thread name); the returned channel_id equals the thread ID
+agent-discordbot message send <channel-id> <content> --thread <thread-id|thread-name>
 agent-discordbot message send 1234567890123456789 "Hello world" --thread 9876543210987654321
+agent-discordbot message send 1234567890123456789 "Hello world" --thread "Deployment Progress"
+
+# Sending directly to a thread ID also works (a thread is a channel)
+agent-discordbot message send 9876543210987654321 "Hello thread"
 
 # List messages
 agent-discordbot message list <channel-id>
@@ -243,7 +249,6 @@ agent-discordbot channel info 1234567890123456789
 ```bash
 # List server members
 agent-discordbot user list
-agent-discordbot user list --limit 50
 
 # Get user info
 agent-discordbot user info <user-id>
@@ -258,19 +263,36 @@ agent-discordbot reaction add 1234567890123456789 9876543210987654321 thumbsup
 
 # Remove reaction
 agent-discordbot reaction remove <channel-id> <message-id> <emoji>
+
+# List reactions on a message: [{ emoji: {id, name}, count, me }]
+agent-discordbot reaction list <channel-id> <message-id>
 ```
 
 ### File Commands
 
 ```bash
-# Upload file to a channel
-agent-discordbot file upload <channel-id> <path>
+# Upload one or more files (max 10) to a channel, optionally with text
+agent-discordbot file upload <channel-id> <path...> [--text <text>] [--thread <id|name>] [--reply <message-id>] [--filename <name>]
 agent-discordbot file upload 1234567890123456789 ./report.pdf
+agent-discordbot file upload 1234567890123456789 ./report.pdf ./chart.png --text "Weekly numbers"
+
+# Upload into a thread, or as a reply
+agent-discordbot file upload 1234567890123456789 ./log.txt --thread 9876543210987654321
+agent-discordbot file upload 1234567890123456789 ./log.txt --text "Full log attached" --reply 9876543210987654321
 
-# List files in channel
+# Override the stored filename (single file only)
+agent-discordbot file upload 1234567890123456789 ./tmp-8x1.txt --filename build.log
+
+# List files in channel (attachments of the latest 100 messages, one request)
 agent-discordbot file list <channel-id>
+
+# Get info for one attachment (id, filename, size, url, content_type)
+# Searches back through the latest 1,000 messages and stops at the first match
+agent-discordbot file info <channel-id> <file-id>
 ```
 
+`file upload` returns `{ success, file, files, message_id, channel_id }`. `file` is the first attachment, `files` has all of them, and `channel_id` is the thread ID when `--thread` was used. Every message read path (`message send|list|get|replies`) includes `attachments: [{ id, filename, size, url, content_type }]`, `[]` when there are none. There is no fixed size limit in the CLI; Discord decides per server and reports `40005` (or `http_413`) when a file is too big.
+
 ### Thread Commands
 
 ```bash
@@ -278,10 +300,19 @@ agent-discordbot file list <channel-id>
 agent-discordbot thread create <channel-id> <name>
 agent-discordbot thread create 1234567890123456789 "Discussion" --auto-archive-duration 1440
 
+# List active threads (whole server, or one channel's threads)
+agent-discordbot thread list
+agent-discordbot thread list <channel-id>
+
+# List archived threads of a channel (100 most recently archived; has_more tells you if there are older ones)
+agent-discordbot thread list <channel-id> --archived
+
 # Archive a thread
 agent-discordbot thread archive <thread-id>
 ```
 
+`thread list` returns `{ threads: [{ id, name, type, parent_id, archived }], has_more }`. `--archived` needs a channel argument (`parent_required` otherwise).
+
 ### Snapshot Command
 
 Get server overview for AI agents (brief by default):
@@ -369,6 +400,16 @@ All commands return consistent error format:
 
 Common errors: `missing_token`, `invalid_token`, `Missing Access`, `Unknown Channel`, `Missing Permissions`.
 
+Errors specific to sending files and targeting threads:
+
+- `empty_message`: `file upload` needs at least one file, or `--text` alongside it.
+- `too_many_files`: more than 10 files in one upload.
+- `invalid_filename`: `--filename` is empty, `.`, `..`, or contains a path separator.
+- `thread_not_found`: `--thread <name>` matched no active thread in that channel. Run `thread list <channel>` (add `--archived` for archived ones) or pass the thread ID.
+- `thread_ambiguous`: several active threads share that name; the message lists their IDs. Use the ID.
+- `parent_required`: `thread list --archived` was called without a channel.
+- `40005` / `http_413`: Discord rejected the upload as too large for that server's limit. The error message says so; the CLI doesn't preflight sizes.
+
 ## Configuration
 
 Credentials stored in `~/.config/agent-messenger/discordbot-credentials.json` (0600 permissions). See [references/authentication.md](references/authentication.md) for format and security details.
@@ -384,7 +425,9 @@ Credentials stored in `~/.config/agent-messenger/discordbot-credentials.json` (0
 | Mentions             | Yes                             | No                           |
 | Friends/Notes        | Yes                             | No                           |
 | Edit/delete messages | Any message                     | Bot's own messages only      |
-| File upload          | Yes                             | Yes                          |
+| File upload          | Yes                             | Yes (text, threads, replies) |
+| Thread list          | No                              | Yes (active + archived)      |
+| Reaction list        | Yes                             | Yes                          |
 | Snapshot             | Yes                             | Yes                          |
 | CI/CD friendly       | Requires desktop app            | Yes (just set token)         |
 
@@ -401,6 +444,9 @@ Credentials stored in `~/.config/agent-messenger/discordbot-credentials.json` (0
 - Bot must be invited to the server and have appropriate permissions
 - Message Content intent required for verified bots (100+ servers)
 - Plain text messages only (no embeds in v1)
+- Thread names resolve against active threads only; archived threads need their ID
+- `thread list --archived` returns one page (100 threads) with `has_more`; no pagination beyond that
+- No file download or delete
 
 ## Troubleshooting
 

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

@@ -25,6 +25,7 @@ agent-discordbot uses Discord Bot tokens obtained from the Discord Developer Por
 2. Under **Scopes**, select `bot`
 3. Under **Bot Permissions**, select the permissions you need:
    - Send Messages
+   - Send Messages in Threads
    - Read Message History
    - View Channels
    - Add Reactions
@@ -49,7 +50,7 @@ Even for unverified bots, enabling this intent is recommended to avoid surprises
 ```bash
 agent-discordbot auth set your-bot-token
 
-agent-discordbot auth set your-bot-token --bot deploy --name "Deploy Bot"
+agent-discordbot auth set your-bot-token --bot deploy
 ```
 
 This command:
@@ -102,8 +103,8 @@ This command:
 Store and switch between multiple bot tokens:
 
 ```bash
-agent-discordbot auth set deploy-bot-token --bot deploy --name "Deploy Bot"
-agent-discordbot auth set alert-bot-token --bot alert --name "Alert Bot"
+agent-discordbot auth set deploy-bot-token --bot deploy
+agent-discordbot auth set alert-bot-token --bot alert
 
 agent-discordbot auth list
 
@@ -171,14 +172,15 @@ agent-discordbot auth status
 
 ## Required Bot Permissions
 
-| Permission           | Used For                            |
-| -------------------- | ----------------------------------- |
-| Send Messages        | Sending messages to channels        |
-| Read Message History | Reading channel messages            |
-| View Channels        | Listing and accessing channels      |
-| Add Reactions        | Adding and removing emoji reactions |
-| Attach Files         | Uploading files to channels         |
-| Manage Threads       | Creating and archiving threads      |
+| Permission               | Used For                                             |
+| ------------------------ | ---------------------------------------------------- |
+| Send Messages            | Sending messages to channels                         |
+| Send Messages in Threads | Posting messages and files into threads (`--thread`) |
+| Read Message History     | Reading channel messages                             |
+| View Channels            | Listing and accessing channels                       |
+| Add Reactions            | Adding and removing emoji reactions                  |
+| Attach Files             | Uploading files to channels and threads              |
+| Manage Threads           | Creating and archiving threads                       |
 
 ## Troubleshooting
 

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

@@ -39,14 +39,17 @@ CHANNEL="1234567890123456789"
 RESULT=$(agent-discordbot thread create "$CHANNEL" "Deployment Progress")
 THREAD_ID=$(echo "$RESULT" | jq -r '.thread.id')
 
-# Send updates in the thread
+# Send updates in the thread (either target the thread ID directly, or use --thread from the parent channel)
 agent-discordbot message send "$THREAD_ID" "Building application..."
 sleep 2
-agent-discordbot message send "$THREAD_ID" "Running tests..."
+agent-discordbot message send "$CHANNEL" "Running tests..." --thread "$THREAD_ID"
 sleep 2
-agent-discordbot message send "$THREAD_ID" "Deploying to production..."
+agent-discordbot message send "$CHANNEL" "Deploying to production..." --thread "Deployment Progress"
 sleep 2
-agent-discordbot message send "$THREAD_ID" "Deployment complete!"
+
+# Attach the build log to the thread; channel_id in the result equals the thread ID
+RESULT=$(agent-discordbot file upload "$CHANNEL" ./build.log --text "Deployment complete!" --thread "$THREAD_ID")
+echo "$RESULT" | jq -r '.channel_id, .file.filename'
 
 # Add reaction to the original channel message
 agent-discordbot reaction add "$CHANNEL" "$THREAD_ID" white_check_mark
@@ -54,6 +57,29 @@ agent-discordbot reaction add "$CHANNEL" "$THREAD_ID" white_check_mark
 
 **When to use**: Multi-step processes, CI/CD pipelines, progress tracking.
 
+## Pattern 2b: Find an Existing Thread
+
+**Use case**: Continue a conversation in a thread you didn't create in this session
+
+```bash
+#!/bin/bash
+
+CHANNEL="1234567890123456789"
+
+# Active threads in the channel
+THREAD_ID=$(agent-discordbot thread list "$CHANNEL" | jq -r '.threads[] | select(.name=="Deployment Progress") | .id')
+
+# Not active? Look through the 100 most recently archived threads (has_more flags older ones)
+if [ -z "$THREAD_ID" ]; then
+  THREAD_ID=$(agent-discordbot thread list "$CHANNEL" --archived | jq -r '.threads[] | select(.name=="Deployment Progress") | .id')
+fi
+
+# Posting by ID unarchives the thread (unless it's locked). Names only resolve for active threads.
+agent-discordbot message send "$CHANNEL" "Picking this back up" --thread "$THREAD_ID"
+```
+
+**When to use**: Resuming work across sessions, replying in threads other people opened.
+
 ## Pattern 3: Monitor Channel for New Messages
 
 **Use case**: Poll a channel and respond to new messages
@@ -187,21 +213,23 @@ echo "Channels:"
 agent-discordbot channel list --pretty
 
 echo "Members:"
-agent-discordbot user list --pretty --limit 20
+agent-discordbot user list --pretty
 ```
 
 ## Best Practices
 
-### 1. Always Use Channel IDs
+### 1. Prefer Channel IDs, Names Work Too
 
-Discord requires Snowflake IDs (large numbers), not channel names:
+Every `<channel>` argument accepts an exact channel name (`general` or `#general`), so `agent-discordbot message send general "Hello"` works. An ID skips the channel lookup on every call and can't hit a rename, so resolve once and reuse the ID:
 
 ```bash
 CHANNELS=$(agent-discordbot channel list)
-CHANNEL_ID=$(echo "$CHANNELS" | jq -r '.[] | select(.name=="general") | .id')
+CHANNEL_ID=$(echo "$CHANNELS" | jq -r '.channels[] | select(.name=="general") | .id')
 agent-discordbot message send "$CHANNEL_ID" "Hello"
 ```
 
+The same goes for `--thread`: a name resolves against the channel's active threads, an ID is used as-is.
+
 ### 2. Rate Limit Your Requests
 
 ```bash

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.38.0
+version: 2.39.0
 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.38.0
+version: 2.39.0
 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.38.0
+version: 2.39.0
 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.38.0
+version: 2.39.0
 allowed-tools: Bash(agent-line:*)
 metadata:
   openclaw: