Struct PiMonoHook 

pub struct PiMonoHook { /* private fields */ }

Pi-Mono hook for extracting memory from pi-mono session execution.

Uses a native TypeScript extension (not SKILL.md) that integrates with pi-mono’s extension API for full lifecycle event coverage.

Integration Points

• Extension: ~/.pi/agent/extensions/nexus-memory.ts
• Transport: CLI (nexus session start, nexus ingest-hook-event)
• Fallback: Process monitoring + .pi/sessions/ file scanning

Lifecycle Coverage

All five lifecycle events are supported:

• session_start — via extension session_start event
• session_end — via extension session_shutdown event
• checkpoint — via debounced agent_end and explicit triggers
• error_hook — synthetic from failed tool_result / abnormal agent_end
• compact — via extension session_compact event

Implementations

impl PiMonoHook

pub const AGENT_TYPE: &'static str = "pi-mono"

Agent type string

pub const CONFIG_DIR_NAME: &'static str = ".pi"

Config directory name

pub const EXTENSIONS_SUBDIR: &'static str = "agent/extensions"

Extensions subdirectory

pub const SESSIONS_SUBDIR: &'static str = "sessions"

Sessions subdirectory

pub const LOGS_SUBDIR: &'static str = "logs"

Logs subdirectory

pub fn new() -> Self

Create a new Pi-Mono hook

pub fn new_readonly() -> Self

Create a new Pi-Mono hook without mutating user state.

Trait Implementations

impl AgentHook for PiMonoHook

fn agent_type(&self) -> &str

fn install_session_start_hook<'life0, 'async_trait>( &'life0 mut self, callback: SessionEndCallback, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn install_session_end_hook<'life0, 'async_trait>( &'life0 mut self, callback: SessionEndCallback, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn install_checkpoint_hook<'life0, 'async_trait>( &'life0 mut self, callback: SessionEndCallback, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn install_compact_hook<'life0, 'async_trait>( &'life0 mut self, callback: SessionEndCallback, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn install_error_hook<'life0, 'async_trait>( &'life0 mut self, callback: SessionEndCallback, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn detect_session_activity<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<SessionActivity>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn extract_session_context<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<SessionContext>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn is_hook_installed(&self) -> bool

fn reliability_score(&self) -> f32

fn lifecycle_capabilities(&self) -> LifecycleCapabilities

fn support_tier(&self) -> SupportTier

fn uninstall_hooks<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn record_activity(&self)

impl Default for PiMonoHook

fn default() -> Self

Returns the “default value” for a type.