AgentCircuits.Storage.Aws 0.4.6

AgentCircuits.Storage.Aws

AWS storage implementations (DynamoDB, S3) for the AgentCircuits agent framework.

Overview

This package provides production-ready persistence for AgentCircuits deployments on AWS ECS and other ephemeral compute environments. It uses:

• DynamoDB for sessions, events, async operations, and channel conversations (high write volume, query requirements)
• S3 for configuration entities (agents, providers, MCP servers, remote agents, channel configs)

Installation

dotnet add package AgentCircuits.Storage.Aws

Usage

using AgentCircuits.Storage.Aws;

builder.Services.AddAgentCircuitsPortal(portal =>
{
    portal.UseAwsStorage(options =>
    {
        options.Region = "eu-west-1";
        options.DynamoDbTablePrefix = "agentcircuits-";
        options.S3ConfigBucket = "my-config-bucket";
        options.S3ConfigPrefix = "config/";
    });
});

Configuration Options

DynamoDB Tables

The following tables are created/used:

• {prefix}sessions - Session metadata with GSIs for user/agent queries
• {prefix}session-events - Session events (separate for scalability)
• {prefix}session-participants - Participant-to-session mappings
• {prefix}async-operations - Async operation tracking with TTL
• {prefix}channel-conversations - Channel conversation mappings

IAM Permissions Required

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "dynamodb:GetItem",
                "dynamodb:PutItem",
                "dynamodb:UpdateItem",
                "dynamodb:DeleteItem",
                "dynamodb:Query",
                "dynamodb:Scan"
            ],
            "Resource": [
                "arn:aws:dynamodb:*:*:table/agentcircuits-*",
                "arn:aws:dynamodb:*:*:table/agentcircuits-*/index/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetObject",
                "s3:PutObject",
                "s3:DeleteObject",
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::my-config-bucket",
                "arn:aws:s3:::my-config-bucket/config/*"
            ]
        }
    ]
}

License

MIT