agent-messenger 2.8.0 → 2.9.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.8.0
+version: 2.9.0
 allowed-tools: Bash(agent-discordbot:*)
 metadata:
   openclaw:
@@ -265,21 +265,30 @@ agent-discordbot thread archive <thread-id>
 
 ### Snapshot Command
 
-Get comprehensive server state for AI agents:
+Get server overview for AI agents (brief by default):
 
 ```bash
-# Full snapshot of current server
+# Brief snapshot (default) — fast, minimal API calls
 agent-discordbot snapshot
 
-# Filtered snapshots
-agent-discordbot snapshot --channels-only
-agent-discordbot snapshot --users-only
+# Full snapshot — includes messages and members (slow, large output)
+agent-discordbot snapshot --full
 
-# Limit messages per channel
-agent-discordbot snapshot --limit 10
+# Filtered full snapshots
+agent-discordbot snapshot --full --channels-only
+agent-discordbot snapshot --full --users-only
+
+# Limit messages per channel (only with --full)
+agent-discordbot snapshot --full --limit 10
 ```
 
-Returns JSON with:
+Default returns brief JSON with:
+
+- Server ID
+- Channels (id, name) — text channels only
+- Hint for next commands
+
+With `--full`, returns comprehensive JSON with:
 
 - Server metadata (id, name)
 - Channels (id, name, type, topic)

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.8.0
+version: 2.9.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.8.0
+version: 2.9.0
 allowed-tools: Bash(agent-kakaotalk:*)
 metadata:
   openclaw:

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.8.0
+version: 2.9.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.8.0
+version: 2.9.0
 allowed-tools: Bash(agent-slack:*)
 metadata:
   openclaw:
@@ -473,24 +473,33 @@ agent-slack emoji list --pretty
 
 ### Snapshot Command
 
-Get comprehensive workspace state for AI agents:
+Get workspace overview for AI agents (brief by default):
 
 ```bash
-# Full snapshot
+# Brief snapshot (default) — fast, minimal API calls
 agent-slack snapshot
 
-# Filtered snapshots
-agent-slack snapshot --channels-only
-agent-slack snapshot --users-only
+# Full snapshot — includes messages, users, user groups (slow, large output)
+agent-slack snapshot --full
 
-# Limit messages per channel
-agent-slack snapshot --limit 10
+# Filtered full snapshots
+agent-slack snapshot --full --channels-only
+agent-slack snapshot --full --users-only
+
+# Limit messages per channel (only with --full)
+agent-slack snapshot --full --limit 10
 ```
 
-Returns JSON with:
+Default returns brief JSON with:
+
+- Workspace metadata
+- Channels (id, name) — non-archived only
+- Hint for next commands
+
+With `--full`, returns comprehensive JSON with:
 
 - Workspace metadata
-- Channels (id, name, topic, purpose)
+- Channels (id, name, topic, purpose, is_private, is_archived)
 - Recent messages (ts, text, user, channel)
 - Users (id, name, profile)
 - User groups (id, name, handle, description, user_count, users)

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

@@ -71,28 +71,25 @@ done
 ```bash
 #!/bin/bash
 
-# Get full snapshot
+# Get brief snapshot (default — fast, minimal output)
 SNAPSHOT=$(agent-slack snapshot)
 
 # Extract key information
 WORKSPACE_NAME=$(echo "$SNAPSHOT" | jq -r '.workspace.name')
 CHANNEL_COUNT=$(echo "$SNAPSHOT" | jq -r '.channels | length')
-USER_COUNT=$(echo "$SNAPSHOT" | jq -r '.users | length')
 
 echo "Workspace: $WORKSPACE_NAME"
 echo "Channels: $CHANNEL_COUNT"
-echo "Users: $USER_COUNT"
 
 # List all channels
 echo -e "\nChannels:"
 echo "$SNAPSHOT" | jq -r '.channels[] | "  \(.name) (\(.id))"'
 
-# List recent activity
-echo -e "\nRecent messages:"
-echo "$SNAPSHOT" | jq -r '.recent_messages[] | "  \(.channel_name): \(.text[0:50])"'
+# Then drill into specific channels for messages
+agent-slack message list general --limit 10
 ```
 
-**When to use**: Initial context gathering, status reports, workspace summaries.
+**When to use**: Initial context gathering, status reports, workspace summaries. Start with brief snapshot, then use targeted commands for details.
 
 ## Pattern 4: Thread Conversation
 

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.8.0
+version: 2.9.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.8.0
+version: 2.9.0
 allowed-tools: Bash(agent-teams:*)
 metadata:
   openclaw:
