Coven.Core 2.0.1

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package Coven.Core --version 2.0.1
                    


                    

                
NuGet\Install-Package Coven.Core -Version 2.0.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Coven.Core" Version="2.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Coven.Core" Version="2.0.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Coven.Core" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Coven.Core --version 2.0.1
                    


                    

                
#r "nuget: Coven.Core, 2.0.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Coven.Core@2.0.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Coven.Core&version=2.0.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Coven.Core&version=2.0.1
                    


                            Install as a Cake Tool

Coven.Core

Engine primitives for composing and running a Coven: MagikBlocks, Scriveners (journals), orchestration, and DI helpers to build a spine (ritual) of work.

What’s Inside

  • IMagikBlock<TIn,TOut>: unit of work with DoMagik.
  • IScrivener<T>: append‑only, typed journal with tailing; includes InMemoryScrivener<T>.
  • Builder: BuildCoven, CovenServiceBuilder to register blocks and finalize runtime.
  • Orchestration: ICoven to invoke rituals; IBoard and pull mode options.
  • Utilities: Empty marker type; capability tags and selection strategy hooks.

Why use it?

  • Deterministic pipelines: execute a chain of typed blocks with explicit I/O.
  • Decoupled comms: components communicate via journals instead of callbacks.
  • Testable by design: swap InMemoryScrivener<T> and run blocks in isolation.

Usage

using Coven.Core;
using Coven.Core.Builder;
using Microsoft.Extensions.DependencyInjection;

// A minimal block that writes/reads journals or orchestrates other services
internal sealed class HelloBlock : IMagikBlock<Empty, Empty>
{
    public Task<Empty> DoMagik(Empty input, CancellationToken cancellationToken = default)
    {
        // do work; start daemons; read/write journals
        return Task.FromResult(input);
    }
}

ServiceCollection services = new();

services.BuildCoven(c =>
{
    c.MagikBlock<Empty, Empty, HelloBlock>();
    c.Done();
});

ServiceProvider provider = services.BuildServiceProvider();
ICoven coven = provider.GetRequiredService<ICoven>();
await coven.Ritual<Empty, Empty>(new Empty());

Testing

  • Prefer InMemoryScrivener<T> for journals and invoke blocks directly.
  • Treat OperationCanceledException as cooperative shutdown when using tokens.

See Also

  • Architecture: Journaling and Scriveners; Windowing and Shattering.
  • Samples: src/samples/01.DiscordAgent for end‑to‑end orchestration.
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (9)

Showing the top 5 NuGet packages that depend on Coven.Core:

Package Downloads
Coven.Chat

Chat primitives and windowing integration for Coven.
Coven.Spellcasting

Spell contracts, schema generation, and spellbooks for Coven.
Coven.Spellcasting.Agents.Validation

Package Description
Coven.Daemonology

Daemon scaffolding: status/failure contracts for long-running services.
Coven.Core.Streaming

Streaming/windowing utilities and daemon for chunked message flows.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.1 390 11/11/2025
2.0.0 366 11/11/2025
1.0.1-preview.pr43.36.8606c07 126 11/8/2025
1.0.1-preview.pr41.34.92b660c 152 11/2/2025
1.0.1-preview.pr40.32.83e0f6a 116 11/2/2025
1.0.1-preview.pr27.17.f335ec5 165 10/7/2025
1.0.1-preview.pr24.14.6d41e78 170 10/1/2025
1.0.1-preview.pr23.13.d459c52 152 9/28/2025
1.0.1-preview.pr22.12.4f5e840 101 9/27/2025
1.0.1-preview.pr19.9.009bd20 170 9/25/2025
1.0.1-preview.pr18.8.1344f0a 167 9/1/2025
1.0.1-preview.pr17.7.b635fa1 172 8/31/2025
1.0.1-preview.pr17.6.cc737ce 163 8/31/2025
1.0.1-preview.pr17.5.89bfd90 167 8/31/2025
1.0.1-preview.pr17.4.fa90205 168 8/31/2025
1.0.0 271 8/30/2025
0.1.0-preview.pr17.3.d408821 170 8/31/2025