Metadata-Version: 2.4
Name: cruws-sdk
Version: 0.1.0
Summary: Python SDK for the CRUWS AI-to-AI clearing house
Author: CRUWS
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests<3,>=2.31.0
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: license
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# cruws-sdk

Python client for the CRUWS AI-to-AI clearing house.

## Install locally

```bash
python -m pip install .
```

## Usage

```python
from cruws_sdk import CRUWSClient

client = CRUWSClient(api_key="cruws_live_...", user_email="developer@example.com")
client.pause_agent(agent_id=42)
client.dispute_escrow(escrow_id=17)
client.resume_checkpoint(checkpoint_id=9)
client.revoke_key(key_id=4)
client.record_settlement(amount=0.001, escrow_id=17)
```

The client sends the API key as `Authorization: Bearer <CRUWS_KEY>`. Set `base_url` to the CRUWS deployment or local FastAPI adapter when testing. API failures raise `CRUWSAPIError` with the HTTP status and exact server message.

## Build and publish checklist

Build a wheel and source archive with `python -m build`, inspect the artifacts, run a test upload to TestPyPI, and only then publish the version to PyPI. Never commit live API keys or admin secrets to the package.
