SWire.Extensions.Storage.FileSystem 0.8.5-beta

<div align="center">

<picture> <source media="(max-width: 600px)" srcset=" <div align='center'> <img src='assets/SWire-Logo_Big.png' width='100' style='display:block; margin:auto;' /> <h1 style='font-family:monospace; margin-top:10px;'> <span style='color:#54CFC0;'>S</span>Wire </h1> </div> "> <div align="center"> <table border="0" cellpadding="0" cellspacing="0"> <tr> <td valign="middle"> <img src="assets/SWire-Logo_Big.png" width="120" style="padding-right: 20px;" /> </td> <td valign="middle"> <h1 style="font-family: 'Courier New', monospace; font-size: 3em; border-bottom: none; margin: 0;"> <span style="color: #54CFC0;">S</span>Wire </h1> </td> </tr> </table> </div> </picture>

<p align="center"> <strong>The Agnostic Agent Orchestrator & Tunneling Bridge</strong> </p>

<p align="center"> <img src="https://img.shields.io/github/actions/workflow/status/Swire-Labs/SWire/ci-cd.yml?branch=dev&style=for-the-badge&logo=github&label=Build" alt="Build Status" /> <img src="https://img.shields.io/badge/NuGet-v0.8.5--beta-blue.svg?style=for-the-badge&logo=nuget" alt="NuGet Version" /> <img src="https://img.shields.io/badge/Coverage-100%25-brightgreen.svg?style=for-the-badge&logo=codecov" alt="Code Coverage" /> <img src="https://img.shields.io/badge/.NET-10.0-512bd4.svg?style=for-the-badge&logo=dotnet" alt=".NET 10" /> <img src="https://img.shields.io/github/license/Swire-Labs/SWire?style=for-the-badge" alt="License" /> </p>

</div>

🌐 Orchestration Without Borders

SWire is a modular, high-performance orchestration framework designed for Agents as a Service (AaaS). It decouples agent logic from network constraints, providing a secure, transport-agnostic bridge that enables seamless communication across any protocol.

Whether you are bridging SignalR to gRPC, or routing MCP (Model Context Protocol) messages across hybrid clouds, SWire acts as the intelligent nervous system for your agentic infrastructure.

🚀 Why SWire?

🧩 Transport-Agnostic Orchestration

Stop worrying about the underlying protocol. SWire's Strategy-Based Routing handles the complexity of message delivery. Swap SignalR for gRPC or add your own transport without changing a single line of business logic.

🏢 Built for Scalability & Multi-Tenancy

Designed from the ground up for massive agent fleets. Built-in support for User Isolation, Group Scoping, and Hierarchical Routing ensures your infrastructure scales with your user base.

🇪🇺 EU-Centric Sovereignty & GDPR Ready

Built with European data standards in mind. SWire enables organizations to maintain full sovereignty over their agentic infrastructure. By keeping the orchestration layer zero-knowledge and implementing strict Metadata Anonymization, you ensure that PII (Personally Identifiable Information) never leaves your trust boundary.

🛡️ Secure-by-Design Tunneling

End-to-end encryption (E2EE) is not an afterthought. SWire provides native AES-256-GCM encryption and RSA-based trust establishment. The Hub acts as a zero-knowledge relay—it routes messages without ever seeing the content, perfectly aligning with data residency and sovereignty requirements.

🔌 Extreme Modularity

Install only what you need. SWire is broken down into lean, focused modules:

• Core: Routing logic and security primitives.
• Transports: SignalR, gRPC, and more.
• Extensions: Redis Caching, FileSystem Storage, Anonymization.
• Protocols: Native support for MCP (Model Context Protocol).

📦 Getting Started

1. The Hub (Central Orchestrator)

The Hub manages agent registration and intelligent message relaying.

var builder = WebApplication.CreateBuilder(args);

// Add SWire Core Orchestration
builder.Services.AddSWireServer()
    .AddRedisBackplane("localhost:6379"); // Optional: Scale out

var app = builder.Build();

// Expose multiple transport protocols simultaneously
app.MapSWireHub(); // SignalR (HTTP/1.1 compatible)
app.MapSWireGrpcService(); // gRPC (HTTP/2 high performance)

app.Run();

2. The Agent (Client)

Connect your agent through any supported tunnel.

var services = new ServiceCollection();
services.AddSWire();
services.AddSWireSignalRClient("https://hub.acme-agents.com/agentHub");

var provider = services.BuildServiceProvider();
var transport = provider.GetRequiredService<IMessageTransport>();

// Establish secure tunnel & Start orchestrating
await transport.ConnectAsync();

🏗 Modular Ecosystem

💎 Open-Core & Enterprise

SWire follows an Open-Core model. We provide the essential secure plumbing to the community while offering advanced binary optimizations and enterprise-grade features for high-scale environments.

🗺️ Roadmap

• v0.8.5: Modular refactoring & gRPC Bridge alpha.
• v0.9.0: Advanced Tenancy Isolation & Result<T> pattern adoption.
• v1.0.0: Production-ready Stability & High-Performance binary optimizations.

<p align="center"> Built with ❤️ for the Privacy-Conscious AI future.<br/> <strong>Part of the <a href="https://github.com/Swire-Labs">Swire-Labs</a> ecosystem.</strong><br/> Contact: <a href="mailto:swire-labs@proton.me">swire-labs@proton.me</a> </p>