agent-relay 1.1.0 → 1.2.3

package/docs/removable-code-analysis.md

@@ -1,24 +0,0 @@
-# Removable Code Analysis
-
-Requested: identify code/assets likely safe to remove (unused, legacy, or duplicates).
-
-## Candidates
-1) `run-dashboard.js`  
-   - Purpose: helper to start dashboard from built `dist/dashboard/server.js`.  
-   - Evidence: Dashboard now exposed via CLI subcommand `dashboard` in `src/cli/index.ts`. No `rg` references to `run-dashboard.js`. Redundant helper.
-
-2) `scripts/games/*` and `scripts/tictactoe-setup.sh`  
-   - Purpose: old demo/game scripts (hearts/tictactoe).  
-   - Evidence: Not referenced by CLI commands or docs (checked with `rg`). Pure examples; removable if demos not needed.
-
-3) `src/hooks/check-inbox.sh`  
-   - Purpose: legacy hook example for Claude stop-event inbox check.  
-   - Evidence: Replaced by compiled hook in `dist/hooks/inbox-check/*` and TypeScript sources in `src/hooks/inbox-check/*`. No other references via `rg`, so redundant.
-
-4) `coverage/` directory  
-   - Purpose: test coverage artifacts.  
-   - Evidence: Generated output; not source. Safe to delete/regenerate.
-
-5) `TOMORROW.md`  
-   - Purpose: session notes / planning doc.  
-   - Evidence: Not used by runtime or tests; optional to keep for historical notes only.

package/scripts/dev/PUBLIC_RELEASE_PLAN.md

@@ -1,88 +0,0 @@
-# Agent-Relay Public Release Plan
-
-## Goal
-Prepare agent-relay for public release on npm and GitHub with comprehensive documentation, examples, and polish.
-
-## Team Structure
-
-### Agent 1: DocWriter (Claude) - Documentation & Examples
-**Focus:** User-facing content, tutorials, examples
-**Workdir:** `/Users/khaliqgant/Projects/prpm/agent-relay`
-
-Tasks:
-- [ ] Review and improve README.md
-  - Add GIF/video demo of quick start usage
-  - Improve quick start section
-  - Add "Common Use Cases" section
-- [ ] Create docs/CONTRIBUTING.md
-- [ ] Create examples/ directory with:
-  - [ ] examples/basic-chat/ - Two agents chatting
-  - [ ] examples/tic-tac-toe/ - Simple game
-  - [ ] examples/collaborative-coding/ - Agents working together
-- [ ] Update CLI --help text for all commands
-- [ ] Document the new inbox-* commands
-- [ ] Create API.md documenting the protocol
-
-### Agent 2: CodePolish (Claude) - Code Quality & Tests
-**Focus:** Test coverage, error handling, code cleanup
-**Workdir:** `/Users/khaliqgant/Projects/prpm/agent-relay`
-
-Tasks:
-- [ ] Audit test coverage - identify gaps
-- [ ] Add tests for new inbox-poll/write/agents commands
-- [ ] Improve error messages (user-friendly)
-- [ ] Add input validation to CLI commands
-- [ ] Clean up console.log statements (use proper logging)
-- [ ] Remove dead code and unused files
-- [ ] Review and fix any TypeScript strict mode issues
-- [ ] Add JSDoc comments to public APIs
-
-### Agent 3: DevOps (Codex) - CI/CD & Publishing
-**Focus:** Build, publish, installation
-**Workdir:** `/Users/khaliqgant/Projects/prpm/agent-relay`
-
-Tasks:
-- [ ] Review and improve package.json
-  - Verify all fields for npm publish
-  - Add repository, bugs, homepage URLs
-  - Review dependencies (prune unused)
-- [ ] Enhance GitHub Actions workflow
-  - Add npm publish on release
-  - Add test coverage reporting
-  - Add build badge to README
-- [ ] Review install.sh script
-  - Test on clean systems
-  - Improve error handling
-- [ ] Add LICENSE file (MIT)
-- [ ] Create docs/CHANGELOG.md
-- [ ] Test npm pack / npm publish --dry-run
-- [ ] Set up GitHub release automation
-
-## Coordination Protocol
-
-Agents communicate via `/tmp/agent-relay-dev/`:
-- DocWriter, CodePolish, DevOps each have inbox directories
-- Use `agent-relay inbox-*` commands
-
-### Message Types
-- `STATUS: <doing what>` - Progress update
-- `QUESTION: <question>` - Need input from another agent
-- `DONE: <task>` - Task completed
-- `BLOCKER: <issue>` - Blocked on something
-- `HANDOFF: <what>` - Passing work to another agent
-
-### Coordination Rules
-1. Before editing a file, announce: `STATUS: Editing <filename>`
-2. After completing a task, broadcast: `DONE: <task description>`
-3. If blocked, ask: `QUESTION: @AgentName <question>`
-4. Check inbox after each major task
-
-## Success Criteria
-- [ ] npm install agent-relay works
-- [ ] All CLI commands have --help
-- [ ] README has working quick start
-- [ ] 3+ working examples
-- [ ] Test coverage > 80%
-- [ ] No TypeScript errors in strict mode
-- [ ] GitHub Actions green
-- [ ] Clean npm audit

