agent-messenger 1.0.0 → 1.2.0

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

@@ -0,0 +1,239 @@
+#!/bin/bash
+#
+# monitor-channel.sh - Monitor a Microsoft Teams 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 "19:abc123@thread.tacv2"
+#   ./monitor-channel.sh "19:abc123@thread.tacv2" 5
+#
+# NOTE: Teams tokens expire in 60-90 minutes! This script handles automatic refresh.
+
+set -euo pipefail
+
+# Check arguments
+if [ $# -lt 1 ]; then
+  echo "Usage: $0 <channel-id> [interval]"
+  echo ""
+  echo "Examples:"
+  echo "  $0 '19:abc123@thread.tacv2'          # Monitor channel, poll every 10s"
+  echo "  $0 '19:abc123@thread.tacv2' 5        # Monitor channel, poll every 5s"
+  echo ""
+  echo "To find channel IDs, run: agent-teams channel list"
+  echo ""
+  echo "NOTE: Teams tokens expire in 60-90 minutes - this script auto-refreshes!"
+  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
+LAST_TOKEN_CHECK=$(date +%s)
+TOKEN_CHECK_INTERVAL=300  # Check token every 5 minutes
+
+# 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 refresh token if needed (TEAMS-SPECIFIC)
+refresh_token_if_needed() {
+  local now=$(date +%s)
+  local elapsed=$((now - LAST_TOKEN_CHECK))
+  
+  # Only check periodically to avoid API spam
+  if [ $elapsed -lt $TOKEN_CHECK_INTERVAL ]; then
+    return 0
+  fi
+  
+  LAST_TOKEN_CHECK=$now
+  
+  echo -e "${YELLOW}Checking token validity...${NC}"
+  
+  local status
+  status=$(agent-teams auth status 2>&1)
+  
+  # Check if token is expired or expiring soon
+  if echo "$status" | jq -e '.error' > /dev/null 2>&1; then
+    echo -e "${YELLOW}Token expired, refreshing...${NC}"
+    agent-teams auth extract
+    return 0
+  fi
+  
+  local expires_soon
+  expires_soon=$(echo "$status" | jq -r '.token_expires_soon // false')
+  local token_age
+  token_age=$(echo "$status" | jq -r '.token_age_minutes // 0')
+  
+  if [ "$expires_soon" = "true" ]; then
+    echo -e "${YELLOW}Token expiring soon (${token_age} min old), refreshing...${NC}"
+    agent-teams auth extract
+  else
+    echo -e "${GREEN}Token valid (${token_age} min old)${NC}"
+  fi
+}
+
+# Function to check for new messages
+check_messages() {
+  # Get latest message
+  MESSAGES=$(agent-teams message list "$CHANNEL_ID" --limit 1 2>&1)
+  
+  # Check for token expiry error
+  if echo "$MESSAGES" | grep -Eqi "expired|401|unauthorized" 2>/dev/null; then
+    echo -e "${YELLOW}Token expired during operation, refreshing...${NC}"
+    agent-teams auth extract
+    # Retry
+    MESSAGES=$(agent-teams message list "$CHANNEL_ID" --limit 1 2>&1)
+  fi
+  
+  # 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-teams message send "$CHANNEL_ID" "You called?"
+      # fi
+    fi
+    
+    LAST_ID="$LATEST_ID"
+  fi
+  
+  FIRST_RUN=false
+  return 0
+}
+
+# Check if agent-teams is installed
+if ! command -v agent-teams &> /dev/null; then
+  echo -e "${RED}Error: agent-teams not found${NC}"
+  echo ""
+  echo "Install it with:"
+  echo "  bun install -g agent-teams"
+  exit 1
+fi
+
+# Check authentication and refresh if needed
+echo "Checking authentication..."
+refresh_token_if_needed
+
+AUTH_STATUS=$(agent-teams 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-teams auth extract"
+  exit 1
+fi
+
+USER_NAME=$(echo "$AUTH_STATUS" | jq -r '.user // "Unknown"')
+TOKEN_AGE=$(echo "$AUTH_STATUS" | jq -r '.token_age_minutes // "unknown"')
+echo -e "${GREEN}Authenticated as: $USER_NAME${NC}"
+echo -e "Token age: ${TOKEN_AGE} minutes"
+echo ""
+
+# Verify channel exists
+echo "Verifying channel..."
+CHANNEL_INFO=$(agent-teams 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-teams 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}Token will be auto-refreshed before expiry (60-90 min limit)${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
+  # Proactively refresh token before it expires
+  refresh_token_if_needed
+  
+  check_messages
+  sleep "$INTERVAL"
+done

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

@@ -0,0 +1,224 @@
+#!/bin/bash
+#
+# post-message.sh - Send a message to Microsoft Teams with error handling
+#
+# Usage:
+#   ./post-message.sh <channel-id> <message>
+#   ./post-message.sh --channel-name <name> <message>
+#
+# Example:
+#   ./post-message.sh "19:abc123@thread.tacv2" "Hello from script!"
+#   ./post-message.sh --channel-name General "Deployment completed"
+#
+# NOTE: Teams tokens expire in 60-90 minutes! This script handles token refresh.
+
+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 [ "$1" = "--channel-name" ]; then
+  if [ $# -lt 3 ]; then
+    echo "Usage: $0 --channel-name <name> <message>"
+    echo ""
+    echo "Example:"
+    echo "  $0 --channel-name General 'Build completed'"
+    echo ""
+    echo "NOTE: Teams tokens expire in 60-90 minutes!"
+    exit 1
+  fi
+  CHANNEL_NAME="$2"
+  MESSAGE="$3"
+elif [ $# -lt 2 ]; then
+  echo "Usage: $0 <channel-id> <message>"
+  echo "       $0 --channel-name <name> <message>"
+  echo ""
+  echo "Examples:"
+  echo "  $0 '19:abc123@thread.tacv2' 'Hello world!'"
+  echo "  $0 --channel-name General 'Build completed'"
+  echo ""
+  echo "NOTE: Teams tokens expire in 60-90 minutes!"
+  exit 1
+else
+  CHANNEL_ID="$1"
+  MESSAGE="$2"
+fi
+
+# Function to refresh token if needed
+refresh_token_if_needed() {
+  local status
+  status=$(agent-teams auth status 2>&1)
+  
+  # Check if token is expired or expiring soon
+  if echo "$status" | jq -e '.error' > /dev/null 2>&1; then
+    echo -e "${YELLOW}Token expired or invalid, refreshing...${NC}"
+    agent-teams auth extract
+    return 0
+  fi
+  
+  local expires_soon
+  expires_soon=$(echo "$status" | jq -r '.token_expires_soon // false')
+  
+  if [ "$expires_soon" = "true" ]; then
+    echo -e "${YELLOW}Token expiring soon, refreshing...${NC}"
+    agent-teams auth extract
+  fi
+}
+
+# Function to send message with retry logic
+send_message() {
+  local channel_id=$1
+  local message=$2
+  local max_attempts=3
+  local attempt=1
+  local token_refresh_attempts=0
+  local max_token_refresh=2
+  
+  while [ $attempt -le $max_attempts ]; do
+    echo -e "${YELLOW}Attempt $attempt/$max_attempts...${NC}"
+    
+    # Send message and capture result
+    RESULT=$(agent-teams 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}"
+      
+      # Handle token expiry - refresh and retry (with a limit on refresh attempts)
+      if echo "$ERROR_MSG" | grep -Eqi "expired|401|unauthorized"; then
+        token_refresh_attempts=$((token_refresh_attempts + 1))
+        if [ $token_refresh_attempts -le $max_token_refresh ]; then
+          echo -e "${YELLOW}Token expired, refreshing (attempt $token_refresh_attempts/$max_token_refresh)...${NC}"
+          agent-teams auth extract
+          continue
+        else
+          echo -e "${RED}Token refresh failed after $max_token_refresh attempts${NC}"
+          return 1
+        fi
+      fi
+      
+      # Don't retry on certain errors
+      if echo "$ERROR_MSG" | grep -q "Not authenticated"; then
+        echo ""
+        echo "Not authenticated. Run:"
+        echo "  agent-teams auth extract"
+        return 1
+      fi
+      
+      if echo "$ERROR_MSG" | grep -q "Channel not found"; then
+        echo ""
+        echo "Channel '$channel_id' not found. Check channel ID."
+        echo "List channels with: agent-teams 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-teams is installed
+if ! command -v agent-teams &> /dev/null; then
+  echo -e "${RED}Error: agent-teams not found${NC}"
+  echo ""
+  echo "Install it with:"
+  echo "  bun install -g agent-teams"
+  exit 1
+fi
+
+# Check and refresh authentication
+echo "Checking authentication..."
+refresh_token_if_needed
+
+AUTH_STATUS=$(agent-teams 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-teams auth extract"
+  exit 1
+fi
+
+USER_NAME=$(echo "$AUTH_STATUS" | jq -r '.user // "Unknown"')
+TEAM_ID=$(echo "$AUTH_STATUS" | jq -r '.current_team // ""')
+TOKEN_AGE=$(echo "$AUTH_STATUS" | jq -r '.token_age_minutes // "unknown"')
+echo -e "${GREEN}Authenticated as: $USER_NAME${NC}"
+echo -e "Token age: ${TOKEN_AGE} minutes"
+
+if [ -z "$TEAM_ID" ]; then
+  echo -e "${RED}No team selected!${NC}"
+  echo ""
+  echo "Run this to select a team:"
+  echo "  agent-teams team list"
+  echo "  agent-teams team switch <team-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-teams 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-teams/templates/team-summary.sh

@@ -0,0 +1,210 @@
+#!/bin/bash
+#
+# team-summary.sh - Generate a comprehensive Microsoft Teams team summary
+#
+# Usage:
+#   ./team-summary.sh [--json]
+#
+# Options:
+#   --json  Output raw JSON instead of formatted text
+#
+# Example:
+#   ./team-summary.sh
+#   ./team-summary.sh --json > summary.json
+#
+# NOTE: Teams tokens expire in 60-90 minutes! This script handles token refresh.
+
+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'
+
+# Function to refresh token if needed
+refresh_token_if_needed() {
+  local status
+  status=$(agent-teams auth status 2>&1)
+  
+  if echo "$status" | jq -e '.error' > /dev/null 2>&1; then
+    echo -e "${YELLOW}Token expired, refreshing...${NC}" >&2
+    agent-teams auth extract >&2
+    return 0
+  fi
+  
+  local expires_soon
+  expires_soon=$(echo "$status" | jq -r '.token_expires_soon // false')
+  
+  if [ "$expires_soon" = "true" ]; then
+    echo -e "${YELLOW}Token expiring soon, refreshing...${NC}" >&2
+    agent-teams auth extract >&2
+  fi
+}
+
+if ! command -v agent-teams &> /dev/null; then
+  echo -e "${RED}Error: agent-teams not found${NC}" >&2
+  echo "" >&2
+  echo "Install it with:" >&2
+  echo "  bun install -g agent-teams" >&2
+  exit 1
+fi
+
+# Check and refresh token
+refresh_token_if_needed
+
+AUTH_STATUS=$(agent-teams 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-teams auth extract" >&2
+  exit 1
+fi
+
+CURRENT_TEAM=$(echo "$AUTH_STATUS" | jq -r '.current_team // ""')
+TOKEN_AGE=$(echo "$AUTH_STATUS" | jq -r '.token_age_minutes // "unknown"')
+
+if [ -z "$CURRENT_TEAM" ]; then
+  echo -e "${RED}No team selected!${NC}" >&2
+  echo "" >&2
+  echo "Run this to select a team:" >&2
+  echo "  agent-teams team list" >&2
+  echo "  agent-teams team switch <team-id>" >&2
+  exit 1
+fi
+
+echo -e "${YELLOW}Fetching team snapshot...${NC}" >&2
+echo -e "Token age: ${TOKEN_AGE} minutes" >&2
+SNAPSHOT=$(agent-teams snapshot 2>&1)
+
+# Handle token expiry during snapshot
+if echo "$SNAPSHOT" | grep -Eqi "expired|401|unauthorized" 2>/dev/null; then
+  echo -e "${YELLOW}Token expired during snapshot, refreshing...${NC}" >&2
+  agent-teams auth extract >&2
+  SNAPSHOT=$(agent-teams snapshot 2>&1)
+fi
+
+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
+
+TEAM_NAME=$(echo "$SNAPSHOT" | jq -r '.team.name // "Unknown"')
+TEAM_ID=$(echo "$SNAPSHOT" | jq -r '.team.id // "Unknown"')
+
+CHANNELS=$(echo "$SNAPSHOT" | jq '.channels // []')
+CHANNEL_COUNT=$(echo "$CHANNELS" | jq 'length')
+STANDARD_COUNT=$(echo "$CHANNELS" | jq '[.[] | select(.type == "standard")] | length')
+PRIVATE_COUNT=$(echo "$CHANNELS" | jq '[.[] | select(.type == "private")] | length')
+
+MEMBERS=$(echo "$SNAPSHOT" | jq '.members // []')
+MEMBER_COUNT=$(echo "$MEMBERS" | jq 'length')
+
+MESSAGES=$(echo "$SNAPSHOT" | jq '.recent_messages // []')
+MESSAGE_COUNT=$(echo "$MESSAGES" | jq 'length')
+
+echo ""
+echo -e "${BOLD}${BLUE}=====================================================${NC}"
+echo -e "${BOLD}${BLUE}  Microsoft Teams Summary${NC}"
+echo -e "${BOLD}${BLUE}=====================================================${NC}"
+echo ""
+echo -e "${BOLD}Team:${NC}        $TEAM_NAME"
+echo -e "${BOLD}ID:${NC}          $TEAM_ID"
+echo -e "${BOLD}Token Age:${NC}   ${TOKEN_AGE} minutes (expires at ~60-90 min)"
+echo ""
+
+echo -e "${BOLD}${CYAN}Channels (${CHANNEL_COUNT} total)${NC}"
+echo -e "  Standard:   $STANDARD_COUNT"
+echo -e "  Private:    $PRIVATE_COUNT"
+echo ""
+
+echo -e "${BOLD}${CYAN}Channels:${NC}"
+echo "$CHANNELS" | jq -r '
+  .[0:10] | 
+  .[] | 
+  "  #\(.name) (\(.id[0:30])...)"
+'
+if [ "$CHANNEL_COUNT" -gt 10 ]; then
+  echo "  ... and $((CHANNEL_COUNT - 10)) more"
+fi
+echo ""
+
+echo -e "${BOLD}${CYAN}Members (${MEMBER_COUNT} shown)${NC}"
+echo ""
+
+echo -e "${BOLD}${CYAN}Sample Members:${NC}"
+echo "$MEMBERS" | jq -r '
+  .[0:10] | 
+  .[] | 
+  "  \(.displayName) \(if .email then "(\(.email))" else "" end)"
+'
+if [ "$MEMBER_COUNT" -gt 10 ]; then
+  echo "  ... and $((MEMBER_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)] \(.author): \(.content[0:50])\(if (.content | length) > 50 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].id // "CHANNEL_ID"')
+FIRST_CHANNEL_NAME=$(echo "$CHANNELS" | jq -r '.[0].name // "General"')
+echo -e "  agent-teams message send \"$FIRST_CHANNEL\" \"Hello!\""
+echo ""
+echo -e "  ${GREEN}# List messages in #$FIRST_CHANNEL_NAME${NC}"
+echo -e "  agent-teams message list \"$FIRST_CHANNEL\" --limit 10"
+echo ""
+echo -e "  ${GREEN}# Get user info${NC}"
+FIRST_USER=$(echo "$MEMBERS" | jq -r '.[0].id // "USER_ID"')
+echo -e "  agent-teams user info \"$FIRST_USER\""
+echo ""
+echo -e "  ${GREEN}# Switch to another team${NC}"
+echo -e "  agent-teams team list"
+echo -e "  agent-teams team switch <team-id>"
+echo ""
+echo -e "  ${GREEN}# Refresh token (expires in 60-90 min!)${NC}"
+echo -e "  agent-teams auth extract"
+echo ""
+
+echo -e "${BOLD}${BLUE}=====================================================${NC}"
+echo ""
+
+SNAPSHOT_FILE="team-snapshot-$(date +%Y%m%d-%H%M%S).json"
+echo "$SNAPSHOT" > "$SNAPSHOT_FILE"
+echo -e "${GREEN}Full snapshot saved to: $SNAPSHOT_FILE${NC}"
+echo ""
+
+# Warn if token is getting old
+if [ "$TOKEN_AGE" != "unknown" ] && [ "${TOKEN_AGE%.*}" -gt 45 ] 2>/dev/null; then
+  echo -e "${YELLOW}WARNING: Token is ${TOKEN_AGE} minutes old. Consider refreshing soon!${NC}"
+  echo -e "${YELLOW}Run: agent-teams auth extract${NC}"
+  echo ""
+fi

package/src/cli.ts

@@ -24,6 +24,10 @@ program.command('discord', 'Interact with Discord guilds', {
   executableFile: join(__dirname, 'platforms', 'discord', 'cli.ts'),
 })
 
+program.command('teams', 'Interact with Microsoft Teams', {
+  executableFile: join(__dirname, 'platforms', 'teams', 'cli.ts'),
+})
+
 program.parse(process.argv)
 
 export default program