Stateflows.Extensions.PlantUml 0.23.3-beta

Prefix Reserved
This is a prerelease version of Stateflows.Extensions.PlantUml.
dotnet add package Stateflows.Extensions.PlantUml --version 0.23.3-beta
                    
NuGet\Install-Package Stateflows.Extensions.PlantUml -Version 0.23.3-beta
                    
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="Stateflows.Extensions.PlantUml" Version="0.23.3-beta" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Stateflows.Extensions.PlantUml" Version="0.23.3-beta" />
                    
Directory.Packages.props
<PackageReference Include="Stateflows.Extensions.PlantUml" />
                    
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 Stateflows.Extensions.PlantUml --version 0.23.3-beta
                    
#r "nuget: Stateflows.Extensions.PlantUml, 0.23.3-beta"
                    
#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 Stateflows.Extensions.PlantUml@0.23.3-beta
                    
#: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=Stateflows.Extensions.PlantUml&version=0.23.3-beta&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Stateflows.Extensions.PlantUml&version=0.23.3-beta&prerelease
                    
Install as a Cake Tool

Introduction

Stateflows is a .NET framework for building stateful applications with executable state machines, data-flow activities, actions, and entities. Model business lifecycles, coordinate concurrent work, and process live streams through typed, testable C# APIs. Run locally or scale with Orleans, with persistence, messaging, and observability integrated into your behaviors.

Getting Started

Go to Stateflows homepage to learn more.

Startup serialization validation

Stateflows transports application events and activity tokens using Newtonsoft.Json, including inside Orleans envelopes. Orleans serializer attributes on an application event do not repair an incompatible JSON constructor.

Enable verification explicitly, optionally declaring payloads that visitors cannot discover (for example notifications published inside application code):

services.AddStateflows(builder =>
{
    builder.AddStateMachines(/* behavior registrations */);
    builder.AddStartupSerializationValidation(validation => validation
        .AddEvent<OrderCompleted>()
        .AddToken<ProcessingResult>()
        .AddSample(() => new Failure(new List<string> { "example" })));
});

Verification uses existing behavior visitors without changing routing registration. Definite defects fail startup with SER001-SER003 diagnostics naming the type/member and its behavior usage. Sample round-trip failures report SER004. Unverifiable contracts warn: custom converters, runtime polymorphism, computed members, recursive references and specialized collections need representative samples, optionally with semantic assertions. Samples exercise envelope cloning and, when registered, the Orleans transport envelope. They execute only when verification is enabled. Enabled hosts also check newly sent concrete event/token types before serialization; this is not exhaustive inspection of arbitrary object graphs.

A single parameterized constructor is supported when its parameters bind to serialized members by name and type. For example, Failure(List<string> messages) can populate Messages; an unrelated parameter name such as errorMessages cannot. With multiple constructors, select the intended one using Newtonsoft.Json.JsonConstructorAttribute, preserving matching bindings (or explicit JsonProperty names). Selecting a constructor alone does not fix a mismatch. Use semantic sample assertions for values a constructor computes or transforms.

Omit AddStartupSerializationValidation() to disable discovery, samples and additional runtime contract checks. Mandatory delivery error reporting remains enabled. See the implementation plan for visitor coverage limits and manual registration guidance.

Dispatch without waiting for processing

SendResult admission = await behavior.DispatchAsync(new Work());

IBehavior.DispatchAsync() copies the supplied headers, adds DispatchAndReturn and calls SendAsync(). Adding that header yourself, or applying the inherited DispatchAndReturnAttribute to an event type, also enables admission-only delivery. EventStatus.Dispatched confirms admission to a volatile receiver inbox, not processing, persistence or a guaranteed response. Dispatch-only RequestAsync() returns without a response. Ordinary sends and requests retain their existing processing-awaiting semantics. Combining dispatch-only delivery with Stream or JoinTransaction throws rather than weakening their guarantees.

Orleans and the legacy hosted runtime support admission-only delivery. Standalone execution explicitly rejects it. Context Send() remains void and nonblocking, with supervised dispatch; context DispatchAsync() lets an effect await admission safely, including a self-send with execution concurrency one. Behavior-originated dispatch passes through IBehaviorInterceptor.EventDispatchAsync: await next() inside try/catch to observe dispatch errors. The framework reports dispatch and post-admission processing failures through ILogger.LogError and Trace.WriteLine (⦗→s⦘), independently of startup validation.

Configure inbox limits separately from execution resource limits:

builder.ConfigureInbox(options => options.DefaultCapacity = 128);
// On an action, activity, state-machine or entity builder:
behaviorBuilder.SetInboxCapacity(32);

Limits must be positive and count pending messages per behavior instance, excluding the executing message. A full inbox immediately returns Overloaded; admission does not wait for a resource permit. Admitted dispatches are drained in inbox order, but ordinary calls can overtake queued dispatches. Graceful shutdown drains admitted work within the shutdown timeout; process/silo loss can lose volatile work. Post-admission failures are receiver-side reports, not a later fault on the already-completed dispatch task.

Deploy matching framework/runtime packages to every hosting silo. Dispatch uses a new inbox grain contract: Orleans must find a host for that grain and behavior; an unsupported deployment fails rather than falling back to a normal processing RPC or returning a fabricated Dispatched. No rolling-version interoperability is promised. Generated HTTP event/request endpoints return 202 for Dispatched, without a follow-up target status query or notification wait.

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

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.23.3-beta 0 11/19/2026
0.23.2-beta 40 11/17/2026
0.23.1-beta 56 11/12/2026
0.23.0-beta 54 11/11/2026
0.22.0-beta 66 10/28/2026
0.21.1-beta 73 10/20/2026
0.21.0-beta 65 10/19/2026
0.20.13-beta 77 9/25/2026
0.20.12-beta 88 9/8/2026
0.20.11-beta 83 9/7/2026
0.20.10-beta 80 9/2/2026
0.20.9-beta 84 9/1/2026
0.20.8-beta 96 8/17/2026
0.20.7-beta 92 8/6/2026
0.20.6-beta 94 8/5/2026
0.20.5-beta 98 7/23/2026
0.20.4-beta 99 6/24/2026
0.20.3-beta 91 6/24/2026
0.20.2-beta 101 6/23/2026
0.19.7-beta 57 11/2/2026
Loading failed