# AFR SDK

Tamper-evident execution recording for AI agents.

## Installation

```bash
pip install afr-sdk
```

## Quick Start

```python
from afr_python_sdk import Recorder

rec = Recorder(base_url="http://localhost:3001")
run = rec.start({"model": "gpt-4"})
```

## Full Example

```python
from afr_python_sdk import Recorder

rec = Recorder(base_url="http://localhost:3001", api_key="your-api-key")

rec.start({"model": "gpt-4", "temperature": 0.2})

rec.step({
    "step_type":   "tool_result",
    "tool_name":   "risk_score",
    "tool_input":  {"txn_id": "TXN-001"},
    "tool_output": {"fraud_probability": 0.82},
})

rec.decision({
    "goal_reference":  "evaluate-transaction",
    "selected_option": "block",
    "confidence":      0.92,
})

proof = rec.finish()
print(proof["run_id"])
```

## License

MIT