@@ -262,21 +262,30 @@ agent-teams file info <team-id> <channel-id> <file-id>
 
 ### Snapshot Command
 
-Get comprehensive team state for AI agents:
+Get team overview for AI agents (brief by default):
 
 ```bash
-# Full snapshot
+# Brief snapshot (default) — fast, minimal API calls
 agent-teams snapshot
 
-# Filtered snapshots
-agent-teams snapshot --channels-only
-agent-teams snapshot --users-only
+# Full snapshot — includes messages and members (slow, large output)
+agent-teams snapshot --full
 
-# Limit messages per channel
-agent-teams snapshot --limit 10
+# Filtered full snapshots
+agent-teams snapshot --full --channels-only
+agent-teams snapshot --full --users-only
+
+# Limit messages per channel (only with --full)
+agent-teams snapshot --full --limit 10
 ```
 
-Returns JSON with:
+Default returns brief JSON with:
+
+- Team metadata (id, name)
+- Channels (id, name)
+- Hint for next commands
+
+With `--full`, returns comprehensive JSON with:
 
 - Team metadata (id, name)
 - Channels (id, name, type, description)

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

@@ -127,28 +127,30 @@ done
 # Ensure fresh token
 agent-teams auth extract 2>/dev/null || true
 
-# Get full snapshot
+# Get brief snapshot (default — fast, minimal output)
 SNAPSHOT=$(agent-teams snapshot)
 
 # Extract key information
 TEAM_NAME=$(echo "$SNAPSHOT" | jq -r '.team.name // "Unknown"')
 CHANNEL_COUNT=$(echo "$SNAPSHOT" | jq -r '.channels | length')
-MEMBER_COUNT=$(echo "$SNAPSHOT" | jq -r '.members | length')
 
 echo "Team: $TEAM_NAME"
 echo "Channels: $CHANNEL_COUNT"
-echo "Members: $MEMBER_COUNT"
 
 # List all channels
 echo -e "\nChannels:"
 echo "$SNAPSHOT" | jq -r '.channels[] | "  #\(.name) (\(.id))"'
 
-# List recent activity
-echo -e "\nRecent messages:"
-echo "$SNAPSHOT" | jq -r '.recent_messages[] | "  [\(.channel_name)] \(.author): \(.content[0:50])"'
+# Then drill into a specific channel for recent activity
+CHANNEL_ID=$(echo "$SNAPSHOT" | jq -r '.channels[0].id // empty')
+TEAM_ID=$(echo "$SNAPSHOT" | jq -r '.team.id // empty')
+if [ -n "$TEAM_ID" ] && [ -n "$CHANNEL_ID" ]; then
+  echo -e "\nRecent messages:"
+  agent-teams message list "$TEAM_ID" "$CHANNEL_ID" --limit 10
+fi
 ```
 
-**When to use**: Initial context gathering, status reports, team summaries.
+**When to use**: Initial context gathering, status reports, team summaries. Start with brief snapshot, then use `message list <team-id> <channel-id>` or `member list <team-id>` for details.
 
 ## Pattern 4: Find Channel by Name
 

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.8.0
+version: 2.9.0
 allowed-tools: Bash(agent-telegram:*)
 ---
 

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.8.0
+version: 2.9.0
 allowed-tools: Bash(agent-webex:*)
 metadata:
   openclaw:
@@ -247,15 +247,24 @@ agent-webex member list <space-id> --limit 100
 
 ### Snapshot Command
 
-Get workspace spaces overview for AI agents:
+Get workspace overview for AI agents (brief by default):
 
 ```bash
+# Brief snapshot (default) — fast, minimal output
 agent-webex snapshot
+
+# Full snapshot — includes type and lastActivity
+agent-webex snapshot --full
 ```
 
-Returns JSON with:
+Default returns brief JSON with:
+
+- Spaces (id, title) — only spaces you're a member of
+- Hint for next commands
+
+With `--full`, returns:
 
-- Spaces (id, title, type, lastActivity) — only spaces you're a member of
+- Spaces (id, title, type, lastActivity)
 
 For messages or members, use `message list <space-id>` or `member list <space-id>`.
 

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

@@ -336,10 +336,16 @@ SPACE_COUNT=$(echo "$SNAPSHOT" | jq -r '.spaces | length')
 echo "Total spaces: $SPACE_COUNT"
 
 # List all spaces
-echo "$SNAPSHOT" | jq -r '.spaces[] | "  \(.title) (\(.type))"'
+echo "$SNAPSHOT" | jq -r '.spaces[] | "  \(.title) (\(.id))"'
+
+# Then drill into a specific space for details
+SPACE_ID=$(echo "$SNAPSHOT" | jq -r '.spaces[0].id // empty')
+if [ -n "$SPACE_ID" ]; then
+  agent-webex message list "$SPACE_ID" --limit 10
+fi
 ```
 
