agent-messenger 2.30.0 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-messenger",
-  "version": "2.30.0",
+  "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.30.0
+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.30.0
+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.30.0
+version: 2.31.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.30.0
+version: 2.31.0
 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.30.0
+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.30.0
+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.30.0
+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.30.0
+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.30.0
+version: 2.31.0
 allowed-tools: Bash(agent-slack:*)
 metadata:
   openclaw:

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

package/src/platforms/discord/client.test.ts

@@ -447,6 +447,127 @@ describe('DiscordClient', () => {
     })
   })
 
+  describe('searchMessages', () => {
+    const searchResult = {
+      id: 'msg1',
+      channel_id: 'ch1',
+      guild_id: 'guild1',
+      author: { id: 'user1', username: 'user1' },
+      content: 'matching message',
+      timestamp: '2026-01-01T00:00:00.000Z',
+      hit: true,
+    }
+
+    it('flattens grouped search results and keeps hits', async () => {
+      mockResponse({
+        doing_deep_historical_index: false,
+        total_results: 1,
+        messages: [[searchResult, { ...searchResult, id: 'context', hit: false }]],
+      })
+
+      const client = await new DiscordClient().login({ token: 'test-token' })
+      const result = await client.searchMessages('guild1', 'matching', { limit: 25 })
+
+      expect(result).toEqual({ results: [searchResult], total: 1 })
+      expect(fetchCalls[0].url).toBe(
+        'https://discord.com/api/v10/guilds/guild1/messages/search?content=matching&limit=25',
+      )
+    })
+
+    it('retries when the search index is not ready', async () => {
+      mockResponse(
+        {
+          message: 'Index not yet available. Try again later',
+          code: 110000,
+          documents_indexed: 0,
+          retry_after: 0,
+        },
+        202,
+      )
+      mockResponse({
+        doing_deep_historical_index: false,
+        total_results: 1,
+        messages: [[searchResult]],
+      })
+
+      const client = await new DiscordClient().login({ token: 'test-token' })
+      const startTime = Date.now()
+      const result = await client.searchMessages('guild1', 'matching')
+      const elapsed = Date.now() - startTime
+
+      expect(result).toEqual({ results: [searchResult], total: 1 })
+      expect(elapsed).toBeGreaterThanOrEqual(50)
+      expect(fetchCalls).toHaveLength(2)
+    })
+
+    it('throws a clear error when the search index remains unavailable', async () => {
+      for (let attempt = 0; attempt < 4; attempt++) {
+        mockResponse(
+          {
+            message: 'Index not yet available. Try again later',
+            code: 110000,
+            documents_indexed: 0,
+            retry_after: 0.001,
+          },
+          202,
+        )
+      }
+
+      const client = await new DiscordClient().login({ token: 'test-token' })
+
+      await expect(client.searchMessages('guild1', 'matching')).rejects.toThrow(
+        'Search index is not ready after retries',
+      )
+      expect(fetchCalls).toHaveLength(4)
+    })
+
+    it('rejects unexpected successful response payloads', async () => {
+      mockResponse(
+        {
+          message: 'Unexpected response',
+          code: 999999,
+          retry_after: 0,
+        },
+        202,
+      )
+
+      const client = await new DiscordClient().login({ token: 'test-token' })
+
+      try {
+        await client.searchMessages('guild1', 'matching')
+        throw new Error('Expected searchMessages to throw')
+      } catch (error) {
+        expect(error).toBeInstanceOf(DiscordError)
+        if (!(error instanceof DiscordError)) throw error
+        expect(error.code).toBe('invalid_search_response')
+      }
+      expect(fetchCalls).toHaveLength(1)
+    })
+
+    it('rejects malformed message and retry payloads', async () => {
+      mockResponse({ total_results: 1, messages: null })
+      mockResponse(
+        {
+          message: 'Index not yet available. Try again later',
+          code: 110000,
+          documents_indexed: 0,
+          retry_after: -1,
+        },
+        202,
+      )
+
+      const client = await new DiscordClient().login({ token: 'test-token' })
+
+      await expect(client.searchMessages('guild1', 'matching')).rejects.toThrow(
+        'Discord returned an invalid search response',
+      )
+      await expect(client.searchMessages('guild1', 'matching')).rejects.toThrow(
+        'Discord returned an invalid search response',
+      )
+      expect(fetchCalls).toHaveLength(2)
+    })
+  })
+
   describe('rate limiting', () => {
     it('waits when bucket is exhausted before making request', async () => {
       mockResponse({ id: '1', username: 'user1' }, 200, {

package/src/platforms/discord/client.ts

@@ -1,6 +1,7 @@
 import { readFile } from 'node:fs/promises'
 
 import { getDiscordHeaders } from './super-properties'
+import { DiscordSearchIndexNotReadyResponseSchema, DiscordSearchResponseSchema } from './types'
 import type {
   DiscordChannel,
   DiscordDMChannel,
@@ -11,7 +12,6 @@ import type {
   DiscordMessage,
   DiscordRelationship,
   DiscordSearchOptions,
-  DiscordSearchResponse,
   DiscordSearchResult,
   DiscordUser,
   DiscordUserNote,
@@ -37,6 +37,7 @@ interface RateLimitBucket {
 const BASE_URL = 'https://discord.com/api/v10'
 const MAX_RETRIES = 3
 const BASE_BACKOFF_MS = 100
+const MAX_SEARCH_INDEX_RETRY_MS = 30_000
 
 export class DiscordClient {
   private token: string | null = null
@@ -393,28 +394,50 @@ export class DiscordClient {
       params.set('offset', options.offset.toString())
     }
 
-    const response = await this.request<DiscordSearchResponse>(
-      'GET',
-      `/guilds/${guildId}/messages/search?${params.toString()}`,
-    )
-
-    const results = response.messages
-      .flat()
-      .filter((msg) => msg.hit)
-      .map((msg) => ({
-        id: msg.id,
-        channel_id: msg.channel_id,
-        guild_id: msg.guild_id,
-        content: msg.content,
-        author: msg.author,
-        timestamp: msg.timestamp,
-        hit: msg.hit,
-      }))
-
-    return {
-      results,
-      total: response.total_results,
+    const path = `/guilds/${guildId}/messages/search?${params.toString()}`
+
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+      const response: unknown = await this.request('GET', path)
+      const searchResponse = DiscordSearchResponseSchema.safeParse(response)
+
+      if (searchResponse.success) {
+        const results = searchResponse.data.messages
+          .flat()
+          .filter((msg) => msg.hit)
+          .map((msg) => ({
+            id: msg.id,
+            channel_id: msg.channel_id,
+            guild_id: msg.guild_id,
+            content: msg.content,
+            author: msg.author,
+            timestamp: msg.timestamp,
+            hit: msg.hit,
+          }))
+
+        return {
+          results,
+          total: searchResponse.data.total_results,
+        }
+      }
+
+      const indexNotReadyResponse = DiscordSearchIndexNotReadyResponseSchema.safeParse(response)
+      if (!indexNotReadyResponse.success) {
+        throw new DiscordError('Discord returned an invalid search response', 'invalid_search_response')
+      }
+
+      if (attempt === MAX_RETRIES) {
+        throw new DiscordError('Search index is not ready after retries', 'search_index_not_ready')
+      }
+
+      const requestedDelayMs = indexNotReadyResponse.data.retry_after * 1000
+      const retryDelayMs = Math.min(
+        requestedDelayMs === 0 ? BASE_BACKOFF_MS : requestedDelayMs,
+        MAX_SEARCH_INDEX_RETRY_MS,
+      )
+      await this.sleep(retryDelayMs)
     }
+
+    throw new DiscordError('Search failed after retries', 'max_retries')
   }
 
   async getUserProfile(userId: string): Promise<DiscordUserProfile> {

package/src/platforms/discord/types.ts

@@ -109,6 +109,15 @@ export interface DiscordSearchResponse {
   messages: DiscordSearchResult[][]
 }
 
+export interface DiscordSearchIndexNotReadyResponse {
+  message: string
+  code: 110000
+  documents_indexed: number
+  retry_after: number
+}
+
+export type DiscordSearchApiResponse = DiscordSearchResponse | DiscordSearchIndexNotReadyResponse
+
 export interface DiscordSearchOptions {
   channelId?: string
   authorId?: string
@@ -267,6 +276,13 @@ export const DiscordSearchResponseSchema = z.object({
   messages: z.array(z.array(DiscordSearchResultSchema)),
 })
 
+export const DiscordSearchIndexNotReadyResponseSchema = z.object({
+  message: z.string(),
+  code: z.literal(110000),
+  documents_indexed: z.number(),
+  retry_after: z.number().nonnegative(),
+})
+
 export const DiscordCredentialsSchema = z.object({
   token: z.string(),
 })