agent-messenger 2.36.1 → 2.37.0

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.36.1
+version: 2.37.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.36.1
+version: 2.37.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.36.1
+version: 2.37.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.36.1
+version: 2.37.0
 allowed-tools: Bash(agent-kakaotalk:*)
 metadata:
   openclaw:

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

@@ -57,6 +57,17 @@ agent-kakaotalk message send "$TARGET_CHAT" "Hey Alice!"
 
 > Note: `display_name` joins the chat's member nicknames. For the user-set room title (matching the KakaoTalk app), see [Pattern 10](#pattern-10-resolve-canonical-room-titles).
 
+For an exact chat ID observed from a live event, the SDK can resolve that room
+directly without depending on the login-time list:
+
+```typescript
+const chat = await client.getChat('9876543210')
+```
+
+`getChat()` uses the read-only `CHATINFO` owner. It preserves numeric room types
+and open-chat types `OM` / `OD`; open chats without a `TITLE` meta use the
+OpenLink name as a display-title fallback.
+
 ## Pattern 3: Send Files, Photos, Videos, and Audio
 
 **Use case**: Upload an attachment to a chat (photo, video, voice, generic file, or multi-photo gallery)
@@ -187,6 +198,31 @@ NEW_MESSAGES=$(agent-kakaotalk message list "$CHAT_ID" --from "$LAST_SEEN")
 
 **Pagination details**: The CLI prefers KakaoTalk's `MCHATLOGS` flow for history reads, fetching message batches from the requested `--from` point and returning the last N messages after deduplication and ascending sort. If that path cannot provide results, it reads the maximum log ID from the login chat-list watermark (`ll`, falling back to `l.logId`) and calls `SYNCMSG` directly only when that watermark is ahead of the current cursor. The history path never uses `CHATONROOM`, which avoids room-entry side effects. If the watermark is missing or is not ahead of the cursor, the fallback fails closed and returns `[]`. As a safety net, both message flows are capped at 50 internal pages. A warning is printed to stderr only when that cap is actually hit and the returned history may be incomplete.
 
+For lossless forward-only SDK pagination, carry `next_cursor` into the next
+exclusive `from` request until `complete` is true:
+
+```typescript
+let from = '123456789'
+do {
+  const page = await client.getMessagePage(CHAT_ID, { from, count: 80 })
+  for (const message of page.messages) {
+    await archive(message)
+  }
+  if (page.complete) break
+  if (page.next_cursor === null) {
+    throw new Error('KakaoTalk history made no forward progress')
+  }
+  from = page.next_cursor
+} while (true)
+```
+
+`from` is exclusive. `next_cursor` is the last returned log ID, or `null` when
+the server made no forward progress. `complete` is true only when the available
+forward range is exhausted. The SDK prefers `MCHATLOGS`; for late rooms or an
+empty page it reconciles with read-only `CHATINFO` and then calls `SYNCMSG` only
+when the observed maximum log ID is ahead of `from`. This path does not call
+`CHATONROOM`.
+
 ## Pattern 7: Multi-Chat Broadcast
 
 **Use case**: Send the same message to multiple chats

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

package/src/platforms/kakaotalk/chat-classifier.test.ts

@@ -19,7 +19,7 @@ describe('classifyKakaoChat', () => {
     expect(classifyKakaoChat({ type: 10, active_members: 3 })).toBe('group')
   })
 
-  for (const type of [2, 13, 14, 15, 16]) {
+  for (const type of [2, 13, 14, 15, 16, 'OM', 'OD'] as const) {
     it(`classifies open-chat type ${type} as open regardless of member count`, () => {
       expect(classifyKakaoChat({ type, active_members: 1 })).toBe('open')
       expect(classifyKakaoChat({ type, active_members: 2 })).toBe('open')

package/src/platforms/kakaotalk/chat-classifier.ts

@@ -1,12 +1,15 @@
-import type { KakaoChat } from './types'
+import type { KakaoChat, KakaoOpenChatType } from './types'
 
 export type KakaoChatKind = 'dm' | 'group' | 'open' | 'unknown'
 
-// OpenChat-family `type` codes observed on the wire. KakaoTalk's LOCO
-// protocol exposes a numeric `type` field with no documented mapping; these
-// five codes consistently identify OpenChat rooms across normal OpenChat,
-// OpenChat DMs, and the various OpenChat sub-types seen in production.
-const OPEN_CHAT_TYPE_CODES: ReadonlySet<number> = new Set([2, 13, 14, 15, 16])
+// OpenChat-family `type` values observed on the wire. Login/chat-list data
+// uses numeric codes while CHATINFO may return the protocol string tags
+// `OM` / `OD`; both forms must share this single classification owner.
+const OPEN_CHAT_TYPES: ReadonlySet<KakaoOpenChatType> = new Set([2, 13, 14, 15, 16, 'OM', 'OD'])
+
+export function isOpenKakaoChatType(type: unknown): type is KakaoOpenChatType {
+  return OPEN_CHAT_TYPES.has(type as KakaoOpenChatType)
+}
 
 /**
  * Classify a KakaoTalk chat as `'dm'`, `'group'`, `'open'`, or `'unknown'`.
@@ -23,7 +26,7 @@ const OPEN_CHAT_TYPE_CODES: ReadonlySet<number> = new Set([2, 13, 14, 15, 16])
  * the case defensively.
  */
 export function classifyKakaoChat(chat: Pick<KakaoChat, 'type' | 'active_members'>): KakaoChatKind {
-  if (OPEN_CHAT_TYPE_CODES.has(chat.type)) return 'open'
+  if (isOpenKakaoChatType(chat.type)) return 'open'
   // active_members counts the logged-in user, so a 1:1 DM is exactly 2
   // (self + one other) and a "lone" room with only self is 1.
   if (chat.active_members <= 2) return 'dm'