Skip to content

health.live

Is this process alive: the cheapest true statement this executable can make about itself, with the version that answered. No filesystem traversal, no index build, no network — this is what a hosting platform polls, and it must cost nothing to say.

Is this process alive: the cheapest true statement this executable can make about itself, with the version that answered. No filesystem traversal, no index build, no network — this is what a hosting platform polls, and it must cost nothing to say.

Exposure

Where this one definition is reachable. Absence is explicit: a surface not listed does not carry it.

surfaceas
MCP
HTTPGET /api/v1/live operationId health.live
command line

Schemas

The canonical input and output, from the Rust types; the MCP tool schema and the OpenAPI parameters and responses are derived from these.

input · Empty

No input.

No properties: the capability takes no input.

JSON Schema
{
  "additionalProperties": false,
  "description": "No input.",
  "title": "Empty",
  "type": "object"
}

output · Liveness

The answer to "is this process alive": the cheapest true thing this executable can say about itself. Deliberately not a summary of anything — a probe that grew an opinion would stop reporting the one fact the platform polls it for.

propertytyperequireddescription
alive boolean yes Always `true`. A process that could not answer would not answer at all, which is the signal.
version string yes This executable's version, so a rolling deployment can tell which build answered.
JSON Schema
{
  "description": "The answer to \"is this process alive\": the cheapest true thing this executable can\nsay about itself. Deliberately not a summary of anything — a probe that grew an\nopinion would stop reporting the one fact the platform polls it for.",
  "properties": {
    "alive": {
      "description": "Always `true`. A process that could not answer would not answer at all, which is\nthe signal.",
      "type": "boolean"
    },
    "version": {
      "description": "This executable's version, so a rolling deployment can tell which build answered.",
      "type": "string"
    }
  },
  "required": [
    "alive",
    "version"
  ],
  "title": "Liveness",
  "type": "object"
}

Policies

benchmark
required — a target on every transport the exposure declares; the cases are the input type's
cache
disabled — every call runs the handler

Benchmark targets

Derived from the registry for this repository: one requirement per transport, and the cases the input type provides. The whole matrix is on the benchmarks page.

transportstatecasestargets
directcovered1default
httpcovered1default