Automation Node Reference
Generated from the node type registry. Do not edit by hand.
Task
- id:
task - kind: agent
- category: Agent
- version: 1
Delegate work to an agent; returns structured output.
Fields
agent— Agent [agentref (required)] Help: Agent or role to run this task.prompt— Prompt [prompt (required)]output_schema— Output schema [jsonschema]
Outgoing ports: out
Decision
- id:
decision - kind: agent
- category: Agent
- version: 1
Agent chooses one of the declared outgoing branches.
Fields
agent— Agent [agentref (required)]prompt— Prompt [prompt (required)]choices— Choices [branchport (required), multiple] Help: Unique non-empty port ids the agent may choose between; each must connect to an outgoing edge.
Outgoing ports are derived from the choices field.
Branch
- id:
branch - kind: engine
- category: Control
- version: 1
Deterministic condition on run state.
Fields
condition— Condition [text (required)] Help: A dot-separated registry path such as nodes.agent-1.output.ready. Operators and comparisons are not supported.
Outgoing ports: on_true, on_false
Loop
- id:
loop - kind: engine
- category: Control
- version: 1
Container: repeats its body subgraph until a bound is hit.
Fields
max_iterations— Max iterations [number]until— Until condition [text] Help: A dot-separated registry path such as nodes.agent-1.output.ready. Operators and comparisons are not supported.
Outgoing ports: body, done
Join
- id:
join - kind: engine
- category: Control
- version: 1
Synchronization barrier; waits for all inbound edges.
No fields.
Outgoing ports: out
Approval
- id:
approval - kind: engine
- category: Control
- version: 1
Human-in-the-loop gate; parks the run until a person approves.
Fields
prompt— Approval prompt [prompt] Help: What the approver is signing off on.
Outgoing ports: out
Shell
- id:
shell - kind: engine
- category: Action
- version: 1
Run a shell command.
Fields
command— Command [longtext (required)]cwd— Working directory [path]
Outgoing ports: out
Script
- id:
script - kind: engine
- category: Action
- version: 1
Run a local script through a selected runtime.
Fields
runtime— Runtime [enum:python|node|sh (required)]path— Script path [path (required)]
Outgoing ports: out
State
- id:
state - kind: engine
- category: State
- version: 1
Read or write storage scoped to the current automation run.
Fields
op— Operation [enum:get|set|merge|delete (required)]entries— Entries [kvmap]
Outgoing ports: out
Memory commit
- id:
memory_commit - kind: engine
- category: State
- version: 1
Validate and atomically commit structured agent-memory changes.
Fields
source_node— Source node [text (required)]agent_id— Memory agent [text (required)] Help: Engine-owned invocation agent; only {{trigger.output.agent_id}} is accepted.
Outgoing ports: out
Send message
- id:
message_send - kind: engine
- category: Action
- version: 1
Admit an exact UTF-8 workspace artifact as a host informational message. Requires the application host; no task or reply is created.
Fields
recipient— Recipient [text (required)] Help: One exact UUID or unambiguous exact agent name. No class or broadcast selectors. Must resolve before tasks start.artifact_path— Artifact path [text (required)] Help: Workspace-relative UTF-8 file, at most 64 KiB. Use a run-specific directory such as .wardian-review/{{run.id}}/review.md; an existing artifact fails fresh-run preflight.
Outgoing ports: out
Notify
- id:
notify - kind: engine
- category: State
- version: 1
Send an operator-facing notification.
Fields
message— Message [prompt (required)]
Outgoing ports: out
Sub-automation
- id:
sub_automation - kind: engine
- category: Action
- version: 1
- status: unsupported
Reserved for durable child automation runs; not available for execution yet.
Fields
automation— Automation [automationref (required)]
Outgoing ports: out
Manual Trigger
- id:
manual_trigger - kind: trigger
- category: Trigger
- version: 1
Entry point. Runs on demand or when an invoker fires it.
Fields
input_schema— Input schema [jsonschema]
Outgoing ports: out