agent-messenger 1.0.0

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

@@ -0,0 +1,130 @@
+#!/bin/bash
+#
+# post-message.sh - Send a message to Slack with error handling
+#
+# Usage:
+#   ./post-message.sh <channel> <message>
+#
+# Example:
+#   ./post-message.sh general "Hello from script!"
+#   ./post-message.sh engineering "Deployment completed ✅"
+
+set -euo pipefail
+
+# Check arguments
+if [ $# -lt 2 ]; then
+  echo "Usage: $0 <channel> <message>"
+  echo ""
+  echo "Examples:"
+  echo "  $0 general 'Hello world!'"
+  echo "  $0 engineering 'Build completed'"
+  exit 1
+fi
+
+CHANNEL="$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 channel=$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-slack message send "$channel" "$message" 2>&1)
+    
+    # Check if successful
+    if echo "$RESULT" | jq -e '.success' > /dev/null 2>&1; then
+      echo -e "${GREEN}✓ Message sent successfully!${NC}"
+      
+      # Extract message details
+      MSG_TS=$(echo "$RESULT" | jq -r '.data.ts')
+      
+      echo ""
+      echo "Message details:"
+      echo "  Channel: $channel"
+      echo "  Timestamp: $MSG_TS"
+      
+      return 0
+    fi
+    
+    # Extract error information
+    if echo "$RESULT" | jq -e '.error' > /dev/null 2>&1; then
+      ERROR_CODE=$(echo "$RESULT" | jq -r '.error.code // "UNKNOWN"')
+      ERROR_MSG=$(echo "$RESULT" | jq -r '.error.message // "Unknown error"')
+      
+      echo -e "${RED}✗ Failed: $ERROR_MSG${NC}"
+      
+      # Don't retry on certain errors
+      case "$ERROR_CODE" in
+        "NO_WORKSPACE")
+          echo ""
+          echo "No workspace authenticated. Run:"
+          echo "  agent-slack auth extract"
+          return 1
+          ;;
+        "INVALID_CHANNEL")
+          echo ""
+          echo "Channel '$channel' not found. Check channel name or ID."
+          return 1
+          ;;
+      esac
+    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-slack is installed
+if ! command -v agent-slack &> /dev/null; then
+  echo -e "${RED}Error: agent-slack not found${NC}"
+  echo ""
+  echo "Install it with:"
+  echo "  bun install -g agent-slack"
+  exit 1
+fi
+
+# Check authentication
+echo "Checking authentication..."
+AUTH_STATUS=$(agent-slack auth status 2>&1)
+
+if ! echo "$AUTH_STATUS" | jq -e '.success' > /dev/null 2>&1; then
+  echo -e "${RED}Not authenticated!${NC}"
+  echo ""
+  echo "Run this to authenticate:"
+  echo "  agent-slack auth extract"
+  exit 1
+fi
+
+WORKSPACE_NAME=$(echo "$AUTH_STATUS" | jq -r '.data.workspace_name // "Unknown"')
+echo -e "${GREEN}✓ Authenticated to: $WORKSPACE_NAME${NC}"
+echo ""
+
+# Send the message
+echo "Sending message to #$CHANNEL..."
+echo "Message: $MESSAGE"
+echo ""
+
+send_message "$CHANNEL" "$MESSAGE"

package/skills/agent-slack/templates/workspace-summary.sh