package/scripts/dev/dev-team-setup.sh

@@ -1,431 +0,0 @@
-#!/bin/bash
-#
-# Development Team Setup
-# Sets up 3 agents (2 Claude + 1 Codex) to work on agent-relay public release
-#
-
-set -e
-
-DEV_DIR="${DEV_DIR:-/tmp/agent-relay-dev}"
-AGENT_1="DocWriter"
-AGENT_2="CodePolish"
-AGENT_3="DevOps"
-AGENT_4="Dashboard"
-
-REPO_DIR="/Users/khaliqgant/Projects/prpm/agent-relay"
-
-echo "=== Agent-Relay Development Team Setup ==="
-echo "Dev directory: $DEV_DIR"
-echo "Repo: $REPO_DIR"
-echo "Agents: $AGENT_1 (Claude), $AGENT_2 (Claude), $AGENT_3 (Codex), $AGENT_4 (Gemini)"
-echo ""
-
-# Create directories
-mkdir -p "$DEV_DIR/$AGENT_1"
-mkdir -p "$DEV_DIR/$AGENT_2"
-mkdir -p "$DEV_DIR/$AGENT_3"
-mkdir -p "$DEV_DIR/$AGENT_4"
-
-# Clear any existing inbox
-echo "" > "$DEV_DIR/$AGENT_1/inbox.md"
-echo "" > "$DEV_DIR/$AGENT_2/inbox.md"
-echo "" > "$DEV_DIR/$AGENT_3/inbox.md"
-echo "" > "$DEV_DIR/$AGENT_4/inbox.md"
-
-# Copy the release plan
-cp "$REPO_DIR/scripts/dev/PUBLIC_RELEASE_PLAN.md" "$DEV_DIR/"
-
-# Create instructions for DocWriter (Claude 1)
-cat > "$DEV_DIR/$AGENT_1/INSTRUCTIONS.md" << 'EOF'
-# You are DocWriter - Documentation & Examples Lead
-
-## Your Mission
-Prepare agent-relay's documentation and examples for public release.
-
-## Project Location
-`/Users/khaliqgant/Projects/prpm/agent-relay`
-
-## Your Tasks (in priority order)
-
-### 1. Review README.md
-- Read the current README: `cat /Users/khaliqgant/Projects/prpm/agent-relay/README.md`
-- Identify gaps or unclear sections
-- Improve the Quick Start guide
-- Add a "Common Use Cases" section
-
-### 2. Create examples/ directory
-Create working examples that users can run:
-- `examples/basic-chat/` - Two agents having a conversation
-- `examples/collaborative-task/` - Agents working on a shared task
-
-### 3. Document CLI Commands
-The new inbox commands need documentation:
-- `agent-relay inbox-poll` - Blocking wait for messages
-- `agent-relay inbox-read` - Read inbox contents
-- `agent-relay inbox-write` - Write to agent inbox
-- `agent-relay inbox-agents` - List agents
-
-### 4. Create docs/CONTRIBUTING.md
-Guide for contributors.
-
-## Communication
-
-**Your inbox:** `/tmp/agent-relay-dev/DocWriter/inbox.md`
-**Teammates:** CodePolish, DevOps
-
-### Commands
-Use the LOCAL build (not the global install):
-```bash
-# Wait for messages
-node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js inbox-poll -n DocWriter -d /tmp/agent-relay-dev --clear
-
-# Send to teammate
-node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js inbox-write -t CodePolish -f DocWriter -m "MESSAGE" -d /tmp/agent-relay-dev
-
-# Broadcast to all
-node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js inbox-write -t "*" -f DocWriter -m "MESSAGE" -d /tmp/agent-relay-dev
-
-# List team
-node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js inbox-agents -d /tmp/agent-relay-dev
-```
-
-**TIP:** You can create an alias for convenience:
-```bash
-alias ar='node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js'
-```
-
-### Protocol
-- `STATUS: <what you're doing>` - Progress update
-- `DONE: <task>` - Task completed
-- `QUESTION: @AgentName <question>` - Ask teammate
-- `BLOCKER: <issue>` - Blocked
-
-## START NOW
-1. Read the release plan: `cat /tmp/agent-relay-dev/PUBLIC_RELEASE_PLAN.md`
-2. Broadcast your start: `STATUS: DocWriter starting, reviewing README.md`
-3. Begin with reviewing README.md
-4. Check inbox periodically for teammate messages
-EOF
-
-# Create instructions for CodePolish (Claude 2)
-cat > "$DEV_DIR/$AGENT_2/INSTRUCTIONS.md" << 'EOF'
-# You are CodePolish - Code Quality & Testing Lead
-
-## Your Mission
-Improve agent-relay's code quality, test coverage, and error handling for public release.
-
-## Project Location
-`/Users/khaliqgant/Projects/prpm/agent-relay`
-
-## Your Tasks (in priority order)
-
-### 1. Audit Test Coverage
-- Run tests: `cd /Users/khaliqgant/Projects/prpm/agent-relay && npm test`
-- Identify files without tests
-- Focus on `src/cli/index.ts` - the new inbox commands need tests
-
-### 2. Add Missing Tests
-Priority:
-- `inbox-poll` command
-- `inbox-write` command (including broadcast)
-- `inbox-read` command
-- `inbox-agents` command
-
-### 3. Improve Error Handling
-- Review CLI commands for user-friendly error messages
-- Add input validation
-- Handle edge cases gracefully
-
-### 4. Code Cleanup
-- Remove console.log debugging statements
-- Add JSDoc comments to public functions
-- Check for unused imports/variables
-
-### 5. TypeScript Strict Mode
-- Run: `npx tsc --noEmit --strict`
-- Fix any type errors
-
-## Communication
-
-**Your inbox:** `/tmp/agent-relay-dev/CodePolish/inbox.md`
-**Teammates:** DocWriter, DevOps
-
-### Commands
-Use the LOCAL build (not the global install):
-```bash
-# Wait for messages
-node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js inbox-poll -n CodePolish -d /tmp/agent-relay-dev --clear
-
-# Send to teammate
-node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js inbox-write -t DevOps -f CodePolish -m "MESSAGE" -d /tmp/agent-relay-dev
-
-# Broadcast to all
-node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js inbox-write -t "*" -f CodePolish -m "MESSAGE" -d /tmp/agent-relay-dev
-```
-
-**TIP:** Create an alias: `alias ar='node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js'`
-
-### Protocol
-- `STATUS: <what you're doing>` - Progress update
-- `DONE: <task>` - Task completed
-- `QUESTION: @AgentName <question>` - Ask teammate
-- `BLOCKER: <issue>` - Blocked
-
-## START NOW
-1. Read the release plan: `cat /tmp/agent-relay-dev/PUBLIC_RELEASE_PLAN.md`
-2. Broadcast your start: `STATUS: CodePolish starting, auditing test coverage`
-3. Run tests and identify gaps
-4. Check inbox periodically for teammate messages
-EOF
-
-# Create instructions for DevOps (Codex)
-cat > "$DEV_DIR/$AGENT_3/INSTRUCTIONS.md" << 'EOF'
-# You are DevOps - CI/CD & Publishing Lead
-
-## Your Mission
-Prepare agent-relay for npm publishing and improve CI/CD for public release.
-
-## Project Location
-`/Users/khaliqgant/Projects/prpm/agent-relay`
-
-## Your Tasks (in priority order)
-
-### 1. Review package.json
-- Check: `cat /Users/khaliqgant/Projects/prpm/agent-relay/package.json`
-- Verify npm publish fields: name, version, description, main, bin, repository, bugs, homepage
-- Review dependencies - remove unused
-- Add "files" field to whitelist published files
-
-### 2. Add LICENSE file
-- Create MIT license at `/Users/khaliqgant/Projects/prpm/agent-relay/LICENSE`
-
-### 3. Enhance GitHub Actions
-- Review: `cat /Users/khaliqgant/Projects/prpm/agent-relay/.github/workflows/test.yml`
-- Add npm publish workflow on GitHub release
-- Add test coverage badge
-
-### 4. Create docs/CHANGELOG.md
-- Document the 0.1.0 release features
-
-### 5. Test npm publish
-- Run: `npm pack --dry-run`
-- Verify package contents are correct
-- Check: `npm publish --dry-run`
-
-### 6. Review install.sh
-- Test the installer script logic
-- Improve error handling
-
-## Communication
-
-**Your inbox:** `/tmp/agent-relay-dev/DevOps/inbox.md`
-**Teammates:** DocWriter, CodePolish
-
-### Commands
-Use the LOCAL build (not the global install):
-```bash
-# Wait for messages
-node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js inbox-poll -n DevOps -d /tmp/agent-relay-dev --clear
-
-# Send to teammate
-node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js inbox-write -t DocWriter -f DevOps -m "MESSAGE" -d /tmp/agent-relay-dev
-
-# Broadcast to all
-node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js inbox-write -t "*" -f DevOps -m "MESSAGE" -d /tmp/agent-relay-dev
-```
-
-**TIP:** Create an alias: `alias ar='node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js'`
-
-### Protocol
-- `STATUS: <what you're doing>` - Progress update
-- `DONE: <task>` - Task completed
-- `QUESTION: @AgentName <question>` - Ask teammate
-- `BLOCKER: <issue>` - Blocked
-
-## START NOW
-1. Read the release plan: `cat /tmp/agent-relay-dev/PUBLIC_RELEASE_PLAN.md`
-2. Broadcast your start: `STATUS: DevOps starting, reviewing package.json`
-3. Begin with package.json audit
-4. Check inbox periodically for teammate messages
-EOF
-
-# Create instructions for Dashboard (Gemini)
-cat > "$DEV_DIR/$AGENT_4/INSTRUCTIONS.md" << 'EOF'
-# You are Dashboard - Web Visualization Lead
-
-## Your Mission
-Build a web dashboard to visualize agent-relay communication patterns and help users track multi-agent progress in real-time.
-
-## Project Location
-`/Users/khaliqgant/Projects/prpm/agent-relay`
-
-## Your Tasks (in priority order)
-
-### 1. Create Dashboard Directory Structure
-```
-src/dashboard/
-├── server.ts       # Express/Fastify server
-├── index.html      # Main dashboard page
-├── styles.css      # Styling
-└── client.ts       # Client-side JS (or keep it simple with vanilla JS)
-```
-
-### 2. Build Core Features
-
-**a) Inbox Monitor**
-- Watch all agent inbox files in a data directory
-- Display messages in real-time as they arrive
-- Show sender, recipient, timestamp, message preview
-
-**b) Agent Status Panel**
-- List all active agents
-- Show last activity timestamp
-- Indicate if inbox has unread messages
-
-**c) Message Flow Visualization**
-- Simple diagram showing message flow between agents
-- Could be a timeline or network graph
-- Show who sent what to whom
-
-**d) Activity Log**
-- Scrolling log of all messages
-- Filter by agent
-- Search functionality
-
-### 3. CLI Integration
-Add a new command to agent-relay CLI:
-```bash
-agent-relay dashboard -d /tmp/agent-relay-dev -p 3000
-```
-
-This should:
-- Start the web server on specified port
-- Watch the data directory for changes
-- Serve the dashboard UI
-
-### 4. Tech Stack Suggestions
-Keep it simple - no heavy frameworks needed:
-- **Server:** Node.js with built-in http or express
-- **File watching:** fs.watch or chokidar
-- **Real-time updates:** Server-Sent Events (SSE) or WebSocket
-- **UI:** Vanilla HTML/CSS/JS or minimal framework
-
-### 5. Design Goals
-- **Zero dependencies if possible** (or minimal)
-- **Works out of the box** - no build step required for dashboard
-- **Real-time updates** - see messages as they happen
-- **Mobile-friendly** - responsive design
-
-## Communication
-
-**Your inbox:** `/tmp/agent-relay-dev/Dashboard/inbox.md`
-**Teammates:** DocWriter, CodePolish, DevOps
-
-### Commands
-Use the LOCAL build (not the global install):
-```bash
-# Wait for messages
-node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js inbox-poll -n Dashboard -d /tmp/agent-relay-dev --clear
-
-# Send to teammate
-node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js inbox-write -t DocWriter -f Dashboard -m "MESSAGE" -d /tmp/agent-relay-dev
-
-# Broadcast to all
-node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js inbox-write -t "*" -f Dashboard -m "MESSAGE" -d /tmp/agent-relay-dev
-```
-
-**TIP:** Create an alias: `alias ar='node /Users/khaliqgant/Projects/prpm/agent-relay/dist/cli/index.js'`
-
-### Protocol
-- `STATUS: <what you're doing>` - Progress update
-- `DONE: <task>` - Task completed
-- `QUESTION: @AgentName <question>` - Ask teammate
-- `BLOCKER: <issue>` - Blocked
-
-## Example Dashboard Layout
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  Agent-Relay Dashboard                    [Watching: /tmp/] │
-├─────────────────────────────────────────────────────────────┤
-│                                                             │
-│  AGENTS                    MESSAGE FLOW                     │
-│  ┌──────────────────┐     ┌─────────────────────────────┐  │
-│  │ ● DocWriter      │     │  DocWriter ──→ CodePolish   │  │
-│  │   Last: 2s ago   │     │  CodePolish ──→ DevOps      │  │
-│  │ ● CodePolish     │     │  DevOps ──→ * (broadcast)   │  │
-│  │   Last: 5s ago   │     │  Dashboard ──→ DocWriter    │  │
-│  │ ● DevOps         │     └─────────────────────────────┘  │
-│  │   Last: 10s ago  │                                      │
-│  │ ○ Dashboard      │     ACTIVITY LOG                     │
-│  │   (you)          │     ┌─────────────────────────────┐  │
-│  └──────────────────┘     │ 12:01 DocWriter→CodePolish  │  │
-│                           │ "STATUS: Reviewing README"  │  │
-│                           │ 12:02 CodePolish→*          │  │
-│                           │ "DONE: Added 5 new tests"   │  │
-│                           └─────────────────────────────┘  │
-└─────────────────────────────────────────────────────────────┘
-```
-
-## START NOW
-1. Read the release plan: `cat /tmp/agent-relay-dev/PUBLIC_RELEASE_PLAN.md`
-2. Broadcast your start: `STATUS: Dashboard starting, designing web UI architecture`
-3. Begin by creating the directory structure
-4. Check inbox periodically for teammate messages
-EOF
-
-echo "Created development team files:"
-echo "  - $DEV_DIR/PUBLIC_RELEASE_PLAN.md"
-echo "  - $DEV_DIR/$AGENT_1/INSTRUCTIONS.md (Claude - Documentation)"
-echo "  - $DEV_DIR/$AGENT_2/INSTRUCTIONS.md (Claude - Code Quality)"
-echo "  - $DEV_DIR/$AGENT_3/INSTRUCTIONS.md (Codex - DevOps)"
-echo "  - $DEV_DIR/$AGENT_4/INSTRUCTIONS.md (Gemini - Dashboard)"
-echo ""
-echo "=== TO START DEVELOPMENT ==="
-echo ""
-echo "Make sure agent-relay is built:"
-echo "  cd $REPO_DIR"
-echo "  npm run build"
-echo ""
-echo "Open FOUR terminal windows:"
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "Terminal 1 - DocWriter (Claude):"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  cd $REPO_DIR"
-echo "  claude"
-echo ""
-echo "  Then say:"
-echo "  Read /tmp/agent-relay-dev/DocWriter/INSTRUCTIONS.md and start working on agent-relay documentation"
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "Terminal 2 - CodePolish (Claude):"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  cd $REPO_DIR"
-echo "  claude"
-echo ""
-echo "  Then say:"
-echo "  Read /tmp/agent-relay-dev/CodePolish/INSTRUCTIONS.md and start working on agent-relay code quality"
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "Terminal 3 - DevOps (Codex):"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  cd $REPO_DIR"
-echo "  codex"
-echo ""
-echo "  Then say:"
-echo "  Read /tmp/agent-relay-dev/DevOps/INSTRUCTIONS.md and start working on agent-relay CI/CD and publishing"
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "Terminal 4 - Dashboard (Gemini):"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  cd $REPO_DIR"
-echo "  gemini"
-echo ""
-echo "  Then say:"
-echo "  Read /tmp/agent-relay-dev/Dashboard/INSTRUCTIONS.md and start building the agent-relay web dashboard"
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-echo "The four agents will coordinate via /tmp/agent-relay-dev/ inboxes!"
-echo ""

package/scripts/e2e-test.sh

@@ -1,119 +0,0 @@
-#!/bin/bash
-# E2E Test for Agent Relay
-# Tests the full flow: daemon -> supervisor -> agent processing
-
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
-DATA_DIR="/tmp/agent-relay-e2e-test"
-SOCKET_PATH="/tmp/agent-relay-e2e.sock"
-AGENT_NAME="TestAgent"
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m' # No Color
-
-log_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
-log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
-log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
-
-cleanup() {
-    log_info "Cleaning up..."
-    # Kill background processes
-    if [ -n "$DAEMON_PID" ]; then
-        kill $DAEMON_PID 2>/dev/null || true
-    fi
-    # Clean up test data
-    rm -rf "$DATA_DIR"
-    rm -f "$SOCKET_PATH" "${SOCKET_PATH}.pid"
-    log_info "Cleanup complete"
-}
-
-trap cleanup EXIT
-
-# Ensure we're in the project directory
-cd "$PROJECT_DIR"
-
-log_info "=== Agent Relay E2E Test ==="
-log_info "Data dir: $DATA_DIR"
-log_info "Socket: $SOCKET_PATH"
-
-# Clean up any previous test data
-rm -rf "$DATA_DIR"
-rm -f "$SOCKET_PATH" "${SOCKET_PATH}.pid"
-mkdir -p "$DATA_DIR"
-
-# Build if needed
-log_info "Building project..."
-npm run build
-
-# Start daemon in background
-log_info "Starting daemon..."
-node dist/cli/index.js start -s "$SOCKET_PATH" -f &
-DAEMON_PID=$!
-sleep 1
-
-# Verify daemon is running
-if ! kill -0 $DAEMON_PID 2>/dev/null; then
-    log_error "Daemon failed to start"
-    exit 1
-fi
-log_info "Daemon started (PID: $DAEMON_PID)"
-
-# Register a test agent (using 'echo' as a simple CLI that just exits)
-log_info "Registering test agent: $AGENT_NAME"
-node dist/cli/index.js register \
-    -n "$AGENT_NAME" \
-    -c custom \
-    --command "echo" \
-    -w "$PROJECT_DIR" \
-    -d "$DATA_DIR"
-
-# Verify registration
-if [ ! -f "$DATA_DIR/$AGENT_NAME/state.json" ]; then
-    log_error "Agent state file not created"
-    exit 1
-fi
-log_info "Agent registered successfully"
-
-# Create inbox with test message
-log_info "Writing test message to inbox..."
-INBOX_PATH="$DATA_DIR/$AGENT_NAME/inbox.md"
-cat > "$INBOX_PATH" << 'EOF'
-## Message from TestSender | 2025-12-18T12:00:00.000Z
-Hello from the E2E test! Please respond with @relay:TestSender Got your message!
-EOF
-
-# Verify inbox was created
-if [ ! -f "$INBOX_PATH" ]; then
-    log_error "Inbox file not created"
-    exit 1
-fi
-log_info "Inbox created with test message"
-
-# Show initial state
-log_info "Initial state.json:"
-cat "$DATA_DIR/$AGENT_NAME/state.json" | head -20
-
-# Note: Full supervisor test requires a real CLI that can process messages
-# For now, we verify the infrastructure is in place
-
-log_info ""
-log_info "=== E2E Infrastructure Test PASSED ==="
-log_info ""
-log_info "Verified:"
-log_info "  - Daemon starts and runs"
-log_info "  - Agent registration creates state.json"
-log_info "  - Inbox file can be created"
-log_info ""
-log_info "To test full message flow with a real CLI:"
-log_info "  1. Start daemon:     npm run start -- start -f"
-log_info "  2. Register agent:   npm run start -- register -n MyAgent -c claude -w \$(pwd)"
-log_info "  3. Start supervisor: npm run start -- supervisor -v -d /tmp/agent-relay"
-log_info "  4. Send message:     npm run start -- send -t MyAgent -m 'Hello!'"
-log_info ""
-
-exit 0