Skip to main content

Module fleet_preflight

Module fleet_preflight 

Source
Expand description

Worker route preflight: everything about a route that must be true and frozen before a Workflow starts, and certainly before any Router is asked anything.

An exact Fleet’s promise is that the saved provider/model is the one that runs. That promise is only worth something if it is checked at the point the run is admitted, not discovered at the first API call:

  • Provider identity — the exact configured provider key and its kind.
  • Canonical wire model — the model string that will actually be placed on the request. Receipt and child spawn must use this value, not the file’s spelling of it, or the receipt describes a request nobody made.
  • Credential / readiness — decided locally, from configuration. No live probe: a preflight that hits the network would spend money and leak the fact of the run before the operator’s gates have even been evaluated. Keyless local providers (vllm, ollama, sglang, …) are CredentialReadiness::KeylessLocal and are perfectly valid.
  • Endpoint identity — a non-secret label for where the request goes, so two members pointed at different deployments of the same model id are distinguishable on a receipt. Never a full URL with credentials in it.
  • Reasoning capability — what the route can truthfully express, derived once here so a later launch cannot invent one.

Everything in this module is a plain value with no clock, no filesystem, and no network. The host supplies the facts; this crate defines their shape and the invariants over them.

Structs§

EndpointIdentity
A non-secret identity for the endpoint a route talks to.
PreflightedRoute
One worker’s route, fully preflighted and frozen.
RoutePreflight
A frozen preflight for every worker in a Workflow, plus the Router.

Enums§

CredentialReadiness
Whether a route can be called at all, decided from local configuration.
PreflightError