Struct RetrievalWindowCandidatePlan 

pub struct RetrievalWindowCandidatePlan {

    pub message_ids_to_archive: Vec<String>,
    pub archive_message_count: usize,
    pub archive_group_count: usize,
    pub archive_user_turn_count: usize,
    pub archive_message_tokens: u32,
    pub active_message_count: usize,
    pub active_state_sha256: String,
    pub token_accounting_sha256: String,
    pub active_tokens_before: u32,
    pub projected_active_tokens_after: u32,
    pub context_window_tokens: u32,
    pub request_input_limit_tokens: u32,
    pub target_tokens: u32,
    pub target_usage_percent: u8,
    pub min_recent_user_turns: usize,
    pub fixed_prompt_tokens: u32,
    pub boundary_reclaimable_tokens: u32,
    pub system_message_tokens: u32,
    pub provider_message_token_override_count: usize,
    pub protected_active_tokens: u32,
    pub retained_recent_user_turn_count: usize,
    pub retained_user_turn_count: usize,
    pub oldest_retained_message_id: Option<String>,
    pub oldest_retained_user_message_id: Option<String>,
    pub incomplete_protocol_group_count: usize,
    /* private fields */
}

Immutable evidence describing a safe retrieval-window archive candidate set.

Fields

message_ids_to_archive: Vec<String>

Message IDs to archive, in authoritative session order.

archive_message_count: usize

Number of messages selected for archival.

archive_group_count: usize

Number of complete logical groups selected, including a preamble group.

archive_user_turn_count: usize

Number of selected groups anchored by a user message.

archive_message_tokens: u32

Tokens represented by message_ids_to_archive.

active_message_count: usize

Number of active messages observed before candidate selection.

active_state_sha256: String

Versioned digest of every token-relevant active message field and its order at planning time.

token_accounting_sha256: String

Versioned digest of the fixed prompt cost and provider-prepared message token estimate overrides used by this plan.

active_tokens_before: u32

Active message plus fixed prompt tokens before candidate selection.

projected_active_tokens_after: u32

Projected active tokens after the candidate messages are removed.

context_window_tokens: u32

Provider context-window size used for the plan.

request_input_limit_tokens: u32

Effective provider request-input limit after output and safety reserves.

target_tokens: u32

Effective token target after output/safety reserves are respected.

target_usage_percent: u8

Requested target percentage retained for observability.

min_recent_user_turns: usize

Configured minimum number of newest user turns that must remain active.

fixed_prompt_tokens: u32

Provider-visible prompt/tool tokens outside Session.messages.

boundary_reclaimable_tokens: u32

Provider-visible tokens reclaimed once by the committed model-context boundary, independently of which ordinary message groups are archived.

system_message_tokens: u32

Tokens contributed by active system messages.

provider_message_token_override_count: usize

Active messages whose cost came from provider-prepared estimates.

protected_active_tokens: u32

Active message tokens that cannot be selected by this plan.

retained_recent_user_turn_count: usize

Number of groups retained specifically by the recent-turn floor.

retained_user_turn_count: usize

Total user-anchored groups projected to remain active.

oldest_retained_message_id: Option<String>

Oldest projected retained non-system message, if one remains.

oldest_retained_user_message_id: Option<String>

User anchor of the oldest projected retained user turn, if one remains.

incomplete_protocol_group_count: usize

Unsafe protocol groups that constrained selection.

Trait Implementations

impl Clone for RetrievalWindowCandidatePlan

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RetrievalWindowCandidatePlan

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

Formats the value using the given formatter.

impl Eq for RetrievalWindowCandidatePlan

impl PartialEq for RetrievalWindowCandidatePlan

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for RetrievalWindowCandidatePlan

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RetrievalWindowCandidatePlan