agent-messenger 2.8.0 → 2.9.0

package/dist/src/platforms/webex/commands/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../../src/platforms/webex/commands/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAOnC,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBjF;AAED,eAAO,MAAM,eAAe,SAOxB,CAAA"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../../src/platforms/webex/commands/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAOnC,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BjG;AAED,eAAO,MAAM,eAAe,SASxB,CAAA"}

package/dist/src/platforms/webex/commands/snapshot.js

@@ -10,13 +10,18 @@ export async function snapshotAction(options) {
         const allSpaces = await client.listSpaces({ max: 100 });
         const spaces = allSpaces.filter((s) => myRoomIds.has(s.id));
         const snapshot = {
-            spaces: spaces.map((s) => ({
-                id: s.id,
-                title: s.title,
-                type: s.type,
-                lastActivity: s.lastActivity,
-            })),
+            spaces: options.full
+                ? spaces.map((s) => ({
+                    id: s.id,
+                    title: s.title,
+                    type: s.type,
+                    lastActivity: s.lastActivity,
+                }))
+                : spaces.map((s) => ({ id: s.id, title: s.title })),
         };
+        if (!options.full) {
+            snapshot.hint = "Use 'message list <space>' for messages, 'space info <space>' for space details.";
+        }
         console.log(formatOutput(snapshot, options.pretty));
     }
     catch (error) {
@@ -24,10 +29,12 @@ export async function snapshotAction(options) {
     }
 }
 export const snapshotCommand = new Command('snapshot')
-    .description('Get workspace spaces overview for AI agents')
+    .description('Get workspace overview for AI agents (brief by default, use --full for comprehensive data)')
+    .option('--full', 'Include full space details (verbose)')
     .option('--pretty', 'Pretty print JSON output')
     .action(async (options) => {
     await snapshotAction({
+        full: options.full,
         pretty: options.pretty,
     });
 });

package/dist/src/platforms/webex/commands/snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../../../src/platforms/webex/commands/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEvC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA6B;IAChE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,WAAW,EAAE,CAAC,KAAK,EAAE,CAAA;QAE9C,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAA;QAClE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;QAE7D,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAA;QACvD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAE3D,MAAM,QAAQ,GAAG;YACf,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,YAAY,EAAE,CAAC,CAAC,YAAY;aAC7B,CAAC,CAAC;SACJ,CAAA;QAED,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,KAAc,CAAC,CAAA;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;KACnD,WAAW,CAAC,6CAA6C,CAAC;KAC1D,MAAM,CAAC,UAAU,EAAE,0BAA0B,CAAC;KAC9C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,cAAc,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../../../src/platforms/webex/commands/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEvC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA6C;IAChF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,WAAW,EAAE,CAAC,KAAK,EAAE,CAAA;QAE9C,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAA;QAClE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;QAE7D,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAA;QACvD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAE3D,MAAM,QAAQ,GAAwB;YACpC,MAAM,EAAE,OAAO,CAAC,IAAI;gBAClB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACjB,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,YAAY,EAAE,CAAC,CAAC,YAAY;iBAC7B,CAAC,CAAC;gBACL,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;SACtD,CAAA;QAED,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,QAAQ,CAAC,IAAI,GAAG,kFAAkF,CAAA;QACpG,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,KAAc,CAAC,CAAA;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;KACnD,WAAW,CAAC,4FAA4F,CAAC;KACzG,MAAM,CAAC,QAAQ,EAAE,sCAAsC,CAAC;KACxD,MAAM,CAAC,UAAU,EAAE,0BAA0B,CAAC;KAC9C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,cAAc,CAAC;QACnB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/docs/content/docs/agent-skills.mdx

@@ -46,16 +46,6 @@ Or from within Claude Code:
 /plugin install agent-messenger
 ```
 
-### OpenCode (via plugin)
-
-Add to your `opencode.jsonc`:
-
-```jsonc
-{
-  "plugins": ["agent-messenger"],
-}
-```
-
 ## How It Works
 
 Once installed, your AI agent can:

package/docs/content/docs/cli/channeltalk.mdx

@@ -170,21 +170,31 @@ agent-channeltalk bot list --limit 50
 
 ### Snapshot Command
 
-Get comprehensive workspace state for AI agents:
+Get workspace overview for AI agents (brief by default):
 
 ```bash
-# Full snapshot of current workspace
+# Brief snapshot (default) — fast, minimal API calls
 agent-channeltalk snapshot
 
-# Filtered snapshots
-agent-channeltalk snapshot --groups-only
-agent-channeltalk snapshot --chats-only
+# Full snapshot — includes messages, managers, bots (slow, large output)
+agent-channeltalk snapshot --full
 
