Module session_navigation 

Session tree navigation for branched sessions

Handles navigation between different points in the session tree, including the creation of branch summaries when leaving a path.

Structs

BeforeTreeHookResult

Extension hook result for session_before_tree event

BranchSummaryDetails

Details stored in BranchSummaryEntry for file tracking

BranchSummaryEntry

Branch summary entry - captures context when navigating away from a branch

BranchSummaryResult

Result of branch summarization

CollectEntriesResult

Result of collecting entries for branch summarization

CompactionEntry

Compaction entry - summary after context window compaction

CustomEntry

Custom entry for extensions to store extension-specific data

CustomMessageEntry

Custom message entry for extensions to inject messages into LLM context

ExtensionSummary

Summary generated by an extension

LabelEntry

Label entry - user-defined bookmark/marker on entries

MessageEntry

Message entry content

NavigationOptions

Navigation target options

NavigationResult

Result of tree navigation

SessionInfoEntry

Session info entry - metadata like display name

SessionNavigator

Session navigator for tree-based session management

TreePreparation

Preparation data for tree navigation (passed to extension hooks)

Enums

MessageRole

Message role types

SessionEntryType

Extended session entry types for tree navigation

SummarizationError

Error during summarization

Traits

Summarizer

Trait for LLM-based summarization Implement this to provide actual summarization, or use a mock for testing

Functions

extract_custom_message_text

Extract text content from custom message

extract_user_message_text

Extract text content from user message

is_assistant_message

Check if an entry is an assistant message

is_custom_message

Check if an entry is a custom message

is_user_message

Check if an entry is a user message