Metadata-Version: 2.4
Name: rootzerovault
Version: 4.0.0
Summary: Root Zero Vault — Constitutional AI Governance SDK
Project-URL: Homepage, https://rsb.is
Project-URL: Repository, https://github.com/deensaleh/rsbis-sdk
Project-URL: Documentation, https://rsb.is/docs
Author-email: Root Zero Vault <sdk@rootzerovault.com>
License: MIT
Keywords: ai-governance,audit-chain,constitutional,deed,rootzerovault,rsbis,validation
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.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: blake3>=0.3.3
Requires-Dist: httpx>=0.24.0
Provides-Extra: a2a
Requires-Dist: a2a-sdk>=0.3.0; extra == 'a2a'
Provides-Extra: acp
Requires-Dist: acp-sdk>=0.0.6; (python_version >= '3.11') and extra == 'acp'
Provides-Extra: all
Requires-Dist: a2a-sdk>=0.3.0; extra == 'all'
Requires-Dist: acp-sdk>=1.0.0; extra == 'all'
Requires-Dist: anp>=0.6.0; extra == 'all'
Requires-Dist: crewai>=1.0.0; extra == 'all'
Requires-Dist: langchain-core>=0.1.0; extra == 'all'
Requires-Dist: mcp>=1.0.0; extra == 'all'
Requires-Dist: pydantic-ai>=1.0.0; extra == 'all'
Requires-Dist: smolagents>=1.0.0; extra == 'all'
Provides-Extra: anp
Requires-Dist: anp>=0.6.0; extra == 'anp'
Requires-Dist: fastapi>=0.100.0; extra == 'anp'
Provides-Extra: crewai
Requires-Dist: crewai>=1.0.0; extra == 'crewai'
Provides-Extra: dev
Requires-Dist: a2a-sdk>=0.3.0; (python_version >= '3.10') and extra == 'dev'
Requires-Dist: acp-sdk>=0.0.6; (python_version >= '3.11') and extra == 'dev'
Requires-Dist: anp>=0.6.0; (python_version >= '3.10') and extra == 'dev'
Requires-Dist: anthropic>=0.40.0; (python_version >= '3.10') and extra == 'dev'
Requires-Dist: boto3>=1.34.0; (python_version >= '3.10') and extra == 'dev'
Requires-Dist: cohere>=5.0.0; (python_version >= '3.10') and extra == 'dev'
Requires-Dist: crewai>=1.0.0; (python_version >= '3.10') and extra == 'dev'
Requires-Dist: fastapi>=0.100.0; (python_version >= '3.9') and extra == 'dev'
Requires-Dist: httpx>=0.24.0; extra == 'dev'
Requires-Dist: langchain-core>=0.1.0; (python_version >= '3.9') and extra == 'dev'
Requires-Dist: mcp>=1.0.0; (python_version >= '3.10') and extra == 'dev'
Requires-Dist: openai>=1.0.0; (python_version >= '3.10') and extra == 'dev'
Requires-Dist: pydantic-ai>=1.0.0; (python_version >= '3.10') and extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: respx>=0.20; extra == 'dev'
Requires-Dist: smolagents>=1.0.0; (python_version >= '3.10') and extra == 'dev'
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.1.0; extra == 'langchain'
Provides-Extra: mcp
Requires-Dist: mcp>=1.0.0; extra == 'mcp'
Provides-Extra: pydantic-ai
Requires-Dist: pydantic-ai>=1.0.0; extra == 'pydantic-ai'
Provides-Extra: semantic-kernel
Requires-Dist: semantic-kernel>=1.0.0; extra == 'semantic-kernel'
Provides-Extra: smolagents
Requires-Dist: smolagents>=1.0.0; extra == 'smolagents'
Description-Content-Type: text/markdown

# rootzerovault

Constitutional AI Governance SDK for Python — connects your AI agents and tools to the Root Zero Vault constitutional gateway.

## Install

```bash
pip install rootzerovault
```

## Quick start (live gateway)

```python
from rootzerovault import RzvClient

rzv = RzvClient(gateway="http://localhost:8443")
result = rzv.validate(specimen)
print(result.outcome)  # 'ACCEPT' | 'REJECT'
```

## Quick start (offline / demo mode)

For tests, demos, or offline development without a gateway, use `demo_mode=True`:

```python
from rootzerovault import RzvClient

rzv = RzvClient(demo_mode=True)
# Governance calls return simulated outcomes instead of raising RzvNotConfiguredError.
# All adapters propagate this through their internal GovernanceClient.
```

**Important:** `demo_mode` is for tests and demos only — **never use in production**. Without `gateway` and without `demo_mode=True`, calls that need governance fail closed with `RzvNotConfiguredError`.

## Framework adapters

Out-of-the-box wrappers for common AI/agent frameworks. Each adapter constructs a `GovernanceClient` that propagates the `demo_mode` flag from the `RzvClient` you pass in.

- LangChain — `from rootzerovault.adapters import governed_langchain_tool, GovernedTool`
- CrewAI — `from rootzerovault.adapters import governed_crewai_tool, GovernedCrew`
- OpenAI Agents — `from rootzerovault.adapters import governed_openai_agents_tool`
- Anthropic — `from rootzerovault.adapters import GovernedAnthropic`
- AWS Bedrock — `from rootzerovault.adapters import GovernedBedrockClient`
- Google Vertex / Gemini — `from rootzerovault.adapters import governed_vertex_tool`
- Azure OpenAI — `from rootzerovault.adapters import governed_azure_openai`
- Cohere — `from rootzerovault.adapters import governed_cohere`
- MCP (Model Context Protocol) — `from rootzerovault.adapters import GovernedMCPServer, governed_tool`
- A2A (Agent-to-Agent) — `from rootzerovault.adapters import GovernedA2AAgent`
- ANP (Agent Network Protocol) — `from rootzerovault.adapters import governed_anp`
- ACP — `from rootzerovault.adapters import GovernedACPAgent`
- Agno — `from rootzerovault.adapters import GovernedAgnoAgent`
- Semantic Kernel — `from rootzerovault.adapters import governed_semantic_kernel`
- Smolagents — `from rootzerovault.adapters import GovernedSmolTool`
- PydanticAI — `from rootzerovault.adapters import governed_pydantic_ai`
- HTTP — `from rootzerovault.adapters import HttpAdapter`
- Database / SQL — `from rootzerovault.adapters import governed_database`
- gRPC — `from rootzerovault.adapters import governed_grpc`

Optional dependencies are listed under `pyproject.toml [project.optional-dependencies]`. Install with the framework you need:

```bash
pip install rootzerovault[langchain]
pip install rootzerovault[crewai]
pip install rootzerovault[mcp]
# or all at once:
pip install rootzerovault[all]
```

## Genesis

Constitutional anchor — frozen since March 14, 2026. Cannot be backdated. Cannot be altered.

```
cvid:blake3:1544ff7dd978d911083bd60a7a4e6ba9647996bfdefb62aa8a045ccb63158867
```

## Testing

```bash
pip install -e ".[dev]"
python -m pytest tests/
```

Tests fall into three implicit categories: unit tests (no optional deps required), adapter tests (each requires its framework's optional dep installed; skipped otherwise), and live-gateway tests (require a running gateway at `http://localhost:8443`).

## License

Dual MIT OR Apache-2.0.

## Links

- Source: https://github.com/deensaleh/rsbis-sdk
- Issues: https://github.com/deensaleh/rsbis-sdk/issues
- Project: https://rootzerovault.com
