Agent Builder Canvas

The Agent Builder Canvas is a visual workflow editor backed by a production workflow engine. It composes 16 core node types plus 8 BH-OS rails into clinical workflows that ship safely from sandbox to production with WORM audit.

---

​

Lifecycle

agent_workflows carries the current draft. Publishing snapshots the canvas into agent_workflow_versions and immediately deploys to sandbox. Promotion to production is explicit.

​

Optimistic concurrency

Every draft update is guarded by lock_version. Concurrent edits to the same workflow return 409 idempotency_conflict. Draft auto-save is hash-deduped — identical payloads do not create new versions.

​

Tenant isolation

The canvas is tenant-scoped end to end: - agent_workflows.organization_id is RLS-enforced

• Published versions inherit the org
• Deployments expose https://sandbox.medera.info/{org}/{agent}-v{ver} (sandbox) or https://agents.medera.info/{org}/{agent} (production)
• Sandbox deployments auto-expire 72 h after deploy

---

​

Variable scopes

Canvas nodes can reference variables using {{scope.path}} syntax. Five scopes are available:

---

​

Real-time events (real-time channel)

The executor emits the following events to the org room and per-execution room:

---

​

What’s next