Struct PostgresCheckpointer 

pub struct PostgresCheckpointer { /* private fields */ }

PostgreSQL-backed checkpointer with connection pooling.

Examples

use agents_persistence::PostgresCheckpointer;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // Basic usage
    let checkpointer = PostgresCheckpointer::new(
        "postgresql://user:pass@localhost/agents"
    ).await?;

    // With custom pool configuration
    let checkpointer = PostgresCheckpointer::builder()
        .url("postgresql://user:pass@localhost/agents")
        .table_name("my_checkpoints")
        .max_connections(20)
        .build()
        .await?;

    Ok(())
}

Implementations

impl PostgresCheckpointer

pub async fn new(database_url: &str) -> Result<Self>

Create a new PostgreSQL checkpointer with default settings.

This will automatically create the checkpoints table if it doesn’t exist.

Arguments

• database_url - PostgreSQL connection string

pub fn builder() -> PostgresCheckpointerBuilder

Create a builder for configuring the PostgreSQL checkpointer.

Trait Implementations

impl Checkpointer for PostgresCheckpointer

fn save_state<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, thread_id: &'life1 ThreadId, state: &'life2 AgentStateSnapshot, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Save the current agent state for a given thread.

fn load_state<'life0, 'life1, 'async_trait>( &'life0 self, thread_id: &'life1 ThreadId, ) -> Pin<Box<dyn Future<Output = Result<Option<AgentStateSnapshot>>> + Send + 'async_trait>>

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

Load the last saved state for a given thread. Returns None if no state exists for this thread.

fn delete_thread<'life0, 'life1, 'async_trait>( &'life0 self, thread_id: &'life1 ThreadId, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Delete all saved state for a given thread.

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

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

List all thread IDs that have saved state.

impl Clone for PostgresCheckpointer

fn clone(&self) -> PostgresCheckpointer

Returns a duplicate of the value.

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

Performs copy-assignment from source.