agent-messenger 2.29.1 → 2.31.0

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

@@ -126,6 +126,43 @@ await client.sendAttachment('9876543210', [
 
 The typed helpers `sendPhoto`, `sendVideo`, `sendAudio`, `sendFile`, and `sendMultiPhoto` remain available when you want to bypass MIME sniffing and dispatch to a specific message_type explicitly.
 
+### Leave Chat
+
+```typescript
+const result = await client.leaveChat('9876543210')
+// → { success: true, status_code: 0, chat_id: '9876543210' }
+```
+
+Leaves a chat room by its chat ID. Works on 1:1, group, open, and PlusChat rooms. Returns `success: true` on a successful leave. The departed chat is immediately evicted from the client's cached chat list — a subsequent `getChats()` call will not include it.
+
+### Typing Indicator
+
+```typescript
+// Fire a single typing pulse — the recipient sees the animated "…" dots
+const result = await client.sendTyping('9876543210')
+// → KakaoTypingResult { success: true, status_code: 0, chat_id: '9876543210' }
+
+// For OpenChat rooms, pass the linkId
+await client.sendTyping('9876543210', { linkId: '77777' })
+```
+
+The KakaoTalk client-side lifetime is ~5s per pulse — to keep the indicator visible while generating a long reply, re-fire faster than that (e.g. every 3s):
+
+```typescript
+const interval = setInterval(() => {
+  client.sendTyping('9876543210').catch(() => {}) // ignore transient errors
+}, 3000)
+
+try {
+  const reply = await generateReply()
+  await client.sendMessage('9876543210', reply)
+} finally {
+  clearInterval(interval)
+}
+```
+
+Errors follow the same shape as `markRead`: transport-level failures (non-zero `statusCode`, including the synthetic `-1` LocoConnection emits on disconnect) throw `KakaoTalkError('send_typing_failed')` so `executeWithReconnect` can retry on a fresh session. Non-numeric `chatId` / `linkId` throw `invalid_chat_id` / `invalid_link_id`.
+
 ### Cleanup
 
 ```typescript
@@ -239,6 +276,7 @@ import type {
   KakaoMember,
   KakaoMessage,
   KakaoSendResult,
+  KakaoTypingResult,
   KakaoAccountCredentials,
   KakaoConfig,
   KakaoDeviceType,
@@ -256,6 +294,7 @@ import {
   KakaoMemberSchema,
   KakaoMessageSchema,
   KakaoSendResultSchema,
+  KakaoTypingResultSchema,
   KakaoAccountCredentialsSchema,
   KakaoConfigSchema,
 } from 'agent-messenger/kakaotalk'

package/e2e/README.md

@@ -171,7 +171,7 @@ When triggering manually, you can select which platform to test:
 | ------------- | -------------------------------------------------------------- |
 | `auth`        | status                                                         |
 | `workspace`   | list, current                                                  |
-| `message`     | send, list, get, update, delete, thread reply, replies, search |
+| `message`     | send, list, get, edit, delete, thread reply, replies, search |
 | `channel`     | list, list --type, info, history                               |
 | `user`        | list, me, info                                                 |
 | `reaction`    | add, list, remove                                              |
@@ -188,7 +188,7 @@ When triggering manually, you can select which platform to test:
 | Command Group | Tests                                                  |
 | ------------- | ------------------------------------------------------ |
 | `auth`        | status                                                 |
-| `message`     | send, list, get, update, delete, thread reply, replies |
+| `message`     | send, list, get, edit, delete, thread reply, replies |
 | `channel`     | list, info                                             |
 | `user`        | list, info                                             |
 | `reaction`    | add, remove                                            |
@@ -228,7 +228,7 @@ When triggering manually, you can select which platform to test:
 | Command Group | Tests                                            |
 | ------------- | ------------------------------------------------ |
 | `auth`        | status                                           |
-| `message`     | send, list, get, update, delete, thread, replies |
+| `message`     | send, list, get, edit, delete, thread, replies |
 | `channel`     | list, info                                       |
 | `user`        | list, info                                       |
 | `reaction`    | add, remove                                      |

package/e2e/discordbot.e2e.test.ts

@@ -114,7 +114,7 @@ describe('DiscordBot E2E Tests', () => {
       expect(data?.id).toBe(sent!.id)
     })
 
-    it('message update modifies message', async () => {
+    it('message edit modifies message', async () => {
       const testId = generateTestId()
       const sendResult = await runCLI('discordbot', [
         'message',
@@ -130,7 +130,7 @@ describe('DiscordBot E2E Tests', () => {
 
       const result = await runCLI('discordbot', [
         'message',
-        'update',
+        'edit',
         DISCORDBOT_TEST_CHANNEL_ID,
         sent!.id,
         `Updated ${testId}`,

package/e2e/slack.e2e.test.ts

@@ -95,14 +95,14 @@ describe('Slack E2E Tests', () => {
       expect(data?.text).toContain(testId)
     })
 
-    it('message update modifies message', async () => {
+    it('message edit modifies message', async () => {
       const testId = generateTestId()
       const { id: ts } = await createTestMessage('slack', SLACK_TEST_CHANNEL_ID, `Original ${testId}`)
       testMessages.push(ts)
 
       await waitForRateLimit()
 
-      const result = await runCLI('slack', ['message', 'update', SLACK_TEST_CHANNEL_ID, ts, `Updated ${testId}`])
+      const result = await runCLI('slack', ['message', 'edit', SLACK_TEST_CHANNEL_ID, ts, `Updated ${testId}`])
       expect(result.exitCode).toBe(0)
 
       await waitForRateLimit()

package/e2e/slackbot.e2e.test.ts

@@ -104,7 +104,7 @@ describe('SlackBot E2E Tests', () => {
       expect(data?.ts).toBe(sent!.ts)
     })
 
-    it('message update modifies message', async () => {
+    it('message edit modifies message', async () => {
       const testId = generateTestId()
       const sendResult = await runCLI('slackbot', ['message', 'send', SLACKBOT_TEST_CHANNEL_ID, `Original ${testId}`])
       const sent = parseJSON<{ ts: string }>(sendResult.stdout)
@@ -115,7 +115,7 @@ describe('SlackBot E2E Tests', () => {
 
       const result = await runCLI('slackbot', [
         'message',
-        'update',
+        'edit',
         SLACKBOT_TEST_CHANNEL_ID,
         sent!.ts,
         `Updated ${testId}`,

package/e2e/telegrambot.e2e.test.ts

@@ -93,7 +93,7 @@ describe('Telegram Bot E2E Tests', () => {
       if (data?.message?.message_id) trackedMessageIds.push(data.message.message_id)
     })
 
-    it('message update edits previously sent message', async () => {
+    it('message edit edits previously sent message', async () => {
       if (!telegramBotAvailable) return
 
       const testId = generateTestId()
@@ -111,7 +111,7 @@ describe('Telegram Bot E2E Tests', () => {
 
       const updateResult = await runCLI('telegrambot', [
         'message',
-        'update',
+        'edit',
         TELEGRAMBOT_TEST_CHAT_ID,
         String(sent!.message.message_id),
         `Edited ${testId}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-messenger",
-  "version": "2.29.1",
+  "version": "2.31.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",
@@ -211,7 +211,7 @@
     "oxlint": "^1.51.0",
     "tsc-alias": "^1.8.16",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3"
+    "typescript": "^7.0.2"
   },
   "optionalDependencies": {
     "koffi": "^2.15.2",

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.29.1
+version: 2.31.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.29.1
+version: 2.31.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.29.1
+version: 2.31.0
 allowed-tools: Bash(agent-discord:*)
 metadata:
   openclaw:
@@ -193,6 +193,10 @@ agent-discord message list 1234567890123456789 --limit 50
 agent-discord message get <channel-id> <message-id>
 agent-discord message get 1234567890123456789 9876543210987654321
 
+# Edit a message
+agent-discord message edit <channel-id> <message-id> <content>
+agent-discord message edit 1234567890123456789 9876543210987654321 "Updated text"
+
 # Delete a message
 agent-discord message delete <channel-id> <message-id> --force
 

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.29.1
+version: 2.31.0
 allowed-tools: Bash(agent-discordbot:*)
 metadata:
   openclaw:
@@ -220,8 +220,8 @@ agent-discordbot message get <channel-id> <message-id>
 agent-discordbot message replies <channel-id> <message-id>
 agent-discordbot message replies 1234567890123456789 9876543210987654321 --limit 50
 
-# Update a message (bot's own messages only)
-agent-discordbot message update <channel-id> <message-id> <new-content>
+# Edit a message (bot's own messages only)
+agent-discordbot message edit <channel-id> <message-id> <new-content>
 
 # Delete a message (bot's own messages only)
 agent-discordbot message delete <channel-id> <message-id> --force

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

@@ -107,8 +107,8 @@ sleep 5
 agent-discordbot reaction remove "$CHANNEL" "$MSG_ID" hourglass
 agent-discordbot reaction add "$CHANNEL" "$MSG_ID" white_check_mark
 
-# Update message with result
-agent-discordbot message update "$CHANNEL" "$MSG_ID" "Request processed successfully!"
+# Edit message with result
+agent-discordbot message edit "$CHANNEL" "$MSG_ID" "Request processed successfully!"
 ```
 
 **When to use**: Visual status tracking, acknowledgments, workflow states.

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.29.1
+version: 2.31.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.29.1
+version: 2.31.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.29.1
+version: 2.31.0
 allowed-tools: Bash(agent-kakaotalk:*)
 metadata:
   openclaw:
@@ -303,6 +303,23 @@ Output includes:
 - `unread_count` — unread message count
 - `last_message` — most recent message preview, including `author_name` when the sender's nickname is known from the chat list (otherwise `null`)
 
+### Chat Leave
+
+```bash
+# Leave a chat room (works on 1:1, group, open, and PlusChat rooms)
+agent-kakaotalk chat leave <chat-id>
+agent-kakaotalk chat leave <chat-id> --pretty
+agent-kakaotalk chat leave <chat-id> --account <account-id>
+```
+
+Output (JSON by default; `--pretty` pretty-prints the same JSON):
+
+```json
+{ "success": true, "status_code": 0, "chat_id": "9876543210" }
+```
+
+The process exits non-zero when `success` is `false`.
+
 ### Member Commands
 
 ```bash
@@ -623,7 +640,7 @@ See the [KakaoTalk SDK documentation](https://agent-messenger.dev/docs/sdk/kakao
 ## Limitations
 
 - Auto-extraction of email/password from the desktop app is **macOS and Windows only** (KakaoTalk desktop is not available on Linux). Linux users must pass `--email` and `--password` (or `--password-file`) explicitly — the LOCO protocol, login flow, and all messaging features work on Linux.
-- No channel/chat room creation or management
+- No chat room creation
 - No friend list management
 - No reactions or emoji
 - No message editing or deletion

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.29.1
+version: 2.31.0
 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.29.1
+version: 2.31.0
 allowed-tools: Bash(agent-slack:*)
 metadata:
   openclaw:
@@ -217,8 +217,8 @@ agent-slack message replies general 1234567890.123456 --limit 50
 agent-slack message replies general 1234567890.123456 --oldest 1234567890.000000
 agent-slack message replies general 1234567890.123456 --cursor <next_cursor>
 
-# Update a message
-agent-slack message update <channel> <ts> <new-text>
+# Edit a message
+agent-slack message edit <channel> <ts> <new-text>
 
 # Delete a message
 agent-slack message delete <channel> <ts> --force

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

@@ -287,8 +287,8 @@ sleep 5
 agent-slack reaction remove "$CHANNEL" "$MSG_TS" hourglass_flowing_sand
 agent-slack reaction add "$CHANNEL" "$MSG_TS" white_check_mark
 
-# Update message
-agent-slack message update "$CHANNEL" "$MSG_TS" "✅ Deployed v2.1.0 to production successfully!"
+# Edit message
+agent-slack message edit "$CHANNEL" "$MSG_TS" "✅ Deployed v2.1.0 to production successfully!"
 ```
 
 **When to use**: Visual status tracking, workflow states, quick acknowledgments.

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.29.1
+version: 2.31.0
 allowed-tools: Bash(agent-slackbot:*)
 metadata:
   openclaw:
@@ -206,8 +206,8 @@ agent-slackbot message get <channel> <ts>
 agent-slackbot message replies <channel> <thread_ts>
 agent-slackbot message replies C0ACZKTDDC0 1234567890.123456 --limit 50
 
-# Update a message (bot's own messages only)
-agent-slackbot message update <channel> <ts> <new-text>
+# Edit a message (bot's own messages only)
+agent-slackbot message edit <channel> <ts> <new-text>
 
 # Delete a message (bot's own messages only)
 agent-slackbot message delete <channel> <ts> --force

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

@@ -47,8 +47,8 @@ sleep 2
 agent-slackbot message send "$CHANNEL" "Deploying to production..." --thread "$THREAD_TS"
 sleep 2
 
-# Update parent with final status
-agent-slackbot message update "$CHANNEL" "$THREAD_TS" "Deployment complete!"
+# Edit parent with final status
+agent-slackbot message edit "$CHANNEL" "$THREAD_TS" "Deployment complete!"
 
 # Add reaction
 agent-slackbot reaction add "$CHANNEL" "$THREAD_TS" white_check_mark
@@ -110,8 +110,8 @@ sleep 5
 agent-slackbot reaction remove "$CHANNEL" "$MSG_TS" hourglass_flowing_sand
 agent-slackbot reaction add "$CHANNEL" "$MSG_TS" white_check_mark
 
-# Update message with result
-agent-slackbot message update "$CHANNEL" "$MSG_TS" "Request processed successfully!"
+# Edit message with result
+agent-slackbot message edit "$CHANNEL" "$MSG_TS" "Request processed successfully!"
 ```
 
 **When to use**: Visual status tracking, acknowledgments, workflow states.

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.29.1
+version: 2.31.0
 allowed-tools: Bash(agent-teams:*)
 metadata:
   openclaw:
@@ -249,10 +249,15 @@ agent-teams chat history <chat-id> --limit 100
 
 # Send a message to a chat
 agent-teams chat send <chat-id> "Hello"
+
+# Edit one of your own chat messages
+agent-teams chat edit <chat-id> <message-id> "Updated text"
 ```
 
 Chat IDs look like `19:guid1_guid2@unq.gbl.spaces` (1:1) or `19:guid@thread.tacv2` (group). Get them from `chat list`. The `48:notes` chat (`type: self`) is your personal "to me" notes thread.
 
+`chat edit` only works on your own messages, and only for chats — Teams channel messages are not editable through this API.
+
 ### Team Commands
 
 ```bash

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.29.1
+version: 2.31.0
 allowed-tools: Bash(agent-telegram:*)
 ---
 
@@ -117,6 +117,9 @@ agent-telegram chat get @durov
 # List recent messages
 agent-telegram message list @durov --limit 10
 
+# Edit one of your own messages (within 48h)
+agent-telegram message edit @durov <message-id> "Updated text"
+
 # Logout
 agent-telegram auth logout
 ```

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.29.1
+version: 2.31.0
 allowed-tools: Bash(agent-telegrambot:*)
 metadata:
   openclaw:
@@ -172,7 +172,7 @@ agent-telegrambot message send @username "Silent message" --silent
 agent-telegrambot message send <chat> "Topic message" --thread-id 5
 
 # Edit a message (bot's own messages only)
-agent-telegrambot message update <chat> <message-id> <new-text>
+agent-telegrambot message edit <chat> <message-id> <new-text>
 
 # Delete a message
 agent-telegrambot message delete <chat> <message-id> --force

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.29.1
+version: 2.31.0
 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.29.1
+version: 2.31.0
 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.29.1
+version: 2.31.0
 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.29.1
+version: 2.31.0
 allowed-tools: Bash(agent-whatsapp:*)
 metadata:
   openclaw:
@@ -251,6 +251,10 @@ agent-whatsapp message send +1234567890 "Hello!"
 agent-whatsapp message send 123456789-123345@g.us "Hello team!"
 agent-whatsapp message send +1234567890 "Hello!" --account <id>
 
+# Edit one of your own messages (within ~15 minutes)
+agent-whatsapp message edit <chat> <message-id> <text>
+agent-whatsapp message edit +1234567890 ABC123DEF456 "Updated text"
+
 # React to a message
 agent-whatsapp message react <chat> <message-id> <emoji>
 agent-whatsapp message react +1234567890 ABC123DEF456 "👍"
@@ -342,6 +346,26 @@ agent-whatsapp message list +1234567890 --limit 1
 agent-whatsapp message react +1234567890 <message-id> "👍"
 ```
 
+### Edit one of your own messages
+
+```bash
+# Get the message ID of a message you sent
+agent-whatsapp message list +1234567890 --limit 5
+
+# Edit it (only your own messages, within ~15 minutes)
+agent-whatsapp message edit +1234567890 <message-id> "Updated text"
+```
+
+The SDK exposes the same capability via `WhatsAppClient.editMessage`:
+
+```typescript
+import { WhatsAppClient } from 'agent-messenger/whatsapp'
+
+const client = await new WhatsAppClient().login()
+const sent = await client.sendMessage('+1234567890', 'Deploying…')
+await client.editMessage('+1234567890', sent.id, 'Deployed ✅')
+```
+
 ## Error Handling
 
 All commands return consistent error format:

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.29.1
+version: 2.31.0
 allowed-tools: Bash(agent-whatsappbot:*)
 metadata:
   openclaw: