Workflow nodes
donmai ships a set of built-in nodes for common workflow tasks. These are available without installing any plugin.
core.shell
Run an arbitrary shell command.
| Input | Type | Required | Description |
|---|---|---|---|
run | string | yes | The shell command to execute |
env | object | no | Additional environment variables for this step |
timeout_seconds | number | no | Per-step timeout override |
| Output | Type | Description |
|---|---|---|
stdout | string | Captured stdout |
stderr | string | Captured stderr |
exit_code | number | Process exit code |
[[steps]]
id = "build"
type = "core.shell"
run = "go build ./..."
core.condition
Branch workflow execution based on a boolean expression.
| Input | Type | Required | Description |
|---|---|---|---|
expression | string | yes | A boolean expression evaluated against the workflow context |
| Output | Type | Description |
|---|---|---|
result | boolean | Evaluated result of the expression |
core.wait
Pause workflow execution for a fixed duration.
| Input | Type | Required | Description |
|---|---|---|---|
duration_seconds | number | yes | How long to wait |
core.log
Emit a structured log event. Useful for adding audit trail entries within a workflow.
| Input | Type | Required | Description |
|---|---|---|---|
message | string | yes | Log message |
level | string | no | One of debug, info, warn, error. Defaults to info. |
data | object | no | Arbitrary structured data to attach to the event |
The full authoritative list of built-in nodes and their current input/output contracts is in the source at github.com/RenseiAI/donmai. This page is a stable summary for v0.9 — new built-ins added in patch releases appear in the source before they appear here.
For plugin-provided nodes (e.g., linear.*, github.*), see the individual plugin documentation: