Simplify Agent Relay core surfaces

.agentworkforce/trajectories/completed/2026-05/traj_4mejgzhbabzm/summary.md

@@ -0,0 +1,39 @@
+# Trajectory: Rename packages/driver to packages/runtime and create packages/harnesses
+
+> **Status:** ✅ Completed
+> **Confidence:** 95%
+> **Started:** May 28, 2026 at 04:26 PM
+> **Completed:** May 28, 2026 at 04:30 PM
+
+---
+
+## Summary
+
+Renamed packages/driver to packages/runtime (all imports updated), created packages/harnesses with 8 CLI harness exports
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Renamed @agent-relay/driver to @agent-relay/runtime
+
+- **Chose:** Renamed @agent-relay/driver to @agent-relay/runtime
+- **Reasoning:** Package rename requested: directory moved, all imports updated across packages/openclaw, packages/cli, packages/hooks, packages/gateway, and the package itself
+
+### Created packages/harnesses with StaticPtyHarnessDefinition exports for all 8 supported CLIs
+
+- **Chose:** Created packages/harnesses with StaticPtyHarnessDefinition exports for all 8 supported CLIs
+- **Reasoning:** New thin package requested as a catalog of pre-built harness definitions
+
+---
+
+## Chapters
+
+### 1. Work
+
+_Agent: default_
+
+- Renamed @agent-relay/driver to @agent-relay/runtime: Renamed @agent-relay/driver to @agent-relay/runtime
+- Created packages/harnesses with StaticPtyHarnessDefinition exports for all 8 supported CLIs: Created packages/harnesses with StaticPtyHarnessDefinition exports for all 8 supported CLIs

.agentworkforce/trajectories/completed/2026-05/traj_4mejgzhbabzm/trajectory.json

@@ -0,0 +1,65 @@
+{
+  "id": "traj_4mejgzhbabzm",
+  "version": 1,
+  "task": {
+    "title": "Rename packages/driver to packages/runtime and create packages/harnesses"
+  },
+  "status": "completed",
+  "startedAt": "2026-05-28T20:26:54.858Z",
+  "completedAt": "2026-05-28T20:30:14.620Z",
+  "agents": [
+    {
+      "name": "default",
+      "role": "lead",
+      "joinedAt": "2026-05-28T20:30:13.144Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_disnuoh2hcq8",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-05-28T20:30:13.144Z",
+      "endedAt": "2026-05-28T20:30:14.620Z",
+      "events": [
+        {
+          "ts": 1780000213145,
+          "type": "decision",
+          "content": "Renamed @agent-relay/driver to @agent-relay/runtime: Renamed @agent-relay/driver to @agent-relay/runtime",
+          "raw": {
+            "question": "Renamed @agent-relay/driver to @agent-relay/runtime",
+            "chosen": "Renamed @agent-relay/driver to @agent-relay/runtime",
+            "alternatives": [],
+            "reasoning": "Package rename requested: directory moved, all imports updated across packages/openclaw, packages/cli, packages/hooks, packages/gateway, and the package itself"
+          },
+          "significance": "high"
+        },
+        {
+          "ts": 1780000213887,
+          "type": "decision",
+          "content": "Created packages/harnesses with StaticPtyHarnessDefinition exports for all 8 supported CLIs: Created packages/harnesses with StaticPtyHarnessDefinition exports for all 8 supported CLIs",
+          "raw": {
+            "question": "Created packages/harnesses with StaticPtyHarnessDefinition exports for all 8 supported CLIs",
+            "chosen": "Created packages/harnesses with StaticPtyHarnessDefinition exports for all 8 supported CLIs",
+            "alternatives": [],
+            "reasoning": "New thin package requested as a catalog of pre-built harness definitions"
+          },
+          "significance": "high"
+        }
+      ]
+    }
+  ],
+  "retrospective": {
+    "summary": "Renamed packages/driver to packages/runtime (all imports updated), created packages/harnesses with 8 CLI harness exports",
+    "approach": "Standard approach",
+    "confidence": 0.95
+  },
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/will/Projects/AgentWorkforce/relay",
+  "tags": [],
+  "_trace": {
+    "startRef": "b01ee3f89143a028f91a2c44b7b39fdc8d07ca0a",
+    "endRef": "b01ee3f89143a028f91a2c44b7b39fdc8d07ca0a"
+  }
+}

