feat: add browser and github workflow primitives

.github/workflows/publish.yml

@@ -503,6 +503,8 @@ jobs:
           - brand
           - gateway
           - credential-proxy
+          - github-primitive
+          - browser-primitive
 
     steps:
       - name: Checkout code

.trajectories/completed/2026-04/traj_05xg7j388bc4.json

@@ -0,0 +1,53 @@
+{
+  "id": "traj_05xg7j388bc4",
+  "version": 1,
+  "task": {
+    "title": "Add browser workflow step integration"
+  },
+  "status": "completed",
+  "startedAt": "2026-04-10T14:56:33.229Z",
+  "agents": [
+    {
+      "name": "default",
+      "role": "lead",
+      "joinedAt": "2026-04-10T15:05:09.082Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_bmb65cpsvqen",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-04-10T15:05:09.082Z",
+      "events": [
+        {
+          "ts": 1775833509083,
+          "type": "decision",
+          "content": "Implemented Browser primitive as SDK integration step: Implemented Browser primitive as SDK integration step",
+          "raw": {
+            "question": "Implemented Browser primitive as SDK integration step",
+            "chosen": "Implemented Browser primitive as SDK integration step",
+            "alternatives": [],
+            "reasoning": "The SDK runner already delegates type: integration steps through executeIntegrationStep, so the Browser primitive can plug in without changing DAG scheduling or runner internals."
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-04-10T15:05:14.660Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/AgentWorkforce/relay",
+  "tags": [],
+  "_trace": {
+    "startRef": "e3853a983feca165c17142f740487172dced606e",
+    "endRef": "e3853a983feca165c17142f740487172dced606e"
+  },
+  "completedAt": "2026-04-10T15:05:14.660Z",
+  "retrospective": {
+    "summary": "Added Browser primitive workflow-step integration, MCP JSON-RPC server, package exports, build artifacts, and workflow example.",
+    "approach": "Standard approach",
+    "confidence": 0.86
+  }
+}

.trajectories/completed/2026-04/traj_05xg7j388bc4.md

@@ -0,0 +1,31 @@
+# Trajectory: Add browser workflow step integration
+
+> **Status:** ✅ Completed
+> **Confidence:** 86%
+> **Started:** April 10, 2026 at 04:56 PM
+> **Completed:** April 10, 2026 at 05:05 PM
+
+---
+
+## Summary
+
+Added Browser primitive workflow-step integration, MCP JSON-RPC server, package exports, build artifacts, and workflow example.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Implemented Browser primitive as SDK integration step
+- **Chose:** Implemented Browser primitive as SDK integration step
+- **Reasoning:** The SDK runner already delegates type: integration steps through executeIntegrationStep, so the Browser primitive can plug in without changing DAG scheduling or runner internals.
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Implemented Browser primitive as SDK integration step: Implemented Browser primitive as SDK integration step

.trajectories/completed/2026-04/traj_0t92gxaz6igh.json

@@ -50,4 +50,4 @@
     "approach": "Standard approach",
     "confidence": 0.78
   }
-}
+}

.trajectories/completed/2026-04/traj_0t92gxaz6igh.md

@@ -18,6 +18,7 @@ Moved docs navigation into the hamburger menu on mobile, hid the separate mobile
 ## Key Decisions
 
 ### Collapsed the mobile docs sidebar into the hamburger menu instead of rendering it above the content rail
+
 - **Chose:** Collapsed the mobile docs sidebar into the hamburger menu instead of rendering it above the content rail
 - **Reasoning:** On small screens the left rail consumes vertical space and duplicates navigation. Passing a mobile-only DocsNav into SiteNav keeps the docs tree available from the existing hamburger while preserving the desktop sidebar unchanged.
 
@@ -26,6 +27,7 @@ Moved docs navigation into the hamburger menu on mobile, hid the separate mobile
 ## Chapters
 
 ### 1. Work
-*Agent: default*
+
+_Agent: default_
 
 - Collapsed the mobile docs sidebar into the hamburger menu instead of rendering it above the content rail: Collapsed the mobile docs sidebar into the hamburger menu instead of rendering it above the content rail

.trajectories/completed/2026-04/traj_4zqhfqw7g28l.json

@@ -50,4 +50,4 @@
     "approach": "Standard approach",
     "confidence": 0.95
   }
-}
+}

