Skip to content

v0.22.0

Latest

Choose a tag to compare

@tim-osterhus tim-osterhus released this 24 Jul 04:50

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.

Documentation