Struct Transaction 

pub struct Transaction { /* private fields */ }

Transaction for atomic file operations.

The Transaction manages file snapshots and provides rollback capability. Files are snapshot before mutation, and can be restored to their original state if the transaction fails.

Implementations

impl Transaction

pub async fn begin() -> Result<Self, AgentError>

Begins a new transaction with a unique ID.

Creates a fresh transaction with no snapshots and Active state.

pub async fn snapshot_file(&mut self, path: &Path) -> Result<(), AgentError>

Snapshots a file before mutation.

If the file exists, stores its content for rollback. If the file doesn’t exist, stores an empty snapshot (indicating the file should be deleted on rollback).

Arguments

• path - Path to the file to snapshot

pub async fn rollback(self) -> Result<(), AgentError>

Rolls back the transaction, restoring all files to original state.

Iterates through snapshots in reverse order and restores each file. Files that didn’t exist before are deleted.

Errors

Returns an error if the transaction is not in Active state.

pub async fn commit(self) -> Result<Uuid, AgentError>

Commits the transaction, generating a commit ID.

Returns

The commit ID (UUID).

pub fn id(&self) -> Uuid

Returns the transaction ID.

pub fn state(&self) -> &TransactionState

Returns the current transaction state.

Trait Implementations

impl Clone for Transaction

fn clone(&self) -> Transaction

Returns a duplicate of the value.

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

Performs copy-assignment from source.