.agentworkforce/trajectories/completed/2026-05/traj_brxv912628sm/summary.md

@@ -0,0 +1,14 @@
+# Trajectory: Iterate README product API direction
+
+> **Status:** ✅ Completed
+> **Confidence:** 84%
+> **Started:** May 28, 2026 at 09:52 AM
+> **Completed:** May 28, 2026 at 10:08 AM
+
+---
+
+## Summary
+
+Expanded README target contracts after Quick Start: messaging records, listener predicates/event handlers, delivery policies, harness delivery adapters, and harness observability events.
+
+**Approach:** Standard approach

.agentworkforce/trajectories/completed/2026-05/traj_brxv912628sm/trajectory.json

@@ -0,0 +1,25 @@
+{
+  "id": "traj_brxv912628sm",
+  "version": 1,
+  "task": {
+    "title": "Iterate README product API direction"
+  },
+  "status": "completed",
+  "startedAt": "2026-05-28T13:52:33.505Z",
+  "completedAt": "2026-05-28T14:08:51.239Z",
+  "agents": [],
+  "chapters": [],
+  "retrospective": {
+    "summary": "Expanded README target contracts after Quick Start: messaging records, listener predicates/event handlers, delivery policies, harness delivery adapters, and harness observability events.",
+    "approach": "Standard approach",
+    "confidence": 0.84
+  },
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/will/Projects/AgentWorkforce/relay",
+  "tags": [],
+  "_trace": {
+    "startRef": "44beabbc821b783c413ff6c7c95c4e62516cc47d",
+    "endRef": "44beabbc821b783c413ff6c7c95c4e62516cc47d"
+  }
+}

.agentworkforce/trajectories/completed/2026-05/traj_fot7xzqzwd5a/summary.md

@@ -0,0 +1,14 @@
+# Trajectory: Use Zod schemas in README actions
+
+> **Status:** ✅ Completed
+> **Confidence:** 90%
+> **Started:** May 27, 2026 at 04:16 PM
+> **Completed:** May 27, 2026 at 04:17 PM
+
+---
+
+## Summary
+
+Updated root and SDK README action examples to use Zod input/output schemas and added zod to install snippets.
+
+**Approach:** Standard approach

.agentworkforce/trajectories/completed/2026-05/traj_fot7xzqzwd5a/trajectory.json

@@ -0,0 +1,25 @@
+{
+  "id": "traj_fot7xzqzwd5a",
+  "version": 1,
+  "task": {
+    "title": "Use Zod schemas in README actions"
+  },
+  "status": "completed",
+  "startedAt": "2026-05-27T20:16:26.878Z",
+  "completedAt": "2026-05-27T20:17:37.842Z",
+  "agents": [],
+  "chapters": [],
+  "retrospective": {
+    "summary": "Updated root and SDK README action examples to use Zod input/output schemas and added zod to install snippets.",
+    "approach": "Standard approach",
+    "confidence": 0.9
+  },
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/will/Projects/AgentWorkforce/relay",
+  "tags": [],
+  "_trace": {
+    "startRef": "614e3dba9c0a40edeba1751243cea4bbbf15bdcc",
+    "endRef": "614e3dba9c0a40edeba1751243cea4bbbf15bdcc"
+  }
+}

.agentworkforce/trajectories/completed/2026-05/traj_j2qa2s5hqvui/summary.md

@@ -0,0 +1,14 @@
+# Trajectory: Improve README examples for core categories
+
+> **Status:** ✅ Completed
+> **Confidence:** 86%
+> **Started:** May 27, 2026 at 01:51 PM
+> **Completed:** May 27, 2026 at 01:55 PM
+
+---
+
+## Summary
+
+Reworked root and SDK READMEs as target product docs with explicit Messaging, Delivery, and Actions examples; removed public Relaycast framing from those READMEs and updated scope/changelog wording.
+
+**Approach:** Standard approach

