dyff-schema 0.33.1__tar.gz → 0.34.1__tar.gz

{dyff_schema-0.33.1/dyff_schema.egg-info → dyff_schema-0.34.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dyff-schema
-Version: 0.33.1
+Version: 0.34.1
 Summary: Data models for the Dyff AI auditing platform.
 Author-email: Digital Safety Research Institute <contact@dsri.org>
 License: Apache-2.0

dyff_schema-0.34.1/dyff/schema/_version.py

@@ -0,0 +1,2 @@
+__version__ = version = "0.34.1"
+__version_tuple__ = version_tuple = (0, 34, 1)

{dyff_schema-0.33.1 → dyff_schema-0.34.1}/dyff/schema/v0/r1/oci.py

@@ -181,3 +181,15 @@ class ImageManifest(_OCISchemaBaseModel):
                     " if .artifactType is unspecified"
                 )
         return self
+
+
+__all__ = [
+    "Descriptor",
+    "ExecutionParameters",
+    "HistoryEntry",
+    "ImageConfig",
+    "ImageDescriptor",
+    "ImageManifest",
+    "Platform",
+    "RootFS",
+]

{dyff_schema-0.33.1 → dyff_schema-0.34.1}/dyff/schema/v0/r1/platform.py

@@ -24,6 +24,7 @@ import enum
 import urllib.parse
 from datetime import datetime
 from enum import Enum
+from pathlib import Path
 from typing import Any, Literal, NamedTuple, Optional, Type, Union
 
 import pyarrow
@@ -317,6 +318,9 @@ class EntityIdentifier(DyffSchemaBaseModel):
         description="The .kind of the entity.",
     )
 
+    def resource_path(self) -> str:
+        return f"{Resources.for_kind(Entities(self.kind)).value}/{self.id}"
+
 
 def LabelKey() -> type[str]:
     return Annotated[
@@ -1082,6 +1086,32 @@ class Dataset(DyffEntity, DatasetBase):
         return None
 
 
+# ----------------------------------------------------------------------------
+# Model
+
+
+class File(DyffSchemaBaseModel):
+    mediaType: Optional[str] = pydantic.Field(
+        default=None, description="The media type (MIME type) of the file"
+    )
+    path: str = pydantic.Field(
+        description="The relative path of the file within the containing volume"
+    )
+    digest: Digest = pydantic.Field(
+        default_factory=Digest,
+        description="One or more message digests (hashes) of the file data",
+    )
+
+
+class FileStorageURL(DyffSchemaBaseModel):
+    file: File
+    signedURL: StorageSignedURL
+
+
+class Volume(DyffSchemaBaseModel):
+    files: list[File] = pydantic.Field(description="A list of files in the volume")
+
+
 class ModelSourceKinds(str, enum.Enum):
     GitLFS = "GitLFS"
     HuggingFaceHub = "HuggingFaceHub"
@@ -1135,10 +1165,6 @@ class ModelSource(DyffSchemaBaseModel):
     )
 
 
-class ContainerImage(DyffSchemaBaseModel):
-    pass
-
-
 class AcceleratorGPU(DyffSchemaBaseModel):
     hardwareTypes: list[str] = pydantic.Field(
         min_length=1,
@@ -1160,14 +1186,23 @@ class Accelerator(DyffSchemaBaseModel):
     )
 
 
+# FIXME: Remove .storage because it's replaced by ScratchVolume, and rename to
+# ResourceRequirements for consistency with k8s.
 class ModelResources(DyffSchemaBaseModel):
