Enum Residency 

pub enum Residency {
    Resident,
    External {
        payload_ref: String,
        digest: String,
        original_size: u64,
    },
    PagedOut {
        payload_ref: String,
        digest: String,
    },
    Collapsed,
}

Where a handle’s content currently lives. Page-in/page-out are transitions on this.

Self::External and Self::PagedOut are deliberately distinct (§7.10, cluster-b B19): the first is “generated over the inline threshold and never was resident”, the second is “was resident, archived under context pressure”.

Variants

Resident

Full content present in working context.

External

§7.10 · the body was over the inline threshold when it was generated: the host persisted it before the kernel ever saw it, and only preview was ever resident.

Fields

payload_ref: String

Opaque host locator. Never a path, never joined, never opened by the kernel.

digest: String

original_size: u64

PagedOut

§7.10 · the body was resident and left under context pressure (page-out archive).

Fields

payload_ref: String

digest: String

Collapsed

Original kept locally but projected out of the rendered view (Layer 4 read-time projection).

Implementations

impl Residency

pub fn label(&self) -> &'static str

pub fn occupies_context(&self) -> bool

Whether the handle’s full content currently counts against the token budget.

pub fn payload_ref(&self) -> Option<&str>

The opaque locator a page-in must hand back to the host, when one exists.

None for every residency the kernel can satisfy on its own — Resident and Collapsed still hold the body locally.

pub fn digest(&self) -> Option<&str>

The digest a paged-in body must reproduce. Paired with Self::payload_ref: a residency that can be loaded is exactly one that can be verified.

Trait Implementations

impl Clone for Residency

fn clone(&self) -> Residency

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Residency

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Residency

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Residency

impl PartialEq for Residency

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Residency

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 Residency