Metadata-Version: 2.5
Name: warrantai
Version: 0.0.1
Summary: Warrant: the decision ledger for AI agents. Record every consequential agent action with its mandate, evidence, cost and outcome, and replay real decisions before you ship a change.
Project-URL: Homepage, https://warrantai.dev
Project-URL: Source, https://github.com/warrant-ai/warrant
Project-URL: Issues, https://github.com/warrant-ai/warrant/issues
Author: AI Foundry Ventures
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: ai-agents,audit,decision-records,governance,llm,observability,policy
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Logging
Requires-Python: >=3.9
Requires-Dist: jsonschema>=4.18
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Description-Content-Type: text/markdown

# warrantai

Warrant is the decision ledger for AI agents. Every consequential action an agent takes is recorded with the mandate that allowed it, the evidence it used, what it cost, and how it turned out. Developers replay real recorded decisions against a changed prompt, model or policy before shipping. Risk, finance and audit teams get records they can sample and verify without trusting the vendor.

This is release 0.0.1. It ships the decision record schema v0 and a validator so the format can be reviewed and integrated against before the SDK lands.

```
pip install warrantai
warrant --version
warrant schema
warrant validate examples/loan-approval.json
```

```python
from warrant import validate, ValidationError

try:
    validate(record)
except ValidationError as exc:
    for message in exc.errors:
        print(message)
```

## What arrives next

- `decide()` context manager that opens a record, captures model and tool calls as evidence, and closes it on success or failure, off the hot path
- `check()` policy evaluation against a cached bundle before the action, with allow, deny or escalate
- local append-only store with hash chaining and an offline verifier
- `warrant test`: replay a set of real decisions against a changed target and fail the build on flipped decisions
- `warrant import`: reconstruct decision records from existing OpenTelemetry trace exports and run policy over them retrospectively

Roadmap and schema specification: https://warrantai.dev

## Note on the import name

The package installs as `warrantai` and imports as `warrant`. An unrelated, unmaintained package named `warrant` (an AWS Cognito helper, last released in 2017) also uses the `warrant` module name. Installing both in one environment will shadow one of them. Uninstall that package if `from warrant import validate` fails.

## Licence

Apache 2.0.
