Metadata-Version: 2.4
Name: matrx-runtime
Version: 0.0.4
Summary: The durable-execution substrate: one global_execution spine, one lifecycle state machine, one cost ledger, that every matrx-* executor (agent loop, workflow superstep, utilities) plugs into.
Author-email: Matrx <admin@aimatrx.com>
License: MIT
Keywords: durable,execution,matrx,orchestration,runtime
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.13
Requires-Dist: matrx-orm>=3.1
Requires-Dist: pydantic>=2.12
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# matrx-runtime

The durable-execution substrate for the Matrx platform.

Every unit of work — a utility call, a workflow run, an agent session — is one
row on a single `global_execution` spine that can nest inside any other. The
substrate owns the concerns all three flavors share, so they compose freely and
share **one lifecycle, one nesting tree, one cost ledger, and one enforced state
machine**:

- run identity + lineage (`parent_execution_id`, denormalized `root_execution_id`)
- the lifecycle state machine (`transition()` — the only legal way to change status)
- the cost ledger + tree-wide budget *(forthcoming)*
- cancellation signal + down-tree propagation *(forthcoming)*
- generalized checkpoint + lifecycle-event primitives *(forthcoming)*
- the hardened write coordinator *(moving in from matrx-ai)*
- the typed runtime context *(forthcoming)*

Executors plug in as strategies and are NOT owned here: the agent loop
(`matrx-ai`), the superstep DAG (`matrx-graph`), utility implementations
(`matrx-scraper`).

Status: **pre-alpha.** The pure decision core (lifecycle + spine models) is in
place; the persistence/coordinator/context drops follow. Built behind a `/v2`
route; the legacy `cx_*` / `wf_*` paths are untouched until cutover.

Design + phased plan: [`docs/runtime/EXECUTION_SPINE.md`](../../docs/runtime/EXECUTION_SPINE.md).
