Add per-actor-type runtime configuration overrides to Actors Next by m3nax · Pull Request #1879 · dapr/dotnet-sdk

m3nax · 2026-08-04T06:41:20Z

Description

This PR adds per-actor-type runtime configuration overrides to Actors Next. Today the idle timeout, drain, and reentrancy settings can only be configured globally through DaprActorsOptions, even though the runtime already opens one SubscribeActorEvents stream per actor type and the protocol (ActorEntityConfig) supports per-entity overrides.

Issue reference

We strive to have all PR being opened based on an issue, where the problem or feature have been discussed prior to implementation.

Please reference the issue this PR will close: #[issue number]

Checklist

Please make sure you've completed the relevant tasks for this PR, out of the following list:

Code compiles correctly
Created/updated tests
Extended the documentation

Signed-off-by: Manuel Menegazzo <manuel.menegazzo@outlook.com>

Copilot

Pull request overview

Adds first-class support for per-actor-type runtime configuration overrides (“type options”) in Actors Next, and wires those overrides through registration, source generation, and sidecar stream advertisement so each actor type can publish a merged SubscribeActorEventsInitialConfig.

Changes:

Introduces DaprActorTypeOptions and new registration APIs to capture per-type overrides alongside global DaprActorsOptions.
Updates stream advertisement to merge per-type overrides over the effective (global/per-registration) options when building SubscribeActorEventsInitialConfig.
Expands unit/integration coverage and adds a new tutorial example demonstrating per-type idle timeout and reentrancy overrides.

Reviewed changes

Copilot reviewed 31 out of 31 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
test/Dapr.IntegrationTest.Actors.Next/RealSidecarActorTests.cs	Adds integration coverage verifying per-type merged config is advertised to the real sidecar.
test/Dapr.Actors.Next.SourceGenerators.Test/GeneratorTests.cs	Verifies generator emits `typeOptions:` and that explicit type options flow into runtime registration.
test/Dapr.Actors.Next.Core.Test/GeneratedActorEventsTransportTests.cs	Adds coverage for initial-config mapping (drain/reentrancy/depth) into entity config.
test/Dapr.Actors.Next.Core.Test/CoreRuntimeTests.cs	Adds coverage for global defaults, per-type merged overrides, and override precedence in stream advertisement.
test/Dapr.Actors.Next.Core.Test/CoreEdgeCaseTests.cs	Asserts runtime registration + builder surface `TypeOptions` consistently.
test/Dapr.Actors.Next.Analyzers.Test/ActorsNextAnalyzerTests.cs	Adds analyzer scenario using explicit registration alias with type options.
test/Dapr.Actors.Next.Abstractions.Test/OptionsTests.cs	Adds options-level tests for storing/overwriting/validating/preserving type options.
src/Dapr.Actors.Next.SourceGenerators/ActorsNextSourceGenerator.cs	Updates generated module to pass per-type options into registration builder calls.
src/Dapr.Actors.Next.Core/Transport/SubscribeActorEventsStreamManager.cs	Merges per-type overrides when creating `SubscribeActorEventsInitialConfig`.
src/Dapr.Actors.Next.Core/Registration/ActorRuntimeRegistrationBuilder.cs	Extends builder `Add` overloads to accept per-type options.
src/Dapr.Actors.Next.Core/Registration/ActorRuntimeRegistration.cs	Stores `TypeOptions` on runtime registration for downstream advertisement.
src/Dapr.Actors.Next.Abstractions/Options/DaprActorTypeOptions.cs	New options type defining nullable per-type override fields.
src/Dapr.Actors.Next.Abstractions/Options/DaprActorsOptionsValidator.cs	Extends validation to include per-type option validation.
src/Dapr.Actors.Next.Abstractions/Options/DaprActorRegistrationCollection.cs	Adds `RegisterActor` overloads that accept per-type override configuration.
src/Dapr.Actors.Next.Abstractions/Options/DaprActorRegistration.cs	Extends explicit registration metadata to carry `TypeOptions`.
examples/Actor.Next/README.md	Adds new example entry for per-type options.
examples/Actor.Next/07-PerTypeOptions/Store.Next.Example07.Tests/Store.Next.Example07.Tests.csproj	New test project for the per-type options example.
examples/Actor.Next/07-PerTypeOptions/Store.Next.Example07.Tests/PerTypeOptionsTests.cs	Example tests verifying runtime registrations receive per-type overrides.
examples/Actor.Next/07-PerTypeOptions/Store.Next.Example07.http	Adds request script for the sample endpoints.
examples/Actor.Next/07-PerTypeOptions/Store.Next.Example07.csproj	New sample project showcasing per-type options.
examples/Actor.Next/07-PerTypeOptions/Store.Next.Example07.AppHost/Store.Next.Example07.AppHost.csproj	Adds Aspire AppHost for running sample + sidecar together.
examples/Actor.Next/07-PerTypeOptions/Store.Next.Example07.AppHost/Properties/launchSettings.json	Launch settings for the AppHost.
examples/Actor.Next/07-PerTypeOptions/Store.Next.Example07.AppHost/Directory.Build.props	AppHost build props (target framework/packability).
examples/Actor.Next/07-PerTypeOptions/Store.Next.Example07.AppHost/AppHost.cs	Configures the sample project with a Dapr sidecar via Aspire.
examples/Actor.Next/07-PerTypeOptions/README.md	Documents the per-type options sample and how to run it.
examples/Actor.Next/07-PerTypeOptions/Properties/launchSettings.json	Launch settings for the sample app.
examples/Actor.Next/07-PerTypeOptions/Program.cs	Sample app wiring: global defaults + per-type overrides + minimal API endpoints.
examples/Actor.Next/07-PerTypeOptions/InventoryActor.cs	Inventory actor type used by the per-type options sample.
examples/Actor.Next/07-PerTypeOptions/CheckoutSessionActor.cs	Checkout session actor type used by the per-type options sample.
examples/Actor.Next/07-PerTypeOptions/appsettings.json	Kestrel endpoint config for HTTP API + gRPC app channel.
all.sln	Adds the new example projects to the solution.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Signed-off-by: Manuel Menegazzo <65919883+m3nax@users.noreply.github.com>

