minke.yu/sglang
1
0
Fork 0
Code Issues Pull Requests Actions 12 Packages Projects Releases Wiki Activity

[Rust] Simplify request defaults and document batch header ABI (#37226)

Browse Source
This commit is contained in:
Lianmin Zheng
2026-08-31 12:31:35 -07:00
committed by GitHub
parent 2138494272
commit 579270d459
2 changed files with 49 additions and 59 deletions
Download Patch File Download Diff File Expand all files Collapse all files
rust/sglang-server/src/message/request.rs
-21
View File
@@ -59,73 +59,52 @@ const JSON_TO_HEAP_FACTOR: usize = 8;
pub struct GenerateBody { pub struct GenerateBody {
/// Optional client-supplied request id(s): a single string (a batch fans it /// Optional client-supplied request id(s): a single string (a batch fans it
/// out as `{rid}_{i}`, mirroring Python `_normalize_batch`) or one per item. /// out as `{rid}_{i}`, mirroring Python `_normalize_batch`) or one per item.
#[serde(default)]
pub rid: Option<OneOrMany<String>>, pub rid: Option<OneOrMany<String>>,
#[serde(default)]
pub text: Option<OneOrMany<String>>, pub text: Option<OneOrMany<String>>,
#[serde(default)]
pub input_ids: Option<OneOrMany<TokenIds>>, pub input_ids: Option<OneOrMany<TokenIds>>,
#[serde(default)] #[serde(default)]
pub stream: bool, pub stream: bool,
/// One params object (broadcast) or a list of them (per item); see /// One params object (broadcast) or a list of them (per item); see
/// [`SamplingParamsInput`]. /// [`SamplingParamsInput`].
#[serde(default)]
pub sampling_params: Option<SamplingParamsInput>, pub sampling_params: Option<SamplingParamsInput>,
/// Logprob / hidden-state options: a scalar broadcasts to every prompt, a /// Logprob / hidden-state options: a scalar broadcasts to every prompt, a
/// list is per-prompt (Python `_normalize_logprob_params`). /// list is per-prompt (Python `_normalize_logprob_params`).
#[serde(default)]
pub return_logprob: Option<OneOrMany<bool>>, pub return_logprob: Option<OneOrMany<bool>>,
#[serde(default)]
pub logprob_start_len: Option<OneOrMany<i64>>, pub logprob_start_len: Option<OneOrMany<i64>>,
#[serde(default)]
pub top_logprobs_num: Option<OneOrMany<i64>>, pub top_logprobs_num: Option<OneOrMany<i64>>,
/// Token ids to report logprobs for: one list (broadcast to every prompt) or /// Token ids to report logprobs for: one list (broadcast to every prompt) or
/// one list per prompt, mirroring Python's /// one list per prompt, mirroring Python's
/// `Union[List[int], List[List[int]]]` fan-out in `_normalize_batch`. /// `Union[List[int], List[List[int]]]` fan-out in `_normalize_batch`.
#[serde(default)]
pub token_ids_logprob: Option<OneOrMany<TokenIds>>, pub token_ids_logprob: Option<OneOrMany<TokenIds>>,
#[serde(default)]
pub return_hidden_states: Option<OneOrMany<bool>>, pub return_hidden_states: Option<OneOrMany<bool>>,
/// Scalar-only in Python too (`return_text_in_logprobs: bool`). /// Scalar-only in Python too (`return_text_in_logprobs: bool`).
#[serde(default)]
pub return_text_in_logprobs: Option<bool>, pub return_text_in_logprobs: Option<bool>,
// PD-disaggregation routing, injected per request by the PD router // PD-disaggregation routing, injected per request by the PD router
// (mini_lb / sgl-model-gateway): a scalar for a single prompt, one-per-item // (mini_lb / sgl-model-gateway): a scalar for a single prompt, one-per-item
// lists for a batch. Elements are nullable (`List[Optional[...]]` in // lists for a batch. Elements are nullable (`List[Optional[...]]` in
// Python) — the router sends `bootstrap_port: [null, …]` when deferring to // Python) — the router sends `bootstrap_port: [null, …]` when deferring to
// the scheduler's `--disaggregation-bootstrap-port` default. // the scheduler's `--disaggregation-bootstrap-port` default.
#[serde(default)]
pub bootstrap_host: Option<OneOrMany<Option<String>>>, pub bootstrap_host: Option<OneOrMany<Option<String>>>,
#[serde(default)]
pub bootstrap_port: Option<OneOrMany<Option<i64>>>, pub bootstrap_port: Option<OneOrMany<Option<i64>>>,
/// `bootstrap_room` fits in i64: the PD routers draw it from `[0, 2^63)`. /// `bootstrap_room` fits in i64: the PD routers draw it from `[0, 2^63)`.
#[serde(default)]
pub bootstrap_room: Option<OneOrMany<Option<i64>>>, pub bootstrap_room: Option<OneOrMany<Option<i64>>>,
#[serde(default)]
pub bootstrap_pair_key: Option<OneOrMany<Option<String>>>, pub bootstrap_pair_key: Option<OneOrMany<Option<String>>>,
#[serde(default)]
pub decode_tp_size: Option<OneOrMany<Option<i64>>>, pub decode_tp_size: Option<OneOrMany<Option<i64>>>,
/// DP routing hints — per-request scalars even for batches, as in Python. /// DP routing hints — per-request scalars even for batches, as in Python.
#[serde(default)]
pub routed_dp_rank: Option<i64>, pub routed_dp_rank: Option<i64>,
#[serde(default)]
pub disagg_prefill_dp_rank: Option<i64>, pub disagg_prefill_dp_rank: Option<i64>,
// Multimodal inputs, permissive `Value` so any shape Python's // Multimodal inputs, permissive `Value` so any shape Python's
// `GenerateReqInput` accepts (URL / base64 / list / list-of-lists) parses. // `GenerateReqInput` accepts (URL / base64 / list / list-of-lists) parses.
// `into_requests` fans them out per the Python // `into_requests` fans them out per the Python
// `_normalize_{image,video,audio}_data` batch rules. // `_normalize_{image,video,audio}_data` batch rules.
#[serde(default)]
pub image_data: Option<rmpv::Value>, pub image_data: Option<rmpv::Value>,
/// Caller-supplied per-item content hashes (hex) overriding the computed /// Caller-supplied per-item content hashes (hex) overriding the computed
/// ones, so an external router's keys align with the prefix cache. Single /// ones, so an external router's keys align with the prefix cache. Single
/// requests only: Python declares the batched shapes but `__getitem__` never /// requests only: Python declares the batched shapes but `__getitem__` never
/// forwards them, so a batch is rejected here rather than answered with /// forwards them, so a batch is rejected here rather than answered with
/// hashes it did not ask for. /// hashes it did not ask for.
#[serde(default)]
pub mm_hashes: Option<rmpv::Value>, pub mm_hashes: Option<rmpv::Value>,
#[serde(default)]
pub video_data: Option<rmpv::Value>, pub video_data: Option<rmpv::Value>,
#[serde(default)]
pub audio_data: Option<rmpv::Value>, pub audio_data: Option<rmpv::Value>,
} }
rust/sglang-server/src/message/response.rs
+49 -38
View File
@@ -118,8 +118,18 @@ pub fn frame_decode_batch_cols(header: &[u8], data_cols: &[&[u8]]) -> Bytes {
Bytes::from(buf) Bytes::from(buf)
} }
/// Columnar scalar header for a whole decode batch. All numeric fields are /// Columnar scalar header for a whole decode batch. The first four fields are
/// `#[serde(default)]`; the hot path (no extras) emits just the first four. /// required; every field after `tok_lens` defaults empty, so the hot path emits
/// a four-element header. Field order is the wire ABI and must match
/// `RustTokenizerManager.push_generation`'s `header_cols` in
/// `python/sglang/srt/rust_server/server.py`.
///
/// Field names follow `direction_family_shape`:
/// - direction: `out` = decode output, `in` = prefill input;
/// - family: `lp` = token logprobs, `top` = top-k logprobs, `tokids_lp` =
/// requested-token logprobs, and `hidden` = hidden states;
/// - shape: `lens` counts elements per request, `reqlens` counts positions or
/// rows per request, and `poslens` counts elements per position or row.
#[derive(Debug, Default, Serialize, Deserialize)] #[derive(Debug, Default, Serialize, Deserialize)]
pub struct BatchHeader { pub struct BatchHeader {
/// Request ids, as the same strings Python holds (`Req.rid`, uuid hex) — /// Request ids, as the same strings Python holds (`Req.rid`, uuid hex) —
@@ -143,13 +153,13 @@ pub struct BatchHeader {
#[serde(default)] #[serde(default)]
pub in_top_poslens: Vec<u32>, pub in_top_poslens: Vec<u32>,
#[serde(default)] #[serde(default)]
pub out_tid_reqlens: Vec<u32>, pub out_tokids_lp_reqlens: Vec<u32>,
#[serde(default)] #[serde(default)]
pub out_tid_poslens: Vec<u32>, pub out_tokids_lp_poslens: Vec<u32>,
#[serde(default)] #[serde(default)]
pub in_tid_reqlens: Vec<u32>, pub in_tokids_lp_reqlens: Vec<u32>,
#[serde(default)] #[serde(default)]
pub in_tid_poslens: Vec<u32>, pub in_tokids_lp_poslens: Vec<u32>,
#[serde(default)] #[serde(default)]
pub hidden_reqlens: Vec<u32>, pub hidden_reqlens: Vec<u32>,
#[serde(default)] #[serde(default)]
@@ -262,8 +272,8 @@ pub fn for_each_chunk(body: &[u8], mut route: impl FnMut(ChunkEvent)) -> Decoded
|| !per_req_ok(&h.in_lp_lens) || !per_req_ok(&h.in_lp_lens)
|| !per_req_ok(&h.out_top_reqlens) || !per_req_ok(&h.out_top_reqlens)
|| !per_req_ok(&h.in_top_reqlens) || !per_req_ok(&h.in_top_reqlens)
|| !per_req_ok(&h.out_tid_reqlens) || !per_req_ok(&h.out_tokids_lp_reqlens)
|| !per_req_ok(&h.in_tid_reqlens) || !per_req_ok(&h.in_tokids_lp_reqlens)
|| !per_req_ok(&h.hidden_reqlens) || !per_req_ok(&h.hidden_reqlens)
{ {
reject!() reject!()
@@ -274,8 +284,8 @@ pub fn for_each_chunk(body: &[u8], mut route: impl FnMut(ChunkEvent)) -> Decoded
// surplus left positions unread and delivered a truncated row with a 200. // surplus left positions unread and delivered a truncated row with a 200.
if sum(&h.out_top_reqlens) != h.out_top_poslens.len() if sum(&h.out_top_reqlens) != h.out_top_poslens.len()
|| sum(&h.in_top_reqlens) != h.in_top_poslens.len() || sum(&h.in_top_reqlens) != h.in_top_poslens.len()
|| sum(&h.out_tid_reqlens) != h.out_tid_poslens.len() || sum(&h.out_tokids_lp_reqlens) != h.out_tokids_lp_poslens.len()
|| sum(&h.in_tid_reqlens) != h.in_tid_poslens.len() || sum(&h.in_tokids_lp_reqlens) != h.in_tokids_lp_poslens.len()
|| sum(&h.hidden_reqlens) != h.hidden_poslens.len() || sum(&h.hidden_reqlens) != h.hidden_poslens.len()
{ {
reject!() reject!()
@@ -295,8 +305,8 @@ pub fn for_each_chunk(body: &[u8], mut route: impl FnMut(ChunkEvent)) -> Decoded
let n_ilp = sum(&h.in_lp_lens); let n_ilp = sum(&h.in_lp_lens);
let n_ot = sum(&h.out_top_poslens); let n_ot = sum(&h.out_top_poslens);
let n_it = sum(&h.in_top_poslens); let n_it = sum(&h.in_top_poslens);
let n_od = sum(&h.out_tid_poslens); let n_od = sum(&h.out_tokids_lp_poslens);
let n_id = sum(&h.in_tid_poslens); let n_id = sum(&h.in_tokids_lp_poslens);
let n_h = sum(&h.hidden_poslens); let n_h = sum(&h.hidden_poslens);
let mut c_ids = col(n_ids); let mut c_ids = col(n_ids);
let mut c_olp_v = col(n_olp); let mut c_olp_v = col(n_olp);
@@ -331,8 +341,8 @@ pub fn for_each_chunk(body: &[u8], mut route: impl FnMut(ChunkEvent)) -> Decoded
&& h.in_lp_lens.is_empty() && h.in_lp_lens.is_empty()
&& h.out_top_reqlens.is_empty() && h.out_top_reqlens.is_empty()
&& h.in_top_reqlens.is_empty() && h.in_top_reqlens.is_empty()
&& h.out_tid_reqlens.is_empty() && h.out_tokids_lp_reqlens.is_empty()
&& h.in_tid_reqlens.is_empty() && h.in_tokids_lp_reqlens.is_empty()
&& h.hidden_reqlens.is_empty()); && h.hidden_reqlens.is_empty());
// Position cursors into the header's per-request `poslens` (ragged + hidden). // Position cursors into the header's per-request `poslens` (ragged + hidden).
@@ -378,17 +388,17 @@ pub fn for_each_chunk(body: &[u8], mut route: impl FnMut(ChunkEvent)) -> Decoded
data, data,
&mut c_od_v, &mut c_od_v,
&mut c_od_i, &mut c_od_i,
&h.out_tid_poslens, &h.out_tokids_lp_poslens,
&mut p_od, &mut p_od,
lens_i(&h.out_tid_reqlens, i), lens_i(&h.out_tokids_lp_reqlens, i),
)?; )?;
let (in_tid_val, in_tid_idx, in_tid_lens) = take_ragged( let (in_tid_val, in_tid_idx, in_tid_lens) = take_ragged(
data, data,
&mut c_id_v, &mut c_id_v,
&mut c_id_i, &mut c_id_i,
&h.in_tid_poslens, &h.in_tokids_lp_poslens,
&mut p_id, &mut p_id,
lens_i(&h.in_tid_reqlens, i), lens_i(&h.in_tokids_lp_reqlens, i),
)?; )?;
let (hidden_val, hidden_lens) = take_hidden( let (hidden_val, hidden_lens) = take_hidden(
data, data,
@@ -778,10 +788,10 @@ mod tests {
arr_u(&[]), // out_top_poslens arr_u(&[]), // out_top_poslens
arr_u(&[0, 0]), // in_top_reqlens arr_u(&[0, 0]), // in_top_reqlens
arr_u(&[]), // in_top_poslens arr_u(&[]), // in_top_poslens
arr_u(&[0, 0]), // out_tid_reqlens arr_u(&[0, 0]), // out_tokids_lp_reqlens
arr_u(&[]), // out_tid_poslens arr_u(&[]), // out_tokids_lp_poslens
arr_u(&[0, 0]), // in_tid_reqlens arr_u(&[0, 0]), // in_tokids_lp_reqlens
arr_u(&[]), // in_tid_poslens arr_u(&[]), // in_tokids_lp_poslens
arr_u(&[2, 0]), // hidden_reqlens — 2 rows claimed arr_u(&[2, 0]), // hidden_reqlens — 2 rows claimed
arr_u(&[3]), // hidden_poslens — only 1 supplied arr_u(&[3]), // hidden_poslens — only 1 supplied
]); ]);
@@ -901,7 +911,8 @@ mod tests {
let i = |xs: &[i32]| -> Vec<u8> { xs.iter().flat_map(|x| x.to_le_bytes()).collect() }; let i = |xs: &[i32]| -> Vec<u8> { xs.iter().flat_map(|x| x.to_le_bytes()).collect() };
let arr_u = |xs: &[u32]| Value::Array(xs.iter().map(|&x| Value::from(x)).collect()); let arr_u = |xs: &[u32]| Value::Array(xs.iter().map(|&x| Value::from(x)).collect());
// header: rids, finish, prompt, tok_lens, out_lp_lens, in_lp_lens, // header: rids, finish, prompt, tok_lens, out_lp_lens, in_lp_lens,
// out_top_reqlens, out_top_poslens, in_top_*, out_tid_*, in_tid_*, // out_top_reqlens, out_top_poslens, in_top_*, out_tokids_lp_*,
// in_tokids_lp_*,
// hidden_reqlens, hidden_poslens // hidden_reqlens, hidden_poslens
let header_arr = Value::Array(vec![ let header_arr = Value::Array(vec![
Value::Array(vec![Value::from("1"), Value::from("2")]), // rids Value::Array(vec![Value::from("1"), Value::from("2")]), // rids
@@ -914,10 +925,10 @@ mod tests {
arr_u(&[2]), // out_top_poslens (that pos: k=2) arr_u(&[2]), // out_top_poslens (that pos: k=2)
arr_u(&[0, 0]), // in_top_reqlens arr_u(&[0, 0]), // in_top_reqlens
arr_u(&[]), // in_top_poslens arr_u(&[]), // in_top_poslens
arr_u(&[0, 0]), // out_tid_reqlens arr_u(&[0, 0]), // out_tokids_lp_reqlens
arr_u(&[]), // out_tid_poslens arr_u(&[]), // out_tokids_lp_poslens
arr_u(&[0, 0]), // in_tid_reqlens arr_u(&[0, 0]), // in_tokids_lp_reqlens
arr_u(&[]), // in_tid_poslens arr_u(&[]), // in_tokids_lp_poslens
arr_u(&[1, 0]), // hidden_reqlens (req0: 1 row) arr_u(&[1, 0]), // hidden_reqlens (req0: 1 row)
arr_u(&[3]), // hidden_poslens (dim 3) arr_u(&[3]), // hidden_poslens (dim 3)
]); ]);
@@ -986,10 +997,10 @@ mod tests {
arr_u(&[]), // out_top_poslens arr_u(&[]), // out_top_poslens
reqlens.clone(), // in_top_reqlens reqlens.clone(), // in_top_reqlens
arr_u(&[]), // in_top_poslens arr_u(&[]), // in_top_poslens
reqlens.clone(), // out_tid_reqlens reqlens.clone(), // out_tokids_lp_reqlens
arr_u(&[]), // out_tid_poslens arr_u(&[]), // out_tokids_lp_poslens
reqlens.clone(), // in_tid_reqlens reqlens.clone(), // in_tokids_lp_reqlens
arr_u(&[]), // in_tid_poslens arr_u(&[]), // in_tokids_lp_poslens
reqlens, // hidden_reqlens reqlens, // hidden_reqlens
arr_u(&[]), // hidden_poslens arr_u(&[]), // hidden_poslens
]); ]);
@@ -1045,9 +1056,9 @@ mod tests {
/// All SEVEN extras families in one frame, each with a distinct length AND /// All SEVEN extras families in one frame, each with a distinct length AND
/// distinct values. The existing extras test exercises only `out_lp` / /// distinct values. The existing extras test exercises only `out_lp` /
/// `out_top` / `hidden`, so transposing a header pair — `in_top_*` with /// `out_top` / `hidden`, so transposing a header pair — `in_top_*` with
/// `out_tid_*`, say — leaves every assertion passing while the client receives /// `out_tokids_lp_*`, say, leaves every assertion passing while the client
/// another request's logprobs under the wrong key. Lengths differ per family /// receives another request's logprobs under the wrong key. Lengths differ per
/// (2/1/2/1/2/1/3 elements) so a swap misaligns the cursors too. /// family (2/1/2/1/2/1/3 elements) so a swap misaligns the cursors too.
#[test] #[test]
fn decodes_all_extras_families_without_transposition() { fn decodes_all_extras_families_without_transposition() {
use rmpv::Value; use rmpv::Value;
@@ -1066,10 +1077,10 @@ mod tests {
arr_u(&[2]), // out_top_poslens …k=2) arr_u(&[2]), // out_top_poslens …k=2)
arr_u(&[1]), // in_top_reqlens (1 position… arr_u(&[1]), // in_top_reqlens (1 position…
arr_u(&[1]), // in_top_poslens …k=1) arr_u(&[1]), // in_top_poslens …k=1)
arr_u(&[1]), // out_tid_reqlens (1 position… arr_u(&[1]), // out_tokids_lp_reqlens (1 position...
arr_u(&[2]), // out_tid_poslens …2 ids) arr_u(&[2]), // out_tokids_lp_poslens ...2 ids)
arr_u(&[1]), // in_tid_reqlens (1 position… arr_u(&[1]), // in_tokids_lp_reqlens (1 position...
arr_u(&[1]), // in_tid_poslens …1 id) arr_u(&[1]), // in_tokids_lp_poslens ...1 id)
arr_u(&[1]), // hidden_reqlens (1 row… arr_u(&[1]), // hidden_reqlens (1 row…
arr_u(&[3]), // hidden_poslens …dim 3) arr_u(&[3]), // hidden_poslens …dim 3)
]); ]);