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.