agent-messenger 2.36.0 → 2.37.0

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

@@ -75,6 +75,10 @@ const titled = await client.getChats({ resolveTitles: true })
 
 // Resolve a single chat's title directly (returns null on error or missing title)
 const title = await client.getChatTitle('9876543210')
+
+// Fetch one complete KakaoChat directly via read-only CHATINFO.
+// This also resolves rooms that are not present in the login-time chat list.
+const chat = await client.getChat('9876543210')
 ```
 
 ### Messages
@@ -89,6 +93,17 @@ const more = await client.getMessages('9876543210', { count: 100 })
 
 // Get messages after a known log ID
 const newer = await client.getMessages('9876543210', { from: '123456789' })
+
+// Reconcile history without dropping older messages when a protocol response
+// contains more than `count`. Continue until `complete` is true.
+let cursor: string | undefined = '123456789'
+do {
+  const page = await client.getMessagePage('9876543210', { from: cursor, count: 100 })
+  await consume(page.messages)
+  if (page.complete) break
+  if (!page.next_cursor) throw new Error('KakaoTalk history made no cursor progress')
+  cursor = page.next_cursor
+} while (true)
 ```
 
 Each `KakaoMessage` carries an `author_name: string | null`. The SDK auto-populates this from the same chat-list response that already arrives at login (no extra LOCO calls). It resolves for "display members" — the small set of nicknames KakaoTalk includes in the chat list — and is `null` for everyone else.
@@ -98,14 +113,27 @@ Each `KakaoMessage` also carries an `attachment: Record<string, unknown> | null`
 ### Members
 
 ```typescript
-// List all members of a chat (LOCO GETMEM)
+// List all members through the compatibility array API
 const members = await client.getMembers('9876543210')
 // → KakaoMember[]
 
+// Read the exact snapshot contract and its consistency evidence
+const snapshot = await client.getMemberSnapshot('9876543210')
+// → KakaoMemberSnapshot {
+//     chat_id, active_members, members, complete: true,
+//     consistency_basis: 'stable_double_read_chatinfo_getmem'
+//   }
+
 // Resolve a specific subset by user_id (LOCO MEMBER) — useful for >100-member rooms
 const subset = await client.getMembersByIds('9876543210', ['1234567890', '9876543210'])
 ```
 
+`getMemberSnapshot()` compares two read-only `CHATINFO` observations
+and two complete `GETMEM` observations. It succeeds only when the active
+count, display-member subset, and full member-ID set are stable. It does
+not call `CHATONROOM`, so it does not enter the room or advance unread
+state. Any malformed, partial, or changing snapshot fails closed.
+
 Each `KakaoMember` includes `user_id`, `nickname`, profile image URLs, `status_message`, `country_iso`, `user_type` (nullable; `null` when the server omits the field), and open-chat-only fields (`open_token`, `open_profile_link_id`, `open_permission` — the last is the OpenChannelUserPerm bitfield: `1`=OWNER, `2`=NONE, `4`=MANAGER, `8`=BOT).
 
 ### Sending

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-messenger",
-  "version": "2.36.0",
+  "version": "2.37.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.36.0
+version: 2.37.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.36.0
+version: 2.37.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.36.0
+version: 2.37.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.36.0
+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.0
+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.0
+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.0
+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.0
+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.0
+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.0
+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.0
+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.0
+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.0
+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.0
+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.0
+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.0
+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.0
+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.0
+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'