agent-relay 1.2.0 → 1.3.0

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

@@ -0,0 +1,82 @@
+# Trajectory: Backend developer session - waiting for Lead tasks
+
+> **Status:** ✅ Completed
+> **Confidence:** 90%
+> **Started:** January 3, 2026 at 12:26 PM
+> **Completed:** January 3, 2026 at 12:54 PM
+
+---
+
+## Summary
+
+Fixed LogViewer panel: collapsible header (compact default), spacing improvements (reduced padding, empty line filtering), Codex parsing (enhanced ANSI stripping, spinner fragment filtering)
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### CORS fix already implemented in ae30e62
+- **Chose:** CORS fix already implemented in ae30e62
+- **Reasoning:** Reviewed code: secure by default (empty config blocks cross-origin), configurable via allowedOrigins/env var, proper origin reflection instead of literal *, 403 blocking with logging, Vary header for caching
+
+### Add allowSpawn config to PtyWrapper
+- **Chose:** Add allowSpawn config to PtyWrapper
+- **Reasoning:** Spawned agents get dashboardPort which enables spawn commands. Fix by adding explicit allowSpawn flag that defaults to false for spawned workers.
+
+### Feature already implemented
+- **Chose:** Feature already implemented
+- **Reasoning:** Found commit 5763cd2 that fully implemented agent-relay-gst2. All layers (router, storage, dashboard-server, frontend) have complete ACK status tracking.
+
+### Starting agent-relay-325
+- **Chose:** Starting agent-relay-325
+- **Reasoning:** Moving from completed gst2 to new task: repo context indicator in header
+
+### Stricter spawn command parsing
+- **Chose:** Stricter spawn command parsing
+- **Reasoning:** Require: (1) command at line start, (2) PascalCase agent name, (3) known CLI type. Prevents matching documentation text.
+
+### Created RepoContextHeader component
+- **Chose:** Created RepoContextHeader component
+- **Reasoning:** Implemented Slack-style repo context indicator with dropdown for quick project switching. Integrated into Header.tsx with proper callbacks.
+
+### Fixed fleet agent double-counting
+- **Chose:** Fixed fleet agent double-counting
+- **Reasoning:** Root cause: /api/fleet/servers counted agents from both local daemon AND bridge projects. When bridge is active, the same agents appear in both places. Fix: Only add local daemon entry when no bridge projects exist.
+
+### Fixed LogViewer panel with three improvements: collapsible header, spacing reduction, and Codex parsing
+- **Chose:** Fixed LogViewer panel with three improvements: collapsible header, spacing reduction, and Codex parsing
+- **Reasoning:** Task agent-relay-445 required fixing spacing issues and extra characters in log output
+
+### Added collapsible header with compact default view
+- **Chose:** Added collapsible header with compact default view
+- **Reasoning:** Reduces visual noise in log panel, users can expand if needed
+
+### Fixed spacing by reducing padding py-1 to py-0.5 and filtering empty lines
+- **Chose:** Fixed spacing by reducing padding py-1 to py-0.5 and filtering empty lines
+- **Reasoning:** Denser log display shows more content, empty lines were cluttering the view
+
+### Enhanced ANSI stripping for Codex parsing - added DCS, backspace, spinner fragment filtering
+- **Chose:** Enhanced ANSI stripping for Codex parsing - added DCS, backspace, spinner fragment filtering
+- **Reasoning:** Codex output includes spinner animations that were being rendered as fragments
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- CORS fix already implemented in ae30e62: CORS fix already implemented in ae30e62
+- Add allowSpawn config to PtyWrapper: Add allowSpawn config to PtyWrapper
+- Feature already implemented: Feature already implemented
+- Starting agent-relay-325: Starting agent-relay-325
+- Stricter spawn command parsing: Stricter spawn command parsing
+- Created RepoContextHeader component: Created RepoContextHeader component
+- Started agent-relay-442 to add tests for Vault and billing: Started agent-relay-442 to add tests for Vault and billing
+- Fixed fleet agent double-counting: Fixed fleet agent double-counting
+- Fixed LogViewer panel with three improvements: collapsible header, spacing reduction, and Codex parsing: Fixed LogViewer panel with three improvements: collapsible header, spacing reduction, and Codex parsing
+- Added collapsible header with compact default view: Added collapsible header with compact default view
+- Fixed spacing by reducing padding py-1 to py-0.5 and filtering empty lines: Fixed spacing by reducing padding py-1 to py-0.5 and filtering empty lines
+- Enhanced ANSI stripping for Codex parsing - added DCS, backspace, spinner fragment filtering: Enhanced ANSI stripping for Codex parsing - added DCS, backspace, spinner fragment filtering

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

