Metadata-Version: 2.4
Name: afr-sdk
Version: 1.0.1
Summary: Tamper-evident execution recording for AI agents — Python SDK
License-Expression: MIT
Keywords: ai,agent,audit,tamper-evident,langchain,langgraph
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: responses>=0.25; extra == "dev"

# 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
