Node Types Reference

This auto-generated reference documents the Input and Output schemas for workflow node types. Descriptions are extracted from proto annotations in workflow_v2.proto.

Common Node Fields

These fields are available on all node types. They provide shared functionality for node identification, conditional execution, thread management, and output handling.

Field	Type	Required
`id`	string	Yes
`type`	string	Yes
`condition`	string	No
`timeout`	string	No
`save_message`	SaveMessageConfig	No

Thread Configuration

The thread field controls conversation context:

- id: analyze
  type: call_llm
  thread:
    mode: fork      # fork, new, or inherit (default)
    memo: true      # reuse across loop iterations
    inject:
      role: user
      content: "Analyze: {{inputs.data}}"

Conditional Execution

Use condition to skip nodes based on runtime state:

- id: cleanup
  type: run
  condition: "{{nodes.process.exit_code != 0}}"
  run: "rm -rf temp/"

Automatic Message Saving

Use save_message to capture output without a separate save_message node:

- id: summarize
  type: workflow
  ref: builtin://summarizer
  thread:
    mode: fork
  save_message:
    role: assistant
    content: "{{output.summary}}"

Agent

Invoke an agent or sub-workflow

Inputs

Field	Type	Required	Default	Description
`ref`	string	No	-	Workflow reference (builtin://name or project://name)
`args`	map	No	-	Input values for the sub-workflow
`presets`	map	No	-	Preset configurations for sub-workflow inputs

Approval

Pause workflow execution for user approval

Inputs

Field	Type	Required	Default	Description
`title`	string	No	-	Approval dialog title
`timeout`	string	No	-	How long to wait for approval

Outputs

Field	Type	Description
`approval_id`	string	-
`status`	string	-
`action_taken`	string	-

Call LLM

Send a prompt to a language model and get a response

Inputs

Field	Type	Required	Default	Description
`model`	model	No	-	Model selector using tags (e.g. flagship) or explicit ID
`temperature`	number	No	0.7	Temperature (0-1) controls randomness (range: 0-2)
`thinking_level`	string	No	none	Extended thinking level for complex reasoning (enum: none\|low\|medium\|high\|xhigh)
`system_prompt`	string	No	-	System message for this LLM call
`tool_filter`	array	No	-	Filter which tools are available. Use tool names, glob patterns (edit*), tags (tag:search), or !exclusions (!bash).

Outputs

Field	Type	Description
`response_text`	string	-
`token_count`	integer	-
`upstream_request_id`	string	-
`upstream_proxyman_id`	string	-

Compact

Compact conversation context to reduce token usage

Create Worktree

Create a git worktree for isolated development

Inputs

Field	Type	Required	Default	Description
`name`	string	No	-	Worktree name, used in path
`base_branch`	string	No	-	Base branch to branch from
`copy_files`	string	No	-	Files to copy from source repo (e.g. .env)
`force`	boolean	No	-	Force creation by deleting existing worktree

Outputs

Field	Type	Description
`id`	string	-
`name`	string	-
`path`	string	-
`branch`	string	-
`base_branch`	string	-
`repo_id`	string	-
`status`	string	-

Delete Worktree

Delete a git worktree and clean up its resources

Inputs

Field	Type	Required	Default	Description
`name`	string	Yes	-	-

Outputs

Field	Type	Description
`deleted`	boolean	-

Execute Tools

Execute tool calls from an LLM response

Inputs

Field	Type	Required	Default	Description
`tool_calls`	string	No	-	CEL expression for tool calls to execute

Outputs

Field	Type	Description
`thread_token_count`	integer	-
`total_result_chars`	integer	-

Run Command

Execute a shell command

Inputs

Field	Type	Required	Default	Description
`command`	string	No	-	Shell command to execute

Outputs

Field	Type	Description
`exit_code`	integer	-
`stdout`	string	-
`stderr`	string	-

Save Message

Save a message to the conversation thread

Inputs

Field	Type	Required	Default	Description
`role`	string	No	-	Message role (enum: user\|assistant\|system\|tool)
`content`	string	No	-	Message content
`tool_calls`	string	No	-	Tool calls from LLM response
`display_style`	string	No	-	UI display style hint (enum: info\|warning\|success\|hidden)

Outputs

Field	Type	Description
`message`	object	-
`message.id`	string
`message.role`	string
`message.text`	string
`message_id`	string	-
`thread`	string	-
`tool_calls`	array	-
`tool_calls[].id`	string
`tool_calls[].name`	string
`tool_calls[].input`	string
`tool_results`	array	-
`tool_results[].tool_call_id`	string
`tool_results[].name`	string
`tool_results[].content`	string
`tool_results[].is_error`	bool
`thread_token_count`	integer	-
`message_count`	integer	-

Getting Started

Workflows

Examples

Features

Settings

Reference

Help

Node Types Reference

Common Node Fields

Thread Configuration

Conditional Execution

Automatic Message Saving

Agent

Inputs

Approval

Inputs

Outputs

Call LLM

Inputs

Outputs

Compact

Create Worktree

Inputs

Outputs

Delete Worktree

Inputs

Outputs

Execute Tools

Inputs

Outputs

Run Command

Inputs

Outputs

Save Message

Inputs

Outputs

Getting Started

Workflows

Examples

Features

Settings

Reference

Help

​Common Node Fields

​Thread Configuration

​Conditional Execution

​Automatic Message Saving

​Agent

​Inputs

​Approval

​Inputs

​Outputs

​Call LLM

​Inputs

​Outputs

​Compact

​Create Worktree

​Inputs

​Outputs

​Delete Worktree

​Inputs

​Outputs

​Execute Tools

​Inputs

​Outputs

​Run Command

​Inputs

​Outputs

​Save Message

​Inputs

​Outputs

Common Node Fields

Thread Configuration

Conditional Execution

Automatic Message Saving

Agent

Inputs

Approval

Inputs

Outputs

Call LLM

Inputs

Outputs

Compact

Create Worktree

Inputs

Outputs

Delete Worktree

Inputs

Outputs

Execute Tools

Inputs

Outputs

Run Command

Inputs

Outputs

Save Message

Inputs

Outputs