Struct SessionStartHandler 

pub struct SessionStartHandler {
    context_builder: Option<ContextBuilderService>,
    max_context_tokens: usize,
    guidance_level: GuidanceLevel,
    context_timeout_ms: u64,
}

Handles SessionStart hook events.

Injects relevant context at the start of a Claude Code session.

Fields

context_builder: Option<ContextBuilderService>

Context builder service.

max_context_tokens: usize

Maximum tokens for context.

guidance_level: GuidanceLevel

Guidance level for context injection.

context_timeout_ms: u64

Timeout for context loading in milliseconds (PERF-M3).

Implementations

impl SessionStartHandler

pub fn new() -> Self

Creates a new handler.

pub fn with_context_builder(self, builder: ContextBuilderService) -> Self

Sets the context builder service.

pub const fn with_max_tokens(self, tokens: usize) -> Self

Sets the maximum context tokens.

pub const fn with_guidance_level(self, level: GuidanceLevel) -> Self

Sets the guidance level.

pub const fn with_context_timeout_ms(self, timeout_ms: u64) -> Self

Sets the context loading timeout in milliseconds (PERF-M3).

If context loading takes longer than this timeout, the handler will return minimal context instead of blocking session start.

fn build_context_from_builder( &self, max_tokens: usize, start: Instant, deadline: Duration, ) -> Result<(Option<String>, Option<MemoryStatistics>, usize)>

Helper to build context from the builder service (PERF-M3).

Returns a tuple of (context string, statistics, memory count).

fn add_guidance(&self, context_parts: &mut Vec<String>)

Helper to add guidance based on level (PERF-M3).

fn build_session_context( &self, session_id: &str, cwd: &str, ) -> Result<SessionContext>

Builds context for the session with inline timeout checking (PERF-M3).

Monitors elapsed time and returns early with minimal context if approaching the timeout. This provides timeout safety without requiring thread spawning.

fn format_statistics(stats: &MemoryStatistics) -> String

Formats memory statistics as single-line XML for context injection.

fn standard_guidance() -> String

Returns standard guidance as single-line XML.

fn detailed_guidance() -> String

Returns detailed guidance as single-line XML.

fn is_first_session(&self) -> bool

Checks if this is the first session (no user memories).

Trait Implementations

impl Default for SessionStartHandler

fn default() -> Self

Returns the “default value” for a type.

impl HookHandler for SessionStartHandler

fn event_type(&self) -> &'static str

The hook event type this handler processes.

fn handle(&self, input: &str) -> Result<String>

Handles the hook event.