Struct PointerHandle 

pub struct PointerHandle {
    pub bucket: String,
    pub key: String,
    pub byte_range: Option<(u64, u64)>,
}

Stable locator for a single ResidencyLevel::Pointer page’s backing bytes.

The Phase B incremental derivation can degrade an Evidence page (or any page whose degradation path permits it) to Pointer and hand the corresponding PointerHandle to resolve_pointer on demand. Keeping the handle pure data makes it serialisable into the page sidecar without dragging the MinIO client along.

Examples

use codetether_agent::session::history_sink::PointerHandle;

let handle = PointerHandle {
    bucket: "codetether".to_string(),
    key: "history/abc-123/history.jsonl".to_string(),
    byte_range: Some((0, 512)),
};
assert_eq!(handle.byte_range, Some((0, 512)));

Fields

bucket: String

S3 bucket name.

key: String

Full object key.

byte_range: Option<(u64, u64)>

Optional half-open (start, end) byte range. When None, the full object is fetched.

Implementations

impl PointerHandle

pub fn for_session(config: &HistorySinkConfig, session_id: &str) -> Self

Construct a handle that points at the whole history object for session_id under the sink’s configured prefix.

Trait Implementations

impl Clone for PointerHandle

fn clone(&self) -> PointerHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PointerHandle

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PointerHandle

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PointerHandle

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

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 PointerHandle

impl StructuralPartialEq for PointerHandle