cortexhub 0.1.0__py3-none-any.whl

cortexhub-0.1.0.dist-info/METADATA

@@ -0,0 +1,275 @@
+Metadata-Version: 2.4
+Name: cortexhub
+Version: 0.1.0
+Summary: CortexHub Python SDK - Policy-as-Code for AI Agents
+Project-URL: Homepage, https://cortexhub.ai
+Project-URL: Documentation, https://docs.cortexhub.ai
+Project-URL: Repository, https://github.com/cortexhub/sdks
+Project-URL: Issues, https://github.com/cortexhub/sdks/issues
+Author-email: CortexHub <hello@cortexhub.ai>
+License: MIT
+Keywords: agents,ai,authorization,cedar,governance,policy
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <3.14,>=3.10
+Requires-Dist: cedarpy>=4.0.0
+Requires-Dist: detect-secrets>=1.5.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: opentelemetry-api>=1.20.0
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.20.0
+Requires-Dist: opentelemetry-sdk>=1.20.0
+Requires-Dist: pip>=23.0
+Requires-Dist: presidio-analyzer>=2.2.360
+Requires-Dist: presidio-anonymizer>=2.2.360
+Requires-Dist: pydantic>=2.9.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: structlog>=24.4.0
+Provides-Extra: all
+Requires-Dist: anthropic>=0.40.0; extra == 'all'
+Requires-Dist: claude-agent-sdk>=0.0.1; extra == 'all'
+Requires-Dist: crewai>=0.50.0; extra == 'all'
+Requires-Dist: langchain-core>=0.2.0; extra == 'all'
+Requires-Dist: langchain-openai>=0.1.0; extra == 'all'
+Requires-Dist: langgraph>=0.2.0; extra == 'all'
+Requires-Dist: openai-agents>=0.0.3; extra == 'all'
+Provides-Extra: claude-agents
+Requires-Dist: anthropic>=0.40.0; extra == 'claude-agents'
+Requires-Dist: claude-agent-sdk>=0.0.1; extra == 'claude-agents'
+Provides-Extra: crewai
+Requires-Dist: crewai>=0.50.0; extra == 'crewai'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Provides-Extra: langgraph
+Requires-Dist: langchain-core>=0.2.0; extra == 'langgraph'
+Requires-Dist: langchain-openai>=0.1.0; extra == 'langgraph'
+Requires-Dist: langgraph>=0.2.0; extra == 'langgraph'
+Provides-Extra: openai-agents
+Requires-Dist: openai-agents>=0.0.3; extra == 'openai-agents'
+Description-Content-Type: text/markdown
+
+# CortexHub Python SDK
+
+**Runtime Governance for AI Agents** - Policy enforcement, PII/secrets detection, complete audit trails with OpenTelemetry.
+
+## Installation
+
+```bash
+# Core SDK
+pip install cortexhub
+
+# With framework support (choose one or more)
+pip install cortexhub[langchain]      # LangChain/LangGraph
+pip install cortexhub[crewai]         # CrewAI
+pip install cortexhub[openai-agents]  # OpenAI Agents SDK
+pip install cortexhub[llamaindex]     # LlamaIndex
+pip install cortexhub[litellm]        # LiteLLM
+
+# All frameworks (for development)
+pip install cortexhub[all]
+```
+
+## Quick Start
+
+```python
+from cortexhub import init, Framework
+
+# Initialize CortexHub FIRST, before importing your framework
+cortex = init(
+    agent_id="customer_support_agent",
+    framework=Framework.LANGCHAIN,  # or CREWAI, OPENAI_AGENTS, etc.
+)
+
+# Now import and use your framework
+from langchain_core.tools import tool
+
+@tool
+def process_refund(customer_id: str, amount: float) -> dict:
+    """Process a customer refund."""
+    return {"status": "processed", "amount": amount}
+
+# All tool calls are now governed!
+```
+
+## Supported Frameworks
+
+| Framework | Enum Value | Install |
+|-----------|------------|---------|
+| LangChain | `Framework.LANGCHAIN` | `pip install cortexhub[langchain]` |
+| LangGraph | `Framework.LANGCHAIN` | `pip install cortexhub[langchain]` |
+| CrewAI | `Framework.CREWAI` | `pip install cortexhub[crewai]` |
+| OpenAI Agents | `Framework.OPENAI_AGENTS` | `pip install cortexhub[openai-agents]` |
+| LlamaIndex | `Framework.LLAMAINDEX` | `pip install cortexhub[llamaindex]` |
+| LiteLLM | `Framework.LITELLM` | `pip install cortexhub[litellm]` |
+
+## Configuration
+
+```bash
+# Required: API key for telemetry
+export CORTEXHUB_API_KEY=ch_live_...
+
+# Optional: Backend URL (defaults to production)
+export CORTEXHUB_API_URL=https://api.cortexhub.ai
+
+# Optional: OpenAI key for LLM-based examples
+export OPENAI_API_KEY=sk-...
+```
+
+## Features
+
+- **Policy Enforcement** - Cedar-based policies, local evaluation
+- **PII Detection** - Presidio-powered, 50+ entity types, configurable
+- **Secrets Detection** - detect-secrets integration, 30+ secret types
+- **Configurable Guardrails** - Select specific PII/secret types to redact
+- **Custom Patterns** - Add company-specific regex patterns
+- **OpenTelemetry** - Industry-standard observability
+- **Framework Adapters** - Automatic interception for all major frameworks
+- **Privacy Mode** - Metadata-only by default, safe for production
+
+## Privacy Modes
+
+```python
+# Production (default) - only metadata sent
+cortex = init(agent_id="...", framework=..., privacy=True)
+# Sends: tool names, arg schemas, PII types detected
+# Never: raw values, prompts, responses
+
+# Development - full data for testing policies  
+cortex = init(agent_id="...", framework=..., privacy=False)
+# Also sends: raw args, results, prompts (for policy testing)
+```
+
+## Policy Enforcement
+
+Policies are created in the CortexHub dashboard from detected risks. The SDK automatically fetches and enforces them:
+
+```python
+from cortexhub.errors import PolicyViolationError, ApprovalRequiredError
+
+# Policies are fetched automatically during init()
+# If policies exist, enforcement mode is enabled
+
+try:
+    agent.run("Process a $10,000 refund")
+except PolicyViolationError as e:
+    print(f"Blocked by policy: {e.policy_name}")
+    print(f"Reason: {e.reasoning}")
+except ApprovalRequiredError as e:
+    print(f"\n⏸️  APPROVAL REQUIRED")
+    print(f"   Approval ID: {e.approval_id}")
+    print(f"   Tool: {e.tool_name}")
+    print(f"   Reason: {e.reason}")
+    print(f"   Expires: {e.expires_at}")
+    print(f"\n   Decision endpoint: {e.decision_endpoint}")
+    print(f"   Configure a webhook to receive approval.decisioned event")
+```
+
+## Guardrail Configuration
+
+Guardrails detect PII and secrets in LLM prompts. Configure in the dashboard:
+
+1. **Select types to redact**: Choose specific PII types (email, phone, etc.)
+2. **Add custom patterns**: Regex for company-specific data (employee IDs, etc.)
+3. **Choose action**: Redact, block, or monitor only
+
+The SDK applies your configuration automatically:
+
+```python
+# With guardrail policy active:
+# Input prompt: "Contact john@email.com about employee EMP-123456"
+# After redaction: "Contact [REDACTED-EMAIL_ADDRESS] about employee [REDACTED-CUSTOM_EMPLOYEE_ID]"
+# Only configured types are redacted
+```
+
+## Examples
+
+```bash
+cd python/examples
+
+# LangChain customer support
+python langchain_example.py
+
+# LangGraph fraud investigation  
+python langgraph_example.py
+
+# CrewAI financial operations
+python crewai_example.py
+
+# OpenAI Agents research assistant
+python openai_agents_example.py
+
+# LiteLLM multi-provider
+python litellm_example.py
+```
+
+## Important: Initialization Order
+
+**Always initialize CortexHub FIRST**, before importing your framework:
+
+```python
+# ✅ CORRECT
+from cortexhub import init, Framework
+cortex = init(agent_id="my_agent", framework=Framework.LANGCHAIN)
+
+from langchain_core.tools import tool  # Import AFTER init
+
+# ❌ WRONG
+from langchain_core.tools import tool  # Framework imported first
+from cortexhub import init, Framework
+cortex = init(...)  # Too late!
+```
+
+This ensures:
+1. CortexHub sets up OpenTelemetry before frameworks that also use it
+2. Framework decorators/classes are properly wrapped
+
+## Architecture
+
+```
+Agent Decides → [CortexHub] → Agent Executes
+                    │
+              ┌─────┴─────┐
+              │           │
+         Policy      Guardrails
+         Engine      (PII/Secrets)
+              │           │
+              └─────┬─────┘
+                    │
+              OpenTelemetry
+               (to backend)
+```
+
+## Development
+
+```bash
+cd python
+
+# Install with all frameworks
+uv sync --all-extras
+
+# Run tests
+uv run pytest
+
+# Lint
+uv run ruff check .
+```
+
+## Links
+
+- [Documentation](https://docs.cortexhub.ai)
+- [Dashboard](https://app.cortexhub.ai)
+- [Issues](https://github.com/cortexhub/sdks/issues)
+
+## License
+
+MIT

cortexhub-0.1.0.dist-info/RECORD

@@ -0,0 +1,38 @@
+cortexhub/__init__.py,sha256=hnwsiUy5BT3QaPNK5yXqex6zRzZlok43S04y-dkNWSE,4376
+cortexhub/auto_protect.py,sha256=yW-iW9cdGg-fM8EtR_Z9UkMczn51U8BKh5pOBgV1VqE,3951
+cortexhub/client.py,sha256=pXZI3Fc2SqBWCSmnRB9j6qAq8-qky1EYw9mvEVBXwn0,94080
+cortexhub/config.py,sha256=kpwVMTRcSisJy8HHBL3ZBeQoMN3lE7zziRzEYaq92LI,941
+cortexhub/errors.py,sha256=hsknLHaVCqk5MkpXvahxYIUshDt2VGZfbBWRronFvVM,3697
+cortexhub/frameworks.py,sha256=WCPokPRVafLqe73MDbJasi8FyNHTM2T4wfaBg0LuWoM,2223
+cortexhub/pipeline.py,sha256=EvkrEz7dGnzc0tlv02B3Kx2KQfdX4gsTuhUxj-MwuFI,3256
+cortexhub/version.py,sha256=L1gsFyWfMZYvly7nYjyH0nlWRAsm65S61_B-imDPgXE,68
+cortexhub/adapters/__init__.py,sha256=Lb6RquGPGs4exdfSB6Qb6q6HyGczozuLWSaLCtgZdyo,130
+cortexhub/adapters/base.py,sha256=_ODoJFLQLYnowse3MHQk8bN9KjE1oQr8QDNNlvPSwSs,4094
+cortexhub/adapters/claude_agents.py,sha256=gXjONi7Otl6kfQQLHENsrJ_gsBw2ilATCa1zwNNR6EY,12601
+cortexhub/adapters/crewai.py,sha256=Y7ibOD1sFahDQ39XRZw_Kx2PCcZvKpyQKOSo0aZvs_0,12521
+cortexhub/adapters/langgraph.py,sha256=FpIcAITNnIk6OUK9rCyCA2nVxQvs0ibyCFH0j-CjHv0,15024
+cortexhub/adapters/openai_agents.py,sha256=NtTsUjrRv3nzd-1VXLu7_imW9l2LzCvna1u02QTDRh8,7600
+cortexhub/audit/__init__.py,sha256=tKE9CdpAIpP04oeLOza96jwZs4er5G5bRBWGibvh4Xw,545
+cortexhub/audit/events.py,sha256=w1uHbYzwBTDRm8gKAY_TQlXHjUj2nZt-iXk0NcqzRak,5965
+cortexhub/backend/__init__.py,sha256=Yt5fcaW24l6YwPCLvKbcKAXhhrWTUjwgqJsLOIzgIAo,133
+cortexhub/backend/client.py,sha256=dYd2aWJORysrEfJ5T_QPLwvs0xUQLrhMVT4FWUVOg6c,13680
+cortexhub/context/__init__.py,sha256=BWoR2s4ogOs1YXPFBO7e8_UOZ_5AWYfMlv5PTVORN2Y,144
+cortexhub/context/enricher.py,sha256=cComyfE10EbaCAI8KLM0ED6j-wKYBc26MRnIn-dxhmU,5322
+cortexhub/guardrails/__init__.py,sha256=RH1u8w3FFLd6u7-OYgj42PqAJO9jXsl8-tcLiL24uOo,103
+cortexhub/guardrails/injection.py,sha256=BZqd4qxD2dbM52yajmNBADKazp0DDeRFqjhuYRPGwfo,5786
+cortexhub/guardrails/pii.py,sha256=ruSVtp2rflRjvnvAqAXdNhOTDO5SSbSbfIEzlfb92c8,12818
+cortexhub/guardrails/secrets.py,sha256=9LW93WTTH6lYwD-zumNtSsDPXqjt0SX_fPoo_tEML68,6081
+cortexhub/interceptors/__init__.py,sha256=_rTpQs6CPDVtYXVbinGOWzdhczCkcwTsXNpZkXWxwDo,89
+cortexhub/interceptors/llm.py,sha256=MtYD4M3-9XKmBZH5rYLBxOwFeWFbw4guSt7y93n8DgQ,2068
+cortexhub/interceptors/mcp.py,sha256=SDoVZn0mLQdxOBs3X15DqA6hKzh6UydMuS1FhZaHKcU,3323
+cortexhub/policy/__init__.py,sha256=JcTQQ5nk39dB3L4MmuFxLgfjq3GLi6a8zpTPGlf5q94,212
+cortexhub/policy/effects.py,sha256=aelpCh1aGAJJmJHNgRTJjMAuMktDtR0NgfIb1AocC6c,2694
+cortexhub/policy/evaluator.py,sha256=loDHNqgnQDCDXLaJAhlnVbp9t1YxzcUn0c5r6L5gqHs,10021
+cortexhub/policy/loader.py,sha256=KmoPC5aLQjzuVsJd8Dg0npZXQ5WCBRktgdNmG875D-U,4699
+cortexhub/policy/models.py,sha256=81NPX36yru0AZ22Wivytv3uxlwir4VsTN4MZgq4bdiA,3877
+cortexhub/policy/sync.py,sha256=7kAc3rd5WftipR8XKwvU8SwukIoY-0gcGW2fsf-ij_I,5999
+cortexhub/telemetry/__init__.py,sha256=RSY38hHnYtbRURLoWAhbYYxYMtCItVYZBNN6Bfny8uA,1049
+cortexhub/telemetry/otel.py,sha256=T2pC-K_S_KmrLvfcd3oHMbEwC5ibGZ-PXTZSY0xJgcQ,16633
+cortexhub-0.1.0.dist-info/METADATA,sha256=XSJRddscqapbULDxf9i19lNq9SIhf3iZ-11WJeVg5YM,8629
+cortexhub-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+cortexhub-0.1.0.dist-info/RECORD,,

cortexhub-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any