agent-relay 1.1.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Real-time agent-to-agent communication system",
   "type": "module",
   "main": "dist/index.js",
@@ -39,6 +39,10 @@
     "dashboard": "node dist/dashboard-server/start.js",
     "pretest": "npm run build",
     "test": "vitest run",
+    "test:integration": "vitest run test/cloud/*.integration.test.ts",
+    "test:qa": "./scripts/run-cloud-qa.sh",
+    "qa": "./scripts/manual-qa.sh",
+    "qa:stop": "./scripts/manual-qa.sh --stop",
     "pretest:coverage": "npm run build",
     "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
@@ -51,9 +55,10 @@
     "services:up": "docker compose -f docker-compose.dev.yml up -d postgres redis && echo '✓ Postgres and Redis running'",
     "services:down": "docker compose -f docker-compose.dev.yml down",
     "services:logs": "docker compose -f docker-compose.dev.yml logs -f postgres redis",
-    "cloud:api": "node dist/cloud/index.js",
-    "precloud": "npm run clean && tsc && chmod +x dist/cli/index.js && npm run services:up",
-    "cloud": "concurrently -n api,daemon,dashboard -c cyan,blue,magenta \"npm run cloud:api\" \"npm run dev:daemon\" \"npm run dev:dashboard\""
+    "cloud:setup": "./scripts/cloud-setup.sh",
+    "cloud:api": "WORKSPACE_IMAGE=relay-workspace:local WORKSPACE_DEV_MOUNT=true node -r dotenv/config dist/cloud/index.js",
+    "precloud": "./scripts/cloud-setup.sh --skip-data",
+    "cloud": "concurrently -n api,daemon,dashboard -c cyan,blue,magenta \"npm run cloud:api\" \"npm run dev:daemon\" \"npm run dev:next\""
   },
   "keywords": [
     "agent",
@@ -69,13 +74,16 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/khaliqgant/agent-relay.git"
+    "url": "git+https://github.com/AgentWorkforce/relay.git"
   },
   "bugs": {
-    "url": "https://github.com/khaliqgant/agent-relay/issues"
+    "url": "https://github.com/AgentWorkforce/relay/issues"
   },
-  "homepage": "https://github.com/khaliqgant/agent-relay#readme",
+  "homepage": "https://github.com/AgentWorkforce/relay#readme",
   "dependencies": {
+    "@nangohq/node": "^0.69.20",
+    "@types/jsonwebtoken": "^9.0.10",
+    "agent-trajectories": "^0.1.1",
     "better-sqlite3": "^9.4.3",
     "chokidar": "^5.0.0",
     "commander": "^12.1.0",
@@ -88,6 +96,7 @@
     "express-session": "^1.18.2",
     "helmet": "^8.1.0",
     "http-proxy-middleware": "^3.0.5",
+    "jsonwebtoken": "^9.0.3",
     "node-pty": "1.0.0",
     "pg": "^8.16.3",
     "redis": "^5.10.0",

package/scripts/cloud-setup.sh

@@ -0,0 +1,96 @@
+#!/bin/bash
+# Cloud local development setup script
+# Usage: ./scripts/cloud-setup.sh [--skip-docker] [--skip-migrate] [--skip-data]
+
+set -e
+
+SKIP_DOCKER=false
+SKIP_MIGRATE=false
+SKIP_DATA=false
+
+# Parse arguments
+for arg in "$@"; do
+  case $arg in
+    --skip-docker) SKIP_DOCKER=true ;;
+    --skip-migrate) SKIP_MIGRATE=true ;;
+    --skip-data) SKIP_DATA=true ;;
+  esac
+done
+
+echo "🚀 Setting up Agent Relay Cloud (local dev)"
+echo ""
+
+# Step 1: Start Docker services
+if [ "$SKIP_DOCKER" = false ]; then
+  echo "📦 Starting Docker services (Postgres + Redis)..."
+  docker compose -f docker-compose.dev.yml up -d postgres redis
+
+  # Wait for Postgres to be ready
+  echo "⏳ Waiting for Postgres to be ready..."
+  until docker compose -f docker-compose.dev.yml exec -T postgres pg_isready -U postgres > /dev/null 2>&1; do
+    sleep 1
+  done
+  echo "✓ Postgres is ready"
+else
+  echo "⏭️  Skipping Docker setup"
+fi
+
+# Step 2: Build TypeScript
+echo ""
+echo "🔨 Building TypeScript..."
+npm run build > /dev/null 2>&1
+echo "✓ Build complete"
+
+# Step 3: Run migrations
+if [ "$SKIP_MIGRATE" = false ]; then
+  echo ""
+  echo "📊 Running database migrations..."
+  npm run db:migrate 2>&1 | grep -E "(Applied|already applied|Error)" || true
+  echo "✓ Migrations complete"
+else
+  echo "⏭️  Skipping migrations"
+fi
+
+# Step 4: Set up test data (only if server is running)
+if [ "$SKIP_DATA" = false ]; then
+  echo ""
+  echo "🧪 Setting up test data..."
+
+  # Check if cloud server is running, if not start it temporarily
+  if ! curl -s http://localhost:4567/api/health > /dev/null 2>&1; then
+    echo "   Starting cloud server temporarily for setup..."
+    node dist/cloud/index.js &
+    SERVER_PID=$!
+    sleep 3
+    STARTED_SERVER=true
+  fi
+
+  # Create test data
+  RESPONSE=$(curl -s -X POST http://localhost:4567/api/test/setup-local-cloud \
+    -H "Content-Type: application/json" \
+    -c /tmp/relay-cookies.txt \
+    -d '{"repoName": "test-org/test-repo", "workspaceName": "Local Dev"}' 2>&1 || echo '{"error": "Failed to connect"}')
+
+  if echo "$RESPONSE" | grep -q '"success":true'; then
+    echo "✓ Test data created"
+    echo "   Cookie saved to /tmp/relay-cookies.txt"
+  else
+    echo "⚠️  Could not create test data (server may need to be running)"
+  fi
+
+  # Stop temp server if we started it
+  if [ "$STARTED_SERVER" = true ]; then
+    kill $SERVER_PID 2>/dev/null || true
+  fi
+else
+  echo "⏭️  Skipping test data setup"
+fi
+
+echo ""
+echo "✅ Setup complete!"
+echo ""
+echo "To start the cloud server:"
+echo "  npm run cloud"
+echo ""
+echo "Then open: http://localhost:4567/app"
+echo ""

