Metadata-Version: 2.4
Name: aura-harness
Version: 0.3.0
Summary: Runtime membrane around agent loops — audit, policy, identity, and compliance export.
Author: ARPA Hellenic Logical Systems
License: MIT
Project-URL: Homepage, https://arpacorp.net
Project-URL: Documentation, https://github.com/ARPAHLS/aura#readme
Project-URL: Repository, https://github.com/ARPAHLS/aura
Project-URL: Issues, https://github.com/ARPAHLS/aura/issues
Project-URL: Changelog, https://github.com/ARPAHLS/aura/blob/main/CHANGELOG.md
Keywords: agents,agent-harness,ai-agents,audit-trail,aura,compliance,conformance,governance,observability,policy,runtime,sidecar
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: black>=24.0; extra == "dev"
Requires-Dist: flake8>=7.0; extra == "dev"
Provides-Extra: skillware
Requires-Dist: skillware>=0.5.1; extra == "skillware"
Dynamic: license-file

<div align="center">

<img src="docs/assets/aura_splash.png" alt="αύρα — AURA Harness" width="480" />

<br>

**AURA Harness - A runtime coat for agent loops — audit, policy, and compliance export.**

<br>

<div align="center">
  <a href="https://pypi.org/project/aura-harness/"><img src="https://img.shields.io/pypi/v/aura-harness?label=Version&style=flat-square" alt="Version"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-e8c4c0?style=flat-square" alt="License"></a>
  <a href="docs/getting-started.md"><img src="https://img.shields.io/badge/Python-3.10+-bbd4e8?style=flat-square" alt="Python Version"></a>
  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/Status-Experimental-c4d8c0?style=flat-square" alt="Status"></a>
  <a href="https://github.com/arpahls"><img src="https://img.shields.io/badge/Powered_by-ARPA_HLS-cfc8dc?style=flat-square" alt="ARPA HLS"></a>
</div>

<br>

[Overview](#overview) ·
[How it works](#how-it-works) ·
[Architecture](#architecture) ·
[Quick start](#quick-start) ·
[Documentation](#documentation)

</div>

---

## Overview

**AURA Harness** wraps whatever runs your agent loop — a Python script, [Skillware](https://github.com/arpahls/skillware), LangGraph, or your own host. It does not replace the loop. It sits around it, records what happened, enforces your rules at tool boundaries, and exports a session you can ship to logs or compliance.

| | |
|---|---|
| **For** | Teams that need provenance, policy, and repeatable pipelines around agents |
| **Not** | A model runtime, orchestrator, or skill framework |
| **Pairs with** | Skillware (tools), any LLM host, your existing loop |

---

## How it works

```mermaid
flowchart LR
    Host[Host] --> Aura[AURA]
    Aura --> Audit[Audit Trail]
```

Your **host** runs the loop. **AURA** attaches — policy at egress, causal logging. On close, the **audit trail** becomes session export (JSONL, summary, audit report).

→ [using-aura.md](docs/using-aura.md) · [skillware-integration.md](docs/skillware-integration.md)

---

## Architecture

Optional inputs feed the **body**; AURA wraps it; audit and export follow.

```mermaid
flowchart LR
    ID["Identity"] -.-> BODY["Body / Runtime"]
    BRAIN["Brain"] -.-> BODY
    MEM["Memory"] -.-> BODY
    TOOLS["Tools"] -.-> BODY
    CONST["Constitution"] -.-> BODY

    BODY --> AURA["AURA Harness"]
    AURA --> TRAIL["Audit Trail"]
    TRAIL --> EXPORT["Session Export"]
    TRAIL -.-> OBS["Observers"]
```

→ [architecture.md](docs/architecture.md) · [stack-position.md](docs/stack-position.md)

---

## Quick start

Requires **Python 3.10+**.

**Install from PyPI:**

```bash
pip install aura-harness
# optional Skillware host extra:
pip install "aura-harness[skillware]"
```

**Develop from source:**

```bash
git clone https://github.com/ARPAHLS/aura.git
cd aura
py -3.13 -m venv .venv && .venv\Scripts\activate   # Windows
pip install -e ".[dev]"
pytest
```

```python
from aura import agent, configure

configure()

ag = agent("acme/research-bot", policy_version="1")
with ag.session() as run:
    run.emit("turn.start", {"input": "hello"})
    run.emit("turn.end", {"tokens": 120})

print(run.exports)
```

CLI: `aura agent create`, `aura run`, `aura export`, `aura compare`, `aura export-otel`.

→ [getting-started.md](docs/getting-started.md) · [examples/](examples/)

---

## Documentation

| Topic | Links |
| :--- | :--- |
| **Start** | [getting-started.md](docs/getting-started.md) · [concepts.md](docs/concepts.md) · [using-aura.md](docs/using-aura.md) |
| **Integration** | [skillware-integration.md](docs/skillware-integration.md) · [sequencer.md](docs/sequencer.md) |
| **Identity & audit** | [trust-paths.md](docs/trust-paths.md) · [outputs.md](docs/outputs.md) |
| **Compare & position** | [comparison.md](docs/comparison.md) · [ROADMAP.md](docs/ROADMAP.md) |
| **Contribute** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Agent workflow](docs/contributing/ai_native_workflow.md) · [TESTING.md](docs/TESTING.md) · [PUBLISHING.md](docs/PUBLISHING.md) · [CHANGELOG.md](CHANGELOG.md) |

**Notes**

- **Experimental (alpha)** — API may change between minor releases until 1.0.
- **Wrap, don't replace** — your host owns the loop; AURA records and gates at boundaries you wire through `emit()` or `SkillwareHost`.
- **Security** — loaded skills and scripts run in your process; see [SECURITY.md](SECURITY.md).
- **Citation** — [CITATION.cff](CITATION.cff) (GitHub **Cite this repository**).
- **Support** — [issues](https://github.com/ARPAHLS/aura/issues) · systems@arpacorp.net

---

<div align="center">

<br>
<img src="https://raw.githubusercontent.com/ARPAHLS/.github/main/Group%202062.png" width="50" alt="ARPA Logo" />
<br>
<sub>Developed and Maintained by <b>ARPA HELLENIC LOGICAL SYSTEMS</b></sub>
<br>
<sub>Support: systems@arpacorp.net</sub>

</div>
