agent-messenger 1.0.0

package/skills/agent-discord/templates/monitor-channel.sh

@@ -0,0 +1,180 @@
+#!/bin/bash
+#
+# monitor-channel.sh - Monitor a Discord channel for new messages
+#
+# Usage:
+#   ./monitor-channel.sh <channel-id> [interval]
+#
+# Arguments:
+#   channel-id - Channel ID to monitor (use 'channel list' to find IDs)
+#   interval   - Polling interval in seconds (default: 10)
+#
+# Example:
+#   ./monitor-channel.sh 1234567890123456789
+#   ./monitor-channel.sh 1234567890123456789 5
+
+set -euo pipefail
+
+# Check arguments
+if [ $# -lt 1 ]; then
+  echo "Usage: $0 <channel-id> [interval]"
+  echo ""
+  echo "Examples:"
+  echo "  $0 1234567890123456789          # Monitor channel, poll every 10s"
+  echo "  $0 1234567890123456789 5        # Monitor channel, poll every 5s"
+  echo ""
+  echo "To find channel IDs, run: agent-discord channel list"
+  exit 1
+fi
+
+CHANNEL_ID="$1"
+INTERVAL="${2:-10}"  # Default 10 seconds
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# State tracking
+LAST_ID=""
+FIRST_RUN=true
+
+# Function to format ISO timestamp to readable format
+format_time() {
+  local ts=$1
+  # Handle ISO 8601 format
+  if command -v gdate &> /dev/null; then
+    gdate -d "$ts" "+%Y-%m-%d %H:%M:%S" 2>/dev/null || echo "$ts"
+  else
+    date -d "$ts" "+%Y-%m-%d %H:%M:%S" 2>/dev/null || echo "$ts"
+  fi
+}
+
+# Function to truncate text
+truncate_text() {
+  local text=$1
+  local max_length=100
+  
+  if [ ${#text} -gt $max_length ]; then
+    echo "${text:0:$max_length}..."
+  else
+    echo "$text"
+  fi
+}
+
+# Function to check for new messages
+check_messages() {
+  # Get latest message
+  MESSAGES=$(agent-discord message list "$CHANNEL_ID" --limit 1 2>&1)
+  
+  # Check if successful
+  if echo "$MESSAGES" | jq -e '.error' > /dev/null 2>&1; then
+    ERROR_MSG=$(echo "$MESSAGES" | jq -r '.error // "Unknown error"')
+    echo -e "${RED}Error: $ERROR_MSG${NC}"
+    return 1
+  fi
+  
+  # Extract latest message
+  LATEST_ID=$(echo "$MESSAGES" | jq -r '.[0].id // ""')
+  
+  # No messages in channel
+  if [ -z "$LATEST_ID" ]; then
+    if [ "$FIRST_RUN" = true ]; then
+      echo -e "${YELLOW}No messages in channel yet${NC}"
+    fi
+    return 0
+  fi
+  
+  # Check if new message
+  if [ "$LATEST_ID" != "$LAST_ID" ]; then
+    # Skip notification on first run (just initialize)
+    if [ "$FIRST_RUN" = false ] && [ -n "$LAST_ID" ]; then
+      # Extract message details
+      CONTENT=$(echo "$MESSAGES" | jq -r '.[0].content // ""')
+      AUTHOR=$(echo "$MESSAGES" | jq -r '.[0].author // "Unknown"')
+      TIMESTAMP=$(echo "$MESSAGES" | jq -r '.[0].timestamp // ""')
+      
+      # Format timestamp
+      TIME=$(format_time "$TIMESTAMP")
+      
+      # Display new message
+      echo ""
+      echo -e "${GREEN}----------------------------------------------${NC}"
+      echo -e "${BLUE}New message in channel${NC}"
+      echo -e "${GREEN}----------------------------------------------${NC}"
+      echo -e "Time:    $TIME"
+      echo -e "From:    $AUTHOR"
+      echo -e "Message: $(truncate_text "$CONTENT")"
+      echo -e "${GREEN}----------------------------------------------${NC}"
+      
+      # Example: Auto-respond to keywords
+      # Uncomment to enable
+      # if echo "$CONTENT" | grep -qi "bot"; then
+      #   echo -e "${YELLOW}Detected keyword, responding...${NC}"
+      #   agent-discord message send "$CHANNEL_ID" "You called?"
+      # fi
+    fi
+    
+    LAST_ID="$LATEST_ID"
+  fi
+  
+  FIRST_RUN=false
+  return 0
+}
+
+# Check if agent-discord is installed
+if ! command -v agent-discord &> /dev/null; then
+  echo -e "${RED}Error: agent-discord not found${NC}"
+  echo ""
+  echo "Install it with:"
+  echo "  bun install -g agent-discord"
+  exit 1
+fi
+
+# Check authentication
+echo "Checking authentication..."
+AUTH_STATUS=$(agent-discord auth status 2>&1)
+
+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-discord auth extract"
+  exit 1
+fi
+
+USER_NAME=$(echo "$AUTH_STATUS" | jq -r '.user // "Unknown"')
+echo -e "${GREEN}Authenticated as: $USER_NAME${NC}"
+echo ""
+
+# Verify channel exists
+echo "Verifying channel..."
+CHANNEL_INFO=$(agent-discord channel info "$CHANNEL_ID" 2>&1)
+
+if echo "$CHANNEL_INFO" | jq -e '.error' > /dev/null 2>&1; then
+  echo -e "${RED}Channel '$CHANNEL_ID' not found${NC}"
+  echo ""
+  echo "List available channels with:"
+  echo "  agent-discord channel list"
+  exit 1
+fi
+
+CHANNEL_NAME=$(echo "$CHANNEL_INFO" | jq -r '.name // "Unknown"')
+echo -e "${GREEN}Monitoring: #$CHANNEL_NAME ($CHANNEL_ID)${NC}"
+echo ""
+
+# Start monitoring
+echo -e "${YELLOW}Monitoring for new messages (polling every ${INTERVAL}s)...${NC}"
+echo -e "${YELLOW}Press Ctrl+C to stop${NC}"
+echo ""
+
+# Trap Ctrl+C for clean exit
+trap 'echo -e "\n${YELLOW}Monitoring stopped${NC}"; exit 0' INT
+
+# Main monitoring loop
+while true; do
+  check_messages
+  sleep "$INTERVAL"
+done

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

@@ -0,0 +1,173 @@
+#!/bin/bash
+#
+# post-message.sh - Send a message to Discord with error handling
+#
+# Usage:
+#   ./post-message.sh <channel-id> <message>
+#   ./post-message.sh --channel-name <name> <message>
+#
+# Example:
+#   ./post-message.sh 1234567890123456789 "Hello from script!"
+#   ./post-message.sh --channel-name general "Deployment completed"
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Parse arguments
+CHANNEL_ID=""
+CHANNEL_NAME=""
+MESSAGE=""
+
+if [ $# -lt 2 ]; then
+  echo "Usage: $0 <channel-id> <message>"
+  echo "       $0 --channel-name <name> <message>"
+  echo ""
+  echo "Examples:"
+  echo "  $0 1234567890123456789 'Hello world!'"
+  echo "  $0 --channel-name general 'Build completed'"
+  exit 1
+fi
+
+if [ "$1" = "--channel-name" ]; then
+  CHANNEL_NAME="$2"
+  MESSAGE="$3"
+else
+  CHANNEL_ID="$1"
+  MESSAGE="$2"
+fi
+
+# Function to send message with retry logic
+send_message() {
+  local channel_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-discord message send "$channel_id" "$message" 2>&1)
+    
+    # Check if successful (has an 'id' field)
+    if echo "$RESULT" | jq -e '.id' > /dev/null 2>&1; then
+      echo -e "${GREEN}Message sent successfully!${NC}"
+      
+      # Extract message details
+      MSG_ID=$(echo "$RESULT" | jq -r '.id')
+      
+      echo ""
+      echo "Message details:"
+      echo "  Channel: $channel_id"
+      echo "  Message ID: $MSG_ID"
+      
+      return 0
+    fi
+    
+    # Extract error information
+    if echo "$RESULT" | jq -e '.error' > /dev/null 2>&1; then
+      ERROR_MSG=$(echo "$RESULT" | jq -r '.error // "Unknown error"')
+      echo -e "${RED}Failed: $ERROR_MSG${NC}"
+      
+      # Don't retry on certain errors
+      if echo "$ERROR_MSG" | grep -q "Not authenticated"; then
+        echo ""
+        echo "Not authenticated. Run:"
+        echo "  agent-discord auth extract"
+        return 1
+      fi
+      
+      if echo "$ERROR_MSG" | grep -q "Unknown Channel"; then
+        echo ""
+        echo "Channel '$channel_id' not found. Check channel ID."
+        echo "List channels with: agent-discord channel list"
+        return 1
+      fi
+    else
+      echo -e "${RED}Unexpected error: $RESULT${NC}"
+    fi
+    
+    # Exponential backoff before retry
+    if [ $attempt -lt $max_attempts ]; then
+      SLEEP_TIME=$((attempt * 2))
+      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-discord is installed
+if ! command -v agent-discord &> /dev/null; then
+  echo -e "${RED}Error: agent-discord not found${NC}"
+  echo ""
+  echo "Install it with:"
+  echo "  bun install -g agent-discord"
+  exit 1
+fi
+
+# Check authentication
+echo "Checking authentication..."
+AUTH_STATUS=$(agent-discord auth status 2>&1)
+
+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-discord auth extract"
+  exit 1
+fi
+
+USER_NAME=$(echo "$AUTH_STATUS" | jq -r '.user // "Unknown"')
+GUILD_ID=$(echo "$AUTH_STATUS" | jq -r '.current_guild // ""')
+echo -e "${GREEN}Authenticated as: $USER_NAME${NC}"
+
+if [ -z "$GUILD_ID" ]; then
+  echo -e "${RED}No guild selected!${NC}"
+  echo ""
+  echo "Run this to select a guild:"
+  echo "  agent-discord guild list"
+  echo "  agent-discord guild switch <guild-id>"
+  exit 1
+fi
+
+# If channel name provided, look up channel ID
+if [ -n "$CHANNEL_NAME" ]; then
+  echo "Looking up channel #$CHANNEL_NAME..."
+  CHANNELS=$(agent-discord channel list 2>&1)
+  
+  if echo "$CHANNELS" | jq -e '.error' > /dev/null 2>&1; then
+    echo -e "${RED}Failed to list channels${NC}"
+    exit 1
+  fi
+  
+  CHANNEL_ID=$(echo "$CHANNELS" | jq -r --arg name "$CHANNEL_NAME" '.[] | select(.name==$name) | .id')
+  
+  if [ -z "$CHANNEL_ID" ]; then
+    echo -e "${RED}Channel #$CHANNEL_NAME not found${NC}"
+    echo ""
+    echo "Available channels:"
+    echo "$CHANNELS" | jq -r '.[] | "  #\(.name) (\(.id))"'
+    exit 1
+  fi
+  
+  echo -e "${GREEN}Found channel: $CHANNEL_ID${NC}"
+fi
+
+echo ""
+
+# Send the message
+echo "Sending message to channel $CHANNEL_ID..."
+echo "Message: $MESSAGE"
+echo ""
+
+send_message "$CHANNEL_ID" "$MESSAGE"

package/skills/agent-slack/SKILL.md

@@ -0,0 +1,268 @@
+---
+name: agent-slack
+description: Interact with Slack workspaces - send messages, read channels, manage reactions
+allowed-tools: Bash(agent-slack:*)
+---
+
+# Agent Slack
+
+A TypeScript CLI tool that enables AI agents and humans to interact with Slack workspaces through a simple command interface. Features seamless token extraction from the Slack desktop app and multi-workspace support.
+
+## Quick Start
+
+```bash
+# Extract credentials from Slack desktop app (zero-config)
+agent-slack auth extract
+
+# Get workspace snapshot
+agent-slack snapshot
+
+# Send a message
+agent-slack message send general "Hello from AI agent!"
+
+# List channels
+agent-slack channel list
+```
+
+## Authentication
+
+### Seamless Token Extraction
+
+agent-slack automatically extracts your Slack credentials from the desktop app:
+
+```bash
+# Just run this - no manual token copying needed
+agent-slack auth extract
+
+# Use --debug for troubleshooting
+agent-slack auth extract --debug
+```
+
+This command:
+- Auto-detects your platform (macOS/Linux/Windows)
+- Supports both direct download and App Store versions of Slack on macOS
+- Extracts xoxc token and xoxd cookie (with v10 decryption for sandboxed apps)
+- Validates tokens against Slack API before saving
+- Discovers ALL logged-in workspaces
+- Stores credentials securely in `~/.config/agent-messenger/`
+
+### Multi-Workspace Support
+
+```bash
+# List all authenticated workspaces
+agent-slack workspace list
+
+# Switch to a different workspace
+agent-slack workspace switch <workspace-id>
+
+# Show current workspace
+agent-slack workspace current
+
+# Check auth status
+agent-slack auth status
+```
+
+## Commands
+
+### Message Commands
+
+```bash
+# Send a message
+agent-slack message send <channel> <text>
+agent-slack message send general "Hello world"
+
+# Send a threaded reply
+agent-slack message send general "Reply" --thread <ts>
+
+# List messages
+agent-slack message list <channel>
+agent-slack message list general --limit 50
+
+# Search messages across workspace
+agent-slack message search <query>
+agent-slack message search "project update"
+agent-slack message search "from:@user deadline" --limit 50
+agent-slack message search "in:#general meeting" --sort timestamp
+
+# Get a single message by timestamp
+agent-slack message get <channel> <ts>
+agent-slack message get general 1234567890.123456
+
+# Get thread replies (includes parent message)
+agent-slack message replies <channel> <thread_ts>
+agent-slack message replies general 1234567890.123456
+agent-slack message replies general 1234567890.123456 --limit 50
+agent-slack message replies general 1234567890.123456 --oldest 1234567890.000000
+agent-slack message replies general 1234567890.123456 --cursor <next_cursor>
+
+# Update a message
+agent-slack message update <channel> <ts> <new-text>
+
+# Delete a message
+agent-slack message delete <channel> <ts> --force
+```
+
+### Channel Commands
+
+```bash
+# List channels (excludes archived by default)
+agent-slack channel list
+agent-slack channel list --type public
+agent-slack channel list --type private
+agent-slack channel list --include-archived
+
+# Get channel info
+agent-slack channel info <channel>
+agent-slack channel info general
+
+# Get channel history (alias for message list)
+agent-slack channel history <channel> --limit 100
+```
+
+### User Commands
+
+```bash
+# List users
+agent-slack user list
+agent-slack user list --include-bots
+
+# Get user info
+agent-slack user info <user>
+
+# Get current user
+agent-slack user me
+```
+
+### Reaction Commands
+
+```bash
+# Add reaction
+agent-slack reaction add <channel> <ts> <emoji>
+agent-slack reaction add general 1234567890.123456 thumbsup
+
+# Remove reaction
+agent-slack reaction remove <channel> <ts> <emoji>
+
+# List reactions on a message
+agent-slack reaction list <channel> <ts>
+```
+
+### File Commands
+
+```bash
+# Upload file
+agent-slack file upload <channel> <path>
+agent-slack file upload general ./report.pdf
+
+# List files
+agent-slack file list
+agent-slack file list --channel general
+
+# Get file info
+agent-slack file info <file-id>
+```
+
+### Snapshot Command
+
+Get comprehensive workspace state for AI agents:
+
+```bash
+# Full snapshot
+agent-slack snapshot
+
+# Filtered snapshots
+agent-slack snapshot --channels-only
+agent-slack snapshot --users-only
+
+# Limit messages per channel
+agent-slack snapshot --limit 10
+```
+
+Returns JSON with:
+- Workspace metadata
+- Channels (id, name, topic, purpose)
+- Recent messages (ts, text, user, channel)
+- Users (id, name, profile)
+
+## Output Format
+
+### JSON (Default)
+
+All commands output JSON by default for AI consumption:
+
+```json
+{
+  "ts": "1234567890.123456",
+  "text": "Hello world",
+  "channel": "C123456"
+}
+```
+
+### Pretty (Human-Readable)
+
+Use `--pretty` flag for formatted output:
+
+```bash
+agent-slack channel list --pretty
+```
+
+## Common Patterns
+
+See `references/common-patterns.md` for typical AI agent workflows.
+
+## Templates
+
+See `templates/` directory for runnable examples:
+- `post-message.sh` - Send messages with error handling
+- `monitor-channel.sh` - Monitor channel for new messages
+- `workspace-summary.sh` - Generate workspace summary
+
+## Error Handling
+
+All commands return consistent error format:
+
+```json
+{
+  "error": "No workspace authenticated. Run: agent-slack auth extract"
+}
+```
+
+Common errors:
+- `NO_WORKSPACE`: No authenticated workspace
+- `SLACK_API_ERROR`: Slack API returned an error
+- `RATE_LIMIT`: Hit Slack rate limit (auto-retries with backoff)
+
+## Configuration
+
+Credentials stored in: `~/.config/agent-messenger/slack-credentials.json`
+
+Format:
+```json
+{
+  "current_workspace": "T123456",
+  "workspaces": {
+    "T123456": {
+      "workspace_id": "T123456",
+      "workspace_name": "My Workspace",
+      "token": "xoxc-...",
+      "cookie": "xoxd-..."
+    }
+  }
+}
+```
+
+**Security**: File permissions set to 0600 (owner read/write only)
+
+## 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)
+
+## References
+
+- [Authentication Guide](references/authentication.md)
+- [Common Patterns](references/common-patterns.md)