Skip to content
Nella

nella_heartbeat

Verify trust-chain continuity with a challenge-response check.

Verify trust-chain continuity with a challenge-response check.

This tool is registered by the local MCP server alongside the context and indexing tools. It is meant to be called with the challenge returned by nella_get_context or by the previous nella_heartbeat response.

Parameters

ParameterTypeRequiredDescription
challenge_responsestringYesThe current challenge value returned by Nella.

Example

nella_heartbeat({
  challenge_response: "abcd1234",
});

Response Shape

### Heartbeat: OK

Trust chain verified successfully.

Next challenge: `ef567890`
Verified: 3 | Failed: 0

Notes

  • If the response does not match, the body reports Heartbeat: FAILED and explains that the trust chain may be compromised.
  • The tool still returns a fresh challenge even after failure.
  • Failure is reported in the text body; the handler does not currently set isError.

See nella_get_context for where the initial challenge comes from.