Wayfinder.Engine 0.4.1

There is a newer version of this package available.
See the version list below for details.

dotnet add package Wayfinder.Engine --version 0.4.1

NuGet\Install-Package Wayfinder.Engine -Version 0.4.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="Wayfinder.Engine" Version="0.4.1" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Wayfinder.Engine" Version="0.4.1" />
                    

                            Directory.Packages.props

<PackageReference Include="Wayfinder.Engine" />
                    

                            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 Wayfinder.Engine --version 0.4.1

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Wayfinder.Engine, 0.4.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 Wayfinder.Engine@0.4.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=Wayfinder.Engine&version=0.4.1
                    

                            Install as a Cake Addin

#tool nuget:?package=Wayfinder.Engine&version=0.4.1
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

A GDS-style service blueprint / service-design engine — domain model, calculation engine, state-machine engine, and a compiled visual editor web component. Framework-agnostic: no Umbraco, no ASP.NET Core MVC, no hosting assumptions baked in.

Wayfinder was extracted from Umbraco Prism, which is now a consumer of these packages rather than their owner. A host application — Umbraco-based or otherwise — layers its own tenancy, auth, and rendering opinions on top. Wayfinder.Umbraco is the Umbraco-hosted implementation Prism itself uses.

See it running

Wayfinder.AppHost + Wayfinder.ReferenceApp is a small, self-contained .NET Aspire host in this repo — every package wired together, real GOV.UK Design System rendering, a demo login, and a seeded "apply for a licence to hold a juggling event" journey. It's the fastest way to see what a working Wayfinder host actually looks like, and exactly how little wiring a real host (like Wayfinder.Umbraco) collapses into. Run it with dotnet run --project Wayfinder.AppHost, or the "C#: Aspire (Full Stack)" launch config in VS Code. See docs/guides/reference-app.md for what it implements, how the demo blueprint is seeded from JSON and only saved in memory, and what a real host does differently.

Packages

Package	Purpose
`Wayfinder`	Core domain models (`ServiceBlueprint`, `ServiceRequestResponseEnvelope`, etc.), the declarative calculation engine, and the sanitizer interface. Zero framework dependency.
`Wayfinder.Engine`	The service blueprint state-machine engine — queue routing, gateway evaluation, request persistence.
`Wayfinder.Engine.Api`	REST toolkit (`MapServiceBlueprintAuthoringApi()`) exposing service blueprint authoring — list/read/validate/save/simulate — over HTTP for any ASP.NET Core host.
`Wayfinder.Engine.Mcp`	MCP-over-HTTP toolkit (`MapServiceBlueprintAuthoringMcp()`) — the same authoring surface as MCP tools for AI agents.

The service blueprint model

A ServiceBlueprint describes a journey as queues (named work queues), stages (each owning its own routes), and gateways (first-class Split/Join routing nodes — a stage's routes must always target a gateway, never another stage directly). See docs/guides/reference-service-blueprint-contract.md for the full authoring schema, and docs/guides/calculation-language.md for the declarative expression language used in calculations and showWhen.

AI-ready authoring

Service blueprint authoring is exposed to AI agents (Claude Code or any MCP client) the same way it's exposed to a human editor: as a toolkit a host app wires into its own pipeline. Wayfinder.Engine.Api and Wayfinder.Engine.Mcp map the same list/read/validate/save/simulate operations as REST and MCP-over-HTTP respectively, both calling straight into a host's live Wayfinder.Engine in-process. See docs/guides/ai-service-blueprint-authoring.md.

Building

dotnet build Wayfinder.slnx
dotnet pack Wayfinder.slnx

License

MIT — see LICENSE.

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.

net10.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.7)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.7)
- Wayfinder (>= 0.4.1)

NuGet packages (8)

Showing the top 5 NuGet packages that depend on Wayfinder.Engine:

Package	Downloads
UmbracoPrism Multi-tenancy for Umbraco (v17+) with dynamic branding and stateless identity.	3.7K
Wayfinder.Engine.Mcp ASP.NET Core MCP-over-HTTP endpoint mapping that exposes Umbraco Prism service blueprint authoring (list/read/validate/save/simulate) as MCP tools — a single MapPrismServiceBlueprintAuthoringMcp() call any host adds to its own pipeline, alongside MapPrismServiceBlueprintAuthoringApi(), inheriting its own auth.	2.7K
Wayfinder.Engine.Api ASP.NET Core minimal-API endpoint mapping that exposes Umbraco Prism service blueprint authoring (list/read/validate/save/simulate) as HTTP endpoints — a single MapPrismServiceBlueprintAuthoringApi() call any host adds to its own pipeline, inheriting its own auth.	2.6K
Wayfinder.Umbraco Umbraco-hosted implementation of Wayfinder service design — a DB-backed, uSync-portable service blueprint store, a backoffice authoring API, and two Block Grid-composable building blocks (a citizen-facing stage journey and a caseworker-facing worklist) for any Umbraco v17+ site. An authoritative in-process engine, real multi-queue support, no multi-tenancy or auth opinions of its own; a host wires its own identity/tenant resolution on top.	2.5K
Wayfinder.Engine.Worklist A default, optional caseworker worklist surface — server-rendered GOV.UK markup for the filter/sort/search/paginated list (see docs/guides/queue-worklist-filtering.md), an item review page, advance, and per-cursor pickup/putback (see docs/guides/work-allocation.md). A host wires it up with AddWorklist()/MapWorklist(prefix), supplying only tenant/actor resolution and its own page chrome — or ignores this package entirely and hand-writes the same routes itself, as Wayfinder.ReferenceApp originally did.	82

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
0.7.6	124	8/24/2026
0.7.5	134	8/21/2026
0.7.4	123	8/21/2026
0.7.3	106	8/21/2026
0.7.2	141	8/20/2026
0.7.1	152	8/20/2026
0.7.0	152	8/19/2026
0.6.0	112	8/17/2026
0.4.10	118	8/12/2026
0.4.9	120	8/10/2026
0.4.8	137	8/9/2026
0.4.7	116	8/9/2026
0.4.6	139	8/5/2026
0.4.5	152	8/4/2026
0.4.4	140	8/4/2026
0.4.3	154	8/4/2026
0.4.2	130	8/4/2026
0.4.1	118	8/3/2026
0.4.0	119	8/3/2026
0.3.0	151	8/2/2026