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);