docs: connect Replicas to Agent Relay

KH
3d ago
+332-0

Summary

  • add the public Replicas setup guide and a concise docs reference page
  • document provider-key setup, launch/bind/status/message/release flows, the scoped-helper limitation, and the exact REST routes
  • add Replicas to docs navigation, related agent/MCP pages, and every hosted-client guide series list

Source verification

  • AgentWorkforce/cloud/docs/mcp/replicas-agents.md
  • Cloud PR #5443 and current packages/web/lib/replicas/**, Settings card, and REST route implementations

Validation

  • npm run lint (passes; four pre-existing warnings in unrelated files)
  • npm run build (passes; generates the Replicas blog, docs, Markdown mirror, and OG routes)

Screenshots

Not included. The guide does not rely on screenshots or placeholder images; the verified Settings labels and tool flows are documented directly.


Autofix with [code]smith
Open in [code]smith · Need help on this PR? Tag @codesmith-bot with what you need.


Summary by cubic

Adds documentation for connecting Replicas to Agent Relay Cloud, covering provider key setup through launching or binding chats and messaging them over the relay.

  • Adds a walkthrough blog post and compact docs reference page covering launch, bind, status, message, and release flows, including launch ownership and report delivery, the scoped-helper limitation, binding exclusivity, launch and release recovery, the REST routes, and partial-cleanup failure handling.
  • Clarifies the onboarding contract: saving a key only configures environments, and a chat gets a Relay identity only when its VM makes a verified native MCP call or an admin binds its exact chat; a workspace member must be assigned for automatic relay messaging.
  • Documents the self-hosted relay-control boundary, where Replicas is credentials-only and lifecycle tools are unavailable until the runtime lands; automatic Replicas-environment MCP provisioning is tracked separately from that runtime work.
  • Adds Replicas to the docs navigation, agent docs, MCP docs, and every hosted-client guide series list.