Metadata-Version: 2.4
Name: swarmauri_workflow_statedriven
Version: 0.11.0.dev3
Summary: Swarmauri's StateDrivenWorkflow
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: swarmauri_workflow_statedriven,swarmauri,experimental
Author: Jacob Stewart
Author-email: jacob@swarmauri.com
Requires-Python: >=3.10,<3.15
Classifier: Development Status :: 1 - Planning
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: pyppeteer
Requires-Dist: swarmauri_base (>=0.11.0.dev13,<0.12)
Requires-Dist: swarmauri_core (>=0.11.0.dev8,<0.12)
Requires-Dist: swarmauri_standard (>=0.11.0.dev13,<0.12)
Description-Content-Type: text/markdown

![Swarmauri Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/swarmauri_sdk_brand.png)

<p align="center">
    <a href="https://pepy.tech/project/swarmauri_workflow_statedriven/">
        <img src="https://static.pepy.tech/badge/swarmauri_workflow_statedriven/month" alt="PyPI - Downloads"/></a>
    <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/experimental/swarmauri_workflow_statedriven/">
        <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/experimental/swarmauri_workflow_statedriven.svg"/></a>
    <a href="https://pypi.org/project/swarmauri_workflow_statedriven/">
        <img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
    <a href="https://pypi.org/project/swarmauri_workflow_statedriven/">
        <img src="https://img.shields.io/pypi/l/swarmauri_workflow_statedriven" alt="PyPI - License"/></a>
    <a href="https://pypi.org/project/swarmauri_workflow_statedriven/">
        <img src="https://img.shields.io/pypi/v/swarmauri_workflow_statedriven?label=swarmauri_workflow_statedriven&color=green" alt="PyPI - swarmauri_workflow_statedriven"/></a>
    <a href="https://discord.gg/N4UpBuQv8T">
        <img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white" alt="Discord"/></a></p>

# Swarmauri Workflow Statedriven

## Execution controller integration

`StateDrivenExecutionDriver(graph=graph, definition_version="1")` reuses
existing conditions, input modes, joins and merge strategies while returning
one durable node boundary per step. An optional authorized dispatcher routes
nodes through the shared invoker. Queues, results, join buffers and JSON
strategy state survive reconstruction; custom strategies can override their
checkpoint codec. Change the definition version when the graph changes.
Existing graph execution methods and transition constructors remain supported.
See the [composition guide](../../../docs/examples/composable-execution/README.md).

An experimental state-driven workflow engine for building graph-based processes using nodes and transitions. It supports conditions, join strategies, merge strategies and input modes to control execution flow.

## Installation

```bash
pip install swarmauri_workflow_statedriven
```

## Usage

```python
from swarmauri_workflow_statedriven.graph import WorkflowGraph

workflow = WorkflowGraph()
# Define nodes and transitions...
result = workflow.execute(start="start", initial_input={})
```

For more details, see the `docs` directory.



