Struct KvEncodedBlockV1 

pub struct KvEncodedBlockV1 {
    pub schema_version: String,
    pub block_id: u32,
    pub batch: u32,
    pub layer: u32,
    pub kv_head: u32,
    pub token: u32,
    pub vector_count: u32,
    pub fixed_size_bytes: u32,
    pub raw_fallback: bool,
    pub reason: String,
    pub encoding: KvBlockEncodingV1,
}

One fixed-addressable KV encoded block.

Fields

schema_version: String

Stable schema marker.

block_id: u32

Block id within the page.

batch: u32

Batch index.

layer: u32

Layer index.

kv_head: u32

KV head index.

token: u32

Token index.

vector_count: u32

Number of source vectors in this block.

fixed_size_bytes: u32

Fixed encoded byte reservation for random access.

raw_fallback: bool

Whether this block is raw fallback/protected.

reason: String

Human-readable fallback or compression reason.

encoding: KvBlockEncodingV1

Payload.

Implementations

impl KvEncodedBlockV1

pub fn raw( block_id: u32, batch: u32, layer: u32, kv_head: u32, token: u32, values: Vec<f32>, fixed_size_bytes: u32, reason: impl Into<String>, ) -> Self

Build a raw block.

pub fn fib_quant( block_id: u32, batch: u32, layer: u32, kv_head: u32, token: u32, code: FibCodeV1, fixed_size_bytes: u32, reason: impl Into<String>, ) -> Self

Build a compressed block.

pub fn validate(&self, head_dim: u32) -> Result<()>

Validate block invariants.

pub fn digest(&self, head_dim: u32) -> Result<String>

Stable digest for this block.

Trait Implementations

impl Clone for KvEncodedBlockV1

fn clone(&self) -> KvEncodedBlockV1

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KvEncodedBlockV1

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for KvEncodedBlockV1

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for KvEncodedBlockV1

fn eq(&self, other: &KvEncodedBlockV1) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for KvEncodedBlockV1

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for KvEncodedBlockV1