Interface ComposableStep

A single step in a composable tool pipeline.

Steps are executed sequentially. Each step invokes an existing registered tool by name and maps values from the pipeline's shared input namespace into the step's arguments using reference expressions.

Reference expression syntax (resolved at runtime):

  • "$input" — the original input to the composable tool.
  • "$prev" — the output of the immediately preceding step.
  • "$steps.<stepName>" — the output of a named step.
  • Any other literal value is used as-is.
interface ComposableStep {
    name: string;
    tool: string;
    inputMapping: Record<string, unknown>;
    condition?: string;
}

Properties

name tool inputMapping condition?

Properties

name

name: string

Unique name for this step within the pipeline. Used for cross-step references via $steps.<stepName>.

Example

"fetchUser"

tool

tool: string

The registered tool name to invoke for this step. Must match the name property of an ITool available to the agent.

Example

"web_search"

inputMapping

inputMapping: Record<string, unknown>

Input argument mapping for the tool invocation. Keys are the tool's argument names; values are literal values or reference expressions ($input, $prev, $steps.<name>).

Example

{ query: "$input.searchTerm", maxResults: 5 }

Optional condition

condition?: string

Optional JSONata / simple expression evaluated against $prev before executing this step. When the expression evaluates to falsy, the step is skipped and its output is null.

Example

"$prev.totalCount > 0"

Settings

Member Visibility

Theme

On This Page

nametoolinputMappingcondition