Metadata-Version: 2.4
Name: kestrel-feature-workflows
Version: 0.1.0
Summary: First-class agent workflow orchestration primitive for Kestrel Sovereign
License-Expression: Apache-2.0
License-File: LICENSE
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-Python: <3.15,>=3.11
Requires-Dist: aiosqlite>=0.21.0
Requires-Dist: jsonschema>=4.20
Requires-Dist: kestrel-sovereign-sdk<1,>=0.17.0
Requires-Dist: kestrel-sovereign<1,>=0.15.2
Provides-Extra: test
Requires-Dist: prometheus-client>=0.20; extra == 'test'
Requires-Dist: pytest-asyncio>=1.1.0; extra == 'test'
Requires-Dist: pytest-timeout>=2.3.1; extra == 'test'
Requires-Dist: pytest>=8.0.0; extra == 'test'
Description-Content-Type: text/markdown

# kestrel-feature-workflows

First-class agent workflow orchestration for Kestrel Sovereign.

Workflows is orchestration **on top of** the existing Signal Dispatcher. Stages
dispatch signals (`ACTION` / `ARTIFACT` / `COGNITION`); durability, dedupe,
locks, causation tracking, retention, and redaction all come from the
dispatcher. Workflows adds what the dispatcher lacks: multi-stage sequencing and
fan-out, per-stage gates (including an adversarial `red_team_clear` gate),
reverse-order saga compensation, a cancellation barrier, DID-signed versioned
workflow definitions, and constitutional-boundary enforcement.

## Installation

```bash
uv pip install kestrel-feature-workflows
```

The package registers `WorkflowsFeature` through the `kestrel_sovereign.features`
entry point group.

## Development

```bash
uv sync --extra test
uv run --extra test pytest -q
```

## Design

See `docs/architecture/WORKFLOWS_FEATURE_DESIGN.md` (v4.1) and
`WORKFLOWS_DEVELOPER_GUIDE.md` in the kestrel-sovereign repository for the full
design and the stage-to-signal reduction.
