Metadata-Version: 2.4
Name: sovr-sdk
Version: 7.0.0
Summary: Sovereign AI Responsibility Layer SDK for Python
Home-page: https://github.com/sovr-ai/sovr-sdk-python
Author: SOVR Team
Author-email: SOVR Team <sdk@sovr.ai>
License: MIT
Project-URL: Homepage, https://sovr.ai
Project-URL: Documentation, https://docs.sovr.ai/sdk/python
Project-URL: Repository, https://github.com/sovr-ai/sovr-sdk-python
Project-URL: Bug Tracker, https://github.com/sovr-ai/sovr-sdk-python/issues
Keywords: sovr,ai,responsibility,layer,sdk,audit,trust,bundle
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Security
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: typing-extensions>=4.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# SOVR SDK for Python

Sovereign AI Responsibility Layer SDK - 为 AI 执行系统提供责任层能力的 Python SDK。

## 安装

```bash
pip install sovr-sdk
```

## 快速开始

```python
from sovr_sdk import SOVRClient

# 初始化客户端
client = SOVRClient(
    api_key="your-api-key",
    tenant_id="your-tenant-id",
    endpoint="https://api.sovr.example.com"
)

# 评估决策
result = client.evaluate_decision(
    action="payment",
    resource="order/12345",
    context={"amount": 1000, "currency": "CNY"}
)

print(f"决策结果: {result.verdict}")
print(f"风险评分: {result.risk_score}")
print(f"价值评分: {result.value_score}")

# 根据决策结果执行后续操作
if result.verdict == "approved":
    print("✓ 操作已批准，可以执行")
elif result.verdict == "pending_approval":
    print("⏳ 需要人工审批")
else:
    print("✗ 操作被拒绝")
```

## 核心功能

### 决策评估

```python
result = client.evaluate_decision(
    action="payment",
    resource="order/12345",
    context={"amount": 1000},
    metadata={"trace_id": "abc123"}
)
```

### 信任包管理

```python
# 创建信任包
bundle = client.create_trust_bundle(
    name="支付决策信任包",
    description="订单 #12345 的支付决策证据"
)

# 添加证据
client.add_evidence(
    bundle_id=bundle.id,
    evidence_type="document",
    content={"title": "合同文件", "url": "https://..."},
    weight=0.3
)

# 评估充分性
evaluation = client.evaluate_sufficiency(bundle.id)
print(f"充分性评分: {evaluation.score}")
```

### 审计日志查询

```python
# 查询审计日志
logs = client.get_audit_logs(
    start_date="2026-01-01",
    end_date="2026-01-25",
    limit=100
)

for log in logs:
    print(f"{log.created_at}: {log.event_type} - {log.action}")
```

## 环境变量

SDK 支持通过环境变量配置：

```bash
export SOVR_API_KEY="your-api-key"
export SOVR_TENANT_ID="your-tenant-id"
export SOVR_API_ENDPOINT="https://api.sovr.example.com"
```

```python
# 自动从环境变量读取配置
client = SOVRClient()
```

## 错误处理

```python
from sovr_sdk.exceptions import SOVRError, AuthenticationError, RateLimitError

try:
    result = client.evaluate_decision(...)
except AuthenticationError:
    print("认证失败，请检查 API Key")
except RateLimitError as e:
    print(f"请求过于频繁，请在 {e.retry_after} 秒后重试")
except SOVRError as e:
    print(f"SOVR 错误: {e.message}")
```

## 文档

- [API 参考](https://docs.sovr.ai/sdk/python/api)
- [集成指南](https://docs.sovr.ai/sdk/python/guide)
- [示例代码](https://github.com/sovr-ai/sovr-sdk-python/tree/main/examples)

## 许可证

MIT License
