Skip to main content
When components transmit or receive state, parameters, or content within a workflow session, the payload conforms precisely to structured Value Objects. Value objects provide strict typing enabling components to parse routing cleanly. All standard type objects require a rigid "type" string mapped uniquely to their implementation.

text

Represents explicit string content. Schema:
Value:

integer / float

Represents numeric data, distinguishing purely integer numbers from decimals. Schema:
Value:

boolean

Represents a binary true/false state. Schema:
Value:

choice

Used in dropdowns or rigid enum selection inputs. Schema:
Value:

message

The comprehensive payload unit representing generative AI prompts, replies, and contexts. It is structured to support tool usage, multimodal content via file attachments referenced by alias, and other components. Schema:
Value:
Each content block is written with its type key, and its own fields follow it, as the shapes show: vendor_data holds what a vendor needs back on a later turn, and nothing else reads it. The genai.chat component reads text blocks only. Messages can include file attachments via file content blocks, which reference file session objects by alias. The order of blocks is significant — a file block may sit between text blocks, and multimodal consumers read the file at that position rather than after the text. For details on the file session object and its properties, see File session object.

messages

An array containing sequential message objects, representing structured conversation strings or dialogue logs. Schema:
Value:

credential

Abstract identifier mapping to a securely stored alias in BlobHub’s secret vault. Schema:
Value:
A port of type credential names the credential type it accepts, api_key or generic, and the editor offers every credential of that type.

list / object

Structural types whose shape the component’s manifest declares. An item or a field is text, integer, float, boolean, choice, credential, list or object, and never message, messages, thread, graph, file or vectors. Schema:
An object without fields holds any JSON object. key names a field of the items that no two items share. Value: only the top level carries the envelope; the items and the fields are stored as plain data.
A run’s model is one object value, {"id", "settings"?}, in a genai.model entry of the run’s input_data. See Choosing a Model per Run.