Metadata-Version: 2.4
Name: loop-guardrail
Version: 1.0.0
Summary: Execution loop detector and guardrail for AI agents
Project-URL: Homepage, https://github.com/p-vbordei/loop-guardrail-py
Project-URL: Repository, https://github.com/p-vbordei/loop-guardrail-py
Project-URL: Issues, https://github.com/p-vbordei/loop-guardrail-py/issues
Project-URL: Changelog, https://github.com/p-vbordei/loop-guardrail-py/blob/main/CHANGELOG.md
Author-email: Vlad Bordei <bordeivlad@gmail.com>
License: Apache-2.0
License-File: LICENSE
Keywords: ai-agents,guardrail,llm,loop-detection,safety
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# loop-guardrail

Execution loop detector and guardrail for AI agents.

## Usage

```python
from loop_guardrail import ToolCallGuardrailController, ToolCallGuardrailConfig

config = ToolCallGuardrailConfig(hard_stop_enabled=True)
ctrl = ToolCallGuardrailController(config)

# Pre-call check
dec = ctrl.before_call("terminal", {"cmd": "ls"})
if dec.action == "block":
    print("Action blocked!")
```