.agentworkforce/trajectories/completed/2026-05/traj_j2qa2s5hqvui/trajectory.json

@@ -0,0 +1,25 @@
+{
+  "id": "traj_j2qa2s5hqvui",
+  "version": 1,
+  "task": {
+    "title": "Improve README examples for core categories"
+  },
+  "status": "completed",
+  "startedAt": "2026-05-27T17:51:29.818Z",
+  "completedAt": "2026-05-27T17:55:30.014Z",
+  "agents": [],
+  "chapters": [],
+  "retrospective": {
+    "summary": "Reworked root and SDK READMEs as target product docs with explicit Messaging, Delivery, and Actions examples; removed public Relaycast framing from those READMEs and updated scope/changelog wording.",
+    "approach": "Standard approach",
+    "confidence": 0.86
+  },
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/will/Projects/AgentWorkforce/relay",
+  "tags": [],
+  "_trace": {
+    "startRef": "c25ac02086edf4502979aa2a076b6d70448d8845",
+    "endRef": "c25ac02086edf4502979aa2a076b6d70448d8845"
+  }
+}

.agentworkforce/trajectories/completed/2026-05/traj_m9sgbxehh8my/summary.md

@@ -0,0 +1,33 @@
+# Trajectory: Workspace-first Agent Relay setup
+
+> **Status:** ✅ Completed
+> **Confidence:** 90%
+> **Started:** May 28, 2026 at 04:43 PM
+> **Completed:** May 28, 2026 at 04:43 PM
+
+---
+
+## Summary
+
+Added workspace-first SDK/MCP/OpenClaw setup with RELAY_WORKSPACE_KEY as the preferred credential name, retained legacy API-key aliases, and validated SDK, CLI, runtime, harnesses, and OpenClaw builds/tests.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Prefer workspace keys over Agent Relay API keys
+
+- **Chose:** Prefer workspace keys over Agent Relay API keys
+- **Reasoning:** Workspace creation should be the default onboarding path; RELAY_WORKSPACE_KEY and workspaceKey are now first-class while RELAY_API_KEY/apiKey remain compatibility aliases for existing tools.
+
+---
+
+## Chapters
+
+### 1. Work
+
+_Agent: default_
+
+- Prefer workspace keys over Agent Relay API keys: Prefer workspace keys over Agent Relay API keys

.agentworkforce/trajectories/completed/2026-05/traj_m9sgbxehh8my/trajectory.json

@@ -0,0 +1,53 @@
+{
+  "id": "traj_m9sgbxehh8my",
+  "version": 1,
+  "task": {
+    "title": "Workspace-first Agent Relay setup"
+  },
+  "status": "completed",
+  "startedAt": "2026-05-28T20:43:31.561Z",
+  "completedAt": "2026-05-28T20:43:39.681Z",
+  "agents": [
+    {
+      "name": "default",
+      "role": "lead",
+      "joinedAt": "2026-05-28T20:43:36.066Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_8amjhjckubva",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-05-28T20:43:36.066Z",
+      "endedAt": "2026-05-28T20:43:39.681Z",
+      "events": [
+        {
+          "ts": 1780001016067,
+          "type": "decision",
+          "content": "Prefer workspace keys over Agent Relay API keys: Prefer workspace keys over Agent Relay API keys",
+          "raw": {
+            "question": "Prefer workspace keys over Agent Relay API keys",
+            "chosen": "Prefer workspace keys over Agent Relay API keys",
+            "alternatives": [],
+            "reasoning": "Workspace creation should be the default onboarding path; RELAY_WORKSPACE_KEY and workspaceKey are now first-class while RELAY_API_KEY/apiKey remain compatibility aliases for existing tools."
+          },
+          "significance": "high"
+        }
+      ]
+    }
+  ],
+  "retrospective": {
+    "summary": "Added workspace-first SDK/MCP/OpenClaw setup with RELAY_WORKSPACE_KEY as the preferred credential name, retained legacy API-key aliases, and validated SDK, CLI, runtime, harnesses, and OpenClaw builds/tests.",
+    "approach": "Standard approach",
+    "confidence": 0.9
+  },
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/will/Projects/AgentWorkforce/relay",
+  "tags": [],
+  "_trace": {
+    "startRef": "b01ee3f89143a028f91a2c44b7b39fdc8d07ca0a",
+    "endRef": "b01ee3f89143a028f91a2c44b7b39fdc8d07ca0a"
+  }
+}

