Struct FilesystemMiddleware 

pub struct FilesystemMiddleware { /* private fields */ }

Middleware that evicts large tool results to files in the backend.

After a tool call, if the result exceeds eviction_threshold tokens (~4 chars/token), the full result is written to .evicted/{tool_call_id}.txt and replaced with a preview showing the first and last 5 lines.

Implementations

impl FilesystemMiddleware

pub fn new(backend: Arc<dyn Backend>, eviction_threshold_tokens: usize) -> Self

Trait Implementations

impl AgentMiddleware for FilesystemMiddleware

fn wrap_tool_call<'life0, 'life1, 'async_trait>( &'life0 self, request: ToolCallRequest, next: &'life1 dyn ToolCaller, ) -> Pin<Box<dyn Future<Output = Result<Value, SynapticError>> + Send + 'async_trait>>

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

Wraps a tool call. Override to intercept or replace tool execution.

fn before_agent<'life0, 'life1, 'async_trait>( &'life0 self, _messages: &'life1 mut Vec<Message>, ) -> Pin<Box<dyn Future<Output = Result<(), SynapticError>> + Send + 'async_trait>>

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

Called once when the agent starts executing.

fn after_agent<'life0, 'life1, 'async_trait>( &'life0 self, _messages: &'life1 mut Vec<Message>, ) -> Pin<Box<dyn Future<Output = Result<(), SynapticError>> + Send + 'async_trait>>

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

Called once when the agent finishes executing.

fn before_model<'life0, 'life1, 'async_trait>( &'life0 self, _request: &'life1 mut ModelRequest, ) -> Pin<Box<dyn Future<Output = Result<(), SynapticError>> + Send + 'async_trait>>

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

Called before each model invocation. Can modify the request.

fn after_model<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _request: &'life1 ModelRequest, _response: &'life2 mut ModelResponse, ) -> Pin<Box<dyn Future<Output = Result<(), SynapticError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

Called after each model invocation. Can modify the response.

fn wrap_model_call<'life0, 'life1, 'async_trait>( &'life0 self, request: ModelRequest, next: &'life1 dyn ModelCaller, ) -> Pin<Box<dyn Future<Output = Result<ModelResponse, SynapticError>> + Send + 'async_trait>>

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

Wraps the model call. Override to intercept or replace the model invocation.

fn before_file_op<'life0, 'life1, 'async_trait>( &'life0 self, _op: &'life1 FileOp, ) -> Pin<Box<dyn Future<Output = Result<FileOpDecision, SynapticError>> + Send + 'async_trait>>

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

Called before a file operation. Return Deny to block it.

fn after_file_op<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _op: &'life1 FileOp, _result: &'life2 FileOpResult, ) -> Pin<Box<dyn Future<Output = Result<(), SynapticError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

Called after a file operation completes.

fn before_command<'life0, 'life1, 'async_trait>( &'life0 self, _cmd: &'life1 CommandOp, ) -> Pin<Box<dyn Future<Output = Result<CommandDecision, SynapticError>> + Send + 'async_trait>>

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

Called before a shell command. Return Deny to block it.

fn after_command<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _cmd: &'life1 CommandOp, _result: &'life2 CommandResult, ) -> Pin<Box<dyn Future<Output = Result<(), SynapticError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

Called after a shell command completes.