Skip to main content
Canvas workflows are semver-versioned. Publishing creates an immutable snapshot in agent_workflow_versions and triggers an automatic sandbox deployment.

​
Deployment lifecycle

medera/versioning.svgsandbox-first · semver · WORMSandbox-first deploymentEditPublish vX.Y.ZAuto-deploy sandboxVerify metricsPromote productionEvery published version is immutable.Rollback = redeploy the previous version.Every deploy is recorded in the WORM audit log.WORM audit · semver · auto-rollback on thresholdDeployment alerts · time-bucketed metrics · preview tokens

​
Tables

​
URLs

  • Sandbox — https://sandbox.medera.info/{org_slug}/{agent_slug}-v{version}
  • Production — https://agents.medera.info/{org_slug}/{agent_slug}
  • Sandbox auto-expiry — auto_expire_at set 72 h after deploy; expirePreviewTokens cron runs daily at 3 AM.

​
Auto-rollback

agent_deployments.auto_rollback_config declares thresholds (error rate, p95 latency, alert severity). When triggered, the deployment rolls back to the previous successful version and writes an event_type='rolled_back' row to deployment_audit_log.

​
WORM audit

deployment_audit_log is append-only. UPDATE and DELETE are blocked by triggers (migration 145 fixed the FK from RESTRICT → SET NULL to preserve WORM semantics when actors are deleted).

​
What’s next

Node Types

16 core + 8 rail nodes.

Variables & Scopes

Template syntax.

Guardrails

Runtime enforcement.

Transforms

Data shaping.