Report runner heartbeat

runner_heartbeat

Schreiben

Was es tut

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.

Parameter

Name	Typ	Pflicht	Beschreibung
`name`	`string`	Pflicht	Stable name for this box. Same name = same box across restarts.
`provider`	`string`	Pflicht	Which CLI this box runs. Erlaubte Werte`claudecodex`
`version`	`string`	Optional	Daemon version, for support.
`claimed`	`boolean`	Optional	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`	Optional	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`	Pflicht	Erlaubte Werte`okfailedauth_failedtimeout`
`run.error`	`string`	Optional	Short failure detail. Redact credentials before sending.

Annotationen

Die Hinweise, die der Server mit diesem Tool mitschickt. Ein Client liest sie, um zu entscheiden, ob er dich vor einem Aufruf fragt.

Nur lesenreadOnlyHint: false: Ändert Daten in deinem Done-Konto.
DestruktivdestructiveHint: false: Fügt nur hinzu oder liest; nichts Bestehendes wird entfernt oder überschrieben.
IdempotentidempotentHint: false: Jeder Aufruf kann etwas Neues hinzufügen, etwa einen Kommentar, einen Lauf oder eine Aufgabe.
Offene WeltopenWorldHint: false: Berührt nur dein eigenes Done-Konto.

Welche Tokens es aufrufen dürfen

Eine per OAuth hergestellte Verbindung hat vollen Zugriff. Ein Token aus Einstellungen → Agentenzugriff → Weitere MCP-Tokens lässt sich einschränken, und ein eingeschränktes Token sieht nie über sein Projekt oder seinen Workspace hinaus.

Voller ZugriffErlaubt
Token nur zum LesenAbgelehnt
Token für ein ProjektErlaubt
Token für einen WorkspaceErlaubt

Probier es aus

Sobald Done verbunden ist, sag deinem Assistenten zum Beispiel:

“Melde Done nach jedem Lauf den Zustand dieses Runners.”

Verbinde Done mit deinem Assistenten

Ein MCP-Endpunkt pro Konto, per OAuth oder Token. Die Einrichtung Schritt für Schritt für jeden Client:

Überblick über die MCP-Einrichtung →