feat: add first-class user messaging with channels and DMs

.trajectories/completed/2026-01/traj_v9dkdoxylyid.json

@@ -0,0 +1,89 @@
+{
+  "id": "traj_v9dkdoxylyid",
+  "version": 1,
+  "task": {
+    "title": "Implement first-class user messaging with channels and DMs",
+    "source": {
+      "system": "plain",
+      "id": "user-messaging-feature"
+    }
+  },
+  "status": "completed",
+  "startedAt": "2026-01-06T17:11:57.504Z",
+  "agents": [
+    {
+      "name": "default",
+      "role": "lead",
+      "joinedAt": "2026-01-06T17:12:09.617Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_u095g4higo8q",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-06T17:12:09.617Z",
+      "events": [
+        {
+          "ts": 1767719529619,
+          "type": "decision",
+          "content": "Chose unified relay daemon approach over WebSocket-only: Chose unified relay daemon approach over WebSocket-only",
+          "raw": {
+            "question": "Chose unified relay daemon approach over WebSocket-only",
+            "chosen": "Chose unified relay daemon approach over WebSocket-only",
+            "alternatives": [],
+            "reasoning": "Enables consistent message routing for both users and agents, supports future features like message persistence and cross-project messaging"
+          },
+          "significance": "high"
+        },
+        {
+          "ts": 1767719541811,
+          "type": "decision",
+          "content": "Added EntityType to protocol: Added EntityType to protocol",
+          "raw": {
+            "question": "Added EntityType to protocol",
+            "chosen": "Added EntityType to protocol",
+            "alternatives": [],
+            "reasoning": "Distinguishes 'user' (human) from 'agent' (AI) entities for proper routing and UI display"
+          },
+          "significance": "high"
+        },
+        {
+          "ts": 1767719549146,
+          "type": "decision",
+          "content": "DM channels use 'dm:alice:bob' naming convention with sorted names: DM channels use 'dm:alice:bob' naming convention with sorted names",
+          "raw": {
+            "question": "DM channels use 'dm:alice:bob' naming convention with sorted names",
+            "chosen": "DM channels use 'dm:alice:bob' naming convention with sorted names",
+            "alternatives": [],
+            "reasoning": "Ensures consistent channel naming regardless of who initiates the DM"
+          },
+          "significance": "high"
+        },
+        {
+          "ts": 1767719563124,
+          "type": "decision",
+          "content": "Created UserBridge to bridge WebSocket users to relay daemon: Created UserBridge to bridge WebSocket users to relay daemon",
+          "raw": {
+            "question": "Created UserBridge to bridge WebSocket users to relay daemon",
+            "chosen": "Created UserBridge to bridge WebSocket users to relay daemon",
+            "alternatives": [],
+            "reasoning": "Clean separation of concerns - dashboard server handles WebSocket, UserBridge creates relay client per user for unified messaging"
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-06T17:12:56.919Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/home/user/relay",
+  "tags": [],
+  "completedAt": "2026-01-06T17:12:56.919Z",
+  "retrospective": {
+    "summary": "Implemented first-class user messaging: EntityType protocol extension, channel join/leave/message routing in daemon, UserBridge for dashboard-relay integration, REST API endpoints, and React components (useChannels hook, ChannelSidebar, ChannelChat). All 1030 tests passing.",
+    "approach": "Standard approach",
+    "confidence": 0.85
+  }
+}

.trajectories/completed/2026-01/traj_v9dkdoxylyid.md

@@ -0,0 +1,47 @@
+# Trajectory: Implement first-class user messaging with channels and DMs
+
+> **Status:** ✅ Completed
+> **Task:** user-messaging-feature
+> **Confidence:** 85%
+> **Started:** January 6, 2026 at 05:11 PM
+> **Completed:** January 6, 2026 at 05:12 PM
+
+---
+
+## Summary
+
+Implemented first-class user messaging: EntityType protocol extension, channel join/leave/message routing in daemon, UserBridge for dashboard-relay integration, REST API endpoints, and React components (useChannels hook, ChannelSidebar, ChannelChat). All 1030 tests passing.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Chose unified relay daemon approach over WebSocket-only
+- **Chose:** Chose unified relay daemon approach over WebSocket-only
+- **Reasoning:** Enables consistent message routing for both users and agents, supports future features like message persistence and cross-project messaging
+
+### Added EntityType to protocol
+- **Chose:** Added EntityType to protocol
+- **Reasoning:** Distinguishes 'user' (human) from 'agent' (AI) entities for proper routing and UI display
+
+### DM channels use 'dm:alice:bob' naming convention with sorted names
+- **Chose:** DM channels use 'dm:alice:bob' naming convention with sorted names
+- **Reasoning:** Ensures consistent channel naming regardless of who initiates the DM
+
+### Created UserBridge to bridge WebSocket users to relay daemon
+- **Chose:** Created UserBridge to bridge WebSocket users to relay daemon
+- **Reasoning:** Clean separation of concerns - dashboard server handles WebSocket, UserBridge creates relay client per user for unified messaging
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Chose unified relay daemon approach over WebSocket-only: Chose unified relay daemon approach over WebSocket-only
+- Added EntityType to protocol: Added EntityType to protocol
+- DM channels use 'dm:alice:bob' naming convention with sorted names: DM channels use 'dm:alice:bob' naming convention with sorted names
+- Created UserBridge to bridge WebSocket users to relay daemon: Created UserBridge to bridge WebSocket users to relay daemon

.trajectories/index.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "lastUpdated": "2026-01-06T16:24:50.254Z",
+  "lastUpdated": "2026-01-06T17:12:56.941Z",
   "trajectories": {
     "traj_ozd98si6a7ns": {
       "title": "Fix thinking indicator showing on all messages",
@@ -358,6 +358,13 @@
       "startedAt": "2026-01-06T16:24:13.901Z",
       "completedAt": "2026-01-06T16:24:50.235Z",
       "path": "/home/user/relay/.trajectories/completed/2026-01/traj_78ffm31jn3uk.json"
+    },
+    "traj_v9dkdoxylyid": {
+      "title": "Implement first-class user messaging with channels and DMs",
+      "status": "completed",
+      "startedAt": "2026-01-06T17:11:57.504Z",
+      "completedAt": "2026-01-06T17:12:56.919Z",
+      "path": "/home/user/relay/.trajectories/completed/2026-01/traj_v9dkdoxylyid.json"
     }
   }
 }

src/cloud/api/onboarding.ts

@@ -317,7 +317,7 @@ onboardingRouter.post('/cli/:provider/complete/:sessionId', async (req: Request,
   try {
     let accessToken = token || session.token;
     let refreshToken = session.refreshToken;
-    let tokenExpiresAt = session.tokenExpiresAt;
+    let _tokenExpiresAt = session.tokenExpiresAt;
 
     // If using workspace delegation, forward complete request first
     if (session.workspaceUrl && session.workspaceSessionId) {
@@ -364,7 +364,7 @@ onboardingRouter.post('/cli/:provider/complete/:sessionId', async (req: Request,
               accessToken = creds.token;
               refreshToken = creds.refreshToken;
               if (creds.tokenExpiresAt) {
-                tokenExpiresAt = new Date(creds.tokenExpiresAt);
+                _tokenExpiresAt = new Date(creds.tokenExpiresAt);
               }
               console.log('[onboarding] Fetched credentials from workspace:', {
                 hasToken: !!accessToken,