Enum LookupResponse 

pub enum LookupResponse {
    Hit {
        payload: String,
        tool_kind: String,
        bytes: u64,
        provenance: Option<Provenance>,
        from_shared: bool,
        file_roots: Vec<FileRootSpec>,
        upstream_keys: Vec<String>,
    },
    Miss,
    Invalidated,
}

Variants

Hit

Entry found. payload is base64-encoded raw bytes (small JSON completions and short tool outputs cross the wire fine inside a JSON envelope; the cost of base64 inflation is acceptable for the volumes M4 handles single-tenant).

Fields

payload: String

tool_kind: String

bytes: u64

provenance: Option<Provenance>

from_shared: bool

file_roots: Vec<FileRootSpec>

File dependencies recorded at persist time. Defaults to empty so older servers that omit the field still deserialize. The client revalidates these against its own checkout before trusting the payload, which is the only mechanism that catches cross-machine drift where Bob’s tree differs from Alice’s. Server-side revalidation cannot catch this case because the server only sees its own filesystem.

upstream_keys: Vec<String>

Upstream cache-key dependencies recorded at persist time. Defaults to empty so an older peer that omits the field still deserializes. Without this, a RemoteStore-backed cache reconstructs every wire hit with an empty upstream set and transitive cross-layer invalidation silently does nothing.

Miss

Invalidated

Entry existed but was invalidated (file root changed, upstream dropped). The client should treat this identically to Miss for cache-population purposes; the distinct kind lets stats distinguish “never had it” from “had it, now stale”.

Trait Implementations

impl Clone for LookupResponse

fn clone(&self) -> LookupResponse

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LookupResponse

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LookupResponse

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for LookupResponse

fn eq(&self, other: &LookupResponse) -> 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 LookupResponse

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for LookupResponse

impl StructuralPartialEq for LookupResponse