agent-messenger 2.12.2 → 2.13.1

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.12.2
+version: 2.13.1
 allowed-tools: Bash(agent-kakaotalk:*)
 metadata:
   openclaw:
@@ -288,15 +288,39 @@ agent-kakaotalk chat list
 agent-kakaotalk chat list --pretty
 agent-kakaotalk chat list --account <account-id>
 agent-kakaotalk chat list --account <account-id> --pretty
+
+# Resolve user-set room titles via CHATINFO (one extra LOCO call per chat;
+# slower, but matches the room name shown in the official KakaoTalk app)
+agent-kakaotalk chat list --resolve-titles
 ```
 
 Output includes:
 - `chat_id` — numeric chat room ID
 - `type` — chat type (1:1, group, open chat)
 - `display_name` — comma-separated member names
+- `title` — user-set room title (only populated with `--resolve-titles`; otherwise `null`). For open chats (`OM` / `OD`) without a user-set title, falls back to the OpenLink room name (one extra `INFOLINK` LOCO call per such chat).
 - `active_members` — number of active members
 - `unread_count` — unread message count
-- `last_message` — most recent message preview
+- `last_message` — most recent message preview, including `author_name` when the sender's nickname is known from the chat list (otherwise `null`)
+
+### Member Commands
+
+```bash
+# List all members of a chat room (uses LOCO GETMEM — one call per invocation)
+agent-kakaotalk member list <chat-id>
+agent-kakaotalk member list <chat-id> --pretty
+agent-kakaotalk member list <chat-id> --account <account-id>
+```
+
+Each member includes:
+- `user_id` — numeric user ID (string for safety)
+- `nickname` — display name in this chat (open chats may differ from the user's main Kakao nickname)
+- `profile_image_url`, `full_profile_image_url`, `original_profile_image_url`
+- `status_message`, `country_iso`
+- `user_type` — KakaoTalk's user type (100 = friend, 1000 = open profile, etc.); `null` when the server omits the field
+- `open_token`, `open_profile_link_id`, `open_permission` — open-chat-only fields (`null` for normal chats; `open_permission` is 1=OWNER, 2=NONE, 4=MANAGER, 8=BOT)
+
+> **SDK-only**: `KakaoTalkClient.getMembersByIds(chatId, userIds)` is available for the >100-member case where you already have specific user IDs to resolve (typically from a CHATONROOM `mi` array). It is intentionally not exposed via the CLI because acquiring those IDs requires a CHATONROOM call that is also SDK-only. Use `agent-kakaotalk member list` for the common case.
 
 ### Message Commands
 
@@ -322,6 +346,7 @@ Each message includes:
 - `log_id` — unique message identifier
 - `type` — message type (1 = text, 2 = photo, etc.)
 - `author_id` — sender's user ID
+- `author_name` — sender's nickname when known from the chat list (otherwise `null`; only the room's "display members" are cached)
 - `message` — message text content
 - `sent_at` — Unix timestamp (milliseconds)
 
@@ -354,10 +379,12 @@ All commands output JSON by default for AI consumption:
   "chat_id": "9876543210",
   "type": 2,
   "display_name": "Alice, Bob",
+  "title": null,
   "active_members": 3,
   "unread_count": 5,
   "last_message": {
-    "author_id": "1111111111",
+    "author_id": 1111111111,
+    "author_name": "Alice",
     "message": "Hello everyone!",
     "sent_at": 1705312200000
   }

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

@@ -55,6 +55,8 @@ agent-kakaotalk message send "$TARGET_CHAT" "Hey Alice!"
 
 **When to use**: First time interacting with a chat, or when the user references a chat by name.
 
+> Note: `display_name` joins the chat's member nicknames. For the user-set room title (matching the KakaoTalk app), see [Pattern 9](#pattern-9-resolve-canonical-room-titles).
+
 ## Pattern 3: Monitor Chat for New Messages
 
 **Use case**: Watch a chat room and respond to new messages
@@ -221,7 +223,53 @@ echo "$UNREAD" | jq -r '.[] | "  \(.display_name // "Unknown") — \(.unread_cou
 
 **When to use**: Morning catch-up, checking for urgent messages, triage.
 
-## Pattern 9: Error Handling and Retry
+## Pattern 9: Resolve Canonical Room Titles
+
+**Use case**: Show user-set room names (matching the official KakaoTalk app) instead of comma-joined member nicknames
+
+By default, `chat list` returns `display_name` built from the chat's "display members" (a comma-joined nickname list — e.g. `"Alice, Bob, Charlie"`). The `--resolve-titles` flag fetches each chat's user-set title via the LOCO `CHATINFO` command and surfaces it in a separate `title` field.
+
+For open chats (`OM` / `OD`) without a user-set title, the CLI additionally consults the OpenLink record via `INFOLINK` and uses the link name as a fallback. This matches what KakaoTalk shows for open-chat rooms in the app sidebar.
+
+```bash
+#!/bin/bash
+
+# Without --resolve-titles: title is null, display_name is member nicknames
+agent-kakaotalk chat list | jq '.[0] | {chat_id, display_name, title}'
+# {
+#   "chat_id": "9876543210",
+#   "display_name": "Alice, Bob, Charlie",
+#   "title": null
+# }
+
+# With --resolve-titles: title is the user-set room name
+agent-kakaotalk chat list --resolve-titles | jq '.[0] | {chat_id, display_name, title}'
+# {
+#   "chat_id": "9876543210",
+#   "display_name": "Alice, Bob, Charlie",
+#   "title": "Project Standup"
+# }
+
+# Render the best available name (title preferred, display_name fallback)
+agent-kakaotalk chat list --resolve-titles \
+  | jq -r '.[] | "\(.chat_id): \(.title // .display_name // "Untitled")"'
+```
+
+**When to use**: User-facing chat pickers, room-name displays in summaries, anywhere you want output that matches what the user sees in the KakaoTalk app.
+
+**Cost**: One extra LOCO call per chat (CHATINFO). Open chats without a user-set title pay one additional call (INFOLINK). For large account snapshots this multiplies quickly — leave the flag off for hot paths.
+
+**SDK equivalent**:
+
+```typescript
+// Resolve titles for the whole list
+const chats = await client.getChats({ resolveTitles: true })
+
+// Single-chat lookup (returns null on error or missing title)
+const title = await client.getChatTitle('9876543210')
+```
+
+## Pattern 10: Error Handling and Retry
 
 **Use case**: Robust message sending with retries
 

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.12.2
+version: 2.13.1
 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.12.2
+version: 2.13.1
 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.12.2
+version: 2.13.1
 allowed-tools: Bash(agent-slackbot:*)
 metadata:
   openclaw:
@@ -365,7 +365,6 @@ Credentials stored in `~/.config/agent-messenger/slackbot-credentials.json` (060
 - Bot can only edit/delete its own messages
 - Bot must be invited to private channels
 - No scheduled messages
-- Plain text messages only (no blocks/formatting)
 
 ## Troubleshooting
 

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

package/src/platforms/discordbot/index.test.ts

@@ -17,6 +17,12 @@ import {
   DiscordReactionSchema,
   DiscordUserSchema,
 } from '@/platforms/discordbot/index'
+import type {
+  DiscordBotListenerOptions,
+  DiscordGatewayEmbed,
+  DiscordGatewayMessageCreateEvent,
+  DiscordGatewayStickerItem,
+} from '@/platforms/discordbot/index'
 
 it('DiscordBotClient is exported from barrel', () => {
   expect(typeof DiscordBotClient).toBe('function')
@@ -34,6 +40,11 @@ it('DiscordBotListener is exported from barrel', () => {
   expect(typeof DiscordBotListener).toBe('function')
 })
 
+it('DiscordBotListenerOptions type is exported from barrel', () => {
+  const options: DiscordBotListenerOptions = { intents: 0 }
+  expect(options.intents).toBe(0)
+})
+
 it('DiscordGatewayOpcode is exported from barrel', () => {
   expect(DiscordGatewayOpcode.Identify).toBe(2)
   expect(DiscordGatewayOpcode.Hello).toBe(10)
@@ -80,3 +91,68 @@ it('DiscordReactionSchema is exported from barrel', () => {
 it('DiscordFileSchema is exported from barrel', () => {
   expect(typeof DiscordFileSchema.parse).toBe('function')
 })
+
+it('DiscordGatewayEmbed type is exported from barrel', () => {
+  const embed: DiscordGatewayEmbed = {
+    type: 'rich',
+    title: 'Release notes',
+    description: 'v2.13.1 is out',
+    url: 'https://example.com/release',
+  }
+  expect(embed.title).toBe('Release notes')
+})
+
+it('DiscordGatewayStickerItem type is exported from barrel', () => {
+  const sticker: DiscordGatewayStickerItem = { id: '1', name: 'wave', format_type: 1 }
+  expect(sticker.format_type).toBe(1)
+})
+
+it('DiscordGatewayMessageCreateEvent accepts the new optional fields', () => {
+  const event: DiscordGatewayMessageCreateEvent = {
+    type: 'MESSAGE_CREATE',
+    id: 'm1',
+    channel_id: 'C1',
+    author: { id: 'U1', username: 'alice', global_name: 'Alice', bot: false },
+    content: 'hello',
+    timestamp: '2026-05-11T00:00:00Z',
+    mention_everyone: false,
+    mention_roles: ['R1', 'R2'],
+    message_reference: { message_id: 'm0', channel_id: 'C1', guild_id: 'G1' },
+    embeds: [{ type: 'rich', title: 't', description: 'd', url: 'https://example.com' }],
+    sticker_items: [{ id: 's1', name: 'wave', format_type: 1 }],
+  }
+  expect(event.mention_everyone).toBe(false)
+  expect(event.mention_roles).toEqual(['R1', 'R2'])
+  expect(event.message_reference?.message_id).toBe('m0')
+  expect(event.embeds?.[0]?.title).toBe('t')
+  expect(event.sticker_items?.[0]?.name).toBe('wave')
+  expect(event.author.global_name).toBe('Alice')
+})
+
+it('DiscordGatewayMessageCreateEvent treats new fields as optional', () => {
+  const event: DiscordGatewayMessageCreateEvent = {
+    type: 'MESSAGE_CREATE',
+    id: 'm1',
+    channel_id: 'C1',
+    author: { id: 'U1', username: 'alice' },
+    content: 'hello',
+    timestamp: '2026-05-11T00:00:00Z',
+  }
+  expect(event.mention_everyone).toBeUndefined()
+  expect(event.embeds).toBeUndefined()
+  expect(event.sticker_items).toBeUndefined()
+  expect(event.message_reference).toBeUndefined()
+  expect(event.author.global_name).toBeUndefined()
+})
+
+it('DiscordGatewayMessageCreateEvent author.global_name accepts null', () => {
+  const event: DiscordGatewayMessageCreateEvent = {
+    type: 'MESSAGE_CREATE',
+    id: 'm1',
+    channel_id: 'C1',
+    author: { id: 'U1', username: 'alice', global_name: null },
+    content: 'hello',
+    timestamp: '2026-05-11T00:00:00Z',
+  }
+  expect(event.author.global_name).toBeNull()
+})

package/src/platforms/discordbot/index.ts

@@ -1,6 +1,7 @@
 export { DiscordBotClient } from './client'
 export { DiscordBotCredentialManager } from './credential-manager'
 export { DiscordBotListener } from './listener'
+export type { DiscordBotListenerOptions } from './listener'
 export type {
   DiscordBotConfig,
   DiscordBotCredentials,
@@ -9,6 +10,7 @@ export type {
   DiscordChannel,
   DiscordFile,
   DiscordGatewayChannelEvent,
+  DiscordGatewayEmbed,
   DiscordGatewayEvent,
   DiscordGatewayGenericEvent,
   DiscordGatewayGuildEvent,
@@ -19,6 +21,7 @@ export type {
   DiscordGatewayMessageUpdateEvent,
   DiscordGatewayPresenceEvent,
   DiscordGatewayReactionEvent,
+  DiscordGatewayStickerItem,
   DiscordGatewayTypingEvent,
   DiscordGuild,
   DiscordMessage,

package/src/platforms/discordbot/listener.test.ts

@@ -235,6 +235,47 @@ describe('DiscordBotListener', () => {
       expect(messages[0].channel_id).toBe('C123')
     })
 
+    it('surfaces global_name, mentions, message_reference, embeds, and sticker_items', async () => {
+      const client = createMockClient()
+      listener = new DiscordBotListener(client)
+
+      const messages: DiscordGatewayMessageCreateEvent[] = []
+      listener.on('message_create', (event) => messages.push(event))
+
+      await listener.start()
+      mockWsInstance.simulateOpen()
+      mockWsInstance.simulateHello()
+      mockWsInstance.simulateReady()
+      mockWsInstance.simulateDispatch(
+        'MESSAGE_CREATE',
+        {
+          id: 'msg_2',
+          channel_id: 'C123',
+          author: { id: 'U456', username: 'user', global_name: 'User Display' },
+          content: 'reply text',
+          timestamp: '2024-01-01T00:00:00Z',
+          mention_everyone: false,
+          mention_roles: ['R1'],
+          message_reference: { message_id: 'msg_orig', channel_id: 'C123', guild_id: 'G1' },
+          embeds: [{ type: 'rich', title: 'embed-title', description: 'embed-desc', url: 'https://example.com' }],
+          sticker_items: [{ id: 'sk1', name: 'wave', format_type: 1 }],
+        },
+        2,
+      )
+
+      expect(messages.length).toBe(1)
+      const event = messages[0]
+      expect(event.author.global_name).toBe('User Display')
+      expect(event.mention_everyone).toBe(false)
+      expect(event.mention_roles).toEqual(['R1'])
+      expect(event.message_reference?.message_id).toBe('msg_orig')
+      expect(event.message_reference?.guild_id).toBe('G1')
+      expect(event.embeds?.[0]?.title).toBe('embed-title')
+      expect(event.embeds?.[0]?.url).toBe('https://example.com')
+      expect(event.sticker_items?.[0]?.name).toBe('wave')
+      expect(event.sticker_items?.[0]?.format_type).toBe(1)
+    })
+
     it('emits message_update events', async () => {
       const client = createMockClient()
       listener = new DiscordBotListener(client)

package/src/platforms/discordbot/listener.ts

@@ -24,6 +24,10 @@ const DEFAULT_INTENTS =
 
 type EventKey = keyof DiscordBotListenerEventMap
 
+export interface DiscordBotListenerOptions {
+  intents?: number
+}
+
 export class DiscordBotListener {
   private client: DiscordBotClient
   private intents: number
@@ -43,7 +47,7 @@ export class DiscordBotListener {
   private cachedUser: { id: string; username: string } | null = null
   private generation = 0
 
-  constructor(client: DiscordBotClient, options?: { intents?: number }) {
+  constructor(client: DiscordBotClient, options?: DiscordBotListenerOptions) {
     this.client = client
     this.intents = options?.intents ?? DEFAULT_INTENTS
   }

package/src/platforms/discordbot/types.ts

@@ -224,17 +224,39 @@ export const DiscordIntent = {
   AutoModerationExecution: 1 << 21,
 } as const
 
+export interface DiscordGatewayEmbed {
+  type?: string
+  title?: string
+  description?: string
+  url?: string
+}
+
+export interface DiscordGatewayStickerItem {
+  id: string
+  name: string
+  format_type?: number
+}
+
 export interface DiscordGatewayMessageCreateEvent {
   type: 'MESSAGE_CREATE'
   id: string
   channel_id: string
   guild_id?: string
-  author: { id: string; username: string; bot?: boolean }
+  author: { id: string; username: string; global_name?: string | null; bot?: boolean }
   content: string
   timestamp: string
   edited_timestamp?: string
   mentions?: DiscordUser[]
+  mention_everyone?: boolean
+  mention_roles?: string[]
+  message_reference?: {
+    message_id?: string
+    channel_id?: string
+    guild_id?: string
+  }
   attachments?: DiscordFile[]
+  embeds?: DiscordGatewayEmbed[]
+  sticker_items?: DiscordGatewayStickerItem[]
 }
 
 export interface DiscordGatewayMessageUpdateEvent {

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

@@ -0,0 +1,33 @@
+import { describe, expect, it } from 'bun:test'
+
+import { classifyKakaoChat } from './chat-classifier'
+
+describe('classifyKakaoChat', () => {
+  it('classifies a normal DM (type 11, 2 members) as dm', () => {
+    expect(classifyKakaoChat({ type: 11, active_members: 2 })).toBe('dm')
+  })
+
+  it('classifies a normal group (type 10, 5 members) as group', () => {
+    expect(classifyKakaoChat({ type: 10, active_members: 5 })).toBe('group')
+  })
+
+  it('classifies legacy DM (type 9, 2 members) as dm via member-count fallback', () => {
+    expect(classifyKakaoChat({ type: 9, active_members: 2 })).toBe('dm')
+  })
+
+  it('classifies a 3-member group (type 10) as group, not dm', () => {
+    expect(classifyKakaoChat({ type: 10, active_members: 3 })).toBe('group')
+  })
+
+  for (const type of [2, 13, 14, 15, 16]) {
+    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')
+      expect(classifyKakaoChat({ type, active_members: 50 })).toBe('open')
+    })
+  }
+
+  it('classifies a 1-member chat (lone room) as dm', () => {
+    expect(classifyKakaoChat({ type: 11, active_members: 1 })).toBe('dm')
+  })
+})

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

@@ -0,0 +1,31 @@
+import type { KakaoChat } 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])
+
+/**
+ * Classify a KakaoTalk chat as `'dm'`, `'group'`, `'open'`, or `'unknown'`.
+ *
+ * REGRESSION GUARD: An earlier implementation hard-coded `0=dm`, `1=group`,
+ * `2=open` on the raw `type` number. Modern KakaoTalk uses codes like `11`
+ * for normal DMs and `10` for normal groups, so the old mapping silently
+ * classified every real DM as `'unknown'` and bucketed it as a group. Do
+ * NOT "simplify" this back to a pure type-code mapping without verifying
+ * against a real KakaoTalk session.
+ *
+ * `'unknown'` is reserved for future protocol drift; the current heuristic
+ * never returns it, but it is part of the union so consumers can handle
+ * the case defensively.
+ */
+export function classifyKakaoChat(chat: Pick<KakaoChat, 'type' | 'active_members'>): KakaoChatKind {
+  if (OPEN_CHAT_TYPE_CODES.has(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'
+  return 'group'
+}

package/src/platforms/kakaotalk/cli.ts

@@ -4,7 +4,7 @@ import type { Command as CommandType } from 'commander'
 import { Command } from 'commander'
 
 import pkg from '../../../package.json' with { type: 'json' }
-import { authCommand, chatCommand, messageCommand, whoamiCommand } from './commands/index'
+import { authCommand, chatCommand, memberCommand, messageCommand, whoamiCommand } from './commands/index'
 import { ensureKakaoAuth } from './ensure-auth'
 
 function isAuthCommand(command: CommandType): boolean {
@@ -30,6 +30,7 @@ program.hook('preAction', async (_thisCommand, actionCommand) => {
 
 program.addCommand(authCommand)
 program.addCommand(chatCommand)
+program.addCommand(memberCommand)
 program.addCommand(messageCommand)
 program.addCommand(whoamiCommand)