#251 docs: add Freestyle agent hosting guide

Summary

• document running a forward-deployed Agent Relay agent on Freestyle
• keep Relay and model credentials out of reusable VM snapshots
• prevent cloned nodes from sharing a baked machine identity
• document pause/resume behavior and bounded dev/test lifecycles

Verification

• npm ci
• npm run build — passed; compiled, typechecked, and generated 244 static pages
• git diff --check

Provenance

The guidance is based on a dev-only proof using two VMs cloned from one clean snapshot. Both joined the same hosted Relay workspace with distinct node IDs; pause transitioned one node offline, and resume returned it online with the same identity. No credentials or VM identifiers are included in this change.

---

^{Need help on this PR? Tag @codesmith-bot with what you need.}

---

Summary by cubic

Adds a guide for hosting the answering agent on a Freestyle VM so it stays online without a laptop.

• Covers keeping Relay and model credentials out of reusable snapshots and injecting them at runtime.
• Documents removing broker machine-id and token state before capturing a snapshot to prevent cloned nodes from colliding on node id (provider_instance_conflict).
• Notes the current Freestyle SDK /v5 API requirement (older /v1 packages return 401) and pause/resume behavior with lifecycle bounds for dev/test VMs.
• Requires Agent Relay 11.3.1 or later, since earlier versions print the workspace key during node up.

---

Agent Relay sessions

• codex session 01a18883 · opened via gh pr create · last active 2026-10-29