Metadata-Version: 2.4
Name: agentforge-guard-presidio
Version: 0.2.4
Summary: Microsoft Presidio PII detector for AgentForge guardrails
Project-URL: Homepage, https://github.com/Scaffoldic/agentforge-py
Project-URL: Repository, https://github.com/Scaffoldic/agentforge-py
Project-URL: Documentation, https://github.com/Scaffoldic/agentforge-py
Project-URL: Changelog, https://github.com/Scaffoldic/agentforge-py/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/Scaffoldic/agentforge-py/issues
Author: The AgentForge Authors
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agent,ai,guardrails,pii,presidio
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.13
Requires-Dist: agentforge-core~=0.2.4
Description-Content-Type: text/markdown

# agentforge-guard-presidio

[Microsoft Presidio](https://microsoft.github.io/presidio/) PII
detection + anonymisation for AgentForge guardrails (feat-018).

Adds the `presidio` validator to the `agentforge.yaml`
`modules.guardrails.output` section:

```yaml
modules:
  guardrails:
    output:
      - presidio:
          entities: ["EMAIL_ADDRESS", "PHONE_NUMBER", "PERSON",
                     "CREDIT_CARD", "US_SSN", "IP_ADDRESS"]
          score_threshold: 0.5
          action: "redact"   # "redact" | "score-only"
```

```bash
agentforge add module guard-presidio
```

The default `score_threshold` of `0.5` is Presidio's recommended
balance between recall and false positives. Set lower for stricter
redaction, higher to reduce noise. `action: "score-only"` reports
the violations without modifying the content.
