Struct ContextItem 

pub struct ContextItem {
    pub kind: ContextItemKind,
    pub path: String,
    pub preview: Option<String>,
    pub blob: Option<ObjectHash>,
}

A single input item within a ContextSnapshot.

Represents one piece of context the agent has access to — a source file, a URL, a text snippet, command output, or an image. See module documentation for the three-layer design (path / blob / preview) and blob retention strategies.

Fields

kind: ContextItemKind

The kind of content this item represents. Determines how path and blob should be interpreted.

path: String

Human-readable locator for this item.

Meaning depends on kind: repo-relative path for File, full URL for Url, descriptive label for Snippet, shell command for Command, file name for Image.

preview: Option<String>

Truncated preview of the content for quick display.

Should be kept under 500 characters. None when no preview is available (e.g. binary content, very short items where the full content fits in path).

blob: Option<ObjectHash>

Git blob hash referencing the full content at capture time.

For File items, this is the same blob already in the git tree (zero extra storage due to content-addressing). For other kinds (Url, Snippet, Command, Image), the content is stored as a new blob — see module-level docs for retention strategies. None during the draft/collection phase; should be set before the snapshot is finalized.

Implementations

impl ContextItem

pub fn new( kind: ContextItemKind, path: impl Into<String>, ) -> Result<Self, String>

Create a new draft context item with the given kind and locator.

pub fn set_blob(&mut self, blob: Option<ObjectHash>)

Set or clear the blob hash referencing the full captured content.

Trait Implementations

impl Clone for ContextItem

fn clone(&self) -> ContextItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextItem

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContextItem

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ContextItem

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

where __S: Serializer,

Serialize this value into the given Serde serializer.