breach-intel-client 0.3.0__tar.gz

breach_intel_client-0.3.0/.gitignore

@@ -0,0 +1,55 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.so
+*.egg
+*.egg-info/
+dist/
+build/
+.eggs/
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Database
+*.db
+*.sqlite3
+
+# Environment / secrets
+.env
+.env.*
+!.env.example
+
+# pytest
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Editors
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# macOS
+.DS_Store
+.AppleDouble
+
+# Node / TypeScript (openclaw plugin)
+node_modules/
+*.js.map
+dist/
+*.tsbuildinfo
+
+# Logs
+*.log
+logs/
+
+# Docker
+.docker/

breach_intel_client-0.3.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: breach-intel-client
+Version: 0.3.0
+Summary: Python SDK for the Breach Intel Policy Agent — attach any AI agent to breach logging in one import
+Project-URL: Homepage, https://github.com/parthamehta123/breach-intel
+Project-URL: Repository, https://github.com/parthamehta123/breach-intel
+Project-URL: Bug Tracker, https://github.com/parthamehta123/breach-intel/issues
+Author-email: Partha Mehta <parthamehta123@gmail.com>
+License: MIT
+Keywords: agents,ai,audit,breach,compliance,fintech,healthcare,pharma,policy
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Provides-Extra: async
+Requires-Dist: httpx>=0.27; extra == 'async'
+Provides-Extra: dev
+Requires-Dist: httpx>=0.27; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# breach-intel-client
+
+> Python SDK for the [Breach Intel Policy Agent](https://github.com/parthamehta123/breach-intel).
+> Drop into any Python AI agent in 2 lines.
+
+```bash
+pip install breach-intel-client
+```
+
+## Quick Start
+
+```python
+from breach_intel_client import PolicyAgentClient
+
+# Initialize (agent_id from register() below)
+client = PolicyAgentClient(
+    base_url="http://your-policy-agent:8080",
+    agent_id="your-agent-id",
+    vertical="fintech",
+    silent=True,   # never block your agent if policy agent is down
+)
+
+# Wrap your LLM calls
+response = my_llm.generate(prompt)
+result = client.emit_llm_response(response.text, tenant_id="customer-001")
+
+if result.is_breach:
+    print(f"[BREACH] {result.breach_types} — severity: {result.severity}")
+    print(f"Breach ID for audit: {result.breach_id}")
+```
+
+## Registration
+
+Call once at agent startup:
+
+```python
+reg = client.register(
+    agent_name="Portfolio Advisor v2",
+    owner_id="acme-corp",
+    declared_capabilities=["read_portfolio", "get_market_data", "send_report"],
+    approved_domains=["api.bloomberg.com", "smtp.acme.com"],
+)
+client.agent_id = reg.agent_id  # save this
+```
+
+## Emitting Events
+
+| Method | Use when |
+|--------|----------|
+| `emit_llm_response(text)` | Any LLM output |
+| `emit_tool_call(name, args)` | Before/after tool invocation |
+| `emit_api_request(method, url, body)` | Any outbound HTTP call |
+| `emit(event_type, payload)` | Any other event |
+
+## Async Support
+
+```python
+# pip install breach-intel-client[async]
+from breach_intel_client import AsyncPolicyAgentClient
+
+async with AsyncPolicyAgentClient("http://localhost:8080", agent_id="...") as client:
+    result = await client.emit_llm_response_async(text, tenant_id="cust-001")
+```
+
+## Querying Breaches
+
+```python
+# All breaches for this agent
+breaches = client.get_breaches(severity="CRITICAL")
+
+# Single record
+breach = client.get_breach("br-xyz")
+
+# Tamper check
+integrity = client.verify_breach("br-xyz")
+print(integrity["tampered"])  # False = clean
+
+# Summary counts
+print(client.summary())
+```

breach_intel_client-0.3.0/README.md

@@ -0,0 +1,80 @@
+# breach-intel-client
+
+> Python SDK for the [Breach Intel Policy Agent](https://github.com/parthamehta123/breach-intel).
+> Drop into any Python AI agent in 2 lines.
+
+```bash
+pip install breach-intel-client
+```
+
+## Quick Start
+
+```python
+from breach_intel_client import PolicyAgentClient
+
+# Initialize (agent_id from register() below)
+client = PolicyAgentClient(
+    base_url="http://your-policy-agent:8080",
+    agent_id="your-agent-id",
+    vertical="fintech",
+    silent=True,   # never block your agent if policy agent is down
+)
+
+# Wrap your LLM calls
+response = my_llm.generate(prompt)
+result = client.emit_llm_response(response.text, tenant_id="customer-001")
+
+if result.is_breach:
+    print(f"[BREACH] {result.breach_types} — severity: {result.severity}")
+    print(f"Breach ID for audit: {result.breach_id}")
+```
+
+## Registration
+
+Call once at agent startup:
+
+```python
+reg = client.register(
+    agent_name="Portfolio Advisor v2",
+    owner_id="acme-corp",
+    declared_capabilities=["read_portfolio", "get_market_data", "send_report"],
+    approved_domains=["api.bloomberg.com", "smtp.acme.com"],
+)
+client.agent_id = reg.agent_id  # save this
+```
+
+## Emitting Events
+
+| Method | Use when |
+|--------|----------|
+| `emit_llm_response(text)` | Any LLM output |
+| `emit_tool_call(name, args)` | Before/after tool invocation |
+| `emit_api_request(method, url, body)` | Any outbound HTTP call |
+| `emit(event_type, payload)` | Any other event |
+
+## Async Support
+
+```python
+# pip install breach-intel-client[async]
+from breach_intel_client import AsyncPolicyAgentClient
+
+async with AsyncPolicyAgentClient("http://localhost:8080", agent_id="...") as client:
+    result = await client.emit_llm_response_async(text, tenant_id="cust-001")
+```
+
+## Querying Breaches
+
+```python
+# All breaches for this agent
+breaches = client.get_breaches(severity="CRITICAL")
+
+# Single record
+breach = client.get_breach("br-xyz")
+
+# Tamper check
+integrity = client.verify_breach("br-xyz")
+print(integrity["tampered"])  # False = clean
+
+# Summary counts
+print(client.summary())
+```

breach_intel_client-0.3.0/breach_intel_client/__init__.py

@@ -0,0 +1,61 @@
+"""
+breach-intel-client — Python SDK for the Breach Intel Policy Agent
+
+Zero stdlib dependencies. Drop into any Python AI agent.
+
+    pip install breach-intel-client
+
+Quick start:
+    from breach_intel_client import PolicyAgentClient
+
+    client = PolicyAgentClient("http://localhost:8080", agent_id="your-agent-id")
+    result = client.emit_llm_response(llm_output, tenant_id="cust-001")
+    if result.is_breach:
+        print(f"BREACH: {result.breach_types}")
+
+Passive mode (zero code — just set env vars):
+    BREACH_INTEL_URL=http://localhost:8080 python your_agent.py
+"""
+
+from .client import (
+    BreachRecord,
+    EventResult,
+    PolicyAgentClient,
+    RegistrationResult,
+)
+from .auto import (
+    monitor,
+    auto_monitor,
+    auto_attach,
+    get_client,
+    LangChainBreachHandler,
+)
+
+# AsyncPolicyAgentClient requires httpx — import conditionally
+try:
+    from .client import AsyncPolicyAgentClient  # type: ignore
+except ImportError:
+    AsyncPolicyAgentClient = None  # type: ignore
+
+__version__ = "0.3.0"
+__all__ = [
+    "PolicyAgentClient",
+    "AsyncPolicyAgentClient",
+    "EventResult",
+    "BreachRecord",
+    "RegistrationResult",
+    # Auto-instrumentation
+    "monitor",
+    "auto_monitor",
+    "auto_attach",
+    "get_client",
+    "LangChainBreachHandler",
+]
+
+# ─── Import-time passive activation ──────────────────────────────────────────
+# If BREACH_INTEL_URL is set, auto-attach on import. Silent by default —
+# never breaks the importing application.
+
+import os as _os
+if _os.environ.get("BREACH_INTEL_URL"):
+    auto_attach()