agent-relay 1.1.0 → 1.2.3

package/docs/dashboard-v2-plan.md

@@ -1,179 +0,0 @@
-# Dashboard V2 Architecture Plan
-
-## Overview
-
-Migrate from vanilla TypeScript to Next.js with enhanced fleet control capabilities.
-Inspired by AI Maestro's hierarchical naming and color coding system.
-
-## Key Features
-
-### 1. Fleet Overview
-- Multi-server visualization with expandable project cards
-- Agent cards with real-time status indicators
-- Hierarchical grouping based on agent naming (e.g., `backend-api`, `frontend-ui`)
-
-### 2. Agent Status Cards
-- Color-coded by project/role hierarchy
-- Status badge (online/offline/busy)
-- Unread message indicator (red dot, iPhone-style)
-- Current task summary from [[SUMMARY]] blocks
-- Quick actions: message, spawn similar, view trajectory
-
-### 3. Task Assignment UI
-- Drag-and-drop task assignment to agents
-- Integration with beads task system
-- Visual dependency graph
-- Priority indicators (P1-P4 color coding)
-
-### 4. Trajectory Viewer
-- Timeline visualization of agent decisions
-- Expandable decision nodes
-- Context diff viewer
-- Replay capability
-
-### 5. Decision Queue
-- Pending decisions requiring human input
-- Priority-sorted list
-- One-click approve/reject
-- Bulk actions
-
-## Color Coding System
-
-### Hierarchical Colors (from agent name prefix)
-```
-backend-*    → Blue (#1264a3)
-frontend-*   → Purple (#7c3aed)
-infra-*      → Orange (#ea580c)
-lead-*       → Green (#2bac76)
-test-*       → Teal (#0d9488)
-(default)    → Gray (#6b7280)
-```
-
-### Status Colors
-```
-online       → Green dot
-offline      → Gray dot
-busy         → Yellow dot
-error        → Red dot
-attention    → Red badge overlay
-```
-
-## Tech Stack
-
-### Frontend
-- Next.js 14 (App Router)
-- React Server Components where applicable
-- Tailwind CSS for styling
-- Framer Motion for animations
-- React Query for data fetching
-- WebSocket for real-time updates
-
-### State Management
-- Zustand for client state
-- React Query for server state
-- WebSocket context for real-time
-
-## Directory Structure
-
-```
-src/dashboard-v2/
-├── app/
-│   ├── layout.tsx
-│   ├── page.tsx              # Main dashboard
-│   ├── fleet/
-│   │   └── page.tsx          # Fleet overview
-│   ├── agent/[name]/
-│   │   └── page.tsx          # Agent detail view
-│   ├── trajectory/
-│   │   └── page.tsx          # Trajectory viewer
-│   └── decisions/
-│       └── page.tsx          # Decision queue
-├── components/
-│   ├── layout/
-│   │   ├── Sidebar.tsx
-│   │   ├── Header.tsx
-│   │   └── CommandPalette.tsx
-│   ├── agents/
-│   │   ├── AgentCard.tsx
-│   │   ├── AgentList.tsx
-│   │   └── AgentStatus.tsx
-│   ├── fleet/
-│   │   ├── FleetOverview.tsx
-│   │   ├── ProjectCard.tsx
-│   │   └── ServerStatus.tsx
-│   ├── messages/
-│   │   ├── MessageList.tsx
-│   │   ├── MessageComposer.tsx
-│   │   └── ThreadPanel.tsx
-│   ├── tasks/
-│   │   ├── TaskBoard.tsx
-│   │   ├── TaskCard.tsx
-│   │   └── TaskAssignment.tsx
-│   ├── trajectory/
-│   │   ├── Timeline.tsx
-│   │   ├── DecisionNode.tsx
-│   │   └── ContextDiff.tsx
-│   └── decisions/
-│       ├── DecisionQueue.tsx
-│       └── DecisionCard.tsx
-├── hooks/
-│   ├── useWebSocket.ts
-│   ├── useAgents.ts
-│   ├── useMessages.ts
-│   └── useFleet.ts
-├── lib/
-│   ├── api.ts
-│   ├── colors.ts            # Color coding logic
-│   └── hierarchy.ts         # Agent name parsing
-└── types/
-    └── index.ts
-```
-
-## API Endpoints Needed
-
-### Existing (keep)
-- `GET /ws` - WebSocket for real-time updates
-- `POST /api/send` - Send message
-- `POST /api/spawn` - Spawn agent
-- `GET /api/spawned` - List spawned agents
-- `DELETE /api/spawned/:name` - Release agent
-
-### New (for v2)
-- `GET /api/trajectory/:agent` - Agent decision history
-- `GET /api/decisions` - Pending decisions queue
-- `POST /api/decisions/:id/resolve` - Resolve a decision
-- `GET /api/tasks` - Beads integration for task list
-- `POST /api/tasks/:id/assign` - Assign task to agent
-
-## Implementation Phases
-
-### Phase 1: Foundation (Current Sprint)
-- [ ] Set up Next.js project structure
-- [ ] Implement color coding system
-- [ ] Create basic layout components
-- [ ] Port existing WebSocket logic
-
-### Phase 2: Core Features
-- [ ] Agent cards with hierarchy grouping
-- [ ] Enhanced message view
-- [ ] Fleet overview page
-- [ ] Real-time status updates
-
-### Phase 3: Advanced Features
-- [ ] Trajectory viewer
-- [ ] Decision queue
-- [ ] Task assignment UI
-- [ ] Beads integration
-
-### Phase 4: Polish
-- [ ] Animations and transitions
-- [ ] Keyboard shortcuts
-- [ ] Mobile responsiveness
-- [ ] Performance optimization
-
-## Migration Strategy
-
-1. Build v2 alongside existing dashboard
-2. New route: `/v2` or separate port during development
-3. Feature parity checkpoint before switching
-4. Gradual rollout with feature flags