-# Limit messages per group/chat
-agent-channeltalk snapshot --limit 10
+# Filtered full snapshots
+agent-channeltalk snapshot --full --groups-only
+agent-channeltalk snapshot --full --chats-only
+
+# Limit messages per group/chat (only with --full)
+agent-channeltalk snapshot --full --limit 10
 ```
 
-Returns JSON with:
+Default returns brief JSON with:
+
+- Workspace metadata (id, name)
+- Groups (id, name)
+- UserChat summary (total count, by state)
+- Hint for next commands
+
+With `--full`, returns comprehensive JSON with:
 
 - Workspace metadata (id, name)
 - Groups with recent messages (id, name, messages)

package/docs/content/docs/cli/channeltalkbot.mdx

@@ -196,21 +196,31 @@ agent-channeltalkbot bot delete <bot-id> --force
 
 ### Snapshot Command
 
-Get comprehensive workspace state for AI agents:
+Get workspace overview for AI agents (brief by default):
 
 ```bash
-# Full snapshot of current workspace
+# Brief snapshot (default) — fast, minimal API calls
 agent-channeltalkbot snapshot
 
-# Filtered snapshots
+# Full snapshot — includes messages, managers, bots (slow, large output)
+agent-channeltalkbot snapshot --full
+
+# Filtered snapshots (work in both brief and full mode)
 agent-channeltalkbot snapshot --groups-only
 agent-channeltalkbot snapshot --chats-only
 
-# Limit messages per group/chat
-agent-channeltalkbot snapshot --limit 10
+# Limit messages per group/chat (only with --full)
+agent-channeltalkbot snapshot --full --limit 10
 ```
 
-Returns JSON with:
+Default returns brief JSON with:
+
+- Workspace metadata (id, name, homepage_url, description)
+- Groups (id, name)
+- UserChat summary (opened/snoozed/closed counts)
+- Hint for next commands
+
+With `--full`, returns comprehensive JSON with:
 
 - Workspace metadata (id, name, homepage_url, description)
 - Groups with recent messages (id, name, messages)

package/docs/content/docs/cli/discord.mdx

@@ -179,20 +179,36 @@ agent-discord file info <channel-id> <file-id>
 
 ### Snapshot Command
 
-Get comprehensive server state for AI agents:
+Get server overview for AI agents (brief by default):
 
 ```bash
-# Full snapshot (channels, members, recent messages)
+# Brief snapshot (default) — fast, minimal API calls
 agent-discord snapshot
 
-# Filtered snapshots
-agent-discord snapshot --channels-only
-agent-discord snapshot --users-only
+# Full snapshot — includes messages and members (slow, large output)
+agent-discord snapshot --full
 
-# Limit messages per channel
-agent-discord snapshot --limit 10
+# Filtered full snapshots
+agent-discord snapshot --full --channels-only
+agent-discord snapshot --full --users-only
+
+# Limit messages per channel (only with --full)
+agent-discord snapshot --full --limit 10
 ```
 
+Default returns brief JSON with:
+
+- Server metadata (id, name)
+- 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)
+- Recent messages (id, content, author, timestamp)
+- Members (id, username, global_name)
+
 ### DM Commands
 
 ```bash

package/docs/content/docs/cli/discordbot.mdx

@@ -231,20 +231,36 @@ 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
 ```
 
+Default returns brief JSON with:
+
+- Server ID
+- Channels (id, name) — text channels only
+- Hint for next commands
+
+With `--full`, returns comprehensive JSON with:
+
+- Server ID
+- Channels with messages (id, name, messages)
+- Use `--full --channels-only` for channel type info
+- Use `--full --users-only` for members (id, username, global_name)
+
 ## Key Differences from agent-discord
 
 | Feature                     | agent-discord                   | agent-discordbot             |

package/docs/content/docs/cli/slack.mdx

@@ -241,20 +241,37 @@ agent-slack file delete <file-id>
 
 ### 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
 ```
 
+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, is_private, is_archived)
+- Recent messages (ts, text, user, channel)
+- Users (id, name, profile)
+- User groups (id, name, handle, description, user_count, users)
+
 ### Activity Commands
 
 ```bash

package/docs/content/docs/cli/teams.mdx

@@ -209,20 +209,36 @@ agent-teams file download <file-id> <output-path>
 
 ### Snapshot Command
 
-Get comprehensive team state for AI agents:
+Get team overview for AI agents (brief by default):
 
 ```bash
