​
Overview

The Loop Controller Block is a powerful tool that allows you to create loops in your flow. It’s the only block in Lawme that can contain cycles of blocks, including itself. This block maintains the state of the loop and controls the flow of values through it.

​
Key Features

  • Maintains loop state
  • Controls value flow through the loop
  • Dynamic number of input-default pairs
  • Dynamic number of output ports
  • Conditional loop continuation

​
Inputs

​
Continue
any

If truthy, the loop continues executing. If falsy, the loop stops. Coerced to boolean. Optional, defaults to true if not provided or if the value is “Not Ran”.

​
Input X
any

The value that changes in each iteration of the loop. The number of inputs is dynamic based on connections. Each input has a corresponding default input.

​
Input X Default
any

The initial value for the corresponding Input X. Required for each Input X. If any default input is control-flow-excluded, all outputs will be control-flow-excluded.

​
Outputs

​
Break
any[]

If the Continue input is falsy, this output runs with an array of all input values. Does not run if Continue is truthy, instead outputting a control-flow-excluded value.

​
Iteration
number

The current iteration number, starting at 1 for the first iteration.

​
Output X
any

The value of the corresponding input or default input. On the first iteration, it’s the value from the default input. On subsequent iterations, it’s the value from the input on the previous iteration. The number of outputs matches the number of inputs.

​
Editor Settings

​
Max Iterations
number
default:100

The maximum number of iterations the loop can run.

​
At Max Iterations
string
default:"error"

What should happen when max iterations is reached:

  • error: Throw an error (default)
  • break: Break the loop as if Continue was false

​
Example: AI Chatting To Itself

This example demonstrates a loop that continues indefinitely:

  1. Add a Loop Controller block to your flow.
  2. Connect a Chat block to the Loop Controller’s input.
  3. Combine the existing message history with the AI’s response.
  4. Feed the combined history back into the Loop Controller.

This loop will never break on its own. It will fail after 100 iterations by default unless “At Max Iterations” is set to “break”.

​
Example: Iterating Over an Array

This example shows how to iterate over an array and append ” Mapped” to each element:

  1. Use a Pop Block to remove the first value from the array.
  2. Append ” Mapped” to the popped value.
  3. Push the new value into an output array using an Array Block.
  4. Use a Compare Block to check if the input array is empty and break the loop.
  5. Connect an Output block to the Break output of the Loop Controller.

​
Error Handling

The Loop Controller Block will error if:

  • The loop exceeds the maximum number of iterations and “At Max Iterations” is set to “error”
  • Any required default inputs are not connected

​
FAQ

​
See Also