Metadata-Version: 2.4
Name: alovia-watchdog
Version: 0.1.0
Summary: Runtime protection for AI agents. Guard your agent's inputs with your Alovia fleet key.
Project-URL: Homepage, https://aloviaai.com
Author: Alovia
License: MIT
Keywords: agents,ai,guardrails,security,watchdog
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# alovia-watchdog

Runtime protection for AI agents. Guard your agent's inputs with your Alovia fleet key.

## Install

```bash
pip install alovia-watchdog
```

## Use

```python
from alovia_watchdog import Watchdog, guard_input

wd = Watchdog(api_key="wd_live_...")

@guard_input(wd, agent="support-bot")
def handle(message):
    ...
```

`guard_input` raises `WatchdogBlocked` when a message is blocked, so the wrapped function never runs on a malicious input. On a network error it honors `fail_mode` (`"closed"` blocks, `"open"` allows).

You can also check directly:

```python
verdict = wd.check("some user input", agent="support-bot")
if verdict.blocked:
    ...
```
