Metadata-Version: 2.4
Name: algovoi-plugin-crewai
Version: 0.1.0
Summary: AlgoVoi payment guardrail provider and tools for CrewAI
License: Apache-2.0 OR AlgoVoi-Commercial-v1.0
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27
Requires-Dist: rfc8785>=0.1.4
Provides-Extra: crewai
Requires-Dist: crewai>=0.28; extra == "crewai"
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: respx>=0.21; extra == "dev"
Dynamic: license-file

# algovoi-plugin-crewai

AlgoVoi compliance guardrail provider and payment tools for [CrewAI](https://crewai.com/).

## Installation

```bash
pip install algovoi-plugin-crewai[crewai]
```

## Components

### AlgoVoiGuardrailProvider

Implements the CrewAI GuardrailProvider protocol (crewAI #4877/#5888).

```python
from algovoi_plugin_crewai import AlgoVoiGuardrailProvider

guardrail = AlgoVoiGuardrailProvider(
    api_key="algv_...",
    fail_open=True,  # allow if API unreachable (default)
)

decision = guardrail.check(
    tool_name="send_payment",
    tool_input={"recipient_address": "ALGO_ADDR...", "chain": "algorand"},
)
# decision.decision -> "allow" | "refer" | "deny"
```

### AlgoVoi Payment Tool

```python
from algovoi_plugin_crewai import make_algovoi_payment_tool

pay_tool = make_algovoi_payment_tool(api_key="algv_...")
agent = Agent(tools=[pay_tool], ...)
```

## License

Apache-2.0
