Skip to content

v1.69.0

Choose a tag to compare

@github-actions github-actions released this 09 Nov 01:53
· 11 commits to main since this release
Immutable release. Only release title and notes can be modified.
7f1369a

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 with CLIENT_DIVERGENCE.
  • The TypeScript client and the generated client refuse an http: endpoint on a host other than
    loopback. Set allowInsecureTransport (on TraxConnection for 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.revision may be null (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, MaxMessageSize and MaxResponseSize options, 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() or AllowAnonymousOperations() deliberately.
    RequireAuthorization() alone no longer starts.
  • RabbitMQ. UseRabbitMq and UseRabbitMqInvalidation need a SigningKey of at least 32
    bytes shared by every process on the exchange, and amqps:// to a broker on another host. Upgrade
    every process together, or run with AllowUnsignedMessages() 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 Add must be at least 32 characters outside Development.
  • Broadcast output. A non-operator subscriber that reads output from a [TraxBroadcast]
    train needs AllowOutputForBroadcastSubscribers<TTrain>().
  • trax generate now writes trains that require the User role, and the generic saveSnapshot
    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-gherkin derives 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 the Policy actor.
  • Views. Read-only queries across machines under a derived read rule, with persisted documents
    and a generated views.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)