Metadata-Version: 2.5
Name: stellar-dcp-client
Version: 0.1.0
Summary: Python SDK for the Stellar AI Decision Control Plane
Project-URL: Repository, https://github.com/jk-stellar/stellar-dcp
Requires-Python: >=3.11
Requires-Dist: httpx>=0.28.1
Description-Content-Type: text/markdown

# Stellar DCP Python SDK

`stellar-dcp-client` is the Python SDK for the Stellar AI Decision Control Plane. It exposes the DCP
route surface tracked by `packages/sdk-parity.json` and is built together with the Node.js/TypeScript
and Java SDKs.

## Install

```bash
pip install stellar-dcp-client
```

For a private or newly published version, install the wheel artifact directly from the release or local
`dist` directory:

```bash
pip install stellar_dcp_client-0.1.0-py3-none-any.whl
```

## Usage

```python
from stellar_dcp_client import DCPClient

client = DCPClient(base_url="https://dcp.example.com", api_key="dcp_ext_live_replace_me")

result = await client.evaluate_external_decision(
    {
        "product_key": "stellar-trustos",
        "source_app": "stellar-trustos",
        "action_type": "vendor_compliance_summary",
        "risk_context": {"data_sensitivity": "public", "external_action": False},
        "input": {
            "user_message": "Summarize approved platform context for this vendor.",
            "retrieved_context_refs": [],
            "tool_request": {},
            "metadata": {},
        },
    },
    correlation_id="trustos-vendor-123",
)
```

The client sends `X-API-Key` when configured and generates idempotency keys for API-key write requests.

## Build

```bash
python -m build packages/sdk-python
```