Axial.Hosting
0.14.1
Prefix Reserved
dotnet add package Axial.Hosting --version 0.14.1
NuGet\Install-Package Axial.Hosting -Version 0.14.1
<PackageReference Include="Axial.Hosting" Version="0.14.1" />
<PackageVersion Include="Axial.Hosting" Version="0.14.1" />
<PackageReference Include="Axial.Hosting" />
paket add Axial.Hosting --version 0.14.1
#r "nuget: Axial.Hosting, 0.14.1"
#:package Axial.Hosting@0.14.1
#addin nuget:?package=Axial.Hosting&version=0.14.1
#tool nuget:?package=Axial.Hosting&version=0.14.1
Axial
<picture> <source media="(prefers-color-scheme: dark)" srcset="docs/content/img/axial-readme-dark.svg"> <source media="(prefers-color-scheme: light)" srcset="docs/content/img/axial-readme-light.svg"> <img alt="Axial" src="docs/content/img/axial-readme-light.svg" width="160"> </picture>
Write asynchronous F# workflows whose expected failures and required dependencies are visible in their types.
Axial is pre-1.0 and its API may change before the first stable release.
Your first flow
A handler usually needs services and can fail, but a Task signature shows neither fact. Flow<'env, 'error, 'value>
makes both part of the contract.
open Axial
type CheckoutError =
| OrderNotFound of orderId: int
| PaymentDeclined of reason: string
type Receipt = { OrderId: int; Total: decimal; Reference: string }
type CheckoutEnv =
{ FindTotal: int -> ColdTask<Result<decimal, CheckoutError>>
Charge: decimal -> ColdTask<Result<string, CheckoutError>> }
let checkout orderId : Flow<CheckoutEnv, CheckoutError, Receipt> =
flow {
let! findTotal = Flow.envWith _.FindTotal
let! charge = Flow.envWith _.Charge
let! total = findTotal orderId
let! reference = charge total
return { OrderId = orderId; Total = total; Reference = reference }
}
The application supplies live functions. A test supplies a record of fakes. The workflow does not change.
Adding a timeout and a retry policy leaves the Flow<CheckoutEnv, CheckoutError, Receipt> signature unchanged.
The runtime supplies its clock and owns cancellation, retries, and cleanup:
open System
let checkoutOrder orderId : Flow<CheckoutEnv, CheckoutError, Receipt> =
checkout orderId
|> Flow.retry (Schedule.recurs 2)
|> Flow.timeout (TimeSpan.FromSeconds 5.0) (PaymentDeclined "checkout timed out")
Flow also carries concurrency, scheduling, streams, and structured child fibers through the same runtime.
Clock, random and GUID values are scoped runtime services; application authority stays in 'env. Use
Flow.withClock, Flow.withRandom and Flow.withGuid to override values for a flow and its descendants.
Log.info writes to the current ILogSink (Information+ on stderr by default); install or decorate destinations
with Flow.withLogSink / Flow.mapLogSink, and observation callbacks with Flow.withTelemetry.
Core Axial ships these runtime services under the Axial namespace. Flow.runTest env creates a
fresh epoch manual clock, seeded random, sequential GUIDs and a recording log. Timed tests explicitly advance
TestClock after observing sleeper registration; time never advances automatically. See runtime services.
Install
dotnet add package Axial
Package family
Axial: the core workflow model: typed failures, dependencies, concurrency, resources, schedules, streams, and runtime platform services.Axial.Process: external process composition, pipelines, streaming output, typed failures, cancellation, and cleanup. Process docsAxial.HttpClient: typed HTTP requests, response handling, and reliability policies. HTTP docsAxial.Configuration: layered environment, argument, JSON, browser, and Microsoft configuration decoded by Reified, with redacted secrets. Configuration docsAxial.Console: standard streams, redirection, and terminal control. Console docsAxial.FileSystem: file-system access, streaming traversal, atomic writes, and the append log. FileSystem docsAxial.WebSocket: typed WebSocket client sessions and errors. WebSocket docsAxial.Hosting,Axial.Hosting.AspNetCore,Axial.Hosting.GenHttp,Axial.Hosting.Node, andAxial.Hosting.Browser: host adapters. Hosting docsAxial.ElmishFlows: Elmish commands and subscriptions backed by workflows. Elmish docsAxial.TelemetryandAxial.Telemetry.JavaScript: .NET and Fable tracing, metrics, and dumps. Telemetry docsAxial.GuardrailsandAxial.Tool: effect-boundary analysis and theaxialpolicy CLI. Guardrails docs
See the package maturity table for each package's rating and application evidence. The package catalogue links the first-class libraries and the complete compatibility matrix.
Documentation and examples
- Getting started
- Add Axial to an existing Task application
- Failures and defects
- Dependencies and services
- Concurrency
- Process
- HTTP client
- Runnable examples
- Integration reference application and HTTP host examples
Reified integration
Reified declares value, model, JSON, and HTTP contracts. Axial's optional server adapters execute Reified HTTP contracts as workflows; neither core depends on the other. Axial 0.12 requires Reified 0.12.1 or later, whose Fable schema builder supports typed schema construction and Config.load decoding on Fable.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. 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. |
| .NET Core | netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.1 is compatible. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.1
- Axial (>= 0.14.1)
- Axial.Configuration (>= 0.14.1)
- Axial.HttpClient (>= 0.14.1)
- FSharp.Core (>= 10.1.403)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.2)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Hosting.Systemd (>= 8.0.0)
- Microsoft.Extensions.Hosting.WindowsServices (>= 8.0.0)
- Microsoft.Extensions.Http (>= 8.0.1)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.2)
- Reified.Data (>= 0.12.1)
-
net8.0
- Axial (>= 0.14.1)
- Axial.Configuration (>= 0.14.1)
- Axial.HttpClient (>= 0.14.1)
- FSharp.Core (>= 10.1.403)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.2)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Hosting.Systemd (>= 8.0.0)
- Microsoft.Extensions.Hosting.WindowsServices (>= 8.0.0)
- Microsoft.Extensions.Http (>= 8.0.1)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.2)
- Reified.Data (>= 0.12.1)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Axial.Hosting:
| Package | Downloads |
|---|---|
|
Axial.Hosting.AspNetCore
[Experimental] ASP.NET Core hosting for schema-driven Axial Flow endpoints, with trusted request parsing, typed outcome lowering, problem details, compiled codecs, and OpenAPI support. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.14.1 | 112 | 11/8/2026 |
| 0.14.0 | 105 | 11/8/2026 |
| 0.13.0 | 112 | 11/7/2026 |
| 0.12.0 | 112 | 11/5/2026 |
| 0.11.3 | 113 | 10/19/2026 |
| 0.11.2 | 104 | 10/19/2026 |
| 0.11.1 | 101 | 10/19/2026 |
| 0.11.0 | 101 | 10/19/2026 |
| 0.10.0 | 107 | 10/1/2026 |
| 0.9.3 | 128 | 9/14/2026 |
| 0.9.2 | 126 | 9/14/2026 |
| 0.9.1 | 129 | 9/11/2026 |
| 0.9.0 | 121 | 9/11/2026 |
| 0.8.0 | 114 | 9/11/2026 |
| 0.7.1 | 127 | 8/18/2026 |
| 0.7.0 | 138 | 8/17/2026 |