Validation SDK

Status: Published (Sprint 33) Module: pkg.specs.validation_sdk

1. Purpose

Provide a lightweight SDK surface for validating:

• execution manifest payloads (v1)
• telemetry extension payloads (v1)
• capability policy input payloads (v1)

2. API Surface

• validate_execution_manifest_v1(payload)
• validate_telemetry_extension_v1(payload)
• validate_capability_policy_input_v1(payload)
• validate_spec_bundle_v1(manifest_payload, telemetry_payload, capability_payload)

Return model:

• ValidationResult(ok: bool, errors: list[str], normalized: dict[str, Any] | None)

3. Example

from pkg.specs.validation_sdk import validate_spec_bundle_v1

result = validate_spec_bundle_v1(
    manifest_payload=manifest_payload,
    telemetry_payload=telemetry_payload,
    capability_payload=capability_payload,
)

if not result["manifest"].ok:
    raise RuntimeError(result["manifest"].errors)

4. Notes

• SDK is deterministic and schema-focused.
• Runtime trust checks (mTLS, signature verification, replay windows) still occur in production control paths.