Report runner heartbeat

runner_heartbeat

Scrittura

Cosa fa

For a self-hosted runner box only. Registers this box against the account and reports its health, so the human can see their runner in Done rather than by reading logs over SSH. Call it on connect, on the interval this returns, and once after every run with that run's outcome. Report run.status 'auth_failed' when the model credential is rejected — a box whose subscription login expired still holds its stream open, so that is the one failure Done cannot otherwise see.

Parametri

Nome	Tipo	Obbligatorio	Descrizione
`name`	`string`	Obbligatorio	Stable name for this box. Same name = same box across restarts.
`provider`	`string`	Obbligatorio	Which CLI this box runs. Valori ammessi`claudecodex`
`version`	`string`	Facoltativo	Daemon version, for support.
`claimed`	`boolean`	Facoltativo	For a Done-provisioned box: true once a model credential exists on this machine. Done cannot see this for itself, so the box reports it.
`run`	`object`	Facoltativo	The outcome of the run that just finished. Omit on a plain check-in — omitting it leaves the previous outcome standing rather than clearing it.
`run.status`	`string`	Obbligatorio	Valori ammessi`okfailedauth_failedtimeout`
`run.error`	`string`	Facoltativo	Short failure detail. Redact credentials before sending.

Annotazioni

Le indicazioni che il server invia con questo strumento. Un client le legge per decidere se chiederti il permesso prima di una chiamata.

Sola letturareadOnlyHint: false: Modifica dati nel tuo account Done.
DistruttivodestructiveHint: false: Aggiunge o legge soltanto; nulla di ciò che esiste viene rimosso o sovrascritto.
IdempotenteidempotentHint: false: Ogni chiamata può aggiungere qualcosa di nuovo, come un commento, un’esecuzione o un’attività.
Mondo apertoopenWorldHint: false: Tocca solo il tuo account Done.

Quali token possono chiamarlo

Una connessione fatta con OAuth ha accesso completo. Un token creato in Impostazioni → Accesso degli agenti → Token MCP aggiuntivi si può restringere, e un token ristretto non vede mai oltre il suo progetto o spazio di lavoro.

Accesso completoConsentito
Token di sola letturaRifiutato
Token per un progettoConsentito
Token per uno spazio di lavoroConsentito

Provalo

Con Done collegato, chiedi al tuo assistente qualcosa come:

“Comunica a Done lo stato di questo runner dopo ogni esecuzione.”

Collega Done al tuo assistente

Un endpoint MCP per account, con OAuth o con un token. La configurazione passo passo per ogni client:

Panoramica della configurazione MCP →