AgentCircuits.Storage.Sql 0.7.134

AgentCircuits.Storage.Sql

PostgreSQL storage implementation for the AgentCircuits agent framework.

Overview

AgentCircuits.Storage.Sql provides production-ready persistence for multi-user deployments with session ownership and access control. It implements the storage interfaces from the core AgentCircuits package using PostgreSQL as the backing store.

Features

• Session Storage: Persistent storage for agent sessions with ownership tracking
• Message History: Store and retrieve conversation history
• A2A Task Storage: Support for Agent-to-Agent protocol task persistence
• Channel Storage: Persistent storage for communication channels
• Access Control: Session ownership and user-based access control
• Connection Pooling: Efficient database connection management via Npgsql

Installation

dotnet add package AgentCircuits.Storage.Sql

Current Limitation

AgentCircuits.Storage.Sql currently includes transitive dependencies on AgentCircuits.Channels and AgentCircuits.A2A.

This is because SQL repository adapters for channels and A2A task storage are implemented in this package. Even if you only need core SQL-backed session/message storage, those optional integration packages are still pulled in today.

Configuration

services.AddAgentCircuitsSql(options =>
{
 options.ConnectionString = "Host=localhost;Database=agentcircuits;Username=user;Password=pass";
});

Requirements

• .NET 10.0 or later
• PostgreSQL 14 or later

Licence

MIT