agent-relay 1.2.3 → 1.3.0

package/.trajectories/completed/2026-01/traj_hf81ey93uz6t.json

@@ -0,0 +1,49 @@
+{
+  "id": "traj_hf81ey93uz6t",
+  "version": 1,
+  "task": {
+    "title": "Add sidebar section break between agents and human users"
+  },
+  "status": "completed",
+  "startedAt": "2026-01-07T14:18:40.736Z",
+  "agents": [
+    {
+      "name": "khaliqgant",
+      "role": "lead",
+      "joinedAt": "2026-01-07T14:18:40.736Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_haez0phsckvf",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-07T14:18:53.712Z",
+      "events": [
+        {
+          "ts": 1767795533713,
+          "type": "decision",
+          "content": "Added human users section divider in sidebar when viewing agents/projects: Added human users section divider in sidebar when viewing agents/projects",
+          "raw": {
+            "question": "Added human users section divider in sidebar when viewing agents/projects",
+            "chosen": "Added human users section divider in sidebar when viewing agents/projects",
+            "alternatives": [],
+            "reasoning": "Requested clear separation between agents and human users; border + heading makes the break obvious while keeping team tab intact"
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-07T14:19:04.139Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-07T14:19:04.139Z",
+  "retrospective": {
+    "summary": "Added sidebar section break for human users below agents/projects",
+    "approach": "Standard approach",
+    "confidence": 0.74
+  }
+}

package/.trajectories/completed/2026-01/traj_hf81ey93uz6t.md

@@ -0,0 +1,31 @@
+# Trajectory: Add sidebar section break between agents and human users
+
+> **Status:** ✅ Completed
+> **Confidence:** 74%
+> **Started:** January 7, 2026 at 03:18 PM
+> **Completed:** January 7, 2026 at 03:19 PM
+
+---
+
+## Summary
+
+Added sidebar section break for human users below agents/projects
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Added human users section divider in sidebar when viewing agents/projects
+- **Chose:** Added human users section divider in sidebar when viewing agents/projects
+- **Reasoning:** Requested clear separation between agents and human users; border + heading makes the break obvious while keeping team tab intact
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Added human users section divider in sidebar when viewing agents/projects: Added human users section divider in sidebar when viewing agents/projects

package/.trajectories/completed/2026-01/traj_hfmki2jr9d4r.json

@@ -0,0 +1,65 @@
+{
+  "id": "traj_hfmki2jr9d4r",
+  "version": 1,
+  "task": {
+    "title": "Implement auto workspace access + mobile UI fixes",
+    "source": {
+      "system": "plain",
+      "id": "agent-relay-462"
+    }
+  },
+  "status": "completed",
+  "startedAt": "2026-01-05T23:45:03.470Z",
+  "agents": [
+    {
+      "name": "Lead",
+      "role": "lead",
+      "joinedAt": "2026-01-05T23:45:03.471Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_oltcv5luvqxx",
+      "title": "Initial work",
+      "agentName": "Lead",
+      "startedAt": "2026-01-05T23:45:03.471Z",
+      "events": [
+        {
+          "ts": 1767656918590,
+          "type": "decision",
+          "content": "Moved OnlineUsersIndicator outside fixed header wrapper: Moved OnlineUsersIndicator outside fixed header wrapper",
+          "raw": {
+            "question": "Moved OnlineUsersIndicator outside fixed header wrapper",
+            "chosen": "Moved OnlineUsersIndicator outside fixed header wrapper",
+            "alternatives": [],
+            "reasoning": "OnlineUsersIndicator was inside the fixed header on mobile, causing variable header height. The 52px spacer didn't account for it, cutting off content including LogViewer scroll and ThreadPanel close button. Moving it outside fixes both issues."
+          },
+          "significance": "high"
+        },
+        {
+          "ts": 1767657712589,
+          "type": "decision",
+          "content": "Implemented auto workspace access via GitHub repo permissions: Implemented auto workspace access via GitHub repo permissions",
+          "raw": {
+            "question": "Implemented auto workspace access via GitHub repo permissions",
+            "chosen": "Implemented auto workspace access via GitHub repo permissions",
+            "alternatives": [],
+            "reasoning": "Created checkWorkspaceAccess function and requireWorkspaceAccess middleware. Access checks: 1) Owner, 2) Member, 3) GitHub repo access via Nango. Added 5min in-memory cache for performance. Added GET /api/workspaces/accessible endpoint to list all accessible workspaces."
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-06T00:03:49.311Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "84085b56a3fa",
+  "tags": [],
+  "completedAt": "2026-01-06T00:03:49.311Z",
+  "retrospective": {
+    "summary": "Implemented auto workspace access from GitHub repo permissions. Added checkWorkspaceAccess, requireWorkspaceAccess middleware, GET /api/workspaces/accessible endpoint, and findByGithubFullName db query. Git push blocked by credential issue.",
+    "approach": "Standard approach",
+    "confidence": 0.8
+  }
+}

package/.trajectories/completed/2026-01/traj_hfmki2jr9d4r.md

@@ -0,0 +1,37 @@
+# Trajectory: Implement auto workspace access + mobile UI fixes
+
+> **Status:** ✅ Completed
+> **Task:** agent-relay-462
+> **Confidence:** 80%
+> **Started:** January 5, 2026 at 11:45 PM
+> **Completed:** January 6, 2026 at 12:03 AM
+
+---
+
+## Summary
+
+Implemented auto workspace access from GitHub repo permissions. Added checkWorkspaceAccess, requireWorkspaceAccess middleware, GET /api/workspaces/accessible endpoint, and findByGithubFullName db query. Git push blocked by credential issue.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Moved OnlineUsersIndicator outside fixed header wrapper
+- **Chose:** Moved OnlineUsersIndicator outside fixed header wrapper
+- **Reasoning:** OnlineUsersIndicator was inside the fixed header on mobile, causing variable header height. The 52px spacer didn't account for it, cutting off content including LogViewer scroll and ThreadPanel close button. Moving it outside fixes both issues.
+
+### Implemented auto workspace access via GitHub repo permissions
+- **Chose:** Implemented auto workspace access via GitHub repo permissions
+- **Reasoning:** Created checkWorkspaceAccess function and requireWorkspaceAccess middleware. Access checks: 1) Owner, 2) Member, 3) GitHub repo access via Nango. Added 5min in-memory cache for performance. Added GET /api/workspaces/accessible endpoint to list all accessible workspaces.
+
+---
+
+## Chapters
+
+### 1. Initial work
+*Agent: Lead*
+
+- Moved OnlineUsersIndicator outside fixed header wrapper: Moved OnlineUsersIndicator outside fixed header wrapper
+- Implemented auto workspace access via GitHub repo permissions: Implemented auto workspace access via GitHub repo permissions

package/.trajectories/completed/2026-01/traj_lq450ly148uw.json

@@ -0,0 +1,49 @@
+{
+  "id": "traj_lq450ly148uw",
+  "version": 1,
+  "task": {
+    "title": "Dashboard UI fixes, billing improvements, and settings alignment"
+  },
+  "status": "completed",
+  "startedAt": "2026-01-07T10:07:46.226Z",
+  "agents": [
+    {
+      "name": "default",
+      "role": "lead",
+      "joinedAt": "2026-01-07T10:07:57.932Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_pfmti13b184h",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-07T10:07:57.932Z",
+      "events": [
+        {
+          "ts": 1767780477933,
+          "type": "decision",
+          "content": "Fixed Docker build - copy only specific docs snippet files: Fixed Docker build - copy only specific docs snippet files",
+          "raw": {
+            "question": "Fixed Docker build - copy only specific docs snippet files",
+            "chosen": "Fixed Docker build - copy only specific docs snippet files",
+            "alternatives": [],
+            "reasoning": ".dockerignore excluded docs/ but Dockerfile needed relay snippets. Selective copy cleaner than broad .dockerignore change"
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-07T10:07:58.979Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-07T10:07:58.979Z",
+  "retrospective": {
+    "summary": "Previous session work",
+    "approach": "Standard approach",
+    "confidence": 0.5
+  }
+}

package/.trajectories/completed/2026-01/traj_lq450ly148uw.md

@@ -0,0 +1,31 @@
+# Trajectory: Dashboard UI fixes, billing improvements, and settings alignment
+
+> **Status:** ✅ Completed
+> **Confidence:** 50%
+> **Started:** January 7, 2026 at 11:07 AM
+> **Completed:** January 7, 2026 at 11:07 AM
+
+---
+
+## Summary
+
+Previous session work
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Fixed Docker build - copy only specific docs snippet files
+- **Chose:** Fixed Docker build - copy only specific docs snippet files
+- **Reasoning:** .dockerignore excluded docs/ but Dockerfile needed relay snippets. Selective copy cleaner than broad .dockerignore change
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Fixed Docker build - copy only specific docs snippet files: Fixed Docker build - copy only specific docs snippet files

package/.trajectories/completed/2026-01/traj_multi_server_arch.md

@@ -0,0 +1,101 @@
+# Trajectory: Multi-server architecture document
+
+> **Status:** Completed
+> **Task:** PR-8-update
+> **Started:** January 7, 2026 at 06:00 AM
+> **Completed:** January 7, 2026 at 06:30 AM
+> **Confidence:** 0.9
+
+---
+
+## Summary
+
+Created comprehensive multi-server architecture document that supersedes PR #8's federation proposal with realistic current state analysis, detailed implementation roadmap, and agent-actionable specifications.
+
+---
+
+## Key Decisions
+
+### 1. Cloud as authoritative registry vs quorum consensus
+- **Reasoning:** Simpler than Lamport timestamps/quorum, leverages existing PostgreSQL with atomic INSERT ON CONFLICT
+
+### 2. API keys + TLS vs Ed25519 per-message signing
+- **Reasoning:** Simpler to implement, adequate security for initial deployment, can add per-message signing in v2
+
+### 3. Hybrid topology (Hub discovery + P2P messaging)
+- **Reasoning:** Best of both worlds - hub provides registry sync, P2P provides low latency, hub failure doesn't break existing P2P connections
+
+### 4. Organization-centric model vs user-centric
+- **Reasoning:** Enables team billing ($49/user/month) while maintaining backwards compatibility
+
+---
+
+## Learnings
+
+1. **PR #8 over-engineered some aspects** - Cloud-mediated routing works fine for current scale, P2P is the real gap
+
+2. **Cloud as source of truth eliminates consensus complexity** - No need for Lamport timestamps when you have atomic DB operations
+
+3. **E2E delivery confirmation via capture-pane** is critical - Peer ACKs alone don't confirm agent received message
+
+4. **Bounded queues with drop policies** prevent OOM from slow peers
+
+5. **Hybrid topology is the sweet spot** - Hub for discovery, P2P for messaging, cloud as fallback
+
+---
+
+## Chapters
+
+### 1. Research
+*Agent: default*
+
+- Explored codebase to document what's actually built today
+- Identified CloudSyncService, MultiProjectClient, project groups as existing cross-server capabilities
+- Documented current limitations: cloud-mediated routing (~100-300ms), no P2P, user-centric billing
+
+### 2. Gap Analysis
+*Agent: default*
+
+- Compared PR #8's proposals vs current implementation
+- Identified P2P as main real gap (other proposals over-engineered)
+- Listed 6 gaps with effort estimates totaling 9 weeks
+
+### 3. PR #8 Integration
+*Agent: default*
+
+- Reviewed FEDERATION_PROPOSAL.md and FEDERATION_PROPOSAL_REVIEW.md from PR #8
+- Adopted critical insights: E2E delivery confirmation, message deduplication, backpressure
+- Preserved protocol specification (PEER_HELLO, PEER_ROUTE, etc.)
+
+### 4. Agent Implementation Guide
+*Agent: default*
+
+- Added Section 8 with directly actionable specifications
+- Provided file paths to create/modify for each phase
+- Included complete code examples (database migrations, service classes)
+- Documented edge cases with resolution code
+
+---
+
+## Edge Cases Handled
+
+| Edge Case | Resolution |
+|-----------|------------|
+| User leaves org | Workspaces suspended with 30-day grace period |
+| Org owner tries to leave | Must promote admin first, auto-promote if available |
+| Org deleted | Cascade: cancel Stripe, deregister agents, suspend workspaces, soft delete |
+| Agent name collision | Return helpful error with suggested alternative name |
+| Daemon disconnects | Mark all its agents offline |
+| Cloud unavailable during P2P discovery | Fall back to cached peer list, then cloud-only routing |
+| Both peers connect simultaneously | Deterministic winner by daemon ID comparison |
+| Message in flight when connection drops | Re-queue for P2P retry or cloud fallback |
+
+---
+
+## Files Changed
+
+- `docs/MULTI_SERVER_ARCHITECTURE.md` - Created (1200+ lines)
+
+---
+
+*Trajectory completed 2026-01-07*

package/.trajectories/completed/2026-01/traj_psd9ob0j2ru3.json

@@ -0,0 +1,27 @@
+{
+  "id": "traj_psd9ob0j2ru3",
+  "version": 1,
+  "task": {
+    "title": "Clarify codex rule file location and spawn behavior"
+  },
+  "status": "completed",
+  "startedAt": "2026-01-07T12:37:16.374Z",
+  "agents": [
+    {
+      "name": "khaliqgant",
+      "role": "lead",
+      "joinedAt": "2026-01-07T12:37:16.389Z"
+    }
+  ],
+  "chapters": [],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-07T12:40:48.197Z",
+  "retrospective": {
+    "summary": "Clarified codex config location and upgrade cause",
+    "approach": "Standard approach",
+    "confidence": 0.68
+  }
+}

package/.trajectories/completed/2026-01/traj_psd9ob0j2ru3.md

@@ -0,0 +1,14 @@
+# Trajectory: Clarify codex rule file location and spawn behavior
+
+> **Status:** ✅ Completed
+> **Confidence:** 68%
+> **Started:** January 7, 2026 at 01:37 PM
+> **Completed:** January 7, 2026 at 01:40 PM
+
+---
+
+## Summary
+
+Clarified codex config location and upgrade cause
+
+**Approach:** Standard approach

package/.trajectories/completed/2026-01/traj_ub8csuv3lcv4.json

@@ -0,0 +1,53 @@
+{
+  "id": "traj_ub8csuv3lcv4",
+  "version": 1,
+  "task": {
+    "title": "Fix WebSocket disconnections for workspace instances",
+    "source": {
+      "system": "plain",
+      "id": "workspace-websocket-stability"
+    }
+  },
+  "status": "completed",
+  "startedAt": "2026-01-06T18:13:23.603Z",
+  "agents": [
+    {
+      "name": "default",
+      "role": "lead",
+      "joinedAt": "2026-01-06T18:13:35.723Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_e4vj0j8ig7ma",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-06T18:13:35.723Z",
+      "events": [
+        {
+          "ts": 1767723215725,
+          "type": "decision",
+          "content": "Add ping/pong keepalive to main and bridge WebSockets: Add ping/pong keepalive to main and bridge WebSockets",
+          "raw": {
+            "question": "Add ping/pong keepalive to main and bridge WebSockets",
+            "chosen": "Add ping/pong keepalive to main and bridge WebSockets",
+            "alternatives": [],
+            "reasoning": "Main dashboard and bridge WebSocket endpoints were missing ping/pong keepalive, while logs and presence endpoints had it. Without keepalive, TCP/proxy timeouts kill idle connections (typically 60-120s)."
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-06T18:16:51.462Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/home/user/relay",
+  "tags": [],
+  "completedAt": "2026-01-06T18:16:51.462Z",
+  "retrospective": {
+    "summary": "Added ping/pong keepalive to main and bridge WebSockets to fix connection instability",
+    "approach": "Standard approach",
+    "confidence": 0.9
+  }
+}

package/.trajectories/completed/2026-01/traj_ub8csuv3lcv4.md

@@ -0,0 +1,32 @@
+# Trajectory: Fix WebSocket disconnections for workspace instances
+
+> **Status:** ✅ Completed
+> **Task:** workspace-websocket-stability
+> **Confidence:** 90%
+> **Started:** January 6, 2026 at 06:13 PM
+> **Completed:** January 6, 2026 at 06:16 PM
+
+---
+
+## Summary
+
+Added ping/pong keepalive to main and bridge WebSockets to fix connection instability
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Add ping/pong keepalive to main and bridge WebSockets
+- **Chose:** Add ping/pong keepalive to main and bridge WebSockets
+- **Reasoning:** Main dashboard and bridge WebSocket endpoints were missing ping/pong keepalive, while logs and presence endpoints had it. Without keepalive, TCP/proxy timeouts kill idle connections (typically 60-120s).
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Add ping/pong keepalive to main and bridge WebSockets: Add ping/pong keepalive to main and bridge WebSockets