.trajectories/completed/2026-04/traj_4zqhfqw7g28l.md

@@ -18,6 +18,7 @@ Confirmed GitHub Actions deploy failed because SST tried to create a CloudFront
 ## Key Decisions
 
 ### Identified deploy failure as CloudFront CNAME conflict on production web domain
+
 - **Chose:** Identified deploy failure as CloudFront CNAME conflict on production web domain
 - **Reasoning:** GitHub Actions logs show sst deploy failed in WebCdnDistribution creation with AWS CloudFront 409 CNAMEAlreadyExists after the Next.js build completed successfully.
 
@@ -26,6 +27,7 @@ Confirmed GitHub Actions deploy failed because SST tried to create a CloudFront
 ## Chapters
 
 ### 1. Work
-*Agent: default*
+
+_Agent: default_
 
 - Identified deploy failure as CloudFront CNAME conflict on production web domain: Identified deploy failure as CloudFront CNAME conflict on production web domain

.trajectories/completed/2026-04/traj_530xmbfeljyb.json

@@ -0,0 +1,53 @@
+{
+  "id": "traj_530xmbfeljyb",
+  "version": 1,
+  "task": {
+    "title": "Implement GitHub primitive adapter base layer"
+  },
+  "status": "completed",
+  "startedAt": "2026-04-10T15:16:25.682Z",
+  "agents": [
+    {
+      "name": "default",
+      "role": "lead",
+      "joinedAt": "2026-04-10T15:17:47.242Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_zpy70g2adds2",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-04-10T15:17:47.242Z",
+      "events": [
+        {
+          "ts": 1775834267243,
+          "type": "decision",
+          "content": "Implemented GitHub primitive as base adapter layer with action stubs: Implemented GitHub primitive as base adapter layer with action stubs",
+          "raw": {
+            "question": "Implemented GitHub primitive as base adapter layer with action stubs",
+            "chosen": "Implemented GitHub primitive as base adapter layer with action stubs",
+            "alternatives": [],
+            "reasoning": "The requested step creates client/runtime infrastructure only; action-specific methods should exist on the contract but throw until the next implementation phase."
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-04-10T15:25:16.937Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/AgentWorkforce/relay",
+  "tags": [],
+  "_trace": {
+    "startRef": "e3853a983feca165c17142f740487172dced606e",
+    "endRef": "e3853a983feca165c17142f740487172dced606e"
+  },
+  "completedAt": "2026-04-10T15:25:16.937Z",
+  "retrospective": {
+    "summary": "Created GitHub primitive adapter base layer with shared types, runtime detection/factory, gh CLI runtime, Nango/relay-cloud runtime, and public exports. Verified the new TypeScript entrypoint with tsc --noEmit.",
+    "approach": "Standard approach",
+    "confidence": 0.86
+  }
+}

.trajectories/completed/2026-04/traj_530xmbfeljyb.md

@@ -0,0 +1,31 @@
+# Trajectory: Implement GitHub primitive adapter base layer
+
+> **Status:** ✅ Completed
+> **Confidence:** 86%
+> **Started:** April 10, 2026 at 05:16 PM
+> **Completed:** April 10, 2026 at 05:25 PM
+
+---
+
+## Summary
+
+Created GitHub primitive adapter base layer with shared types, runtime detection/factory, gh CLI runtime, Nango/relay-cloud runtime, and public exports. Verified the new TypeScript entrypoint with tsc --noEmit.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Implemented GitHub primitive as base adapter layer with action stubs
+- **Chose:** Implemented GitHub primitive as base adapter layer with action stubs
+- **Reasoning:** The requested step creates client/runtime infrastructure only; action-specific methods should exist on the contract but throw until the next implementation phase.
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Implemented GitHub primitive as base adapter layer with action stubs: Implemented GitHub primitive as base adapter layer with action stubs

.trajectories/completed/2026-04/traj_703m7sqyq89t.json

@@ -50,4 +50,4 @@
     "approach": "Standard approach",
     "confidence": 0.84
   }
-}
+}

.trajectories/completed/2026-04/traj_703m7sqyq89t.md

@@ -18,6 +18,7 @@ Fixed docs/blog content loading so runtime resolves MDX from the deployed filesy
 ## Key Decisions
 
 ### Stopped docs and blog content loaders from binding to build-machine absolute paths, and explicitly traced MDX content into the Next server bundle
+
 - **Chose:** Stopped docs and blog content loaders from binding to build-machine absolute paths, and explicitly traced MDX content into the Next server bundle
 - **Reasoning:** The production stack showed a read against /home/runner/work/.../web/content/docs/introduction.mdx, which means the docs loader baked the GitHub runner path into the server chunk via import.meta.url. Resolving content from runtime cwd candidates fixes the path, and tracing content/docs plus content/blog ensures those source files are present in the deployed artifact.
 
@@ -26,6 +27,7 @@ Fixed docs/blog content loading so runtime resolves MDX from the deployed filesy
 ## Chapters
 
 ### 1. Work
-*Agent: default*
+
+_Agent: default_
 
 - Stopped docs and blog content loaders from binding to build-machine absolute paths, and explicitly traced MDX content into the Next server bundle: Stopped docs and blog content loaders from binding to build-machine absolute paths, and explicitly traced MDX content into the Next server bundle

.trajectories/completed/2026-04/traj_8oh4r5km5eic.json

@@ -0,0 +1,53 @@
+{
+  "id": "traj_8oh4r5km5eic",
+  "version": 1,
+  "task": {
+    "title": "Implement GitHub primitive actions"
+  },
+  "status": "completed",
+  "startedAt": "2026-04-10T15:26:11.355Z",
+  "agents": [
+    {
+      "name": "default",
+      "role": "lead",
+      "joinedAt": "2026-04-10T15:32:35.847Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_57wbdbpwceyf",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-04-10T15:32:35.847Z",
+      "events": [
+        {
+          "ts": 1775835155848,
+          "type": "decision",
+          "content": "Implemented GitHub actions as adapter-driven REST helpers: Implemented GitHub actions as adapter-driven REST helpers",
+          "raw": {
+            "question": "Implemented GitHub actions as adapter-driven REST helpers",
+            "chosen": "Implemented GitHub actions as adapter-driven REST helpers",
+            "alternatives": [],
+            "reasoning": "The existing local and cloud runtimes already share a request(method,path,options) abstraction, so action modules can work across gh CLI and Nango without runtime-specific branches."
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-04-10T15:33:35.150Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/AgentWorkforce/relay",
+  "tags": [],
+  "_trace": {
+    "startRef": "e3853a983feca165c17142f740487172dced606e",
+    "endRef": "e3853a983feca165c17142f740487172dced606e"
+  },
+  "completedAt": "2026-04-10T15:33:35.150Z",
+  "retrospective": {
+    "summary": "Implemented GitHub primitive repository, issue, pull request, and file actions with adapter-backed local/cloud runtime support plus a typed GitHubClient facade.",
+    "approach": "Standard approach",
+    "confidence": 0.86
+  }
+}

.trajectories/completed/2026-04/traj_8oh4r5km5eic.md

@@ -0,0 +1,31 @@
+# Trajectory: Implement GitHub primitive actions
+
+> **Status:** ✅ Completed
+> **Confidence:** 86%
+> **Started:** April 10, 2026 at 05:26 PM
+> **Completed:** April 10, 2026 at 05:33 PM
+
+---
+
+## Summary
+
+Implemented GitHub primitive repository, issue, pull request, and file actions with adapter-backed local/cloud runtime support plus a typed GitHubClient facade.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Implemented GitHub actions as adapter-driven REST helpers
+- **Chose:** Implemented GitHub actions as adapter-driven REST helpers
+- **Reasoning:** The existing local and cloud runtimes already share a request(method,path,options) abstraction, so action modules can work across gh CLI and Nango without runtime-specific branches.
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Implemented GitHub actions as adapter-driven REST helpers: Implemented GitHub actions as adapter-driven REST helpers

.trajectories/completed/2026-04/traj_abjovknvcijv.json

@@ -22,4 +22,4 @@
     "approach": "Standard approach",
     "confidence": 0.89
   }
-}
+}