Metadata-Version: 2.4
Name: ai-trustgraph-enterprise
Version: 0.2.0
Summary: Enterprise client for AI-TrustGraph cloud control plane — license-key authenticated with usage metering
Project-URL: Homepage, https://github.com/HONEYPOTZ-AI/TRUSTGRAPH
Project-URL: Documentation, https://github.com/HONEYPOTZ-AI/TRUSTGRAPH#readme
Project-URL: Repository, https://github.com/HONEYPOTZ-AI/TRUSTGRAPH
Author: TrustGraph Authors
License: MIT
Keywords: ai,cloud,data-lineage,enterprise,governance,trust
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Requires-Dist: ai-trustgraph>=0.2.0
Requires-Dist: httpx>=0.27
Requires-Dist: python-jose[cryptography]
Provides-Extra: dev
Requires-Dist: httpx; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Description-Content-Type: text/markdown

# AI-TrustGraph Enterprise

Enterprise client for the AI-TrustGraph cloud control plane.

## Install

```bash
pip install ai-trustgraph-enterprise
```

This also installs `ai-trustgraph` (OSS core) as a dependency.

## Usage

```python
from ai_trustgraph_enterprise import Client

client = Client(
    license_key="tg_xxx",
    endpoint="https://api.ai-trustgraph.com"
)

# Oracle resolution — runs through all 7 TrustGraph layers
result = client.oracle_resolve("customer revenue by region")
print(result["explanation"]["summary"])

# Trust scoring
score = client.trust_score("dataset-123")

# Governance scan (PII, SOX, GDPR)
report = client.governance_scan("dataset-123")

# Contract validation
status = client.contracts_validate("dataset-123")

# Lineage trace
lineage = client.graph_lineage("dataset-123")

# Check usage and billing
usage = client.usage_summary()
bill = client.usage_billing(tier="starter")

# Always close to flush usage events
client.close()
```

Or use as a context manager:

```python
with Client(license_key="tg_xxx") as client:
    result = client.oracle_resolve("monthly active users")
```

## How it works

Every action generates a usage event sent to the cloud control plane:

| Method | Event Type |
|---|---|
| `oracle_resolve()` | `trust_evaluation` |
| `trust_score()` | `trust_evaluation` |
| `governance_scan()` | `policy_execution` |
| `contracts_validate()` | `contract_validation` |
| `graph_lineage()` | `lineage_request` |
| `semantic_search()` | `agent_query` |

Events are queued locally and flushed on `close()`.

## OSS vs Enterprise

| Feature | OSS (`ai-trustgraph`) | Enterprise |
|---|---|---|
| Local trust scoring | ✅ | ✅ |
| Semantic catalog | ✅ | ✅ |
| Metadata ingestion | ✅ | ✅ |
| Local knowledge graph | ✅ | ✅ |
| API server | ✅ | ✅ |
| Cloud control plane | ❌ | ✅ |
| License key auth | ❌ | ✅ |
| Usage metering | ❌ | ✅ |
| Billing integration | ❌ | ✅ |
| Oracle resolution | ✅ | ✅ |