agent-relay 1.0.8 → 1.0.9

package/docs/agent-relay-snippet.md

@@ -0,0 +1,61 @@
+# Agent Relay
+
+Real-time agent-to-agent messaging. Output `->relay:` patterns to communicate.
+
+## Sending Messages
+
+```
+->relay:AgentName Your message here
+->relay:* Broadcast to all agents
+```
+
+### Multi-line Messages
+
+For messages with blank lines or code:
+
+```
+->relay:AgentName <<<
+Your multi-line message here.
+
+Can include blank lines and code.
+>>>
+```
+
+**CRITICAL:** Always end with `>>>` on its own line!
+
+## Receiving Messages
+
+Messages appear as:
+```
+Relay message from Alice [abc123]: Message content here
+```
+
+If truncated, read full message:
+```bash
+agent-relay read abc123
+```
+
+## Spawning Agents
+
+Spawn workers to delegate tasks:
+
+```
+->relay:spawn WorkerName claude "task description"
+->relay:release WorkerName
+```
+
+## Common Patterns
+
+```
+->relay:* STATUS: Starting work on auth module
+->relay:* DONE: Auth module complete
+->relay:Developer TASK: Implement /api/register
+->relay:Reviewer REVIEW: Please check src/auth/*.ts
+->relay:Architect QUESTION: JWT or sessions?
+```
+
+## Rules
+
+- Pattern must be at line start (whitespace OK)
+- Escape with `\->relay:` to output literally
+- Check daemon status: `agent-relay status`

package/docs/dashboard-v2-plan.md

@@ -0,0 +1,179 @@
+# 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Real-time agent-to-agent communication system",
   "type": "module",
   "main": "dist/index.js",
@@ -20,7 +20,8 @@
   },
   "scripts": {
     "postinstall": "npm rebuild better-sqlite3",
-    "build": "npm run clean && tsc",
+    "build": "npm run clean && tsc && npm run build:frontend",
+    "build:frontend": "esbuild src/dashboard/frontend/app.ts --bundle --outfile=src/dashboard/public/js/app.js --format=esm --target=es2022 --minify --sourcemap",
     "postbuild": "cp -r src/dashboard/public dist/dashboard/ && chmod +x dist/cli/index.js",
     "dev": "tsc -w",
     "dev:local": "npm run build && npm link && echo '✓ agent-relay linked globally'",
@@ -76,7 +77,9 @@
     "@typescript-eslint/eslint-plugin": "^8.18.2",
     "@typescript-eslint/parser": "^8.18.2",
     "@vitest/coverage-v8": "^2.1.8",
+    "esbuild": "^0.24.0",
     "eslint": "^8.57.1",
+    "jsdom": "^25.0.1",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8"
   },