Metadata-Version: 2.4
Name: agentguard-tech
Version: 0.11.2
Summary: AgentGuard Python compatibility SDK for HTTP policy evaluation and integration adapters.
Author-email: The Bot Club Pty Ltd <hello@agentguard.tech>
License: Business Source License 1.1
Project-URL: Homepage, https://agentguard.tech
Project-URL: Documentation, https://github.com/thebotclub/agentguard-core#readme
Project-URL: Repository, https://github.com/thebotclub/agentguard-core
Project-URL: Issues, https://github.com/thebotclub/agentguard-core/issues
Project-URL: Limitations, https://agentguard.tech/trust
Keywords: ai-agents,agent-security,policy-engine,openclaw,mcp,runtime-security
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# agentguard-tech

Python compatibility SDK `0.11.1` for AgentGuard HTTP policy evaluation. This
distribution is maintained for truthful compatibility and security fixes; it is
not the normative v1 runtime contract and does not claim equivalent TypeScript
feature scope, executor-owned capability separation, or a compliance outcome.

[![PyPI](https://img.shields.io/pypi/v/agentguard-tech?color=38bdb0)](https://pypi.org/project/agentguard-tech/)
[![Python](https://img.shields.io/pypi/pyversions/agentguard-tech?color=38bdb0)](https://pypi.org/project/agentguard-tech/)
[![license](https://img.shields.io/badge/license-BSL%201.1-orange)](https://github.com/thebotclub/agentguard-core/blob/main/LICENSE)
[![homepage](https://img.shields.io/badge/site-agentguard.tech-38bdb0)](https://agentguard.tech)

The distribution name is `agentguard-tech`; Python imports use `agentguard`.
The TypeScript package is an independent release named
[`@the-bot-club/agentguard`](https://www.npmjs.com/package/@the-bot-club/agentguard).

## Install

```bash
pip install agentguard-tech
```

## Quick start

```python
from agentguard import AgentGuard

guard = AgentGuard(api_key="ag_live_...")
decision = guard.evaluate(tool="shell_exec", params={"cmd": "rm -rf /"})
# → blocked
```

## OpenClaw compatibility hook

`OpenClawGuard` is a Python-side HTTP adapter for a structural
`before_tool_call` hook. Strict mode is required and returns a block decision
on HTTP failure. `strict=False` is a hard startup error. The hook can be
disabled or bypassed and owns no raw capability under a separate identity, so
it is compatibility telemetry only.

```python
from agentguard.integrations.openclaw import openclaw_guard

guard = openclaw_guard(
    api_key=os.environ["AGENTGUARD_API_KEY"],
    agent_id="ops-dispatch-1",
    strict=True,
)
```

OpenClaw-provided session, run, and tool-call IDs are correlation data only.
Other integration modules in this distribution are compatibility adapters; their
presence is not evidence of runtime coverage or equivalent v1 feature scope.

## Documentation

- Website — [agentguard.tech](https://agentguard.tech)
- Docs — [docs.agentguard.tech](https://docs.agentguard.tech)
- OpenClaw integration — [agentguard.tech/openclaw](https://agentguard.tech/openclaw)
- Source — [github.com/thebotclub/agentguard-core](https://github.com/thebotclub/agentguard-core)

## Licence

Business Source License 1.1. The repository `LICENSE` is authoritative.
© 2026 The Bot Club Pty Ltd (ABN 99 695 980 226).