.agentworkforce/trajectories/completed/2026-05/traj_p2vqjz2scihm/summary.md

@@ -0,0 +1,58 @@
+# Trajectory: Implement Agent Relay core simplification
+
+> **Status:** ✅ Completed
+> **Confidence:** 82%
+> **Started:** May 27, 2026 at 12:39 PM
+> **Completed:** May 27, 2026 at 01:29 PM
+
+---
+
+## Summary
+
+Implemented Agent Relay core simplification: SDK messaging/delivery/actions, optional driver package, MCP action tools, pruned CLI and legacy SDK surfaces, updated docs and verification.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Create @agent-relay/driver as managed harness boundary
+
+- **Chose:** Create @agent-relay/driver as managed harness boundary
+- **Reasoning:** The current Rust broker/client code owns harness lifecycle and injection, which is driver infrastructure rather than Agent Relay core messaging. Keeping a separate in-repo package preserves local broker coupling while removing spawn as a root SDK concept.
+
+### Document core as Relaycast-backed SDK plus optional driver harness
+
+- **Chose:** Document core as Relaycast-backed SDK plus optional driver harness
+- **Reasoning:** Worker C owns docs only; the docs should describe Agent Relay as the product, keep Relaycast as the transport layer, and put broker/harness orchestration behind @agent-relay/driver for the SemVer-major split.
+
+### Scoped messaging surface to packages/sdk/src/messaging with relative tests
+
+- **Chose:** Scoped messaging surface to packages/sdk/src/messaging with relative tests
+- **Reasoning:** The user asked Worker A to own only SDK messaging core files and avoid package export/package metadata/doc changes unless necessary; tests can import the new surface by source path while package exports are handled separately.
+
+### Merged SDK action validation into concurrent messaging contracts
+
+- **Chose:** Merged SDK action validation into concurrent messaging contracts
+- **Reasoning:** A concurrent worker added RelayMessaging, AgentDeliveryAdapter, and InMemoryAgentRelayActions contracts while this worker was implementing delivery/actions. I preserved those public shapes and added schema-lite validation, registry helpers, and capability-gated DeliveryRunner tests around them instead of replacing the concurrent work.
+
+### Implemented Relaycast-backed SDK messaging core
+
+- **Chose:** Implemented Relaycast-backed SDK messaging core
+- **Reasoning:** Added normalized Agent Relay messaging types, Relaycast adapters, event/inbox normalization, and explicit unsupported durable delivery capabilities under packages/sdk/src/messaging without changing package metadata or docs in this slice.
+
+---
+
+## Chapters
+
+### 1. Work
+
+_Agent: default_
+
+- Create @agent-relay/driver as managed harness boundary: Create @agent-relay/driver as managed harness boundary
+- Document core as Relaycast-backed SDK plus optional driver harness: Document core as Relaycast-backed SDK plus optional driver harness
+- Scoped messaging surface to packages/sdk/src/messaging with relative tests: Scoped messaging surface to packages/sdk/src/messaging with relative tests
+- Worker C docs pass is complete: root README, SDK README, scope artifact, and changelog now describe Agent Relay as product, Relaycast as transport, SDK core communication, and @agent-relay/driver as optional harness layer.
+- Merged SDK action validation into concurrent messaging contracts: Merged SDK action validation into concurrent messaging contracts
+- Implemented Relaycast-backed SDK messaging core: Implemented Relaycast-backed SDK messaging core