@@ -0,0 +1,65 @@
+{
+  "id": "traj_xy9vifpqet80",
+  "version": 1,
+  "task": {
+    "title": "Extract BaseWrapper from PtyWrapper and TmuxWrapper",
+    "source": {
+      "system": "plain",
+      "id": "agent-relay-wrap1"
+    }
+  },
+  "status": "completed",
+  "startedAt": "2026-01-06T12:27:13.004Z",
+  "agents": [
+    {
+      "name": "khaliqgant",
+      "role": "lead",
+      "joinedAt": "2026-01-06T12:27:13.007Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_8t7vbaqwiz3f",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-06T12:27:45.698Z",
+      "events": [
+        {
+          "ts": 1767702465699,
+          "type": "decision",
+          "content": "Using abstract class with protected methods for shared implementation: Using abstract class with protected methods for shared implementation",
+          "raw": {
+            "question": "Using abstract class with protected methods for shared implementation",
+            "chosen": "Using abstract class with protected methods for shared implementation",
+            "alternatives": [],
+            "reasoning": "Allows subclasses to override while providing default behavior"
+          },
+          "significance": "high"
+        },
+        {
+          "ts": 1767703025592,
+          "type": "decision",
+          "content": "Created BaseWrapper abstract class with comprehensive tests: Created BaseWrapper abstract class with comprehensive tests",
+          "raw": {
+            "question": "Created BaseWrapper abstract class with comprehensive tests",
+            "chosen": "Created BaseWrapper abstract class with comprehensive tests",
+            "alternatives": [],
+            "reasoning": "Extracted shared functionality from PtyWrapper/TmuxWrapper into base class. Tests cover message queue, spawn/release, continuity, and relay command handling."
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-06T12:58:24.003Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-06T12:58:24.003Z",
+  "retrospective": {
+    "summary": "Extracted BaseWrapper abstract class from PtyWrapper and TmuxWrapper using TDD approach. Created 29 new tests, removed ~900 lines of duplicate code, both wrappers now inherit shared functionality.",
+    "approach": "Standard approach",
+    "confidence": 0.9
+  }
+}

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

@@ -0,0 +1,37 @@
+# Trajectory: Extract BaseWrapper from PtyWrapper and TmuxWrapper
+
+> **Status:** ✅ Completed
+> **Task:** agent-relay-wrap1
+> **Confidence:** 90%
+> **Started:** January 6, 2026 at 01:27 PM
+> **Completed:** January 6, 2026 at 01:58 PM
+
+---
+
+## Summary
+
+Extracted BaseWrapper abstract class from PtyWrapper and TmuxWrapper using TDD approach. Created 29 new tests, removed ~900 lines of duplicate code, both wrappers now inherit shared functionality.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Using abstract class with protected methods for shared implementation
+- **Chose:** Using abstract class with protected methods for shared implementation
+- **Reasoning:** Allows subclasses to override while providing default behavior
+
+### Created BaseWrapper abstract class with comprehensive tests
+- **Chose:** Created BaseWrapper abstract class with comprehensive tests
+- **Reasoning:** Extracted shared functionality from PtyWrapper/TmuxWrapper into base class. Tests cover message queue, spawn/release, continuity, and relay command handling.
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Using abstract class with protected methods for shared implementation: Using abstract class with protected methods for shared implementation
+- Created BaseWrapper abstract class with comprehensive tests: Created BaseWrapper abstract class with comprehensive tests

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

@@ -0,0 +1,49 @@
+{
+  "id": "traj_y7aiwijyfmmv",
+  "version": 1,
+  "task": {
+    "title": "Fix CLI hanging - add auth check endpoint"
+  },
+  "status": "completed",
+  "startedAt": "2026-01-07T10:19:49.851Z",
+  "agents": [
+    {
+      "name": "khaliqgant",
+      "role": "lead",
+      "joinedAt": "2026-01-07T10:19:49.852Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_brksv0oi98s5",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-07T10:19:49.908Z",
+      "events": [
+        {
+          "ts": 1767781189908,
+          "type": "decision",
+          "content": "Add /auth/cli/openai/check endpoint to workspace daemon: Add /auth/cli/openai/check endpoint to workspace daemon",
+          "raw": {
+            "question": "Add /auth/cli/openai/check endpoint to workspace daemon",
+            "chosen": "Add /auth/cli/openai/check endpoint to workspace daemon",
+            "alternatives": [],
+            "reasoning": "CLI was hanging because it polls this endpoint to detect auth completion, but it didn't exist. Added check for ~/.codex/auth.json credentials file."
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-07T10:19:49.966Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-07T10:19:49.966Z",
+  "retrospective": {
+    "summary": "Added missing /auth/cli/openai/check endpoint to workspace daemon server.ts. CLI polls this to detect when Codex OAuth completes.",
+    "approach": "Standard approach",
+    "confidence": 0.9
+  }
+}

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

@@ -0,0 +1,31 @@
+# Trajectory: Fix CLI hanging - add auth check endpoint
+
+> **Status:** ✅ Completed
+> **Confidence:** 90%
+> **Started:** January 7, 2026 at 11:19 AM
+> **Completed:** January 7, 2026 at 11:19 AM
+
+---
+
+## Summary
+
+Added missing /auth/cli/openai/check endpoint to workspace daemon server.ts. CLI polls this to detect when Codex OAuth completes.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Add /auth/cli/openai/check endpoint to workspace daemon
+- **Chose:** Add /auth/cli/openai/check endpoint to workspace daemon
+- **Reasoning:** CLI was hanging because it polls this endpoint to detect auth completion, but it didn't exist. Added check for ~/.codex/auth.json credentials file.
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Add /auth/cli/openai/check endpoint to workspace daemon: Add /auth/cli/openai/check endpoint to workspace daemon

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

@@ -0,0 +1,47 @@
+{
+  "id": "traj_ysjc8zaeqtd3",
+  "version": 1,
+  "task": {
+    "title": "Add recent repos quick access",
+    "source": {
+      "system": "plain",
+      "id": "agent-relay-327"
+    }
+  },
+  "status": "completed",
+  "startedAt": "2026-01-03T13:31:22.891Z",
+  "agents": [],
+  "chapters": [
+    {
+      "id": "chap_0nd8brwg8jll",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-03T13:33:03.932Z",
+      "events": [
+        {
+          "ts": 1767447183933,
+          "type": "decision",
+          "content": "Modified autoSave to accept SESSION_END data and create handoff from it when ledger is empty: Modified autoSave to accept SESSION_END data and create handoff from it when ledger is empty",
+          "raw": {
+            "question": "Modified autoSave to accept SESSION_END data and create handoff from it when ledger is empty",
+            "chosen": "Modified autoSave to accept SESSION_END data and create handoff from it when ledger is empty",
+            "alternatives": [],
+            "reasoning": "Root cause: autoSave created handoff from ledger which was empty when agent didn't use ->continuity:save. Fix: use SESSION_END JSON content to populate handoff directly."
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-03T13:33:18.061Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-03T13:33:18.061Z",
+  "retrospective": {
+    "summary": "Fixed empty continuity handoff files by passing SESSION_END JSON content to autoSave. Modified ContinuityManager.autoSave to accept optional sessionEndData and use it to populate handoff when ledger is empty. Updated both pty-wrapper.ts and tmux-wrapper.ts to store and pass sessionEndData.",
+    "approach": "Standard approach",
+    "confidence": 0.9
+  }
+}

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

@@ -0,0 +1,32 @@
+# Trajectory: Add recent repos quick access
+
+> **Status:** ✅ Completed
+> **Task:** agent-relay-327
+> **Confidence:** 90%
+> **Started:** January 3, 2026 at 02:31 PM
+> **Completed:** January 3, 2026 at 02:33 PM
+
+---
+
+## Summary
+
+Fixed empty continuity handoff files by passing SESSION_END JSON content to autoSave. Modified ContinuityManager.autoSave to accept optional sessionEndData and use it to populate handoff when ledger is empty. Updated both pty-wrapper.ts and tmux-wrapper.ts to store and pass sessionEndData.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Modified autoSave to accept SESSION_END data and create handoff from it when ledger is empty
+- **Chose:** Modified autoSave to accept SESSION_END data and create handoff from it when ledger is empty
+- **Reasoning:** Root cause: autoSave created handoff from ledger which was empty when agent didn't use ->continuity:save. Fix: use SESSION_END JSON content to populate handoff directly.
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Modified autoSave to accept SESSION_END data and create handoff from it when ledger is empty: Modified autoSave to accept SESSION_END data and create handoff from it when ledger is empty

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

@@ -0,0 +1,59 @@
+{
+  "id": "traj_yvdadtvdgnz3",
+  "version": 1,
+  "task": {
+    "title": "Full cloud e2e flow review",
+    "source": {
+      "system": "plain",
+      "id": "cloud-review"
+    }
+  },
+  "status": "completed",
+  "startedAt": "2026-01-03T19:17:32.797Z",
+  "agents": [],
+  "chapters": [
+    {
+      "id": "chap_vjlhnvwxq9eo",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-03T19:21:54.982Z",
+      "events": [
+        {
+          "ts": 1767468114983,
+          "type": "decision",
+          "content": "Multi-repo spawning uses workspace root, not specific repo: Multi-repo spawning uses workspace root, not specific repo",
+          "raw": {
+            "question": "Multi-repo spawning uses workspace root, not specific repo",
+            "chosen": "Multi-repo spawning uses workspace root, not specific repo",
+            "alternatives": [],
+            "reasoning": "When agents spawn, cwd is /workspace (where all repos live), not /workspace/repo-name. This is acceptable for MVP - tasks can specify which repo to work on, and agents can cd into the right directory."
+          },
+          "significance": "high"
+        },
+        {
+          "ts": 1767468129191,
+          "type": "decision",
+          "content": "Repo sync limited to 100 repos: Repo sync limited to 100 repos",
+          "raw": {
+            "question": "Repo sync limited to 100 repos",
+            "chosen": "Repo sync limited to 100 repos",
+            "alternatives": [],
+            "reasoning": "listGithubAppRepos only fetches first 100 repos from GitHub API. This is a known limitation - users with >100 repos won't see all of them. Acceptable for MVP, can add pagination later."
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-03T19:22:22.762Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/home/user/relay",
+  "tags": [],
+  "completedAt": "2026-01-03T19:22:22.762Z",
+  "retrospective": {
+    "summary": "Full cloud e2e flow review complete. Flow is viable for MVP with minor limitations: 100 repo max, multi-repo spawns to workspace root. Key pieces verified: Nango OAuth, GitHub App tokens, vault credentials, workspace provisioning, entrypoint cloning, credential file creation, spawn mechanism.",
+    "approach": "Standard approach",
+    "confidence": 0.85
+  }
+}

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

@@ -0,0 +1,37 @@
+# Trajectory: Full cloud e2e flow review
+
+> **Status:** ✅ Completed
+> **Task:** cloud-review
+> **Confidence:** 85%
+> **Started:** January 3, 2026 at 07:17 PM
+> **Completed:** January 3, 2026 at 07:22 PM
+
+---
+
+## Summary
+
+Full cloud e2e flow review complete. Flow is viable for MVP with minor limitations: 100 repo max, multi-repo spawns to workspace root. Key pieces verified: Nango OAuth, GitHub App tokens, vault credentials, workspace provisioning, entrypoint cloning, credential file creation, spawn mechanism.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Multi-repo spawning uses workspace root, not specific repo
+- **Chose:** Multi-repo spawning uses workspace root, not specific repo
+- **Reasoning:** When agents spawn, cwd is /workspace (where all repos live), not /workspace/repo-name. This is acceptable for MVP - tasks can specify which repo to work on, and agents can cd into the right directory.
+
+### Repo sync limited to 100 repos
+- **Chose:** Repo sync limited to 100 repos
+- **Reasoning:** listGithubAppRepos only fetches first 100 repos from GitHub API. This is a known limitation - users with >100 repos won't see all of them. Acceptable for MVP, can add pagination later.
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Multi-repo spawning uses workspace root, not specific repo: Multi-repo spawning uses workspace root, not specific repo
+- Repo sync limited to 100 repos: Repo sync limited to 100 repos

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

@@ -0,0 +1,53 @@
+{
+  "id": "traj_z0vcw1wrzide",
+  "version": 1,
+  "task": {
+    "title": "Fix trajectory agents array population",
+    "source": {
+      "system": "plain",
+      "id": "agent-relay-452"
+    }
+  },
+  "status": "completed",
+  "startedAt": "2026-01-03T13:37:00.860Z",
+  "agents": [
+    {
+      "name": "CodexAgent",
+      "role": "lead",
+      "joinedAt": "2026-01-03T13:37:00.861Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_a5lre0y29y5x",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-03T13:37:45.874Z",
+      "events": [
+        {
+          "ts": 1767447465875,
+          "type": "decision",
+          "content": "Patched trail start to record initiating agent: Patched trail start to record initiating agent",
+          "raw": {
+            "question": "Patched trail start to record initiating agent",
+            "chosen": "Patched trail start to record initiating agent",
+            "alternatives": [],
+            "reasoning": "Agents array was empty; added agent capture and regression test"
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-03T13:38:16.320Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-03T13:38:16.320Z",
+  "retrospective": {
+    "summary": "Patched trail start to record initiating agent and added regression test + postinstall patch",
+    "approach": "Standard approach",
+    "confidence": 0.89
+  }
+}

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

@@ -0,0 +1,32 @@
+# Trajectory: Fix trajectory agents array population
+
+> **Status:** ✅ Completed
+> **Task:** agent-relay-452
+> **Confidence:** 89%
+> **Started:** January 3, 2026 at 02:37 PM
+> **Completed:** January 3, 2026 at 02:38 PM
+
+---
+
+## Summary
+
+Patched trail start to record initiating agent and added regression test + postinstall patch
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Patched trail start to record initiating agent
+- **Chose:** Patched trail start to record initiating agent
+- **Reasoning:** Agents array was empty; added agent capture and regression test
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Patched trail start to record initiating agent: Patched trail start to record initiating agent

package/.trajectories/consolidate-settings-panel.md

@@ -0,0 +1,24 @@
+# Trajectory: Consolidate settings panel and create PR
+
+> **Status:** ✅ Completed
+> **Confidence:** 90%
+> **Started:** January 6, 2026 at 12:40 PM
+> **Completed:** January 6, 2026 at 12:41 PM
+
+---
+
+## Summary
+
+Settings panel consolidation PR exists as #78. Pushed additional commit (7429eb7) with types.ts. GitHub auth working via git-credential-relay helper.
+
+**Approach:** Standard approach
+
+---
+
+## Chapters
+
+### 1. Initial work
+*Agent: Fullstack*
+
+- PR may already exist from previous session, branch was pushed successfully: PR may already exist from previous session, branch was pushed successfully
+

package/.trajectories/gh-cli-user-token.md

@@ -0,0 +1,26 @@
+# Trajectory: Investigate gh CLI auth solution for agents
+
+> **Status:** ✅ Completed
+> **Confidence:** 85%
+> **Started:** January 6, 2026 at 12:44 PM
+> **Completed:** January 6, 2026 at 01:10 PM
+
+---
+
+## Summary
+
+Created PR #79 to fix gh CLI auth. Updates git.ts to use user login connection (GITHUB_USER) for userToken. Also created ~/.local/bin/gh-relay wrapper that uses userToken with GH_TOKEN env var.
+
+**Approach:** Standard approach
+
+---
+
+## Chapters
+
+### 1. Initial work
+*Agent: Fullstack*
+
+- API currently returns same token for both 'token' and 'userToken' - both are GitHub App installation tokens (ghs_*): API currently returns same token for both 'token' and 'userToken' - both are GitHub App installation tokens (ghs_*)
+- Issue identified: getGithubUserOAuthToken returns installation token (ghs_*) instead of user OAuth token (gho_*). gh CLI needs user OAuth token for full API access.: Issue identified: getGithubUserOAuthToken returns installation token (ghs_*) instead of user OAuth token (gho_*). gh CLI needs user OAuth token for full API access.
+- API still returns same token - code change not deployed yet. Need to verify user has login connection (users.nangoConnectionId) and that GITHUB_USER integration returns gho_* OAuth token: API still returns same token - code change not deployed yet. Need to verify user has login connection (users.nangoConnectionId) and that GITHUB_USER integration returns gho_* OAuth token
+