WhitWaldo · 2026-08-05T09:41:30Z

@m3nax This tentatively looks great - excellent idea. I'll give it a more thorough review this week and get it merged in. Thank you for taking the time!

WhitWaldo

Thank you for your contribution. This is an excellent addition and I thank you for taking the time to put it together. I've made a couple of notes throughout - could you please review each of them and correct accordingly so I can get this merged and released? Again, thank you!

WhitWaldo · 2026-08-14T18:23:56Z

+/// over the actor event stream, so they have no effect when
+/// <see cref="DaprActorsOptions.EnableSidecarTransport"/> is <see langword="false"/>.
+/// </summary>
+public sealed class DaprActorTypeOptions


Please consider adding DisableStateMigration on a per-actor option as it's in the DaprActorsOptions today. The other properties are fine to leave as a global value, but this would allow a per-type opt-out.

WhitWaldo · 2026-08-14T18:27:45Z

    /// <summary>
    /// Registers an actor type for hosting.
    /// </summary>
    public void RegisterActor<TActor>(string? actorTypeName = null)


To resolve the CS0121, can you please mark this overload with [OverloadResolutionPriority]?

WhitWaldo · 2026-08-14T18:30:32Z

+                continue;
+            }
+
+            var actorName = registration.ActorImplementationType.Name;


I might suggest this be changed to registration.ActorTypeName ?? registration.ActorImplementationType.Name so the message will match what's advertised (e.g. if a custom ActorTypeName is specified).

WhitWaldo · 2026-08-14T18:31:34Z

