Metadata-Version: 2.5
Name: stackgen-sdk
Version: 0.1.3
Summary: StackGen SDK — Aiden, SRE, and Vault from one client
Project-URL: Homepage, https://pypi.org/project/stackgen-sdk/
Author: StackGen
License-Expression: Apache-2.0
Keywords: aiden,openapi,sre,stackgen
Requires-Python: >=3.10
Requires-Dist: pydantic>=2.0
Requires-Dist: python-dateutil>=2.8
Requires-Dist: typing-extensions>=4.0
Requires-Dist: urllib3>=2.0
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# StackGen Python SDK

Install:

```bash
pip install stackgen-sdk
```

Import package name is `stackgen`:

```python
from stackgen import StackgenClient

client = StackgenClient.from_env()
result = client.aiden.run_webhook_and_download_report(open("alert.json").read())
print(result.session_id, result.output_path)

alerts = client.sre.list_alerts()
```

## Environment

| Variable | Purpose |
|----------|---------|
| `STACKGEN_URL` | Mothership URL (no path suffix) |
| `STACKGEN_TOKEN` | API token (`stackgen_…`) |
| `WEBHOOK_TOKEN` | Webhook token (`sg_aios_…`) for triggers |
| `ORG_ID` | Organization UUID |
| `WEBHOOK_ID` | Optional; needed when older trigger responses omit `session_id` |

Optional: `ARTIFACT_NAME`, `OUTPUT_PATH`, `POLL_INTERVAL_SECONDS`, `TIMEOUT_SECONDS`.

## Namespaces

- `client.aiden` — webhooks, sessions, session-report download
- `client.sre` — alerts and investigations
- `client.vault` — secrets (not enabled in this release)

Prefer `StackgenClient` over the generated OpenAPI modules under `stackgen.generated`.

Pin versions in CI, for example `pip install stackgen-sdk==0.1.2`.
