Skip to content

Documentation / @agentick/core / useOnTickEnd

Function: useOnTickEnd()

useOnTickEnd(callback): void

Defined in: core/src/hooks/lifecycle.ts:137

Register a callback to run at the end of each tick.

The callback receives TickResult (primary data) and COM (context). TickResult contains data about the completed tick and control methods to influence whether execution continues.

Parameters

callback

TickEndCallback

Returns

void

Example

tsx
// Simple: inspect results
useOnTickEnd((result) => {
  console.log(`Tick ${result.tick} complete, tokens: ${result.usage?.totalTokens}`);
});

// Control continuation with boolean return
useOnTickEnd((result) => !result.text?.includes("<DONE>"));

// Control continuation with methods (includes reasons)
useOnTickEnd((result, ctx) => {
  if (result.text?.includes("<DONE>")) {
    result.stop("task-complete");
  } else {
    result.continue("still-working");
  }
});

// Async verification
useOnTickEnd(async (result) => {
  const verified = await checkWithModel(result.text);
  return !verified; // continue if not verified
});

Released under the ISC License.