Skip to content

Actions and verifiers

Helix Patch uses both. They share HTTP + M2M transport into Patch, but answer different questions.

Remote verifierRemote action
QuestionIs this good enough?Please do X
WhenHEE lifecycle phases (executor, task_complete, run_complete)Brain chooses mid-session
Patch APIPOST /v1/hee/verifyPOST /v1/hee/actions
BindingremoteVerifiers / heeRemoteVerifiersremoteActions / heeRemoteActions
Result that matters{ ok } — can block the session{ ok, data } — tool output for the brain
ExamplesTrivy closure vs baseline CVEsscan_fs, apply_bump, open_pr, notify, try_image_on_cluster

Trivy stays in Patch. helix-ee never embeds scanner logic; it only POSTs evidence (verify) or requests tools (actions).

How bindings get to helix-ee

Inside one remediation session

Campaign loop (many sessions)

Verifiers and actions apply inside each HEE session. Across days, Patch owns merge wait + rescan and starts the next IO/HEE session when findings remain.

See also: contributor doc HELIX_PATCH_CAMPAIGN.md.

Helix Patch · Helix · Igentify