Metadata-Version: 2.4
Name: parmana
Version: 1.1.0
Summary: Python SDK for Parmana Execution Trust Infrastructure.
Author: Parmana
License: Apache-2.0
Project-URL: Homepage, https://github.com/pavancharak/parmana-exp
Project-URL: Documentation, https://github.com/pavancharak/parmana-exp/tree/main/docs
Project-URL: Repository, https://github.com/pavancharak/parmana-exp
Project-URL: Issues, https://github.com/pavancharak/parmana-exp/issues
Project-URL: Releases, https://github.com/pavancharak/parmana-exp/releases
Keywords: ai,artificial-intelligence,autonomous-ai,agents,governance,authorization,execution,trust,policy,sdk
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software 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: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests<3,>=2.32.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: responses>=0.25.0; extra == "dev"
Requires-Dist: ruff>=0.6.0; extra == "dev"
Requires-Dist: black>=24.0.0; extra == "dev"
Requires-Dist: mypy>=1.10.0; extra == "dev"
Dynamic: license-file

# Parmana

> **Proof of Human Authority in AI Systems**

[![PyPI](https://img.shields.io/pypi/v/parmana)](https://pypi.org/project/parmana/)
[![Python](https://img.shields.io/pypi/pyversions/parmana)](https://pypi.org/project/parmana/)
[![License](https://img.shields.io/pypi/l/parmana)](https://github.com/pavancharak/parmana-exp/blob/main/LICENSE)

The official Python SDK for **Parmana Execution Trust Infrastructure**.

Parmana enables organizations to confidently deploy AI in high-impact workflows by ensuring that **only authorized actions are executed** and every execution is accompanied by verifiable execution evidence.

## Why Parmana

Modern AI systems can:

- Plan
- Reason
- Call tools
- Invoke APIs
- Execute business workflows

However, most AI systems cannot answer critical governance questions:

- Who authorized this execution?
- Which policy approved it?
- Was the execution independently verified?
- Can the execution be replayed?
- Is there cryptographic evidence of what occurred?

Parmana provides the execution trust layer that answers these questions.

## Installation

```bash
pip install parmana
```

### Requirements

- Python 3.10 or later
- Parmana Runtime

## Quick Start

```python
from parmana import ParmanaClient

client = ParmanaClient(
    endpoint="http://localhost:3000",
)

print(client.version)
```

## Runtime Health

```python
status = client.health()

print(status)
```

## Execute a Business Transaction

```python
from parmana.models import BusinessTransaction

transaction = BusinessTransaction(
    business_transaction_id="txn-001",
)

trust_record = client.execute(transaction)

print(trust_record.trust_record_id)
```

## Verify an Execution

```python
verification = client.verify("txn-001")

print(verification.status)
```

## Replay an Execution

```python
result = client.replay("txn-001")

print(result.success)
```

## Execution Lifecycle

```text
Business Transaction
        |
        v
Execution
        |
        v
Verification
        |
        v
Receipt
        |
        v
Execution Trust Record
```

## Python SDK

| Method | Description |
|--------|-------------|
| `health()` | Runtime health check |
| `execute()` | Execute a Business Transaction |
| `verify()` | Verify an execution |
| `replay()` | Deterministic replay |
| `receipt()` | Generate an execution receipt |
| `transaction()` | Retrieve a Business Transaction |
| `trust_record()` | Retrieve an Execution Trust Record |
| `validate_policy()` | Validate a policy definition |

Each of these is also available under its own namespace (e.g. `client.execution.execute()`, `client.verification.verify()`, `client.replay.replay()`) for finer-grained access to that API's other operations, such as `client.verification.get_latest()` or `client.transactions.list()`.

## Documentation

- Documentation: https://docs.parmana.ai
- GitHub: https://github.com/pavancharak/parmana-exp
- Issues: https://github.com/pavancharak/parmana-exp/issues

## License

Apache License 2.0

---

**Parmana**

**Proof of Human Authority in AI Systems**
