Metadata-Version: 2.4
Name: provision-stack-composio
Version: 0.1.0
Summary: Composio integration for Provision Stack — 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,autogen,aws,composio,crewai,gcp,infrastructure,langchain,mcp
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
Requires-Python: >=3.10
Requires-Dist: composio-core>=0.6.0
Requires-Dist: provision-stack>=0.1.0
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-composio

> Composio integration for Provision Stack — deploy cloud infrastructure via AI agents.

## Install

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

## Quick Start

```python
from composio import ComposioToolSet
from provision_stack_composio import register_provision_stack_tools

toolset = ComposioToolSet()
register_provision_stack_tools(toolset, api_key="your-token", sandbox=True)
tools = toolset.get_tools()

# Now use with any Composio-supported framework:
# LangChain, CrewAI, AutoGen, LlamaIndex, etc.
```

## What This Does

Registers Provision Stack as a Composio integration, making it available
to any framework that uses Composio. One integration → all frameworks.

## Available Actions

| Action | Description |
|--------|-------------|
| `PROVISION_STACK_SUGGEST` | Get deployment suggestions with tier options and costs |
| `PROVISION_STACK_DEPLOY` | Deploy infrastructure (fee held, captured after verification) |
| `PROVISION_STACK_STATUS` | Check deployment status and verification results |
| `PROVISION_STACK_DESTROY` | Destroy all resources owned by a deployment |
| `PROVISION_STACK_BALANCE` | Check account credit balance |
| `PROVISION_STACK_TOPUP` | Add credits via Stripe or XRP |

## Selective Registration

```python
# Register only specific actions
register_provision_stack_tools(
    toolset,
    api_key="your-token",
    actions=["SUGGEST", "DEPLOY"],  # only these two
)
```

## Configuration

```python
register_provision_stack_tools(
    toolset,
    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)
)
```

## License

MIT