@@ -0,0 +1,149 @@
+#!/bin/bash
+#
+# workspace-summary.sh - Generate a comprehensive workspace summary
+#
+# Usage:
+#   ./workspace-summary.sh [--json]
+#
+# Options:
+#   --json  Output raw JSON instead of formatted text
+#
+# Example:
+#   ./workspace-summary.sh
+#   ./workspace-summary.sh --json > summary.json
+
+set -euo pipefail
+
+OUTPUT_JSON=false
+if [ $# -gt 0 ] && [ "$1" = "--json" ]; then
+  OUTPUT_JSON=true
+fi
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+if ! command -v agent-slack &> /dev/null; then
+  echo -e "${RED}Error: agent-slack not found${NC}" >&2
+  echo "" >&2
+  echo "Install it with:" >&2
+  echo "  npm install -g agent-slack" >&2
+  exit 1
+fi
+
+AUTH_STATUS=$(agent-slack auth status 2>&1)
+
+if echo "$AUTH_STATUS" | jq -e '.error' > /dev/null 2>&1; then
+  echo -e "${RED}Not authenticated!${NC}" >&2
+  echo "" >&2
+  echo "Run this to authenticate:" >&2
+  echo "  agent-slack auth extract" >&2
+  exit 1
+fi
+
+echo -e "${YELLOW}Fetching workspace snapshot...${NC}" >&2
+SNAPSHOT=$(agent-slack snapshot 2>&1)
+
+if echo "$SNAPSHOT" | jq -e '.error' > /dev/null 2>&1; then
+  echo -e "${RED}Failed to get snapshot${NC}" >&2
+  ERROR_MSG=$(echo "$SNAPSHOT" | jq -r '.error // "Unknown error"')
+  echo -e "${RED}Error: $ERROR_MSG${NC}" >&2
+  exit 1
+fi
+
+if [ "$OUTPUT_JSON" = true ]; then
+  echo "$SNAPSHOT"
+  exit 0
+fi
+
+WORKSPACE_NAME=$(echo "$SNAPSHOT" | jq -r '.workspace.name // "Unknown"')
+WORKSPACE_ID=$(echo "$SNAPSHOT" | jq -r '.workspace.id // "Unknown"')
+
+CHANNELS=$(echo "$SNAPSHOT" | jq '.channels // []')
+CHANNEL_COUNT=$(echo "$CHANNELS" | jq 'length')
+PUBLIC_COUNT=$(echo "$CHANNELS" | jq '[.[] | select(.is_private == false)] | length')
+PRIVATE_COUNT=$(echo "$CHANNELS" | jq '[.[] | select(.is_private == true)] | length')
+
+USERS=$(echo "$SNAPSHOT" | jq '.users // []')
+USER_COUNT=$(echo "$USERS" | jq 'length')
+
+MESSAGES=$(echo "$SNAPSHOT" | jq '.recent_messages // []')
+MESSAGE_COUNT=$(echo "$MESSAGES" | jq 'length')
+
+echo ""
+echo -e "${BOLD}${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo -e "${BOLD}${BLUE}  Slack Workspace Summary${NC}"
+echo -e "${BOLD}${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+echo -e "${BOLD}Workspace:${NC} $WORKSPACE_NAME"
+echo -e "${BOLD}ID:${NC}        $WORKSPACE_ID"
+echo ""
+
+echo -e "${BOLD}${CYAN}Channels (${CHANNEL_COUNT} total)${NC}"
+echo -e "  Public:  $PUBLIC_COUNT"
+echo -e "  Private: $PRIVATE_COUNT"
+echo ""
+
+echo -e "${BOLD}${CYAN}Channel List:${NC}"
+echo "$CHANNELS" | jq -r '
+  .[0:10] | 
+  .[] | 
+  "  #\(.name) (\(.id))"
+'
+if [ "$CHANNEL_COUNT" -gt 10 ]; then
+  echo "  ... and $((CHANNEL_COUNT - 10)) more"
+fi
+echo ""
+
+echo -e "${BOLD}${CYAN}Users (${USER_COUNT} total)${NC}"
+echo ""
+
+echo -e "${BOLD}${CYAN}Sample Users:${NC}"
+echo "$USERS" | jq -r '
+  .[0:10] | 
+  .[] | 
+  "  \(.name) - \(.real_name // "N/A") (\(.id))"
+'
+if [ "$USER_COUNT" -gt 10 ]; then
+  echo "  ... and $((USER_COUNT - 10)) more"
+fi
+echo ""
+
+echo -e "${BOLD}${CYAN}Recent Activity (${MESSAGE_COUNT} messages)${NC}"
+echo ""
+
+if [ "$MESSAGE_COUNT" -gt 0 ]; then
+  echo -e "${BOLD}${CYAN}Latest Messages:${NC}"
+  echo "$MESSAGES" | jq -r '
+    .[0:5] | 
+    .[] | 
+    "  [\(.channel_name)] \(.username // "Unknown"): \(.text[0:60])\(if (.text | length) > 60 then "..." else "" end)"
+  '
+  echo ""
+fi
+
+echo -e "${BOLD}${CYAN}Quick Actions:${NC}"
+echo ""
+echo -e "  ${GREEN}# Send message to a channel${NC}"
+FIRST_CHANNEL=$(echo "$CHANNELS" | jq -r '.[0].name // "general"')
+echo -e "  agent-slack message send $FIRST_CHANNEL \"Hello!\""
+echo ""
+echo -e "  ${GREEN}# List recent messages in a channel${NC}"
+echo -e "  agent-slack message list $FIRST_CHANNEL --limit 10"
+echo ""
+echo -e "  ${GREEN}# Get user info${NC}"
+FIRST_USER=$(echo "$USERS" | jq -r '.[0].id // "U123"')
+echo -e "  agent-slack user info $FIRST_USER"
+echo ""
+
+echo -e "${BOLD}${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+
+SNAPSHOT_FILE="workspace-snapshot-$(date +%Y%m%d-%H%M%S).json"
+echo "$SNAPSHOT" > "$SNAPSHOT_FILE"
+echo -e "${GREEN}✓ Full snapshot saved to: $SNAPSHOT_FILE${NC}"
+echo ""

package/src/cli.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env bun
+
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { Command } from 'commander'
+import pkg from '../package.json'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+const program = new Command()
+
+program
+  .name('agent-messenger')
+  .description('Multi-platform messaging CLI for AI agents')
+  .version(pkg.version)
+
+// Use absolute paths for CWD-independence
+program.command('slack', 'Interact with Slack workspaces', {
+  executableFile: join(__dirname, 'platforms', 'slack', 'cli.ts'),
+})
+
+program.command('discord', 'Interact with Discord guilds', {
+  executableFile: join(__dirname, 'platforms', 'discord', 'cli.ts'),
+})
+
+program.parse(process.argv)
+
+export default program

package/src/platforms/discord/cli.ts

@@ -0,0 +1,36 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import pkg from '../../../package.json'
+import {
+  authCommand,
+  channelCommand,
+  fileCommand,
+  guildCommand,
+  messageCommand,
+  reactionCommand,
+  snapshotCommand,
+  userCommand,
+} from './commands'
+
+const program = new Command()
+
+program
+  .name('agent-discord')
+  .description('CLI tool for Discord communication')
+  .version(pkg.version)
+  .option('--pretty', 'Pretty-print JSON output')
+  .option('--guild <id>', 'Use specific guild')
+
+program.addCommand(authCommand)
+program.addCommand(guildCommand)
+program.addCommand(channelCommand)
+program.addCommand(fileCommand)
+program.addCommand(messageCommand)
+program.addCommand(reactionCommand)
+program.addCommand(snapshotCommand)
+program.addCommand(userCommand)
+
+program.parse(process.argv)
+
+export default program