Struct PinnedCandidate 

pub struct PinnedCandidate {
    pub id: String,
    pub kind: ContextItemKind,
    pub label: String,
    pub source_path: Option<PathBuf>,
    pub scope: String,
    pub content_hash: Option<u64>,
    pub artifact_handle: Option<String>,
    pub bytes: usize,
}

A pinned working-set item considered for selection.

Pins are task-local evidence kept visible across turns until dropped or expired. They are not durable context.

Fields

id: String

Stable id from item_id_for_path or an explicit handle.

kind: ContextItemKind

Kind of pinned context.

label: String

Short label (e.g. file path, tool-result label).

source_path: Option<PathBuf>

Absolute source path when file-backed.

scope: String

Scope label.

content_hash: Option<u64>

Content hash when applicable.

artifact_handle: Option<String>

Stable handle for bounded redacted recovery, when this pin is evidence.

bytes: usize

Estimated UTF-8 byte size of the pinned content.

Implementations

impl PinnedCandidate

pub fn file( kind: ContextItemKind, path: PathBuf, scope: impl Into<String>, bytes: usize, ) -> Self

Build a pinned file candidate with a stable path-derived id.

Trait Implementations

impl Clone for PinnedCandidate

fn clone(&self) -> PinnedCandidate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PinnedCandidate

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

Formats the value using the given formatter.

impl Eq for PinnedCandidate

impl PartialEq for PinnedCandidate

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PinnedCandidate