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

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