vcp-sdk 0.3.0

Value Context Protocol SDK — portable AI ethics validation

vcp-sdk

Python SDK for the Value Context Protocol (VCP) — a standard for encoding values context (personas, scopes, and behavioral constraints) so AI systems can carry, validate, and exchange it portably. Zero runtime dependencies.

Learn more at valuecontextprotocol.org.

Install

pip install vcp-sdk

Python 3.10+. Optional extra vcp-sdk[jsonschema] enables JSON-schema validation of VCP-Lite documents.

What's in the box

API	Purpose
Token	Parse and validate VCP/I identity tokens (family.safe.guide@1.0.0:SEC)
canonicalize_token, tokens_equal, uri_to_canonical	Token normalization helpers
CSM1Code	Parse and validate VCP/S CSM1 structured codes
validate_lite, lite_to_token, lite_to_csm1	Validate VCP-Lite JSON documents and convert them
Context	Encode/decode full VCP context payloads

Quick start

from vcp import Token, CSM1Code, canonicalize_token
from vcp.lite import validate_lite, lite_to_token

# VCP/I tokens
token = Token.parse("family.safe.guide@1.0.0:SEC")

# Normalization
canonicalize_token("Family.Safe.Guide@01.0.0")  # -> "family.safe.guide@1.0.0"

# VCP/S CSM1 codes
code = CSM1Code.parse("Z4+P+T+W:SEC")

# VCP-Lite documents
import json
with open("my-values.vcp-lite.json") as f:
    doc = json.load(f)
errors = validate_lite(doc)  # [] when valid, list of messages otherwise
if not errors:
    print(lite_to_token(doc))

Parse failures raise ValueError with a message describing the grammar violation; validate_lite returns error strings instead of raising.

Command-line validation

The creed-space-cli package builds a lint-style CLI on top of this SDK:

creed vcp validate family.safe.guide@1.0.0
creed vcp parse "Z4+P+T+W:SEC"

License

Apache-2.0. Maintained by Creed Space.