-# Full snapshot (channels, members, recent messages)
+# 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
 ```
 
+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)
+- Recent messages (id, content, author, timestamp)
+- Members (id, displayName, email)
+
 ## Global Options
 
 All commands support these options:
@@ -321,7 +337,7 @@ if ! agent-teams auth status | grep -q "valid"; then
 fi
 
 # 2. Get team context
-agent-teams snapshot --limit 5 > /tmp/teams-context.json
+agent-teams snapshot > /tmp/teams-context.json
 
 # 3. Send standup reminder
 agent-teams message send $STANDUP_CHANNEL "Good morning! Time for standup."

package/docs/content/docs/cli/webex.mdx

@@ -176,13 +176,26 @@ agent-webex member list abc123 --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 only the spaces you're a member of, with id, title, type, and lastActivity. Use `message list <space-id>` or `member list <space-id>` for details.
+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)
+
+For messages or members, use `message list <space-id>` or `member list <space-id>`.
 
 ## Global Options
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-messenger",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "description": "Multi-platform messaging CLI for AI agents (Slack, Discord, Teams, Webex, Telegram, WhatsApp, LINE, 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.8.0
+version: 2.9.0
 allowed-tools: Bash(agent-channeltalk:*)
 metadata:
   openclaw:
@@ -267,21 +267,31 @@ agent-channeltalk bot list --limit 50
 
 ### Snapshot Command
 
-Get comprehensive workspace state for AI agents:
+Get workspace overview for AI agents (brief by default):
 
 ```bash
-# Full snapshot of current workspace
+# Brief snapshot (default) — fast, minimal API calls
 agent-channeltalk snapshot
 
-# Filtered snapshots
-agent-channeltalk snapshot --groups-only
-agent-channeltalk snapshot --chats-only
+# Full snapshot — includes messages, managers, bots (slow, large output)
+agent-channeltalk snapshot --full
 
-# Limit messages per group/chat
-agent-channeltalk snapshot --limit 10
+# Filtered full snapshots
+agent-channeltalk snapshot --full --groups-only
+agent-channeltalk snapshot --full --chats-only
+
+# Limit messages per group/chat (only with --full)
+agent-channeltalk snapshot --full --limit 10
 ```
 
-Returns JSON with:
+Default returns brief JSON with:
+
+- Workspace metadata (id, name)
+- Groups (id, name)
+- UserChat summary (total count, by state)
+- Hint for next commands
+
+With `--full`, returns comprehensive JSON with:
 
 - Workspace metadata (id, name)
 - Groups with recent messages (id, name, messages)

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

@@ -92,28 +92,29 @@ done
 ```bash
 #!/bin/bash
 
-# Full snapshot for comprehensive context
+# Get brief snapshot (default — fast, minimal output)
 SNAPSHOT=$(agent-channeltalk snapshot)
 
 # Extract key info
 WORKSPACE=$(echo "$SNAPSHOT" | jq -r '.workspace.name')
 GROUP_COUNT=$(echo "$SNAPSHOT" | jq '.groups | length')
 OPEN_CHATS=$(echo "$SNAPSHOT" | jq '.user_chats.by_state.opened')
-MANAGER_COUNT=$(echo "$SNAPSHOT" | jq '.managers | length')
-BOT_COUNT=$(echo "$SNAPSHOT" | jq '.bots | length')
 
 echo "Workspace: $WORKSPACE"
 echo "Groups: $GROUP_COUNT"
 echo "Open chats: $OPEN_CHATS"
-echo "Managers: $MANAGER_COUNT"
-echo "Bots: $BOT_COUNT"
 
-# For focused views
-agent-channeltalk snapshot --groups-only    # Just groups and messages
-agent-channeltalk snapshot --chats-only     # Just UserChat summary
+# List all groups
+echo -e "\nGroups:"
+echo "$SNAPSHOT" | jq -r '.groups[] | "  \(.name) (\(.id))"'
+
+# Then drill into specific resources for details
+agent-channeltalk chat list --state opened --limit 10
+agent-channeltalk manager list --limit 20
+agent-channeltalk bot list --limit 20
 ```
 
-**When to use**: Start of every AI agent session, periodic context refresh, workspace audits.
+**When to use**: Start of every AI agent session, periodic context refresh, workspace audits. Start with brief snapshot, then use targeted list commands for messages, managers, or bots.
 
 ## Pattern 5: Find Group by Name
 

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.8.0
+version: 2.9.0
 allowed-tools: Bash(agent-channeltalkbot:*)
 metadata:
   openclaw:
@@ -274,21 +274,31 @@ agent-channeltalkbot bot delete <bot-id> --force
 
 ### Snapshot Command
 
-Get comprehensive workspace state for AI agents:
+Get workspace overview for AI agents (brief by default):
 
 ```bash
-# Full snapshot of current workspace
+# Brief snapshot (default) — fast, minimal API calls
 agent-channeltalkbot snapshot
 
-# Filtered snapshots
-agent-channeltalkbot snapshot --groups-only
-agent-channeltalkbot snapshot --chats-only
+# Full snapshot — includes messages, managers, bots (slow, large output)
+agent-channeltalkbot snapshot --full
 
