Node

As you have seen in agents, each item within the workflow paramter represents an instance of a Node class.

There are 3 types of Node currently available:

  • prompt
  • mcp
  • return

PromptNode

Represents a single step within the prompt chain. This node is designed for text llms.

class PromptNode extends Node {
    type             enum
    name             String

    system           String
    user             String

    apikey           String
    llm              enum
    model            String
    temperature      int
    maxTokens        int

    output           String
}

type (String, enum)
Represents the type of node. This is used for determined casting in downstream nodes

name (String)
the name of this node. Used for logging purposes

system (string)
Represents the system prompt. This string accepts a special templating synthx using {field}. This is substituded in workflow runtime by referring to values stored in variables within agent.

user (string)
Represents the user prompt. This string accepts a special templating synthax using {field}. This is substituded in workflow runtime by referring to values stored in variables within agent.

apiKey (String)
The API key for this prompt node. This string accepts a special templating syntax using {field} which will allow the API key to be parsed at workflow runtime from agent.variables

llm (String, enum)
Registered enum types of available LLM service provider Valid values are:

  • claude
  • replicate

model (String)
The model available from this service provider. See Glossary of supported services for available models

temperature (Integer)
The Model's temeperature settings

maxToken (Integer)
The model's maximum tokens

output (string, key)
mapping that points to the agent's variables registry key where the model output is stored. If an unregistered key isreferenced, a new one will be created at workflow runtime.


Mcp Node

Represents an powerful Claude single action node, which allows an Mcp server connection.

class McpNode extends Node {
    type           enum
    name           String
    config         McpConfig

    user           String

    apikey         String
    maxSteps       int
    output         String
}

type (String, enum)
Represents the type of node. This is used for determined casting in downstream nodes

name (String)
the name of this node. Used for logging purposes

user (String)
Single prompt user instruction for using an MCP tool

config (McpConfig)
An Mcp config object, this is used to describe the connection, and commands available for an MCP server. See Mcp Sections for more details

apikey (String)
claude API key. The MCP node uses a standard Claude Client SDK

maxSteps (Integer)
The maximum number of steps for the Claude agent to take to process an request and tool use.

output (String, key)
mapping that points to the agent's variables registry key where the model output is stored. If an unregistered key is referenced, a new one will be created at workflow runtime.


Image Analysis Node

Represents a specialized prompt node that can intepret images. It is used to to read images, including documents, and provide intepretation, analysis, or transcription

Under the hood, it is powered by Gemmini.

class ImageNode extends Node {
    type             enum
    name             String

    system           String
    user             String
    image            String

    apikey           String
    model            String
    temperature      float
    maxTokens        int

    output           String
}

type (String, enum)
Represents the type of node. This is used for determined casting in downstream nodes

name (String)
the name of this node. Used for logging purposes

system (string)
Represents the system prompt. This string accepts a special templating synthx using {field}. This is substituded in workflow runtime by referring to values stored in variables within agent.

user (string)
Represents the user prompt. This string accepts a special templating synthax using {field}. This is substituded in workflow runtime by referring to values stored in variables within agent.

apiKey (String)
The API key for this prompt node. This string accepts a special templating syntax using {field} which will allow the API key to be parsed at workflow runtime from agent.variables

model (String)
The model available from this service provider. Currently supported models are:

  • google-deepmind/gemma-3-27b-it
  • google-deepmind/gemma-3-4b-it

temperature (Float)
The Model's temperature settings

maxToken (Integer)
The model's maximum tokens

output (string, key)
mapping that points to the agent's variables registry key where the model output is stored. If an unregistered key is referenced, a new one will be created at workflow runtime.


Api Node

Represents a special Event triggering node, which provide you the ability to make Api requests. These requests can be templated and triggered by a workflow, and have its response read by an llm

class ApiNode extends Node {
    type             enum
    name             String

    method           String
    url              String
    header           String

    body             String

    output           String
}

type (String, enum)
Represents the type of node.

name (String)
the name of this node. Used for logging purposes

url (String)
The Target url for making this http request

method (String, enum)
Represents the REST Api request methods, accepted values are:
GET, POST, PUT, PATCH, and DELETE

header (String, JSON)
A JSON encoded String of a HTTP request Header. This was done to ensure that parser is able to dynamically inject values within its fields

body (String, JSON)
A JSON encoded String of a HTTP request Body. This was done to ensure that parser is able to dynamically inject values within its fields

output (string, key)
mapping that points to the agent's variables registry key where the model output is stored. If an unregistered key is referenced, a new one will be created at workflow runtime.


TextNode

Represents a single step within the prompt chain. This node is designed for build text-templates from other variables

class TextNode extends Node {
    type             enum
    name             String

    text             String
    
    output           String
}

type (String, enum)
Represents the type of node. This is used for determined casting in downstream nodes

name (String)
the name of this node. Used for logging purposes

text (string)
Represents the text to format or write. This string accepts a special templating synthx using {field}. This is substituded in workflow runtime by referring to values stored in variables within agent.

output (string, key)
mapping that points to the agent's variables registry key where the model output is stored. If an unregistered key isreferenced, a new one will be created at workflow runtime.


CryptoNode

Represents a single step within the prompt chain. This node is designed for interacting with the Cyypto Service.

Currently Only Solana Chain is supported.

class CryptoNode extends Node {
    type             enum
    name             String

    tokenName        String
    symbol           String
    description      String
    image            String
    
    userAddress      String
    payer            String
    
    decimals         int
    amount           int

    output           String
}

type (String, enum)
Represents the type of node. This is used for determined casting in downstream nodes

name (String)
the name of this node. Used for logging purposes

tokenName (string)
Represents the token's name. This string accepts a special templating synthx using {field}. This is substituded in workflow runtime by referring to values stored in variables within agent.

symbol (string)
Represents the token's symbol. This string accepts a special templating synthax using {field}. This is substituded in workflow runtime by referring to values stored in variables within agent.

description (String)
The Token's description. This string accepts a special templating syntax using {field} which will allow the API key to be parsed at workflow runtime from agent.variables

image (String, uri)
The Image as dataUri string that represents this Token

userAddress (String, publicKey)
The owner of this token. When tokens are minted this address receives all the amount.

payer (String, secretKey)
Base58 secretKey. The payer that pays for the minting fees, and initial costs of creating and minting this token.

decimals (Integer)
This token's Decimal places. For NFTs, or Fungible Assets, this is 0.

amount (Integer)
The Ammount of tokens to mint. Defaults to 1. For NFTs this must always be 1. But for Fungible Assets, and coins, this can be any amount greater than 1.

output (string, key)
mapping that points to the agent's variables registry key where the model output is stored. If an unregistered key isreferenced, a new one will be created at workflow runtime.


Return Node

Represents the terminal (last) node in your chain. It is used to list out which key within your variables will be returned when the agent finishes execution.

class ReturnNode extends Node {
    type     enum
    name     String

    output   String

    @Override
    output          Array<String>
}

output (Array of String key) List of keys from the shared context variable to return within the task object once the workflow finishes