package/docs/guides/CLOUD.md

@@ -1,236 +0,0 @@
-# Agent Relay Cloud
-
-Get started with [agent-relay.com](https://agent-relay.com) - the fully managed way to orchestrate AI agents across your repositories.
-
-## Overview
-
-Agent Relay Cloud handles everything for you:
-- Automatic server provisioning
-- GitHub repository integration
-- Multi-provider agent authentication (Claude, Codex, Gemini)
-- Team management and collaboration
-- Centralized dashboard and logs
-
-**No servers to manage. No infrastructure to maintain.**
-
-## Getting Started
-
-### 1. Sign Up
-
-Visit [agent-relay.com](https://agent-relay.com) and click **Continue with GitHub**.
-
-This:
-- Creates your Agent Relay account
-- Automatically connects GitHub Copilot
-- Gives us access to list your repositories
-
-### 2. Connect Your Repositories
-
-Select which repositories Agent Relay should manage:
-
-1. Browse your GitHub repos
-2. Check the ones you want to connect
-3. Click **Continue**
-
-We'll:
-- Install the Agent Relay GitHub App on selected repos
-- Clone repos to your cloud workspace
-- Set up webhooks for PR/issue events
-
-### 3. Connect AI Providers
-
-Connect the AI providers you want to use. Click **Login with [Provider]** for each:
-
-| Provider | What You Get |
-|----------|--------------|
-| **Anthropic** | Claude Code - recommended for code tasks |
-| **OpenAI** | Codex and ChatGPT models |
-| **Google** | Gemini - multi-modal capabilities |
-| **GitHub Copilot** | Auto-connected via GitHub signup |
-
-You authenticate with your existing provider accounts. No API keys to manage.
-
-### 4. Start Using Agents
-
-Once connected, you can:
-
-**From the Dashboard:**
-- Spawn agents manually
-- View real-time agent activity
-- Monitor message flows between agents
-
-**From GitHub:**
-- Open a PR to trigger automatic code review
-- Use `@agent-relay` in PR comments to chat with agents
-- Agents respond directly in your PRs
-
-**From the CLI:**
-```bash
-# Connect your local environment to cloud
-agent-relay cloud login
-
-# Spawn a cloud agent from anywhere
-agent-relay cloud spawn Alice claude "Review the auth module"
-```
-
-## Dashboard
-
-Your dashboard is available at `https://app.agent-relay.com` after login.
-
-### Features
-
-- **Real-time Activity Feed** - See all agent messages as they happen
-- **Agent Management** - Spawn, monitor, and stop agents
-- **Repository Overview** - Connected repos and their status
-- **Team Settings** - Manage team members and permissions
-- **Usage & Billing** - Track compute hours and plan limits
-
-## Plans
-
-| Feature | Free | Pro | Team | Enterprise |
-|---------|------|-----|------|------------|
-| Workspaces | 1 | 5 | 20 | Unlimited |
-| Repositories | 3 | 20 | 100 | Unlimited |
-| Concurrent Agents | 2 | 10 | 50 | Unlimited |
-| Compute Hours/Month | 10 | 100 | 500 | Unlimited |
-| Coordinator Agents | - | ✓ | ✓ | ✓ |
-| Priority Support | - | ✓ | ✓ | ✓ |
-| SSO/SAML | - | - | - | ✓ |
-
-See [Pricing](/pricing) for current rates.
-
-## Teams
-
-### Creating a Team
-
-1. Go to **Settings → Teams**
-2. Click **Create Team**
-3. Name your team and invite members
-
-### Team Roles
-
-| Role | Permissions |
-|------|-------------|
-| **Owner** | Full access, billing, can delete team |
-| **Admin** | Manage members, repos, agents |
-| **Member** | Spawn agents, view activity |
-
-### Shared Credentials
-
-Team admins can share provider credentials with team members, so everyone can spawn agents without individual logins.
-
-## Project Groups
-
-Organize related repositories into project groups for coordinated multi-repo work.
-
-### Creating a Project Group
-
-1. Go to **Settings → Project Groups**
-2. Click **Create Group**
-3. Add repositories to the group
-4. Optionally enable a **Coordinator Agent** (Pro+)
-
-### Coordinator Agents
-
-Coordinator agents (Pro plans and above) oversee work across all repos in a project group:
-
-- Delegate tasks to repo-specific agents
-- Track progress across the group
-- Ensure consistency between repos
-
-## CLI Integration
-
-Connect your local terminal to Agent Relay Cloud:
-
-```bash
-# Login to cloud
-agent-relay cloud login
-
-# Check connection status
-agent-relay cloud status
-
-# List your cloud workspaces
-agent-relay cloud workspaces
-
-# Spawn a cloud agent
-agent-relay cloud spawn MyAgent claude "Fix the login bug"
-
-# View cloud agent logs
-agent-relay cloud logs MyAgent
-```
-
-## GitHub Integration
-
-### Webhooks
-
-Agent Relay listens for:
-- **Pull Requests** - Automatic code review
-- **Issues** - Task assignment to agents
-- **Comments** - `@agent-relay` mentions
-
-### PR Comments
-
-Interact with agents directly in PRs:
-
-```
-@agent-relay review this PR
-@agent-relay explain the changes in src/auth/
-@agent-relay suggest improvements
-```
-
-### Issue Assignment
-
-Assign issues to agents:
-
-```
-@agent-relay work on this issue
-@agent-relay implement this feature using Claude
-```
-
-## Security
-
-### Data Protection
-
-- All data encrypted at rest (AES-256)
-- TLS 1.3 for all connections
-- SOC 2 Type II compliant (Enterprise)
-
-### Credential Security
-
-- OAuth tokens encrypted with per-user keys
-- Automatic token refresh
-- No API keys stored in plaintext
-
-### Workspace Isolation
-
-- Each workspace runs in isolated containers
-- No shared filesystem between users
-- Network isolation between workspaces
-
-## Troubleshooting
-
-### Agent Won't Spawn
-
-1. Check provider connection in **Settings → Providers**
-2. Verify you haven't exceeded plan limits
-3. Check the activity log for errors
-
-### GitHub Webhooks Not Working
-
-1. Go to **Settings → Repositories**
-2. Click **Resync** on the affected repo
-3. Verify the GitHub App is still installed
-
-### Token Expired
-
-If you see "Token expired" errors:
-
-1. Go to **Settings → Providers**
-2. Click **Reconnect** on the affected provider
-3. Re-authenticate with the provider
-
-## Support
-
-- **Documentation**: [docs.agent-relay.com](https://docs.agent-relay.com)
-- **GitHub Issues**: [github.com/khaliqgant/agent-relay/issues](https://github.com/khaliqgant/agent-relay/issues)
-- **Email**: support@agent-relay.com (Pro+ plans)