Module dynamodb_checkpointer

Module dynamodb_checkpointer 

Source
Expand description

DynamoDB-backed checkpointer implementation for AWS deployments.

This checkpointer stores agent state in Amazon DynamoDB, providing:

  • Fully managed, serverless persistence
  • Automatic scaling and high availability
  • Global table support for multi-region deployments
  • Pay-per-request pricing with on-demand mode

§Table Schema

The checkpointer expects a DynamoDB table with the following schema:

  • Primary Key: thread_id (String)
  • Attributes:
    • state (Map/JSON) - The serialized agent state
    • updated_at (String) - ISO 8601 timestamp
    • ttl (Number, optional) - Unix epoch for automatic expiration

§Setup

Create the table using AWS CLI:

aws dynamodb create-table \
  --table-name agent-checkpoints \
  --attribute-definitions AttributeName=thread_id,AttributeType=S \
  --key-schema AttributeName=thread_id,KeyType=HASH \
  --billing-mode PAY_PER_REQUEST

Or use Terraform (see deploy/modules/dynamodb/).

Structs§

DynamoDbCheckpointer
DynamoDB-backed checkpointer for serverless AWS deployments.
DynamoDbCheckpointerBuilder
Builder for configuring a DynamoDB checkpointer.