agent-messenger 1.14.0 → 2.0.0

package/skills/agent-line/templates/monitor-chat.sh

@@ -0,0 +1,76 @@
+#!/bin/bash
+
+set -euo pipefail
+
+if [ $# -lt 1 ]; then
+  echo "Usage: $0 <chat-id> [interval-seconds]"
+  echo ""
+  echo "Examples:"
+  echo "  $0 c0123456789abcdef0123456789abcdef"
+  echo "  $0 u0123456789abcdef0123456789abcdef 15"
+  exit 1
+fi
+
+CHAT_ID="$1"
+INTERVAL="${2:-10}"
+MESSAGE_WINDOW="${AGENT_LINE_MESSAGE_WINDOW:-100}"
+LAST_MESSAGE_ID=""
+
+if ! command -v agent-line >/dev/null 2>&1; then
+  echo "Error: agent-line not found"
+  echo "Install it with: npm install -g agent-messenger"
+  exit 1
+fi
+
+if ! command -v jq >/dev/null 2>&1; then
+  echo "Error: jq not found"
+  echo "Install it first to parse agent-line JSON output"
+  exit 1
+fi
+
+AUTH_STATUS=$(agent-line auth status 2>/dev/null || true)
+if echo "$AUTH_STATUS" | jq -e '.error' >/dev/null 2>&1; then
+  echo "Not authenticated. Run: agent-line auth login"
+  exit 1
+fi
+
+echo "Monitoring chat $CHAT_ID every ${INTERVAL}s using a ${MESSAGE_WINDOW}-message window..."
+
+while true; do
+  MESSAGES=$(agent-line message list "$CHAT_ID" -n "$MESSAGE_WINDOW" 2>/dev/null || true)
+
+  if ! echo "$MESSAGES" | jq -e 'type == "array"' >/dev/null 2>&1; then
+    echo "Failed to fetch messages"
+    sleep "$INTERVAL"
+    continue
+  fi
+
+  LATEST_ID=$(echo "$MESSAGES" | jq -r '.[-1].message_id // empty')
+  if [ -z "$LATEST_ID" ]; then
+    sleep "$INTERVAL"
+    continue
+  fi
+
+  if [ -z "$LAST_MESSAGE_ID" ]; then
+    LAST_MESSAGE_ID="$LATEST_ID"
+    sleep "$INTERVAL"
+    continue
+  fi
+
+  if [ "$LATEST_ID" != "$LAST_MESSAGE_ID" ]; then
+    NEW_MESSAGES=$(echo "$MESSAGES" | jq --arg last "$LAST_MESSAGE_ID" '
+      (map(.message_id) | index($last)) as $index
+      | if $index == null then [] else .[$index + 1:] end
+    ')
+
+    if [ "$(echo "$NEW_MESSAGES" | jq 'length')" -eq 0 ]; then
+      echo "Warning: skipped messages fell outside the ${MESSAGE_WINDOW}-message polling window" >&2
+    else
+      echo "$NEW_MESSAGES" | jq -r '.[] | "[\(.sent_at)] \(.author_id): \(.text // "[non-text]")"'
+    fi
+
+    LAST_MESSAGE_ID="$LATEST_ID"
+  fi
+
+  sleep "$INTERVAL"
+done

package/skills/agent-line/templates/post-message.sh

@@ -0,0 +1,123 @@
+#!/bin/bash
+#
+# post-message.sh - Send a message to LINE with error handling
+#
+# Usage:
+#   ./post-message.sh <chat-id> <message>
+#
+# Example:
+#   ./post-message.sh c7a8b9c0d1e2f3a4b5c6d7e8 "Hello from script!"
+#   ./post-message.sh u1a2b3c4d5e6f7a8b9c0 "Deployment completed"
+
+set -euo pipefail
+
+# Check arguments
+if [ $# -lt 2 ]; then
+  echo "Usage: $0 <chat-id> <message>"
+  echo ""
+  echo "Examples:"
+  echo "  $0 c7a8b9c0d1e2f3a4b5c6d7e8 'Hello world!'"
+  echo "  $0 u1a2b3c4d5e6f7a8b9c0 'Build completed'"
+  echo ""
+  echo "Find chat IDs with:"
+  echo "  agent-line chat list --pretty"
+  exit 1
+fi
+
+CHAT_ID="$1"
+MESSAGE="$2"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Function to send message with retry logic
+send_message() {
+  local chat_id=$1
+  local message=$2
+  local max_attempts=3
+  local attempt=1
+
+  while [ $attempt -le $max_attempts ]; do
+    echo -e "${YELLOW}Attempt $attempt/$max_attempts...${NC}"
+
+    # Send message and capture result
+    RESULT=$(agent-line message send "$chat_id" "$message" 2>&1) || true
+
+    # Check if successful
+    SUCCESS=$(echo "$RESULT" | jq -r '.success // false')
+    if [ "$SUCCESS" = "true" ]; then
+      echo -e "${GREEN}Message sent successfully!${NC}"
+
+      # Extract message details
+      MSG_ID=$(echo "$RESULT" | jq -r '.message_id // "unknown"')
+      SENT_AT=$(echo "$RESULT" | jq -r '.sent_at // "unknown"')
+
+      echo ""
+      echo "Message details:"
+      echo "  Chat ID:    $chat_id"
+      echo "  Message ID: $MSG_ID"
+      echo "  Sent at:    $SENT_AT"
+
+      return 0
+    fi
+
+    # Extract error information
+    ERROR=$(echo "$RESULT" | jq -r '.error // "Unknown error"')
+    echo -e "${RED}Failed: $ERROR${NC}"
+
+    # Don't retry on auth errors
+    if echo "$ERROR" | grep -q "not_authenticated\|No LINE account"; then
+      echo ""
+      echo "Not authenticated. Run:"
+      echo "  agent-line auth login"
+      return 1
+    fi
+
+    # Exponential backoff before retry
+    if [ $attempt -lt $max_attempts ]; then
+      SLEEP_TIME=$((attempt * 3))
+      echo "Retrying in ${SLEEP_TIME}s..."
+      sleep $SLEEP_TIME
+    fi
+
+    attempt=$((attempt + 1))
+  done
+
+  echo -e "${RED}Failed after $max_attempts attempts${NC}"
+  return 1
+}
+
+# Check if agent-line is installed
+if ! command -v agent-line &> /dev/null; then
+  echo -e "${RED}Error: agent-line not found${NC}"
+  echo ""
+  echo "Install it with:"
+  echo "  npm install -g agent-messenger"
+  exit 1
+fi
+
+# Check authentication
+echo "Checking authentication..."
+AUTH_STATUS=$(agent-line auth status 2>&1) || true
+
+if echo "$AUTH_STATUS" | jq -e '.error' > /dev/null 2>&1; then
+  echo -e "${RED}Not authenticated!${NC}"
+  echo ""
+  echo "Run this to authenticate:"
+  echo "  agent-line auth login"
+  exit 1
+fi
+
+ACCOUNT_ID=$(echo "$AUTH_STATUS" | jq -r '.account_id // "Unknown"')
+echo -e "${GREEN}Authenticated as: $ACCOUNT_ID${NC}"
+echo ""
+
+# Send the message
+echo "Sending message to chat $CHAT_ID..."
+echo "Message: $MESSAGE"
+echo ""
+
+send_message "$CHAT_ID" "$MESSAGE"

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: 1.14.0
+version: 2.0.0
 allowed-tools: Bash(agent-slack:*)
 metadata:
   openclaw:
@@ -185,6 +185,24 @@ agent-slack message update <channel> <ts> <new-text>
 
 # Delete a message
 agent-slack message delete <channel> <ts> --force
+
+# Schedule a message (post_at is a Unix timestamp)
+agent-slack message schedule <channel> <text> <post-at>
+agent-slack message schedule general "Friday update" 1700000000
+agent-slack message schedule general "Thread reply" 1700000000 --thread 1234567890.123456
+
+# List scheduled messages
+agent-slack message scheduled-list
+agent-slack message scheduled-list --channel general
+
+# Delete a scheduled message
+agent-slack message scheduled-delete <channel> <scheduled-message-id>
+
+# Post ephemeral message (visible only to a specific user)
+agent-slack message ephemeral <channel> <user-id> <text>
+
+# Get a permanent link to a message
+agent-slack message permalink <channel> <ts>
 ```
 
 ### Channel Commands
@@ -204,9 +222,39 @@ agent-slack channel info general
 # Get channel history (alias for message list)
 agent-slack channel history <channel> --limit 100
 
+# Open a DM channel with a user (returns channel ID)
+agent-slack channel open <user_id>
+agent-slack channel open U0ABC123
+
+# Open a group DM with multiple users
+agent-slack channel open U0ABC123,U0DEF456
+
 # List users in a channel
 agent-slack channel users <channel>
 agent-slack channel users general --include-bots
+
+# Create a new channel
+agent-slack channel create <name>
+agent-slack channel create my-new-channel --private
+
+# Archive a channel
+agent-slack channel archive <channel>
+
+# Set channel topic
+agent-slack channel set-topic <channel> <topic>
+
+# Set channel purpose
+agent-slack channel set-purpose <channel> <purpose>
+
+# Invite users to a channel (comma-separated user IDs)
+agent-slack channel invite <channel> <users>
+agent-slack channel invite general U0ABC123,U0DEF456
+
+# Join a channel
+agent-slack channel join <channel>
+
+# Leave a channel
+agent-slack channel leave <channel>
 ```
 
 ### User Commands
@@ -221,6 +269,18 @@ agent-slack user info <user>
 
 # Get current user
 agent-slack user me
+
+# Look up user by email
+agent-slack user lookup <email>
+agent-slack user lookup alice@example.com --pretty
+
+# Get detailed user profile
+agent-slack user profile <user-id>
+
+# Set your status (emoji name without colons)
+agent-slack user set-status <status-text>
+agent-slack user set-status "In a meeting" --emoji calendar
+agent-slack user set-status "On vacation" --emoji palm_tree --expiration 1700100000
 ```
 
 ### Reaction Commands
@@ -255,6 +315,9 @@ agent-slack file info <file-id>
 agent-slack file download <file-id>
 agent-slack file download <file-id> [output-path]
 agent-slack file download F0ABC123 ./downloads/
+
+# Delete a file
+agent-slack file delete <file-id>
 ```
 
 ### Unread Commands
@@ -286,6 +349,7 @@ agent-slack activity list --types thread_reply,message_reaction
 # List saved items
 agent-slack saved list
 agent-slack saved list --limit 10
+agent-slack saved list --cursor <next_cursor>
 ```
 
 ### Drafts Commands
@@ -293,7 +357,8 @@ agent-slack saved list --limit 10
 ```bash
 # List all drafts
 agent-slack drafts list
-agent-slack drafts list --pretty
+agent-slack drafts list --limit 10
+agent-slack drafts list --cursor <next_cursor>
 ```
 
 ### Channel Sections Commands
@@ -304,6 +369,98 @@ agent-slack sections list
 agent-slack sections list --pretty
 ```
 
+### Pin Commands
+
+```bash
+# Pin a message
+agent-slack pin add <channel> <ts>
+
+# Unpin a message
+agent-slack pin remove <channel> <ts>
+
+# List pinned messages in a channel
+agent-slack pin list <channel>
+agent-slack pin list general --pretty
+```
+
+### Bookmark Commands
+
+```bash
+# Add a bookmark to a channel
+agent-slack bookmark add <channel> <title> <link>
+agent-slack bookmark add general "Our Docs" https://docs.example.com --emoji books --type link
+
+# Edit a bookmark
+agent-slack bookmark edit <channel> <bookmark-id> --title "New Title"
+agent-slack bookmark edit <channel> <bookmark-id> --link https://new.example.com
+
+# Remove a bookmark
+agent-slack bookmark remove <channel> <bookmark-id>
+
+# List bookmarks in a channel
+agent-slack bookmark list <channel>
+agent-slack bookmark list general --pretty
+```
+
+### Reminder Commands
+
+```bash
+# Add a reminder (time is a Unix timestamp)
+agent-slack reminder add "Review PR" 1700000000
+agent-slack reminder add "Team standup" 1700000000 --user U0ABC123
+
+# List all reminders
+agent-slack reminder list
+agent-slack reminder list --pretty
+
+# Complete a reminder
+agent-slack reminder complete <reminder-id>
+
+# Delete a reminder
+agent-slack reminder delete <reminder-id>
+```
+
+### Usergroup Commands
+
+```bash
+# List all user groups
+agent-slack usergroup list
+agent-slack usergroup list --include-disabled
+agent-slack usergroup list --include-users --pretty
+
+# Create a user group
+agent-slack usergroup create "Marketing Team"
+agent-slack usergroup create "Marketing Team" --handle marketing-team --description "Marketing gurus"
+agent-slack usergroup create "Engineering" --channels C012ABC,C034DEF
+
+# Update a user group (name, handle, description, channels)
+agent-slack usergroup update <usergroup-id> --name "New Name"
+agent-slack usergroup update S0616NG6M --handle new-handle --description "Updated description"
+agent-slack usergroup update S0616NG6M --channels C012ABC,C034DEF
+
+# Enable a disabled user group
+agent-slack usergroup enable <usergroup-id>
+
+# Disable a user group
+agent-slack usergroup disable <usergroup-id>
+
+# List members of a user group
+agent-slack usergroup members <usergroup-id>
+agent-slack usergroup members S0616NG6M --include-disabled --pretty
+
+# Update members of a user group (replaces all members)
+agent-slack usergroup members-update <usergroup-id> <comma-separated-user-ids>
+agent-slack usergroup members-update S0616NG6M U060R4BJ4,U060RNRCZ
+```
+
+### Emoji Commands
+
+```bash
+# List all custom emoji in the workspace
+agent-slack emoji list
+agent-slack emoji list --pretty
+```
+
 ### Snapshot Command
 
 Get comprehensive workspace state for AI agents:
@@ -326,6 +483,7 @@ Returns JSON with:
 - Channels (id, name, topic, purpose)
 - Recent messages (ts, text, user, channel)
 - Users (id, name, profile)
+- User groups (id, name, handle, description, user_count, users)
 
 ## Output Format
 
@@ -381,13 +539,114 @@ Common errors:
 
 Credentials stored in `~/.config/agent-messenger/slack-credentials.json` (0600 permissions). See [references/authentication.md](references/authentication.md) for format and security details.
 
+## SDK: Real-Time Events
+
+`SlackListener` connects to Slack's RTM WebSocket for instant event streaming. No polling — events arrive in real time.
+
+### Setup
+
+```typescript
+import { SlackClient, SlackListener } from 'agent-messenger/slack'
+
+const client = await new SlackClient().login()
+const listener = new SlackListener(client)
+```
+
+Or with manual credentials:
+
+```typescript
+import { SlackClient, SlackListener } from 'agent-messenger/slack'
+
+const client = await new SlackClient().login({ token, cookie })
+const listener = new SlackListener(client)
+```
+
+### Listening for Events
+
+```typescript
+listener.on('connected', (info) => {
+  console.log(`Connected as ${info.self.id} on ${info.team.id}`)
+})
+
+listener.on('message', (event) => {
+  // event.type, event.channel, event.user, event.text, event.ts
+})
+
+listener.on('reaction_added', (event) => {
+  // event.user, event.reaction, event.item.channel, event.item.ts
+})
+
+listener.on('reaction_removed', (event) => {
+  // same shape as reaction_added
+})
+
+listener.on('member_joined_channel', (event) => {
+  // event.user, event.channel
+})
+
+listener.on('member_left_channel', (event) => {
+  // event.user, event.channel
+})
+
+listener.on('user_typing', (event) => {
+  // event.user, event.channel
+})
+
+listener.on('presence_change', (event) => {
+  // event.user, event.presence ('active' | 'away')
+})
+
+// Catch-all for any RTM event type
+listener.on('slack_event', (event) => {
+  // event.type + all fields
+})
+
+listener.on('error', (err) => {
+  console.error(err.message)
+})
+
+listener.on('disconnected', () => {
+  // auto-reconnects with exponential backoff
+})
+```
+
+### Lifecycle
+
+```typescript
+await listener.start()  // connects via RTM WebSocket
+listener.stop()         // clean shutdown
+```
+
+### Event Types
+
+| Event | Description |
+|-------|-------------|
+| `message` | New message, edit, delete, thread reply, join/leave subtypes |
+| `reaction_added` | Reaction added to a message |
+| `reaction_removed` | Reaction removed from a message |
+| `member_joined_channel` | User joined a channel |
+| `member_left_channel` | User left a channel |
+| `user_typing` | User is typing |
+| `presence_change` | User went active/away |
+| `channel_created` | New channel created |
+| `channel_deleted` | Channel deleted |
+| `channel_rename` | Channel renamed |
+| `channel_archive` | Channel archived |
+| `channel_unarchive` | Channel unarchived |
+| `slack_event` | Catch-all for every RTM event |
+| `connected` | WebSocket connected |
+| `disconnected` | WebSocket disconnected (auto-reconnects) |
+| `error` | Connection or API error |
+
+### Notes
+
+- Receives all workspace events for the authenticated user — no channel subscription needed
+- Auto-reconnects with exponential backoff (1s → 30s max)
+- Ping/pong keepalive every 30s
+- Uses Slack's RTM API with xoxc user tokens
+
 ## Limitations
 
-- No real-time events / Socket Mode
-- No channel management (create/archive)
-- No workspace admin operations
-- No scheduled messages
-- No user presence features
 - Plain text messages only (no blocks/formatting in v1)
 
 ## Troubleshooting