Skip to main content

Function: loopWithState()

loopWithState<TBot, TCustomState, TResult>(bot, config): Processable<unknown, { history: TResult[]; result: TResult; state: TCustomState; }>

Defined in: packages/core/src/graph/loop-with-state.ts:97

Repeat a body until a condition stops it, threading custom state.

repeat() is the same iteration without the state: this adds the mutable bag a condition and its handlers read and write through LoopContext, and returns it alongside the result.

The state starts as a shallow copy of the input when the input is a plain object, which is what lets a caller seed it.

history comes back with the result rather than living on the loop, so concurrent runs of one loop do not overwrite each other's.

Type Parameters​

TBot​

TBot extends Processable<unknown, unknown>

TCustomState​

TCustomState extends Record<string, unknown> = Record<string, unknown>

TResult​

TResult = unknown

Parameters​

bot​

TBot

config​

LoopConfig<TResult, TCustomState>

Returns​

Processable<unknown, { history: TResult[]; result: TResult; state: TCustomState; }>

Example​

const refine = loopWithState(draftBot, {
condition: (draft, ctx) => ctx.iteration < 5 && !draft.approved,
maxIterations: 5,
});
const { result, state } = await refine.process(brief);