Metadata-Version: 2.4
Name: value-context-protocol
Version: 4.2.0
Summary: Project-maintained implementation of the Value Context Protocol for portable, verifiable context
Author: Nell Watson
Author-email: Claude <noreply@anthropic.com>
Maintainer: Nell Watson
License-Expression: MIT
Project-URL: Homepage, https://github.com/Creed-Space/VCP-SDK
Project-URL: Documentation, https://github.com/Creed-Space/VCP-SDK/tree/main/docs
Project-URL: Repository, https://github.com/Creed-Space/VCP-SDK
Project-URL: Source, https://github.com/Creed-Space/VCP-SDK/tree/main/python
Project-URL: Issues, https://github.com/Creed-Space/VCP-SDK/issues
Project-URL: Changelog, https://github.com/Creed-Space/VCP-SDK/blob/main/CHANGELOG.md
Project-URL: Security, https://github.com/Creed-Space/VCP-SDK/security/policy
Project-URL: Support, https://github.com/Creed-Space/VCP-SDK/discussions
Keywords: becoming-minds,context,protocol,safety,values
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
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: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.12.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: rfc8785>=0.1.4
Provides-Extra: server
Requires-Dist: fastapi>=0.100.0; extra == "server"
Requires-Dist: uvicorn>=0.31.1; extra == "server"
Requires-Dist: redis>=4.5.0; extra == "server"
Provides-Extra: redis
Requires-Dist: redis>=4.5.0; extra == "redis"
Provides-Extra: metrics
Requires-Dist: prometheus-client>=0.20.0; extra == "metrics"
Provides-Extra: mcp
Requires-Dist: mcp<3,>=2.0.0; extra == "mcp"
Requires-Dist: jsonschema>=4.20.0; extra == "mcp"
Provides-Extra: dev
Requires-Dist: build>=1.3.0; extra == "dev"
Requires-Dist: twine==7.0.0; extra == "dev"
Requires-Dist: pip-audit>=2.9.0; extra == "dev"
Requires-Dist: uv==0.12.7; extra == "dev"
Requires-Dist: prometheus-client>=0.20.0; extra == "dev"
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov==7.1.0; extra == "dev"
Requires-Dist: httpx>=0.24.0; extra == "dev"
Requires-Dist: jsonschema>=4.20.0; extra == "dev"
Requires-Dist: hypothesis==6.167.1; extra == "dev"
Requires-Dist: redis>=4.5.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: mutmut==3.7.0; extra == "dev"
Requires-Dist: pip>=26.2.1; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: types-jsonschema>=4.20.0; extra == "dev"
Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
Dynamic: license-file

# VCP Python SDK

The Python project-maintained implementation for VCP parsing, signed bundles,
orchestration, policy enforcement, privacy filtering, hooks, messaging, and
protocol extensions.

## Agent Runtime Profile candidate

The `vcp.agent` facade provides complete local reference behavior for observe, controlled, and accretive profile levels. It preserves bounded orientation, explicit assurance, contextual Affordances, proof-first runs, exact single-use authority, interruption and reconciliation, evidence-based completion, candidate-first learning, attributable reuse, and revocation.

```python
from vcp.agent import AgentRuntime

async with AgentRuntime.connect(profile="accretive@0.1.0") as runtime:
    situation = (await runtime.bootstrap("Complete one governed task")).require_value()
```

Local mode opens no network and grants no production authority. Run `vcp doctor --json` before feature use to detect distribution collisions. See [the complete guide](../docs/VCP_AGENT_RUNTIME_GUIDE.md) and the eight executable examples.

## Install for development

Python 3.10 or newer is required.

**Publication state:** source-only candidate. No PyPI release is currently
claimed. Commands below operate on this checkout.

```bash
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e '.[dev]'
```

The package distribution is named `value-context-protocol`. Python imports use
the `vcp` namespace.

## Verify the package

```bash
python -m pytest -q
python -m ruff check src tests
python -m ruff format --check src tests
python -m mypy src/vcp
python -m build
python -m pip_audit
```

## Minimal usage

```python
from vcp.identity import Token
from vcp.semantics.csm1 import CSM1Code

token = Token.parse("family.safe.guide@1.2.0")
profile = CSM1Code.parse("N5+F+E")
print(token.full)
print(profile.encode())
```

Real Ed25519 bundle construction and verification are demonstrated in
[`../examples/python/02_verify_bundle.py`](../examples/python/02_verify_bundle.py).
The full pipeline example verifies before preparing model-context injection.

## Optional features

```bash
python -m pip install -e '.[server]'
python -m pip install -e '.[mcp]'
```

Install the MCP extra and run the packaged stdio server with:

```bash
python -m pip install -e '.[mcp]'
vcp-mcp-server
```

The historical host API adapter is archived outside the package source and is
excluded from distributions. Development and CI use the committed lock file. Update it
deliberately through the documented command in
[`../CONTRIBUTING.md`](../CONTRIBUTING.md).

Signed-skill manifests are written as private workspace state by default. On
POSIX platforms the atomic temporary file and installed `manifest.json` use
mode `0600`. Windows does not provide equivalent POSIX mode semantics, so the
application must protect the containing directory with its native access
controls. A separately published manifest is a deliberate export and should
receive only the permissions required by its publication target.

## Related surfaces

* [Rust SDK](../rust/)
* [WebMCP SDK](../webmcp/)
* [Conformance fixtures](../conformance/)
* [Compatibility policy](../COMPATIBILITY.md)
