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, …) areCredentialReadiness::KeylessLocaland 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§
- Endpoint
Identity - A non-secret identity for the endpoint a route talks to.
- Preflighted
Route - One worker’s route, fully preflighted and frozen.
- Route
Preflight - A frozen preflight for every worker in a Workflow, plus the Router.
Enums§
- Credential
Readiness - Whether a route can be called at all, decided from local configuration.
- Preflight
Error