Metadata-Version: 2.1
Name: mirai-move-sdk
Version: 1.0.0
Summary: Official Mirai Move SDK — a thin, read-only client over the governed Mirai Move API (contract v1).
Home-page: https://www.miraimove.com/developers
License: SEE LICENSE IN LICENSE
Requires-Python: >=3.9

# Mirai Move SDK (Python)

The official thin client over the governed Mirai Move read API, contract **v1**.
Standard library only (urllib). Python 3.9+.

The API — and therefore this SDK — is **read-only**: released deliverables,
Cases, evidence, matches, solution gaps and monitoring, within your
credential's scopes and classification ceiling. There are no write, outreach
or payment functions because the contract has none.

## Install

Install from the downloaded artifact (no external registry required):

```bash
pip install ./mirai_move_sdk-1.0.0-py3-none-any.whl
```

## Use

```python
import os
from mirai_move_sdk import MiraiMoveClient, MiraiMoveApiError

client = MiraiMoveClient(token=os.environ["MIRAI_MOVE_TOKEN"])

# list released deliverables (cursor pagination handled for you)
for d in client.iterate_deliverables():
    print(d["deliverable_id"], f"v{d['version']}", d["title"])

# fetch ONE exact released version — never silently the latest
doc = client.get_deliverable("MM-WD-0123456789abcdef", version=2)

# every refusal is typed
try:
    client.get_case("case-you-cannot-read")
except MiraiMoveApiError as e:
    print(e.code, e.status, e.detail)
```

## Authentication

A bearer credential issued under governed human approval — there is no
self-service key issuance. Keep it server-side; never embed it in code you
distribute. See https://www.miraimove.com/developers

## Data truth

Every response envelope carries `record_class`. `SYNTHETIC_ACCEPTANCE`
data is clearly labeled sample data — never present it as real records.

## Contract binding

- `API_CONTRACT_VERSION` — the contract this build targets (`v1`)
- `OPENAPI_DIGEST` — SHA-256 of the exact OpenAPI document this SDK was built against

A contract change ships as a new SDK version with an updated digest.
