Verification against workspace/main.py (b49ccff submodule) and
workspace-runtime.md (molecule-core main):
- PLATFORM_URL: MOLECULE_API_URL does not exist in the workspace
runtime; correct env var is PLATFORM_URL (workspace/main.py line 85).
Updated all occurrences: env vars table, Docker run, Docker Compose,
Python example, troubleshooting table.
- MOLECULE_API_KEY: not a real workspace env var; removed from Docker
run and Compose examples. The workspace runtime obtains its bearer
token from the platform automatically during registration.
- AGENT_CARD_URL: not a real env var; removed from env vars table.
The workspace generates its URL internally from HOSTNAME+port.
- Healthcheck endpoint: /agent/card is the MCP HTTP/SSE transport
path (separate binary). The A2A workspace agent serves the Agent
Card at /.well-known/agent-card.json (confirmed in boot_routes.py
and agent-card.md). Updated all healthcheck targets accordingly.
- Kubernetes terminationGracePeriodSeconds: 30s is incompatible with
the liveness probe (initialDelay=30 + 3×30s = ~120–150s to
register a failure). Changed to 120s and corrected the note to
reflect the actual failure window.
- Python example: replaced non-existent RemoteAgentClient with correct
HeartbeatLoop class from heartbeat.py.
- Graceful shutdown description: corrected to reflect uvicorn's actual
shutdown behavior (heartbeat.stop() in finally block) rather than
the non-existent stop_event pattern.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
technical-writer
b12527b11e