Metadata-Version: 2.4
Name: provision-stack
Version: 0.1.0
Summary: Python client for the Provision Stack Execution API — deploy cloud infrastructure via AI agents.
Project-URL: Homepage, https://provision-stack.com
Project-URL: Documentation, https://docs.provision-stack.com
Project-URL: Repository, https://github.com/TravisLinkey/provision-stack
Author: Provision Stack
License-Expression: MIT
Keywords: ai-agents,aws,azure,cloud,gcp,infrastructure,mcp,oracle,terraform
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.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.10
Provides-Extra: test
Requires-Dist: pytest-mock>=3.12; extra == 'test'
Requires-Dist: pytest>=8.0; extra == 'test'
Description-Content-Type: text/markdown

# provision-stack

> Python client for the Provision Stack Execution API — deploy cloud infrastructure via AI agents.

## Install

```bash
pip install provision-stack
```

## Quick Start

```python
from provision_stack import ProvisionStackClient

client = ProvisionStackClient(api_key="your-token", sandbox=True)

# Get suggestions
suggestions = client.suggest("deploy a production web app")

# Deploy
result = client.deploy(outcome="deploy a production web app", tier="MVP")

# Check status
status = client.status(result["deploymentId"])
```

## Configuration

```python
client = ProvisionStackClient(
    api_key="your-token",         # or PROVISION_STACK_API_KEY env var
    base_url="https://...",       # or PROVISION_STACK_API_URL env var
    sandbox=True,                 # use sandbox (mock Terraform)
)
```

## API

### `suggest(outcome, **kwargs)`
Get deployment suggestions with tier options and cost estimates.

### `deploy(outcome, **kwargs)`
Deploy infrastructure. Fee held from balance, captured after verification.

### `status(deployment_id)`
Check deployment status and verification results.

### `destroy(deployment_id)`
Destroy all resources owned by a deployment.

### `balance()`
Check account credit balance.

### `topup_stripe(amount_usd)` / `topup_xrp(amount_usd)`
Add credits via Stripe or XRP.

## License

MIT
