Repository navigation
v1.69.0
1.69.0 (2026-11-09)
πͺπ¦β¬ .NET and Rust clients, and agent skills (#108)
A client for .NET frontends
Trax.StateMachine.Client drives a machine your host serves from Blazor, .NET MAUI, Avalonia, WPF or another
service. Give it the machine from your client manifest, an HttpClient and the socket endpoint. It sends every
operation by persisted id, follows the instance over the socket, predicts each event from the machine's IR in the
manifest with MachinePredictor.FromIr, and shows what the server stored. A refusal or a network failure comes back
as a SendOutcome, never an exception. See
.NET client.
Typed C# views, from the assembly or the manifest
trax machine generate --lang csharp writes a typed view of a machine (Checkout.g.cs): enums for its states and
triggers, a record per context and input, and a CheckoutClient with a typed method per event. A frontend that has
the host's client manifest and not its assembly passes --manifest in place of --assembly.
π€ Generated with Claude Code
π¦β¬ Generate the operations console's client (#111)
The operations console's client is generated
The operations console now sends every request through a client trax client generates from its documents, the
same way an app's frontend does. trax client --operations <schema.graphql> --documents <glob> --out <dir> writes
it: a typed function per document, its persisted id, and the documents file a host registers. A host's client
manifest still never lists the operations surface, and who may run an operation is unchanged.
trax client also accepts a nullable variable passed to a non-null argument that has a default, as GraphQL allows.
πͺπ¦β¬π₯ Clients predict only what they can evaluate, and the languages agree (#113)
Machine clients
- A client no longer predicts an event whose edge depends on a custom guard, custom reduction or
custom state requirement it has no handler for. It sends the event without a prediction, so the
server no longer refuses it withCLIENT_DIVERGENCE. - The TypeScript client and the generated client refuse an
http:endpoint on a host other than
loopback. SetallowInsecureTransport(onTraxConnectionfor a generated client) only on a
network you trust. A relative URL in a browser is unaffected. - The TypeScript client fails a non-2xx answer as
TRANSPORT_ERROR, as the .NET client does. ServerSnapshot.revisionmay benull(a custom store that records none); such an answer is
applied and not ordered.- Generated clients are client format 3; regenerate with this release's
trax client.
.NET client
AllowInsecureTransport,MaxMessageSizeandMaxResponseSizeoptions, and the cleartext and
size defaults above.
π¦β¬ Trax-console, the operations console in a terminal (#114)
trax-console
dotnet tool install -g Trax.Api.Console.Terminal installs the operations console for a terminal.
It shows runs, dead letters, the work queue, manifests, a run's trace and machines, and acts on them
with the same documents the browser console sends, so a host that serves the console has nothing new
to allow. With a command it answers in JSON lines for scripts and agents. It signs in with an API key
or bearer token from the environment or a file.
A C# client for the operations console
trax client --operations --lang csharp writes the console's client in C#, over the new
Trax.Client package, a .NET runtime for a host's persisted GraphQL documents.
Registering the console's documents without the page
app.UseTraxOperatorConsoleDocuments() registers the console's documents on a host that requires
persisted operations without serving the browser console, for a host operators reach only from a
terminal.
Upgrading
- Operations namespace. If it is exposed, declare
GateOperations(...), or call
GateOperationsToAuthenticatedUsers()orAllowAnonymousOperations()deliberately.
RequireAuthorization()alone no longer starts. - RabbitMQ.
UseRabbitMqandUseRabbitMqInvalidationneed aSigningKeyof at least 32
bytes shared by every process on the exchange, andamqps://to a broker on another host. Upgrade
every process together, or run withAllowUnsignedMessages()until they are. - Remote runners. Upgrade runners before schedulers: a scheduler with a signing key refuses an
unsigned run response. - API keys. Keys added with
Addmust be at least 32 characters outside Development. - Broadcast output. A non-operator subscriber that reads
outputfrom a[TraxBroadcast]
train needsAllowOutputForBroadcastSubscribers<TTrain>(). trax generatenow writes trains that require theUserrole, and the genericsaveSnapshot
refuses machines with guards, reducers, custom rules or a start that reads input.
πͺπ¦β¬π₯ Catch the host up to a page that ran ahead, and settle every client operation (#122)
Catch the host up to a page that ran ahead of it
Every machine client can now plan and send the events that bring the host to where a form-driven page
is: syncTo in TypeScript (and createFormView's sync), SyncToAsync in .NET, sync_to in Rust.
Each view has unsaved for a leave guard. The planner is also available on its own (plan) and gives
the same answer in all three engines.
Safer, steadier clients
The .NET clients require an HttpClient with automatic redirects off. Every client refuses
scheme-relative and cleartext endpoints unless insecure transport is allowed, refuses to send a trigger
the machine does not declare, and settles every operation with a value: sends after a refused start,
streams the host refuses, and failures that used to leave the queue waiting.
β¬ A new logo, on the site, the README and every package (#125)
Every Trax package on nuget.org now shows the Trax icon.
πͺπ¦β¬ Derive and serve machines from gherkin features (#134)
- Machines from features. Write a machine as Gherkin features and a glossary;
trax machine from-gherkinderives its IR, its access and the policies and views between
machines, and refuses to write a machine its own scenarios fail. Serve them with
ServeFeatures(directory), no machine class needed. - Policies. The server fires a trigger when another machine enters a state, once, across
hosts, recorded as thePolicyactor. - Views. Read-only queries across machines under a derived read rule, with persisted documents
and a generatedviews.g.ts. - New CLI commands:
trax machine from-gherkin,run,missing,usage,diagram. - Console: a Board tab on machines served from features.
- New packages:
Trax.StateMachine.Gherkin,Trax.StateMachine.Gherkin.Reqnroll. - Sample: the Bakery, a web page and API whose machines are written only as features.
All changes
Bug Fixes
- πͺπ¦β¬π₯ clients predict only what they can evaluate, and the languages agree (#113) (40c0ec8)
- πͺπ¦β¬π₯ the three machine clients answer every host the same way (#126) (b744260)
- πͺπ¦β¬π₯ the three machine clients read a real host the same way (#132) (d79a817)
- β¬ build the site's colours and type on the logo (#129) (77c3f6b), closes #6cc596
- β¬ every demo puts its run first, under one toolbar (#130) (27c27cf)
- β¬ one description of your app, for the whole team (#136) (c704d8c)
- π©β¬ make the agent scenarios one point each (#117) (d6e5ba2)
Features
- πͺπ¦β¬π₯ catch the host up to a page that ran ahead, and settle every client operation (#122) (7b7ddb4)
- πͺπ¦β¬ .NET and Rust clients, and agent skills (#108) (c8ca3a3)
- πͺπ¦β¬ derive and serve machines from gherkin features (#134) (7f1369a), closes 35#59
- π¦β¬ trax-console, the operations console in a terminal (#114) (0ecd592)
- π¦β¬ generate the operations console's client (#111) (9fdc363)
- β¬ a new logo, on the site, the README and every package (#125) (1c57b50)