package/scripts/manual-qa.sh

@@ -0,0 +1,293 @@
+#!/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

package/scripts/postinstall.js

@@ -224,10 +224,70 @@ function installDashboardDeps() {
   }
 }
 
+/**
+ * Patch agent-trajectories CLI to record agent info on start
+ */
+function patchAgentTrajectories() {
+  const pkgRoot = getPackageRoot();
+  const cliPath = path.join(pkgRoot, 'node_modules', 'agent-trajectories', 'dist', 'cli', 'index.js');
+
+  if (!fs.existsSync(cliPath)) {
+    info('agent-trajectories not installed, skipping patch');
+    return;
+  }
+
+  const content = fs.readFileSync(cliPath, 'utf-8');
+
+  // If already patched, exit early
+  if (content.includes('--agent <name>') && content.includes('trajectory.agents.push')) {
+    info('agent-trajectories already patched');
+    return;
+  }
+
+  const optionNeedle = '.option("-t, --task <id>", "External task ID").option("-s, --source <system>", "Task system (github, linear, jira, beads)").option("--url <url>", "URL to external task")';
+  const optionReplacement = `${optionNeedle}.option("-a, --agent <name>", "Agent name starting the trajectory").option("-r, --role <role>", "Agent role (lead, contributor, reviewer)")`;
+
+  const createNeedle = `    const trajectory = createTrajectory({
+      title,
+      source
+    });
+    await storage.save(trajectory);`;
+
+  const createReplacement = `    const agentName = options.agent || process.env.AGENT_NAME || process.env.AGENT_RELAY_NAME || process.env.USER || process.env.USERNAME;
+    const agentRole = options.role || "lead";
+    const trajectory = createTrajectory({
+      title,
+      source
+    });
+    if (agentName) {
+      trajectory.agents.push({
+        name: agentName,
+        role: ["lead", "contributor", "reviewer"].includes(agentRole) ? agentRole : "lead",
+        joinedAt: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    }
+    await storage.save(trajectory);`;
+
+  if (!content.includes(optionNeedle) || !content.includes(createNeedle)) {
+    warn('agent-trajectories CLI format changed, skipping patch');
+    return;
+  }
+
+  const updated = content
+    .replace(optionNeedle, optionReplacement)
+    .replace(createNeedle, createReplacement);
+
+  fs.writeFileSync(cliPath, updated, 'utf-8');
+  success('Patched agent-trajectories to record agent on trail start');
+}
+
 /**
  * Main postinstall routine
  */
 async function main() {
+  // Ensure trail CLI captures agent info on start
+  patchAgentTrajectories();
+
   // Always install dashboard dependencies (needed for build)
   installDashboardDeps();