Canvas Node Types

The canvas ships 16 core node types and 8 BH-OS rail node types. Each runner extends and is registered with the.

Core nodes (3)

Type	Runner	Purpose
`start`	`Start runtime`	Workflow entry. Defines input variables.
`end`	`End runtime`	Workflow exit. Marks execution complete with output values.
`note`	annotation only	Documentation node — no runtime effect.

Logic & control (5)

Type	Runner	Outputs
`condition`	`Condition runtime`	`true` / `false` (field + operator + value)
`transform`	`Transform runtime`	`default` (Handlebars / Liquid template)
`classify`	`Classify runtime`	Dynamic — one per declared category
`wait`	`Wait runtime`	`default` (after delay or cron)
`user-approval`	`Approval runtime`	`approved` / `rejected` — pauses execution and writes to `workflow_approvals`

Healthcare agents (4)

Type	Runner	Outputs
`intake-agent`	`Intake runtime`	`success` / `escalate` / `error`
`scribe-agent`	`Scribe runtime`	`success` / `error`
`therapy-agent`	`Therapy runtime`	`success` / `concern` / `error`
`triage-agent`	`Triage runtime`	`urgent` / `routine` / `self_care`

Integration & data (4)

Type	Runner	Outputs
`guardrails`		`pass` / `fail`
`ehr-sync`	`EHR sync runtime`	`success` / `error`
`fhir-query`	`FHIR query runtime`	`success` / `error`
`escalate`	`Escalation runtime`	(terminal — sends notification)

BH-OS rails (8)

The BH-OS rails are typed runners backed by. Each rail wires the workflow into a corresponding backend service.

rails/assessment

Clinical assessment runner

rails/triage

Triage routing

rails/referral

Referral generator + closed-loop

rails/pa

Prior authorization workflow

rails/mbc

Measurement-Based Care

rails/quality

HEDIS / MIPS capture

rails/network

Provider network logic

rails/pharmacy

e-Rx network e-Rx + DDI

Sample composition

Validation

Node runtime.validate(node) enforces required fields per node type at design time. Connections are type-checked — a condition node’s true port can only connect to a node that accepts the condition’s state output shape.

What’s next

Variables & Scopes

Template resolution and template syntax.

Versioning & Deployment

Snapshots, sandbox-first deploys, WORM audit.

Guardrails

HIPAA + 42 CFR Part 2 rules.

Transforms

Template-driven data shaping.

​Core nodes (3)

​Logic & control (5)

​Healthcare agents (4)

​Integration & data (4)

​BH-OS rails (8)