Design Microsoft Orleans systems from each primitive's purpose and failure model.
ManagedCode.Orleans.SignalR
Integrate ManagedCode.Orleans.SignalR for grain-driven SignalR delivery, connection and group routing, offline user queues, and restart-safe state. USE FOR: Orleans backplane setup, grain-to-hub publishing, reconnect, heartbeat, and client-invocation failures. DO NOT USE FOR: ordinary SignalR without Orleans or unrelated persistence. INVOKES: inspect configuration, implement the integration, and validate connected-client delivery.
Trigger On
- configuring an Orleans SignalR backplane or sending messages from grains
- diagnosing connection, group, or user routing across hosts
- upgrading offline delivery, heartbeat persistence, or client invocation handling
Workflow
- Choose combined or separate silo/endpoint hosts and align packages, clustering, partition options, and named storage.
- Configure authenticated connection, user, and group targeting.
- Keep publishing at an explicit domain-event boundary and decide whether bounded offline retention is sufficient.
- Exercise live delivery, reconnect replay, queue limits, heartbeat cleanup, and interrupted client invocations.
- Before upgrades, validate prior persisted payloads with the production serializer and choose an explicit compatibility or maintenance-window strategy.
Deliver
- configured backplane and named storage with a stated durability boundary
- a working publisher and client receiver
- evidence for the required live, offline, restart, and failure behavior
Validate
dotnet restoreanddotnet buildresolve the aligned package set- a real connected client receives a grain-originated message on another host
- user/group isolation, reconnect, queue expiry/overflow, and heartbeat cleanup work
- restart tests preserve queued messages only when durable storage is configured
- cancellation and missing-client completion terminate predictably
- tests keep unrelated cases parallel; isolate destructive restart tests by their owned cluster
Related skills
Integrate ManagedCode.Orleans.Graph into an Orleans-based .NET application for grain-call policy enforcement, deadlock detection, live-call telemetry, and Mermaid graph…
Related agents
Orleans Specialist
Orleans specialist agent for purpose-first grain design, state versus database ownership, timers, reminders, Durable Jobs, stateless workers…
Also works: dotnet agents install orleans-specialist