-    storage: Quantity = pydantic.Field(
-        description="Amount of storage required for packaged model, in k8s Quantity notation",
+    storage: Optional[Quantity] = pydantic.Field(
+        default=None,
+        deprecated=True,
+        description="Storage required for packaged model, in k8s Quantity notation",
     )
 
     memory: Optional[Quantity] = pydantic.Field(
         default=None,
-        description="Amount of memory required to run the model on CPU, in k8s Quantity notation",
+        description="Memory, in k8s Quantity notation",
+    )
+
+    cpu: Optional[Quantity] = pydantic.Field(
+        default=None,
+        description="Number of CPUs, in k8s Quantity notation",
     )
 
 
@@ -1181,6 +1216,7 @@ class ModelStorageMedium(str, enum.Enum):
 class ModelArtifactKind(str, enum.Enum):
     HuggingFaceCache = "HuggingFaceCache"
     Mock = "Mock"
+    Volume = "Volume"
 
 
 class ModelArtifactHuggingFaceCache(DyffSchemaBaseModel):
@@ -1200,6 +1236,9 @@ class ModelArtifact(DyffSchemaBaseModel):
     huggingFaceCache: Optional[ModelArtifactHuggingFaceCache] = pydantic.Field(
         default=None, description="Model stored in a HuggingFace cache"
     )
+    volume: Optional[Volume] = pydantic.Field(
+        default=None, description="Model stored as a generic volume"
+    )
 
 
 class ModelStorage(DyffSchemaBaseModel):
@@ -1251,6 +1290,7 @@ class InferenceServiceBuilder(DyffSchemaBaseModel):
 
 class InferenceServiceRunnerKind(str, Enum):
     BENTOML_SERVICE_OPENLLM = "bentoml_service_openllm"
+    CONTAINER = "container"
     HUGGINGFACE = "huggingface"
     MOCK = "mock"
     STANDALONE = "standalone"
@@ -1312,29 +1352,108 @@ class ContainerImageSource(DyffSchemaBaseModel):
         return v
 
 
-class InferenceServiceRunner(DyffSchemaBaseModel):
-    kind: InferenceServiceRunnerKind
+class EnvVar(DyffSchemaBaseModel):
+    name: str
+    value: str
+
+
+# TODO: ModelResources is deprecated
+ResourceRequirements = ModelResources
+
+
+class VolumeMountKind(str, enum.Enum):
+    data = "Data"
+    scratch = "Scratch"
+
+
+class VolumeMountData(DyffSchemaBaseModel):
+    source: EntityIdentifier = pydantic.Field(
+        description="The Dyff platform resource to mount."
+        " Must be a volume-like entity such as a Model or Dataset."
+    )
+
 
+class VolumeMountScratch(DyffSchemaBaseModel):
+    capacity: Quantity = pydantic.Field(
+        description="Minimum storage capacity of the Scratch volume."
+    )
+
+
+class VolumeMount(DyffSchemaBaseModel):
+    kind: VolumeMountKind = pydantic.Field(description="The kind of volume mount.")
+    name: str = pydantic.Field(description="A descriptive name for the mount.")
+    mountPath: Path = pydantic.Field(
+        description="Where to mount the volume in the running container."
+        " Must be an absolute path."
+    )
+    data: Optional[VolumeMountData] = pydantic.Field(
+        default=None, description="Configuration for Data volume mounts."
+    )
+    scratch: Optional[VolumeMountScratch] = pydantic.Field(
+        default=None, description="Configuration for Scratch volume mounts."
+    )
+
+
+class Container(DyffSchemaBaseModel):
+    """Configuration of a runnable container backed by either an image hosted in an
+    external registyr, or an image artifact hosted in the Dyff system.
+
+    This is mostly a subset of the Kubernetes Container schema.
+    """
+
+    args: Optional[list[str]] = pydantic.Field(
+        default=None,
+        description="Arguments to the entrypoint."
+        " The container image's CMD is used if this is not provided.",
+    )
+    command: Optional[list[str]] = pydantic.Field(
+        default=None,
+        description="Entrypoint array. Not executed within a shell."
+        " The container image's ENTRYPOINT is used if this is not provided.",
+    )
+    env: Optional[list[EnvVar]] = pydantic.Field(
+        default=None,
+        description="List of environment variables to set in the container.",
+    )
     # TODO: (DYFF-421) Make .image required
     image: Optional[ContainerImageSource] = pydantic.Field(
         default=None,
-        description="The container image that implements the runner. This field is"
-        " optional for schema backwards-compatibility, but creating new"
-        " services with image=None will result in an error.",
+        description="The container image that implements the runner."
+        " Exactly one of .image and .imageRef must be set.",
     )
-
-    args: Optional[list[str]] = pydantic.Field(
-        default=None, description="Command line arguments to forward to the runner"
+    imageRef: Optional[EntityIdentifier] = pydantic.Field(
+        default=None,
+        description="Container image reference. Must be an image artifact"
+        " that has been uploaded to this Dyff instance and is in Ready status."
+        " Exactly one of .image and .imageRef must be set.",
+    )
+    resources: ResourceRequirements = pydantic.Field(
+        description="Compute Resources required by this container."
+    )
+    volumeMounts: Optional[list[VolumeMount]] = pydantic.Field(
+        default=None, description="Volumes to mount into the container's filesystem."
     )
+    workingDir: Optional[Path] = pydantic.Field(
+        default=None,
+        description="Container's working directory. If not specified,"
+        " the container runtime's default will be used,"
+        " which might be configured in the container image.",
+    )
+
+
+class InferenceServiceRunner(Container):
+    """Configuration of a managed runner to use to run an inference service.
+
+    Using a managed runner simplifies the configuration of inference services backed by
+    models in common formats, such as HuggingFace models.
+    """
+
+    kind: InferenceServiceRunnerKind
 
     accelerator: Optional[Accelerator] = pydantic.Field(
         default=None, description="Optional accelerator hardware to use, per node."
     )
 
-    resources: ModelResources = pydantic.Field(
-        description="Resource requirements to run the service, per node."
-    )
-
     nodes: int = pydantic.Field(
         default=1,
         ge=1,
@@ -1372,7 +1491,9 @@ class InferenceServiceBase(DyffSchemaBaseModel):
 
     # FIXME: (DYFF-261) .runner should be required
     runner: Optional[InferenceServiceRunner] = pydantic.Field(
-        default=None, description="Configuration of the Runner used to run the service."
+        default=None,
+        description="Configuration of the managed runner used to run the service."
+        " Only one of .container or .runner may be specified.",
     )
 
     interface: InferenceInterface = pydantic.Field(
@@ -2525,6 +2646,7 @@ __all__ = [
     "AuditRequirement",
     "Concern",
     "ConcernBase",
+    "Container",
     "ContainerImageSource",
     "DataSchema",
     "Dataset",
@@ -2558,6 +2680,8 @@ __all__ = [
     "FamilyMemberBase",
     "FamilyMemberKind",
     "FamilyMembers",
+    "File",
+    "FileStorageURL",
     "ForeignInferenceService",
     "ForeignMethod",
     "ForeignModel",
@@ -2622,6 +2746,7 @@ __all__ = [
     "Report",
     "ReportBase",
     "Resources",
+    "ResourceRequirements",
     "Revision",
     "RevisionData",
     "RevisionMetadata",
@@ -2640,6 +2765,11 @@ __all__ = [
     "TagNameType",
     "TaskSchema",
     "UseCase",
+    "Volume",
+    "VolumeMount",
+    "VolumeMountData",
+    "VolumeMountKind",
+    "VolumeMountScratch",
     "entity_class",
     "JobStatus",
     "EntityStatus",

{dyff_schema-0.33.1 → dyff_schema-0.34.1}/dyff/schema/v0/r1/requests.py

@@ -170,15 +170,13 @@ class InferenceServiceCreateRequest(DyffEntityCreateRequest, InferenceServiceBas
         default=None, description="ID of Model backing the service, if applicable"
     )
 
-    # TODO: (DYFF-421) Make .image required and remove this validator
-    @pydantic.field_validator("image", check_fields=False)
-    def validate_image_not_none(cls, v):
-        if v is None:
-            raise ValueError(
-                ".image is required for new services; it is defined as Optional"
-                " for schema backwards-compatibility only"
-            )
-        return v
+    @pydantic.model_validator(mode="after")
+    def check_image_exactly_one(cls, values):
+        image = values.image is not None
+        imageRef = values.imageRef is not None
+        if sum([image, imageRef]) != 1:
+            raise ValueError("must specify exactly one of {image, imageRef}")
+        return values
 
 
 class InferenceSessionCreateRequest(DyffEntityCreateRequest, InferenceSessionBase):

{dyff_schema-0.33.1 → dyff_schema-0.34.1/dyff_schema.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dyff-schema
-Version: 0.33.1
+Version: 0.34.1
 Summary: Data models for the Dyff AI auditing platform.
 Author-email: Digital Safety Research Institute <contact@dsri.org>
 License: Apache-2.0

dyff_schema-0.33.1/dyff/schema/_version.py

@@ -1,2 +0,0 @@
-__version__ = version = "0.33.1"
-__version_tuple__ = version_tuple = (0, 33, 1)