Struct Scratchpad 

pub struct Scratchpad { /* private fields */ }

Scratchpad for interrupt handling and transient data storage

Used by the HITL system to track processed interrupts, maintain an audit trail, and store transient data during interrupt handling.

Implementations

impl Scratchpad

pub fn new() -> Self

Create a new empty scratchpad

pub fn is_interrupt_processed(&self, id: &str) -> bool

Check if an interrupt has been processed

Arguments

• id - The interrupt ID to check

Returns

true if the interrupt has been processed, false otherwise

pub fn get_null_resume(&self, interrupt_id: &str) -> bool

Check if a confirmation-only resume is valid for the given interrupt.

Returns true when the interrupt has already been processed, meaning the caller can resume without providing an explicit value.

pub fn mark_interrupt_processed(&mut self, id: &str)

Mark an interrupt as processed

Arguments

• id - The interrupt ID to mark as processed

pub fn get_data(&self, key: &str) -> Option<&Value>

Get transient data by key

Arguments

• key - The data key

Returns

The stored value, if it exists

pub fn set_data(&mut self, key: String, value: Value)

Set transient data

Arguments

• key - The data key
• value - The value to store

pub fn record_interrupt(&mut self, id: String, node: String, payload: Value)

Record an interrupt event in the audit trail

Creates a new record with the current timestamp and adds it to the interrupt history.

Arguments

• id - The interrupt ID
• node - The node name where the interrupt occurred
• payload - The interrupt payload

pub fn record_resume(&mut self, id: &str, value: Value)

Record that an interrupt was resumed

Finds the interrupt record by ID and updates it with the resume timestamp and value.

Arguments

• id - The interrupt ID to mark as resumed
• value - The resume value provided

pub fn interrupt_history(&self) -> &[InterruptRecord]

Get the complete interrupt history

Returns all interrupt records in chronological order.

Returns

A slice of all interrupt records

pub fn clear_transient(&mut self)

Clear transient scratchpad entries

Removes entries that are not persistent (entries not prefixed with null_resume:). Persistent entries are preserved.

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 Debug for Scratchpad

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Scratchpad

fn default() -> Scratchpad

Returns the “default value” for a type.