Struct Segment 

pub struct Segment {
    pub kind: SegmentKind,
    pub role: Role,
    pub content: String,
    pub age_index: u32,
    pub tool_name: Option<String>,
    pub base_importance: f32,
    pub freshness: Option<ContextFreshness>,
}

One logical segment of the prompt window.

Fields

kind: SegmentKind

Coarse classification.

role: Role

Speaker / origin.

content: String

Raw text content (the orchestrator may compress this).

age_index: u32

0 = newest, larger = older. Used by recency scoring.

tool_name: Option<String>

Optional tool name for ToolResult / ToolDefinitions segments.

base_importance: f32

Caller-provided base importance hint (default 1.0). Boosts always-keep segments implicitly via SegmentKind::is_always_keep regardless of this value.

freshness: Option<ContextFreshness>

Freshness signal at the time this segment was assembled (e.g. repo-knowledge currency). Used by crate::HeuristicScorer to rank stale segments lower per SELF_LEARNING_INTEGRATION_MAP §15.2.

Implementations

impl Segment

pub fn user_prompt(content: impl Into<String>) -> Self

Construct a fresh user-prompt segment (the latest user message).

pub fn system_prompt(content: impl Into<String>) -> Self

Construct a system-prompt segment.

pub fn recent_turn( role: Role, content: impl Into<String>, age_index: u32, ) -> Self

Construct a recent-turn segment with explicit age.

pub fn older_turn( role: Role, content: impl Into<String>, age_index: u32, ) -> Self

Construct an older-turn segment (eligible for compaction).

pub fn tool_result( tool_name: impl Into<String>, content: impl Into<String>, age_index: u32, ) -> Self

Construct a tool-result segment.

pub fn tool_definitions(content: impl Into<String>) -> Self

Construct a tool-definitions segment.

pub fn memory_block( label: impl Into<String>, content: impl Into<String>, ) -> Self

Construct a memory-block segment (graph-memory-derived).

pub fn token_estimate(&self) -> usize

Token estimate via the shared ainl_compression::tokenize_estimate heuristic.

Trait Implementations

impl Clone for Segment

fn clone(&self) -> Segment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Segment

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Segment

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Segment

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

where __S: Serializer,

Serialize this value into the given Serde serializer.