-# Limit messages per group/chat
-agent-channeltalkbot snapshot --limit 10
+# Filtered full snapshots
+agent-channeltalkbot snapshot --full --groups-only
+agent-channeltalkbot snapshot --full --chats-only
+
+# Limit messages per group/chat (only with --full)
+agent-channeltalkbot snapshot --full --limit 10
 ```
 
-Returns JSON with:
+Default returns brief JSON with:
+
+- Workspace metadata (id, name, homepage_url, description)
+- Groups (id, name)
+- UserChat summary (opened/snoozed/closed counts)
+- Hint for next commands
+
+With `--full`, returns comprehensive JSON with:
 
 - Workspace metadata (id, name, homepage_url, description)
 - Groups with recent messages (id, name, messages)

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

@@ -112,28 +112,29 @@ fi
 ```bash
 #!/bin/bash
 
-# Full snapshot for comprehensive context
+# Get brief snapshot (default — fast, minimal output)
 SNAPSHOT=$(agent-channeltalkbot snapshot)
 
 # Extract key info
 WORKSPACE=$(echo "$SNAPSHOT" | jq -r '.workspace.name')
 GROUP_COUNT=$(echo "$SNAPSHOT" | jq '.groups | length')
 OPEN_CHATS=$(echo "$SNAPSHOT" | jq '.user_chats.opened_count')
-MANAGER_COUNT=$(echo "$SNAPSHOT" | jq '.managers | length')
-BOT_COUNT=$(echo "$SNAPSHOT" | jq '.bots | length')
 
 echo "Workspace: $WORKSPACE"
 echo "Groups: $GROUP_COUNT"
 echo "Open chats: $OPEN_CHATS"
-echo "Managers: $MANAGER_COUNT"
-echo "Bots: $BOT_COUNT"
 
-# For focused views
-agent-channeltalkbot snapshot --groups-only    # Just groups and messages
-agent-channeltalkbot snapshot --chats-only     # Just UserChat summary
+# List all groups
+echo -e "\nGroups:"
+echo "$SNAPSHOT" | jq -r '.groups[] | "  \(.name) (\(.id))"'
+
+# Then drill into specific resources for details
+agent-channeltalkbot chat list --state opened --limit 10
+agent-channeltalkbot manager list
+agent-channeltalkbot bot list
 ```
 
-**When to use**: Start of every AI agent session, periodic context refresh, workspace audits.
+**When to use**: Start of every AI agent session, periodic context refresh, workspace audits. Start with brief snapshot, then use targeted list commands for chats, managers, or bots.
 
 ## Pattern 6: Search Messages Across Chats
 

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.8.0
+version: 2.9.0
 allowed-tools: Bash(agent-discord:*)
 metadata:
   openclaw:
@@ -318,21 +318,30 @@ agent-discord file info <channel-id> <file-id>
 
 ### Snapshot Command
 
-Get comprehensive server state for AI agents:
+Get server overview for AI agents (brief by default):
 
 ```bash
-# Full snapshot
+# Brief snapshot (default) — fast, minimal API calls
 agent-discord snapshot
 
-# Filtered snapshots
-agent-discord snapshot --channels-only
-agent-discord snapshot --users-only
+# Full snapshot — includes messages and members (slow, large output)
+agent-discord snapshot --full
 
-# Limit messages per channel
-agent-discord snapshot --limit 10
+# Filtered full snapshots
+agent-discord snapshot --full --channels-only
+agent-discord snapshot --full --users-only
+
+# Limit messages per channel (only with --full)
+agent-discord snapshot --full --limit 10
 ```
 
-Returns JSON with:
+Default returns brief JSON with:
+
+- Server metadata (id, name)
+- 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-discord/references/common-patterns.md

@@ -77,28 +77,29 @@ done
 ```bash
 #!/bin/bash
 
-# Get full snapshot
+# Get brief snapshot (default — fast, minimal output)
 SNAPSHOT=$(agent-discord snapshot)
 
 # Extract key information
 SERVER_NAME=$(echo "$SNAPSHOT" | jq -r '.server.name')
 CHANNEL_COUNT=$(echo "$SNAPSHOT" | jq -r '.channels | length')
-MEMBER_COUNT=$(echo "$SNAPSHOT" | jq -r '.members | length')
 
 echo "Server: $SERVER_NAME"
 echo "Channels: $CHANNEL_COUNT"
-echo "Members: $MEMBER_COUNT"
 
 # List all text 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')
+if [ -n "$CHANNEL_ID" ]; then
+  echo -e "\nRecent messages:"
+  agent-discord message list "$CHANNEL_ID" --limit 10
+fi
 ```
 
-**When to use**: Initial context gathering, status reports, server summaries.
+**When to use**: Initial context gathering, status reports, server summaries. Start with brief snapshot, then use `message list <channel-id>` or `user list` for details.
 
 ## Pattern 4: Find Channel by Name