agent-relay 1.2.0 → 1.2.3

package/scripts/games/hearts-setup.sh

@@ -1,264 +0,0 @@
-#!/bin/bash
-#
-# Hearts - 3 Player Autonomous Agent Game
-# Sets up three agents to play Hearts autonomously via file-based inbox
-#
-
-set -e
-
-GAME_DIR="${GAME_DIR:-/tmp/agent-relay-hearts}"
-PLAYER_1="Alice"
-PLAYER_2="Bob"
-PLAYER_3="Carol"
-
-echo "=== Hearts 3-Player Game Setup ==="
-echo "Game directory: $GAME_DIR"
-echo "Players: $PLAYER_1, $PLAYER_2, $PLAYER_3"
-echo ""
-
-# Create directories
-mkdir -p "$GAME_DIR/$PLAYER_1"
-mkdir -p "$GAME_DIR/$PLAYER_2"
-mkdir -p "$GAME_DIR/$PLAYER_3"
-
-# Clear any existing inbox
-echo "" > "$GAME_DIR/$PLAYER_1/inbox.md"
-echo "" > "$GAME_DIR/$PLAYER_2/inbox.md"
-echo "" > "$GAME_DIR/$PLAYER_3/inbox.md"
-
-# Generate and deal cards
-# For 3 players: remove 2 of diamonds, deal 17 cards each
-CARDS="2C 3C 4C 5C 6C 7C 8C 9C TC JC QC KC AC 2H 3H 4H 5H 6H 7H 8H 9H TH JH QH KH AH 2S 3S 4S 5S 6S 7S 8S 9S TS JS QS KS AS 3D 4D 5D 6D 7D 8D 9D TD JD QD KD AD"
-
-# Shuffle cards using a simple method
-SHUFFLED=$(echo $CARDS | tr ' ' '\n' | sort -R | tr '\n' ' ')
-CARD_ARRAY=($SHUFFLED)
-
-# Deal 17 cards to each player
-HAND_1="${CARD_ARRAY[@]:0:17}"
-HAND_2="${CARD_ARRAY[@]:17:17}"
-HAND_3="${CARD_ARRAY[@]:34:17}"
-
-# Create common game rules file
-cat > "$GAME_DIR/GAME_RULES.md" << 'EOF'
-# Hearts - 3 Player Rules
-
-## Overview
-Hearts is a trick-taking card game where you try to AVOID points.
-
-## Card Values
-- Suits: Clubs (C), Diamonds (D), Spades (S), Hearts (H)
-- Ranks: 2-9, T(10), J, Q, K, A (low to high)
-- Card notation: RankSuit (e.g., 2C = 2 of Clubs, QS = Queen of Spades)
-
-## Scoring
-- Each Heart: 1 point
-- Queen of Spades (QS): 13 points
-- **Goal: Get the LOWEST score**
-
-## Special Rule: Shooting the Moon
-If you take ALL hearts AND the Queen of Spades in one round:
-- You score 0 points
-- All opponents get 26 points each
-
-## Gameplay
-
-### 1. Passing Phase
-- Pass 3 cards to the player on your left
-- Round 1: Alice→Bob, Bob→Carol, Carol→Alice
-
-### 2. Trick Phase
-- Player with 2 of Clubs (2C) leads first trick
-- Players must follow suit if able
-- If can't follow suit, can play any card
-- Highest card of the led suit wins the trick
-- Winner leads next trick
-
-### 3. Hearts Breaking
-- Cannot lead hearts until hearts have been "broken"
-- Hearts break when someone plays a heart (because they can't follow suit)
-
-## Turn Order
-Alice → Bob → Carol → Alice → ...
-
-## End of Round
-- Round ends when all 17 tricks are played
-- Count points taken
-- Game ends when someone reaches 100 points
-
-## Commands
-
-**Wait for your turn:**
-```bash
-agent-relay inbox-poll -n YOUR_NAME -d /tmp/agent-relay-hearts --clear
-```
-
-**Play a card (to next player or broadcast):**
-```bash
-agent-relay inbox-write -t "NEXT_PLAYER" -f YOUR_NAME -m "PLAY: CARD" -d /tmp/agent-relay-hearts
-```
-
-**Broadcast to all:**
-```bash
-agent-relay inbox-write -t "*" -f YOUR_NAME -m "MESSAGE" -d /tmp/agent-relay-hearts
-```
-EOF
-
-# Create player-specific instruction files
-create_player_instructions() {
-  local PLAYER=$1
-  local HAND=$2
-  local PREV=$3
-  local NEXT=$4
-  local IS_FIRST=$5
-
-  cat > "$GAME_DIR/$PLAYER/INSTRUCTIONS.md" << EOFPLAYER
-# Hearts - You are $PLAYER
-
-Read the game rules: \`cat /tmp/agent-relay-hearts/GAME_RULES.md\`
-
-## Your Starting Hand (17 cards)
-\`\`\`
-$HAND
-\`\`\`
-
-## Players
-- You: **$PLAYER**
-- To your left (you pass TO): **$NEXT**
-- To your right (you receive FROM): **$PREV**
-
-## Commands
-
-**Wait for messages:**
-\`\`\`bash
-agent-relay inbox-poll -n $PLAYER -d /tmp/agent-relay-hearts --clear
-\`\`\`
-
-**Send to next player:**
-\`\`\`bash
-agent-relay inbox-write -t "$NEXT" -f $PLAYER -m "YOUR_MESSAGE" -d /tmp/agent-relay-hearts
-\`\`\`
-
-**Broadcast to all:**
-\`\`\`bash
-agent-relay inbox-write -t "*" -f $PLAYER -m "YOUR_MESSAGE" -d /tmp/agent-relay-hearts
-\`\`\`
-
-## Game Protocol
-
-### Phase 1: Card Passing
-1. Choose 3 cards to pass to $NEXT
-2. Send: \`PASS: card1 card2 card3\`
-3. Wait to receive 3 cards from $PREV
-4. Update your hand (remove passed, add received)
-
-### Phase 2: Playing Tricks
-The player with 2C leads the first trick.
-
-**When it's your turn to play:**
-1. Look at what's been played in this trick
-2. If you have the led suit, you MUST play it
-3. If you don't have the led suit, play any card
-4. Send: \`PLAY: CARD\` (e.g., \`PLAY: 7H\`)
-5. If you're last in trick, also announce winner and next lead
-
-**Message format for playing:**
-- \`PLAY: CARD\` - Your card play
-- \`TRICK_WINNER: PLAYER\` - Who won the trick
-- \`POINTS: {Alice: X, Bob: Y, Carol: Z}\` - Point totals
-
-### Tracking State
-Keep track of:
-- Your current hand
-- Cards played this trick
-- Who has played
-- Hearts broken? (true/false)
-- Points taken this round
-
-EOFPLAYER
-
-  if [ "$IS_FIRST" = "true" ]; then
-    cat >> "$GAME_DIR/$PLAYER/INSTRUCTIONS.md" << EOFSTART
-
-## You Start!
-Since you are $PLAYER, you coordinate the game start:
-
-1. **First, wait for all pass cards:**
-   \`\`\`bash
-   agent-relay inbox-poll -n $PLAYER -d /tmp/agent-relay-hearts --clear
-   \`\`\`
-
-2. **Send your 3 pass cards to $NEXT:**
-   \`\`\`bash
-   agent-relay inbox-write -t "$NEXT" -f $PLAYER -m "PASS: [card1] [card2] [card3]" -d /tmp/agent-relay-hearts
-   \`\`\`
-
-3. **Wait for pass cards from $PREV**
-
-4. **After everyone has passed, if you have 2C, lead first trick:**
-   \`\`\`bash
-   agent-relay inbox-write -t "*" -f $PLAYER -m "TRICK 1 - $PLAYER leads: PLAY: 2C" -d /tmp/agent-relay-hearts
-   \`\`\`
-
-5. **Wait for responses and continue the game loop**
-
-## START NOW
-Begin by choosing 3 cards to pass and sending them to $NEXT!
-EOFSTART
-  else
-    cat >> "$GAME_DIR/$PLAYER/INSTRUCTIONS.md" << EOFWAIT
-
-## Waiting for Game Start
-You will receive the first message when it's time to pass cards.
-
-1. **Wait for instruction to pass:**
-   \`\`\`bash
-   agent-relay inbox-poll -n $PLAYER -d /tmp/agent-relay-hearts --clear
-   \`\`\`
-
-2. **When prompted, send your 3 pass cards to $NEXT:**
-   \`\`\`bash
-   agent-relay inbox-write -t "$NEXT" -f $PLAYER -m "PASS: [card1] [card2] [card3]" -d /tmp/agent-relay-hearts
-   \`\`\`
-
-3. **Continue following the game protocol**
-
-## START NOW
-Run the inbox-poll command to wait for the game to begin!
-EOFWAIT
-  fi
-}
-
-# Create instructions for each player
-create_player_instructions "$PLAYER_1" "$HAND_1" "$PLAYER_3" "$PLAYER_2" "true"
-create_player_instructions "$PLAYER_2" "$HAND_2" "$PLAYER_1" "$PLAYER_3" "false"
-create_player_instructions "$PLAYER_3" "$HAND_3" "$PLAYER_2" "$PLAYER_1" "false"
-
-echo "Created game files:"
-echo "  - $GAME_DIR/GAME_RULES.md"
-echo "  - $GAME_DIR/$PLAYER_1/INSTRUCTIONS.md (Hand: $HAND_1)"
-echo "  - $GAME_DIR/$PLAYER_2/INSTRUCTIONS.md (Hand: $HAND_2)"
-echo "  - $GAME_DIR/$PLAYER_3/INSTRUCTIONS.md (Hand: $HAND_3)"
-echo ""
-echo "=== TO START THE GAME ==="
-echo ""
-echo "Make sure agent-relay is built:"
-echo "  cd $(dirname "$0")/../.."
-echo "  npm run build"
-echo ""
-echo "Open THREE terminal windows and run Claude/Codex in each:"
-echo ""
-echo "Terminal 1 ($PLAYER_1 - coordinates start):"
-echo "  claude"
-echo "  # Say: Read $GAME_DIR/$PLAYER_1/INSTRUCTIONS.md and start the Hearts game"
-echo ""
-echo "Terminal 2 ($PLAYER_2):"
-echo "  claude"
-echo "  # Say: Read $GAME_DIR/$PLAYER_2/INSTRUCTIONS.md and play Hearts"
-echo ""
-echo "Terminal 3 ($PLAYER_3):"
-echo "  claude"
-echo "  # Say: Read $GAME_DIR/$PLAYER_3/INSTRUCTIONS.md and play Hearts"
-echo ""
-echo "The three agents will autonomously play Hearts!"
-echo ""

package/scripts/manual-qa.sh

@@ -1,293 +0,0 @@
-#!/bin/bash
-#
-# Agent Relay Cloud - Manual QA Testing Setup
-#
-# This script sets up everything for manual browser-based QA testing:
-# - PostgreSQL and Redis (via Docker)
-# - Cloud API server (local, with test mode)
-# - Daemon simulators generating test data
-# - Creates test user for dashboard access
-#
-# Usage:
-#   ./scripts/manual-qa.sh              # Start everything
-#   ./scripts/manual-qa.sh --stop       # Stop all services
-#   ./scripts/manual-qa.sh --create-data # Create test data only
-#
-
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-CYAN='\033[0;36m'
-NC='\033[0m'
-
-log_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
-log_success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
-log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
-log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
-log_header() { echo -e "\n${CYAN}=== $1 ===${NC}\n"; }
-
-# Parse arguments
-STOP_ONLY=false
-CREATE_DATA_ONLY=false
-
-while [[ "$#" -gt 0 ]]; do
-    case $1 in
-        --stop) STOP_ONLY=true ;;
-        --create-data) CREATE_DATA_ONLY=true ;;
-        -h|--help)
-            echo "Usage: $0 [options]"
-            echo ""
-            echo "Options:"
-            echo "  --stop         Stop all services"
-            echo "  --create-data  Create test data only (assumes services running)"
-            echo "  -h, --help     Show this help"
-            exit 0
-            ;;
-        *) log_error "Unknown option: $1"; exit 1 ;;
-    esac
-    shift
-done
-
-cd "$PROJECT_DIR"
-
-# Stop services
-stop_services() {
-    log_header "Stopping Services"
-
-    # Stop daemon simulators
-    pkill -f "daemon-simulator" 2>/dev/null || true
-
-    # Stop cloud server
-    pkill -f "node dist/cloud/index.js" 2>/dev/null || true
-
-    # Stop Docker services
-    docker compose -f docker-compose.dev.yml down 2>/dev/null || true
-
-    log_success "All services stopped"
-}
-
-if [ "$STOP_ONLY" = true ]; then
-    stop_services
-    exit 0
-fi
-
-# Create test data
-create_test_data() {
-    log_header "Creating Test Data"
-
-    local API_URL="${1:-http://localhost:3000}"
-
-    # Wait for API to be ready
-    log_info "Waiting for API..."
-    for i in {1..30}; do
-        if curl -sf "$API_URL/health" >/dev/null 2>&1; then
-            break
-        fi
-        if [ $i -eq 30 ]; then
-            log_error "API not available"
-            return 1
-        fi
-        sleep 1
-    done
-
-    # Create test user
-    log_info "Creating test user..."
-    USER_RESPONSE=$(curl -sf -X POST "$API_URL/api/test/create-user" \
-        -H "Content-Type: application/json" \
-        -d '{"email": "qa@test.local", "name": "QA Tester"}' 2>/dev/null || echo "")
-
-    if [ -n "$USER_RESPONSE" ]; then
-        USER_ID=$(echo "$USER_RESPONSE" | grep -o '"userId":"[^"]*"' | cut -d'"' -f4)
-        log_success "Created test user: $USER_ID"
-    else
-        log_warn "Could not create test user (may already exist or test mode disabled)"
-    fi
-
-    # Create test daemons
-    log_info "Creating test daemons..."
-
-    for i in 1 2 3; do
-        DAEMON_RESPONSE=$(curl -sf -X POST "$API_URL/api/test/create-daemon" \
-            -H "Content-Type: application/json" \
-            -d "{\"name\": \"qa-daemon-$i\", \"machineId\": \"qa-machine-$i\"}" 2>/dev/null || echo "")
-
-        if [ -n "$DAEMON_RESPONSE" ]; then
-            DAEMON_ID=$(echo "$DAEMON_RESPONSE" | grep -o '"daemonId":"[^"]*"' | cut -d'"' -f4)
-            API_KEY=$(echo "$DAEMON_RESPONSE" | grep -o '"apiKey":"[^"]*"' | cut -d'"' -f4)
-            log_success "Created daemon $i: $DAEMON_ID"
-
-            # Save API key for simulator
-            echo "$API_KEY" > "/tmp/qa-daemon-$i.key"
-        fi
-    done
-
-    log_success "Test data created!"
-}
-
-if [ "$CREATE_DATA_ONLY" = true ]; then
-    create_test_data
-    exit 0
-fi
-
-# Main setup
-log_header "Agent Relay - Manual QA Setup"
-
-# Check prerequisites
-if ! docker info >/dev/null 2>&1; then
-    log_error "Docker is not running"
-    exit 1
-fi
-
-if ! command -v node >/dev/null 2>&1; then
-    log_error "Node.js is required"
-    exit 1
-fi
-
-# Step 1: Build if needed
-if [ ! -d "dist" ]; then
-    log_header "Building Project"
-    npm run build
-fi
-
-# Step 2: Start infrastructure
-log_header "Starting Infrastructure"
-
-docker compose -f docker-compose.dev.yml up -d postgres redis
-
-log_info "Waiting for PostgreSQL..."
-for i in {1..30}; do
-    if docker compose -f docker-compose.dev.yml exec -T postgres pg_isready -U agent_relay >/dev/null 2>&1; then
-        log_success "PostgreSQL is ready"
-        break
-    fi
-    if [ $i -eq 30 ]; then
-        log_error "PostgreSQL failed to start"
-        exit 1
-    fi
-    sleep 1
-done
-
-log_info "Waiting for Redis..."
-for i in {1..30}; do
-    if docker compose -f docker-compose.dev.yml exec -T redis redis-cli ping >/dev/null 2>&1; then
-        log_success "Redis is ready"
-        break
-    fi
-    if [ $i -eq 30 ]; then
-        log_error "Redis failed to start"
-        exit 1
-    fi
-    sleep 1
-done
-
-# Step 3: Start Cloud API server
-log_header "Starting Cloud API Server"
-
-export NODE_ENV=development
-export PORT=3000
-export PUBLIC_URL=http://localhost:3000
-export DATABASE_URL="postgres://agent_relay:dev_password@localhost:5432/agent_relay"
-export REDIS_URL="redis://localhost:6379"
-export SESSION_SECRET="dev-session-secret"
-export VAULT_MASTER_KEY="ZGV2LXZhdWx0LWtleS1jaGFuZ2UtaW4tcHJvZHVjdGlvbg=="
-export RELAY_CLOUD_ENABLED=true
-export RELAY_MEMORY_MONITORING=true
-
-# Start cloud server in background
-node dist/cloud/index.js &
-CLOUD_PID=$!
-echo $CLOUD_PID > /tmp/cloud-server.pid
-
-log_info "Cloud server starting (PID: $CLOUD_PID)..."
-
-# Wait for cloud server
-for i in {1..60}; do
-    if curl -sf http://localhost:3000/health >/dev/null 2>&1; then
-        log_success "Cloud API server is ready"
-        break
-    fi
-    if [ $i -eq 60 ]; then
-        log_error "Cloud server failed to start"
-        exit 1
-    fi
-    sleep 1
-done
-
-# Step 4: Create test data
-create_test_data "http://localhost:3000"
-
-# Step 5: Start daemon simulators
-log_header "Starting Daemon Simulators"
-
-# Check if tsx is available, otherwise use ts-node or compile
-if command -v tsx >/dev/null 2>&1; then
-    TSX_CMD="tsx"
-elif command -v ts-node >/dev/null 2>&1; then
-    TSX_CMD="ts-node"
-else
-    log_warn "No TypeScript runner found, skipping simulators"
-    TSX_CMD=""
-fi
-
-if [ -n "$TSX_CMD" ] && [ -f "test/cloud/daemon-simulator.ts" ]; then
-    # Start simulator 1 - normal operation
-    DAEMON_NAME=qa-daemon-1 \
-    CLOUD_API_URL=http://localhost:3000 \
-    AGENT_COUNT=3 \
-    REPORT_INTERVAL_MS=5000 \
-    SIMULATE_MEMORY_GROWTH=false \
-    $TSX_CMD test/cloud/daemon-simulator.ts &
-    echo $! > /tmp/simulator-1.pid
-    log_info "Started simulator 1 (PID: $!)"
-
-    # Start simulator 2 - memory growth
-    DAEMON_NAME=qa-daemon-2 \
-    CLOUD_API_URL=http://localhost:3000 \
-    AGENT_COUNT=2 \
-    REPORT_INTERVAL_MS=5000 \
-    SIMULATE_MEMORY_GROWTH=true \
-    $TSX_CMD test/cloud/daemon-simulator.ts &
-    echo $! > /tmp/simulator-2.pid
-    log_info "Started simulator 2 (PID: $!)"
-
-    sleep 3
-    log_success "Daemon simulators running"
-else
-    log_warn "Daemon simulators not started (tsx/ts-node not available)"
-fi
-
-# Done!
-log_header "Manual QA Environment Ready!"
-
-echo -e "${GREEN}Access Points:${NC}"
-echo "  - Dashboard:  http://localhost:3000"
-echo "  - API Health: http://localhost:3000/health"
-echo "  - Metrics:    http://localhost:3000/metrics"
-echo ""
-echo -e "${GREEN}Test Endpoints:${NC}"
-echo "  - GET  /api/test/status           - Check test mode"
-echo "  - POST /api/test/create-user      - Create test user"
-echo "  - POST /api/test/create-daemon    - Create test daemon"
-echo ""
-echo -e "${GREEN}Database Access:${NC}"
-echo "  psql postgres://agent_relay:dev_password@localhost:5432/agent_relay"
-echo ""
-echo -e "${GREEN}Redis Access:${NC}"
-echo "  redis-cli -h localhost -p 6379"
-echo ""
-echo -e "${YELLOW}Note:${NC} OAuth is bypassed in test mode. Use /api/test endpoints to create users."
-echo ""
-echo -e "To stop: ${CYAN}./scripts/manual-qa.sh --stop${NC}"
-echo ""
-
-# Keep script running to show logs
-log_info "Showing cloud server logs (Ctrl+C to exit, services keep running)..."
-echo ""
-tail -f /dev/null