Millrace v0.22.0

Millrace v0.22.0 is a local runtime for governed, long-running agent workflows.
It compiles workflow packages into immutable selected plans and applies runner
results through durable, validated state transitions.

Install

The complete supported bundle requires Python 3.12 or newer:

python -m pip install "millrace==0.22.1"
millrace --version

The base millrace-ai runtime can be installed separately on Python 3.11 or
newer.

Key Capabilities

• Compiler-validated workflow packages and immutable selected plans.
• Durable local queues, runs, artifacts, waits, interventions, and traces.
• Daemon execution with bounded dispatch, recovery, quarantine, fanout, join,
  operator waits, and workflow-defined completion.
• Explicit package, plan, queue, status, trace, wait, intervention, health, and
  daemon commands for a local operator.

Breaking Change

v0.22 is a clean break from v0.21. It does not open, repair, or migrate v0.21
workspaces, state, snapshots, package layouts, or compatibility profiles.
Create a new workspace and re-import current workflow packages. See
Migrating from v0.21
and the v0.22 compatibility guide.

Package Boundaries

| Package | Responsibility |
| --- | --- |
| millrace-ai | Compiler, kernel, storage, adapters, daemon, and CLI |
| millrace-plus | Official workflow definitions, prompt assets, stage skills, and authoring guides |
| millforge | Independent execution harness providing millforge-base |
| millrace==0.22.1 | Dependency-only bundle pinning millrace-ai==0.22.0, millrace-plus==0.22.0, and millforge==0.1.0 |

The legacy millrace-web sidecar is not included in v0.22.

Supported Runners

Millforge is the default for eligible newly compiled plans. Codex remains an
explicitly selectable alternative through an operator-provided wrapper.
Existing selected plans are never remapped.

• Millforge runner guide
• Codex runner guide

Documentation

• Getting started
• How Millrace works
• Workflow packages
• Errors and refusals