+    /// Gets or sets a value indicating whether rebalanced actors of this type drain in-flight calls.
+    /// <see langword="null"/> inherits <see cref="DaprActorsOptions.DrainRebalancedActors"/>.
+    /// </summary>
+    public bool? DrainRebalancedActors { get; set; }


Please consider adding the DrainRebalancedActorsTimeout to the per-actor options as well to pair with this property.

WhitWaldo · 2026-08-14T18:32:30Z

-# Visual Studio Version 17
-VisualStudioVersion = 17.3.32929.385
+# Visual Studio Version 18
+VisualStudioVersion = 18.8.12023.21


Please revert lines 3-4 as I only modify these to track the .NET releases so we don't accidentally introduce errors for users on older VS versions.

Signed-off-by: Manuel Menegazzo <manuel.menegazzo@outlook.com>

m3nax · 2026-08-15T16:01:59Z

@WhitWaldo I've made the changes you asked for. Let me know if there's anything else.

m3nax added 2 commits August 4, 2026 07:42

Add per-actor-type runtime configuration overrides to Actors Next

0fe8fc3

Signed-off-by: Manuel Menegazzo <manuel.menegazzo@outlook.com>

Added example of 2 types actors with different configurations

118ab00

Signed-off-by: Manuel Menegazzo <manuel.menegazzo@outlook.com>

m3nax marked this pull request as ready for review August 4, 2026 07:54

m3nax requested review from a team as code owners August 4, 2026 07:54

WhitWaldo requested a lite review from Copilot August 5, 2026 08:27

Copilot started reviewing on behalf of WhitWaldo August 5, 2026 08:28 View session

Copilot AI reviewed Aug 5, 2026

View reviewed changes

Comment thread src/Dapr.Actors.Next.Abstractions/Options/DaprActorsOptionsValidator.cs Outdated

Potential fix for pull request finding

ebc2c2b

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Signed-off-by: Manuel Menegazzo <65919883+m3nax@users.noreply.github.com>

WhitWaldo requested changes Aug 14, 2026

View reviewed changes

m3nax added 2 commits August 15, 2026 17:56

Handled review comments

34c7b47

Signed-off-by: Manuel Menegazzo <manuel.menegazzo@outlook.com>

Added OverloadResolutionPriorityAttribute for net8.0 build target

b28b3e2

Signed-off-by: Manuel Menegazzo <manuel.menegazzo@outlook.com>

m3nax requested a review from WhitWaldo August 15, 2026 16:02

Navigation Menu

Uh oh!

Add per-actor-type runtime configuration overrides to Actors Next - #1879

Add per-actor-type runtime configuration overrides to Actors Next#1879
m3nax wants to merge 5 commits into
dapr:masterfrom
m3nax:feature/actors-next-per-type-options

m3nax commented Aug 4, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

WhitWaldo commented Aug 5, 2026

Uh oh!

WhitWaldo left a comment

Uh oh!

WhitWaldo Aug 14, 2026

Uh oh!

WhitWaldo Aug 14, 2026

Uh oh!

WhitWaldo Aug 14, 2026

Uh oh!

WhitWaldo Aug 14, 2026

Uh oh!

WhitWaldo Aug 14, 2026

Uh oh!

m3nax commented Aug 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

m3nax commented Aug 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Issue reference

Checklist

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

WhitWaldo commented Aug 5, 2026

Uh oh!

WhitWaldo left a comment

Choose a reason for hiding this comment

Uh oh!

WhitWaldo Aug 14, 2026

Choose a reason for hiding this comment

Uh oh!

WhitWaldo Aug 14, 2026

Choose a reason for hiding this comment

Uh oh!

WhitWaldo Aug 14, 2026

Choose a reason for hiding this comment

Uh oh!

WhitWaldo Aug 14, 2026

Choose a reason for hiding this comment

Uh oh!

WhitWaldo Aug 14, 2026

Choose a reason for hiding this comment

Uh oh!

m3nax commented Aug 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

m3nax commented Aug 4, 2026 •

edited

Loading