ag2-tealtiger
Deterministic governance adapter for AG2 (AutoGen fork) — policy enforcement, PII detection, cost tracking, per-agent kill switch, governed speaker selection, and structured audit evidence.
No LLM in the governance path. All policy evaluation is deterministic, adding <5ms latency.
Installation
pip install ag2-tealtiger
Quick Start
Zero-Config Observe Mode
from ag2_tealtiger import TealTigerGuard
guard = TealTigerGuard() # No engine = observe mode
guard.attach(my_agent)
# Cost, PII, and tool usage tracked automatically. Nothing blocked.
Or the convenience subclass:
from ag2_tealtiger import TealTigerAuditAgent
agent = TealTigerAuditAgent(name="coder") # Zero config, observe mode built-in
Policy Enforcement
from ag2_tealtiger import TealTigerGuard, GovernanceMode
guard = TealTigerGuard(engine=my_engine, mode=GovernanceMode.ENFORCE)
guard.attach(agent)
# DENY blocks the call with a structured denial message
Governed GroupChat
from ag2_tealtiger import GovernedGroupChat, TealTigerGuard, GovernanceMode
guard = TealTigerGuard(engine=engine, mode=GovernanceMode.ENFORCE)
group_chat = GovernedGroupChat(agents=[agent1, agent2, agent3], guard=guard)
speaker = group_chat.select_speaker(last_speaker=agent1)
Features
| Feature | Observe | Monitor | Enforce |
|---|---|---|---|
| Cost tracking per agent | ✅ | ✅ | ✅ |
| PII detection in tool args | ✅ | ✅ | ✅ |
| Structured audit entries (TEEC) | ✅ | ✅ | ✅ |
| Per-agent freeze/unfreeze | ✅ | ✅ | ✅ |
| Policy evaluation | — | ✅ (log) | ✅ (block) |
| Budget enforcement | — | ✅ (log) | ✅ (block) |
| REFER escalation | — | ✅ | ✅ |
| Inter-agent message governance | ✅ | ✅ | ✅ |
| Governed speaker selection | ✅ | ✅ | ✅ |
| JSONL audit export | ✅ | ✅ | ✅ |
License
Apache-2.0
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ag2_tealtiger-0.1.0.tar.gz
(96.2 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ag2_tealtiger-0.1.0.tar.gz.
File metadata
- Download URL: ag2_tealtiger-0.1.0.tar.gz
- Upload date:
- Size: 96.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e9de8a5b5d1d534f3fdb838ffc88ae234ec380fd9363c17deeaadca7605a4d90
|
|
| MD5 |
27e9700e4fa1ebd5ddf97d45582888dc
|
|
| BLAKE2b-256 |
488d18b0d16a858b9ff3f1542c53b989e68229bd7854f66e1cd0f84e80bdc966
|
File details
Details for the file ag2_tealtiger-0.1.0-py3-none-any.whl.
File metadata
- Download URL: ag2_tealtiger-0.1.0-py3-none-any.whl
- Upload date:
- Size: 2.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a6b421155747f5662db7a8c4af324f3154720373dfb9735d271a6338ceca2b6f
|
|
| MD5 |
ca5bf2d0c962fa4470fbfe1c704145b3
|
|
| BLAKE2b-256 |
3fba392458be85b295497d8483b3dfb3043a875532136591c9d3e2896f848004
|
