PR #1190 - AgentWorkforce/relay

Problem

The OpenCode Relay plugin (plugins/opencode-relay-plugin) talked to a bespoke RPC API at https://www.relaycast.dev/api/v1 (/register, /dm/send, /inbox/check, /agent/list, /message/post, /agent/add, /agent/remove). That host is dead (returns HTTP 522), so the plugin is fully broken.

Change

Transport swap only — same tool names, arguments, return shapes, and idle inbox-polling behavior. The plugin now uses the published @relaycast/sdk (^4.1.6) pointed at the current engine.

Default base URL → https://cast.agentrelay.com (old www host is dead; no data continuity). Still configurable via the existing RelayState.apiBaseUrl, now routed into the SDK as baseUrl.
Removed the bespoke fetch / normalizeBaseUrl plumbing.
Tests now mock the SDK (RelayCast / AgentClient) instead of the dead HTTP URLs, with equivalent coverage (19 tests).

Endpoint → SDK mapping

Bespoke endpoint	SDK call
`/register`	`new RelayCast({ apiKey: workspace, baseUrl }).registerOrRotate({ name })` → then `relay.as(token)` for the agent client
`/dm/send`	`AgentClient.dm(to, text)`
`/inbox/check`	`AgentClient.inbox()` flattened by `inboxToMessages()`
`/agent/list`	`RelayCast.agents.list()`
`/message/post`	`AgentClient.post(channel, text)`
`/agent/add`	`RelayCast.agents.registerOrGet({ name, metadata: { cli, task } })`
`/agent/remove`	`RelayCast.agents.delete(name)`

Things that didn't map cleanly

Inbox shape. /v1/inbox returns { unread_channels, mentions, unread_dms, recent_reactions } — no messages[]. inboxToMessages() flattens channel mentions[] and unread_dms[] (using each conversation's lastMessage) into the flat RelayMessage[] the inbox tool and idle hook expect. unread_channels and recent_reactions are not message-like and are ignored.
/agent/add (worker registration). The SDK's agents.spawn requires a cli enum (claude|codex|gemini|aider|goose) that excludes opencode, and it is meant to spawn a remote process. The plugin instead spawns a local OpenCode process, so the relay-side step is just registering the worker identity — implemented with agents.registerOrGet({ name, metadata: { cli: 'opencode', task } }). The local spawn(...) behavior, bootstrap prompt, and env vars are unchanged.
relay_agents return type. Previously passed through whatever the bespoke API returned; now returns the SDK's Agent[] objects. Shape ({ agents: [...] }) is preserved.

Build / test

npm run build (tsc): passes
npm test (vitest): 19/19 passing
Validated against @relaycast/sdk@4.1.6.

A standalone vitest.config.ts was added to the plugin so its tests run in isolation (the plugin is not part of the monorepo npm workspaces; without it vitest climbs to the root config which can't resolve in a fresh plugin install).

🤖 Generated with Claude Code