Struct WorkerSpec 

pub struct WorkerSpec {

    pub url: String,
    pub models: WorkerModels,
    pub worker_type: WorkerType,
    pub connection_mode: ConnectionMode,
    pub runtime_type: RuntimeType,
    pub provider: Option<ProviderType>,
    pub labels: HashMap<String, String>,
    pub priority: u32,
    pub cost: f32,
    pub api_key: Option<String>,
    pub bootstrap_port: Option<u16>,
    pub bootstrap_host: String,
    pub kv_connector: Option<String>,
    pub kv_role: Option<String>,
    pub health: HealthCheckConfig,
    pub max_connection_attempts: u32,
}

Core worker identity and configuration.

The single canonical representation of “what is a worker”. Used as the shared sub-struct across API requests, API responses, and internal runtime state via #[serde(flatten)].

Fields use #[serde(default)] so the same struct works for both input (partial config from user) and output (fully resolved state).

Fields

url: String

Worker URL.

models: WorkerModels

Models this worker can serve.

worker_type: WorkerType

Worker type: regular, prefill, or decode.

connection_mode: ConnectionMode

Connection mode: http or grpc.

runtime_type: RuntimeType

Runtime type: sglang, vllm, trtllm, or external.

provider: Option<ProviderType>

External provider for API transformations. None means native/passthrough.

labels: HashMap<String, String>

Additional labels/tags.

priority: u32

Worker priority (higher = preferred).

cost: f32

Worker cost factor (baseline = 1.0).

api_key: Option<String>

Worker API key. Accepted on input, never included in responses.

bootstrap_port: Option<u16>

Bootstrap port for prefill workers in PD disaggregated mode.

bootstrap_host: String

Bootstrap hostname (derived from URL at construction time).

kv_connector: Option<String>

KV connector type (e.g. “MooncakeConnector”, “NixlConnector”).

kv_role: Option<String>

KV role (e.g. “kv_producer”, “kv_consumer”, “kv_both”).

health: HealthCheckConfig

Health check configuration.

max_connection_attempts: u32

Maximum connection attempts during worker registration (default: 20).

Implementations

impl WorkerSpec

pub fn new(url: impl Into<String>) -> Self

Create a new WorkerSpec with the given URL and sensible defaults.

Trait Implementations

impl Clone for WorkerSpec

fn clone(&self) -> WorkerSpec

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WorkerSpec

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WorkerSpec

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for WorkerSpec

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.