Struct Scratchpad 

pub struct Scratchpad { /* private fields */ }

Adds bounded durable notes without exposing persistence details to the agent loop.

Implementations

impl Scratchpad

pub fn new(store: ScratchpadStore) -> Self

Creates scratchpad middleware backed by a shared concrete store.

Trait Implementations

impl Clone for Scratchpad

fn clone(&self) -> Scratchpad

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Middleware for Scratchpad

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

Stable ID used to reject duplicate registrations.

fn register( &self, catalog: &mut Catalog, runtime: &RuntimeContext, ) -> Result<()>

Adds tools to the catalog while the agent is created.

fn prompt_fragment(&self, _runtime: &RuntimeContext) -> Result<Option<String>>

Contributes immutable system instructions once while the agent is created.

fn frontend(&self) -> FrontendContribution

Declares commands and status data that any frontend may render.

fn render(&self, event: &EventMsg) -> Option<FrontendBlock>

Renders an event owned by this capability for thin frontend shells.

fn initialize<'a>( &'a self, context: RuntimeContext, ) -> BoxFuture<'a, Result<()>>

Restores middleware-owned durable state for this agent tree.

fn command<'a>( &'a self, context: MiddlewareCommandContext<'a>, ) -> BoxFuture<'a, Result<MiddlewareCommandOutput>>

Handles a command declared by this middleware’s frontend contribution.

fn decorate_model_request<'a>( &'a self, context: &'a mut ModelContext<'_>, ) -> BoxFuture<'a, Result<()>>

Applies request-only context after every durable transform has completed.

fn active_operations(&self) -> &'static [&'static str]

Declares active-turn operations owned by this middleware.

fn active_submission( &self, _context: &mut ActiveSubmissionContext<'_>, ) -> Result<ActiveSubmissionResult>

Handles one declared active-turn operation.

fn active_command( &self, _context: &mut ActiveCommandContext<'_>, ) -> Result<Option<ActiveSubmissionResult>>

Handles a capability command synchronously while a turn is active.

fn turn_ended(&self, _context: &mut TurnEndContext<'_>) -> Result<()>

Observes a turn ending and may clear capability-owned transient UI.

fn before_model<'a>( &'a self, _context: &'a mut ModelContext<'_>, ) -> BoxFuture<'a, Result<()>>

Mutates durable context before the next model request is assembled.

fn after_model<'a>( &'a self, _context: &'a mut AfterModelContext<'_>, ) -> BoxFuture<'a, Result<()>>

Observes one normalized response before it is checkpointed or dispatched.

fn shutdown<'a>( &'a self, _context: SessionEndContext, ) -> BoxFuture<'a, Result<()>>

Releases session-local state when the agent runtime stops.