-**When to use**: Quick workspace overview to discover space IDs and titles. Use `message list <space-id>` or `member list <space-id>` for details.
+**When to use**: Quick workspace overview to discover space IDs and titles. Start with brief snapshot, then use `message list <space-id>` or `member list <space-id>` for details.
 
 ## Pipeline Patterns
 

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

package/src/platforms/channeltalk/commands/snapshot.test.ts

@@ -81,9 +81,54 @@ describe('snapshot command', () => {
     mockListUserChats.mockClear()
   })
 
-  test('returns workspace, managers, bots, groups, and user chats', async () => {
+  test('brief snapshot returns workspace, groups (name only), chat counts, and hint', async () => {
     const result = await snapshotAction()
 
+    expect(result.error).toBeUndefined()
+    expect(result.workspace).toEqual({ id: 'ws-1', name: 'Workspace One' })
+    expect(result.groups).toEqual([
+      { id: 'grp-1', name: 'Support' },
+      { id: 'grp-2', name: 'Sales' },
+    ])
+    expect(result.user_chats).toEqual({
+      total: 4,
+      by_state: { opened: 2, snoozed: 1, closed: 1 },
+    })
+    expect(result.hint).toBeDefined()
+    expect(result.managers).toBeUndefined()
+    expect(result.bots).toBeUndefined()
+    expect(mockGetGroupMessages).not.toHaveBeenCalled()
+  })
+
+  test('brief groups-only returns group names without messages', async () => {
+    const result = await snapshotAction({ groupsOnly: true })
+
+    expect(result.workspace).toEqual({ id: 'ws-1', name: 'Workspace One' })
+    expect(result.groups).toHaveLength(2)
+    expect(result.groups?.[0]).toEqual({ id: 'grp-1', name: 'Support' })
+    expect(result.hint).toBeDefined()
+    expect(result.user_chats).toBeUndefined()
+    expect(mockGetGroupMessages).not.toHaveBeenCalled()
+    expect(mockListUserChats).not.toHaveBeenCalled()
+  })
+
+  test('brief chats-only returns counts without recent details', async () => {
+    const result = await snapshotAction({ chatsOnly: true })
+
+    expect(result.workspace).toEqual({ id: 'ws-1', name: 'Workspace One' })
+    expect(result.groups).toBeUndefined()
+    expect(result.user_chats).toEqual({
+      total: 4,
+      by_state: { opened: 2, snoozed: 1, closed: 1 },
+    })
+    expect(result.hint).toBeDefined()
+    expect(mockListGroups).not.toHaveBeenCalled()
+    expect(mockGetGroupMessages).not.toHaveBeenCalled()
+  })
+
+  test('full snapshot returns workspace, managers, bots, groups, and user chats', async () => {
+    const result = await snapshotAction({ full: true })
+
     expect(result.error).toBeUndefined()
     expect(result).toEqual({
       workspace: { id: 'ws-1', name: 'Workspace One' },
@@ -156,19 +201,21 @@ describe('snapshot command', () => {
     })
   })
 
-  test('groups-only skips user chats', async () => {
-    const result = await snapshotAction({ groupsOnly: true })
+  test('full groups-only includes messages', async () => {
+    const result = await snapshotAction({ full: true, groupsOnly: true, limit: 3 })
 
-    expect(result.workspace).toEqual({ id: 'ws-1', name: 'Workspace One' })
-    expect(result.groups).toHaveLength(2)
-    expect(result.user_chats).toBeUndefined()
-    expect(result.managers).toBeUndefined()
-    expect(result.bots).toBeUndefined()
-    expect(mockListUserChats).not.toHaveBeenCalled()
+    expect(mockGetGroupMessages).toHaveBeenCalledWith('ws-1', 'grp-1', { limit: 3, sortOrder: 'desc' })
+    expect(mockGetGroupMessages).toHaveBeenCalledWith('ws-1', 'grp-2', { limit: 3, sortOrder: 'desc' })
+    expect(result.groups?.[0].recent_messages?.[0]).toEqual({
+      id: 'grp-1-msg-1',
+      person_type: 'manager',
+      plain_text: 'Message for grp-1',
+      created_at: 1000,
+    })
   })
 
-  test('chats-only skips groups', async () => {
-    const result = await snapshotAction({ chatsOnly: true, limit: 1 })
+  test('full chats-only includes recent details', async () => {
+    const result = await snapshotAction({ full: true, chatsOnly: true, limit: 1 })
 
     expect(result.workspace).toEqual({ id: 'ws-1', name: 'Workspace One' })
     expect(result.groups).toBeUndefined()
@@ -189,20 +236,5 @@ describe('snapshot command', () => {
         },
       ],
     })
-    expect(mockListGroups).not.toHaveBeenCalled()
-    expect(mockGetGroupMessages).not.toHaveBeenCalled()
-  })
-
-  test('includes recent messages for each group with requested limit', async () => {
-    const result = await snapshotAction({ groupsOnly: true, limit: 3 })
-
-    expect(mockGetGroupMessages).toHaveBeenCalledWith('ws-1', 'grp-1', { limit: 3, sortOrder: 'desc' })
-    expect(mockGetGroupMessages).toHaveBeenCalledWith('ws-1', 'grp-2', { limit: 3, sortOrder: 'desc' })
-    expect(result.groups?.[0].recent_messages[0]).toEqual({
-      id: 'grp-1-msg-1',
-      person_type: 'manager',
-      plain_text: 'Message for grp-1',
-      created_at: 1000,
-    })
   })
 })

package/src/platforms/channeltalk/commands/snapshot.ts

@@ -10,6 +10,7 @@ interface SnapshotOptions {
   pretty?: boolean
   groupsOnly?: boolean
   chatsOnly?: boolean
+  full?: boolean
   limit?: number | string
 }
 
@@ -33,7 +34,7 @@ interface SnapshotResult {
   groups?: Array<{
     id: string
     name: string
-    recent_messages: Array<{
+    recent_messages?: Array<{
       id: string
       person_type?: string
       plain_text?: string
@@ -43,7 +44,7 @@ interface SnapshotResult {
   user_chats?: {
     total: number
     by_state: Record<string, number>
-    recent: Array<{
+    recent?: Array<{
       id: string
       state?: string
       assignee_id?: string
@@ -51,6 +52,7 @@ interface SnapshotResult {
       updated_at?: number
     }>
   }
+  hint?: string
   error?: string
 }
 
@@ -58,7 +60,6 @@ export async function snapshotAction(options: SnapshotOptions = {}): Promise<Sna
   try {
     const client = await getClient(options)
     const workspaceId = await getCurrentWorkspaceId(options)
-    const limit = parseLimit(options.limit)
 
     const channel = await client.getChannel(workspaceId)
     const workspace = {
@@ -66,42 +67,114 @@ export async function snapshotAction(options: SnapshotOptions = {}): Promise<Sna
       name: channel.name,
     }
 
-    if (options.groupsOnly) {
-      const groups = await buildGroupsSnapshot(client, workspaceId, limit)
-      return { workspace, groups }
+    if (options.full) {
+      return buildFullSnapshot(client, workspaceId, workspace, options)
     }
 
-    if (options.chatsOnly) {
-      const userChats = await buildUserChatsSnapshot(client, workspaceId, limit)
-      return { workspace, user_chats: userChats }
+    return buildBriefSnapshot(client, workspaceId, workspace, options)
+  } catch (error) {
+    return { error: (error as Error).message }
+  }
+}
+
+async function buildBriefSnapshot(
+  client: Awaited<ReturnType<typeof getClient>>,
+  workspaceId: string,
+  workspace: { id: string; name: string },
+  options: SnapshotOptions,
+): Promise<SnapshotResult> {
+  if (options.groupsOnly) {
+    const groups = await client.listGroups(workspaceId, { limit: 20 })
+    return {
+      workspace,
+      groups: groups.map((g) => ({ id: g.id, name: g.name })),
+      hint: "Use 'group messages <group>' for messages.",
     }
+  }
 
-    const [managers, bots, groups, userChats] = await Promise.all([
-      client.listManagers(workspaceId, { limit: 50 }),
-      client.listBots(workspaceId, { limit: 50 }),
-      buildGroupsSnapshot(client, workspaceId, limit),
-      buildUserChatsSnapshot(client, workspaceId, limit),
+  if (options.chatsOnly) {
+    const [openedChats, snoozedChats, closedChats] = await Promise.all([
+      client.listUserChats(workspaceId, { state: 'opened', limit: 100 }),
+      client.listUserChats(workspaceId, { state: 'snoozed', limit: 100 }),
+      client.listUserChats(workspaceId, { state: 'closed', limit: 100 }),
     ])
-
     return {
       workspace,
-      managers: managers.map((manager) => ({
-        id: manager.id,
-        name: manager.name,
-        email: manager.email,
-        account_id: manager.accountId,
-        role_id: manager.roleId,
-      })),
-      bots: bots.map((bot) => ({
-        id: bot.id,
-        name: bot.name,
-        avatar_url: bot.avatarUrl,
-      })),
-      groups,
-      user_chats: userChats,
+      user_chats: {
+        total: openedChats.length + snoozedChats.length + closedChats.length,
+        by_state: {
+          opened: openedChats.length,
+          snoozed: snoozedChats.length,
+          closed: closedChats.length,
+        },
+      },
+      hint: "Use 'chat list --state opened' for chat details, 'chat messages <chat>' for messages.",
     }
-  } catch (error) {
-    return { error: (error as Error).message }
+  }
+
+  const [groups, openedChats, snoozedChats, closedChats] = await Promise.all([
+    client.listGroups(workspaceId, { limit: 20 }),
+    client.listUserChats(workspaceId, { state: 'opened', limit: 100 }),
+    client.listUserChats(workspaceId, { state: 'snoozed', limit: 100 }),
+    client.listUserChats(workspaceId, { state: 'closed', limit: 100 }),
+  ])
+
+  return {
+    workspace,
+    groups: groups.map((g) => ({ id: g.id, name: g.name })),
+    user_chats: {
+      total: openedChats.length + snoozedChats.length + closedChats.length,
+      by_state: {
+        opened: openedChats.length,
+        snoozed: snoozedChats.length,
+        closed: closedChats.length,
+      },
+    },
+    hint: "Use 'group messages <group>' for group messages, 'chat list --state opened' for chats, 'manager list' for managers.",
+  }
+}
+
+async function buildFullSnapshot(
+  client: Awaited<ReturnType<typeof getClient>>,
+  workspaceId: string,
+  workspace: { id: string; name: string },
+  options: SnapshotOptions,
+): Promise<SnapshotResult> {
+  const limit = parseLimit(options.limit)
+
+  if (options.groupsOnly) {
+    const groups = await buildGroupsSnapshot(client, workspaceId, limit)
+    return { workspace, groups }
+  }
+
+  if (options.chatsOnly) {
+    const userChats = await buildUserChatsSnapshot(client, workspaceId, limit)
+    return { workspace, user_chats: userChats }
+  }
+
+  const [managers, bots, groups, userChats] = await Promise.all([
+    client.listManagers(workspaceId, { limit: 50 }),
+    client.listBots(workspaceId, { limit: 50 }),
+    buildGroupsSnapshot(client, workspaceId, limit),
+    buildUserChatsSnapshot(client, workspaceId, limit),
+  ])
+
+  return {
+    workspace,
+    managers: managers.map((manager) => ({
+      id: manager.id,
+      name: manager.name,
+      email: manager.email,
+      account_id: manager.accountId,
+      role_id: manager.roleId,
+    })),
+    bots: bots.map((bot) => ({
+      id: bot.id,
+      name: bot.name,
+      avatar_url: bot.avatarUrl,
+    })),
+    groups,
+    user_chats: userChats,
   }
 }
 
@@ -178,10 +251,11 @@ function cliOutput(result: SnapshotResult, pretty?: boolean): void {
 
 export function createSnapshotCommand(): Command {
   return new Command('snapshot')
-    .description('Workspace overview for AI agent context')
+    .description('Workspace overview for AI agents (brief by default, use --full for comprehensive data)')
+    .option('--full', 'Include messages, managers, and bots (verbose)')
     .option('--groups-only', 'List groups only, skip user chats')
     .option('--chats-only', 'List user chats only, skip groups')
-    .option('--limit <n>', 'Messages per group and recent opened chats', '5')
+    .option('--limit <n>', 'Messages per group and recent opened chats with --full', '5')
     .option('--workspace <id>', 'Workspace ID')
     .option('--pretty', 'Pretty print JSON output')
     .action(async (options: SnapshotOptions) => {