dyff-schema 0.38.7__py3-none-any.whl → 0.39.0__py3-none-any.whl

dyff/schema/_version.py

@@ -1,2 +1,2 @@
-__version__ = version = "0.38.7"
-__version_tuple__ = version_tuple = (0, 38, 7)
+__version__ = version = "0.39.0"
+__version_tuple__ = version_tuple = (0, 39, 0)

dyff/schema/v0/r1/platform.py

@@ -216,6 +216,7 @@ class Entities(str, enum.Enum):
     AuditProcedure = "AuditProcedure"
     Challenge = "Challenge"
     Concern = "Concern"
+    Curve = "Curve"
     DataSource = "DataSource"
     Dataset = "Dataset"
     Documentation = "Documentation"
@@ -256,6 +257,7 @@ class Resources(str, enum.Enum):
     AuditProcedure = "auditprocedures"
     Challenge = "challenges"
     Concern = "concerns"
+    Curve = "curves"
     Dataset = "datasets"
     DataSource = "datasources"
     Descriptor = "descriptors"
@@ -309,6 +311,7 @@ EntityKindLiteral = Literal[
     "Audit",
     "AuditProcedure",
     "Challenge",
+    "Curve",
     "DataSource",
     "Dataset",
     "Evaluation",
@@ -435,7 +438,7 @@ class Labeled(DyffSchemaBaseModel):
 class Annotation(DyffSchemaBaseModel):
     key: str = pydantic.Field(
         pattern=_k8s_label_key_regex(),
-        max_length=_k8s_domain_maxlen(),
+        max_length=_k8s_label_key_maxlen(),
         description="The annotation key. A DNS label with an optional DNS domain prefix."
         " For example: 'my-key', 'your.com/key_0'. Names prefixed with"
         " 'dyff.io/', 'subdomain.dyff.io/', etc. are reserved.\n\n"
@@ -541,6 +544,7 @@ class DyffEntity(Status, Labeled, SchemaVersion, DyffModelWithID):
         "Audit",
         "AuditProcedure",
         "Challenge",
+        "Curve",
         "DataSource",
         "Dataset",
         "Evaluation",
@@ -1442,6 +1446,21 @@ class VolumeMount(DyffSchemaBaseModel):
         default=None, description="Configuration for Scratch volume mounts."
     )
 
+    @pydantic.model_validator(mode="after")
+    def _validate_kind_matches_payload(self):
+        """Ensure payload fields match declared kind."""
+        if self.kind == VolumeMountKind.data:
+            if self.data is None or self.scratch is not None:
+                raise ValueError(
+                    "VolumeMount(kind='Data') requires .data and forbids .scratch"
+                )
+        elif self.kind == VolumeMountKind.scratch:
+            if self.scratch is None or self.data is not None:
+                raise ValueError(
+                    "VolumeMount(kind='Scratch') requires .scratch and forbids .data"
+                )
+        return self
+
 
 class Container(DyffSchemaBaseModel):
     """Configuration of a runnable container backed by either an image hosted in an
@@ -1489,6 +1508,15 @@ class Container(DyffSchemaBaseModel):
         " which might be configured in the container image.",
     )
 
+    @pydantic.model_validator(mode="after")
+    def _validate_image_or_ref(self):
+        """Exactly one of image or imageRef must be set."""
+        has_image = self.image is not None
+        has_ref = self.imageRef is not None
+        if has_image == has_ref:
+            raise ValueError("Exactly one of 'image' or 'imageRef' must be set.")
+        return self
+
 
 class InferenceServiceRunner(Container):
     """Configuration of the runtime environment to use to run an inference service.
@@ -2101,6 +2129,34 @@ class ScoreSpec(DyffSchemaBaseModel):
         return format.format(quantity=quantity, unit=unit)
 
 
+class CurveSpec(DyffSchemaBaseModel):
+    """Metadata describing the curve dimensions and how to read them.
+
+    - `dimensions` supplies per-dimension metadata (name -> ScoreSpec).
+    - Use these keys as columns in `CurveData.points`.
+    """
+
+    name: str = pydantic.Field(
+        description="Unique key for this curve within the Method context.",
+        pattern=identifier_regex(),
+        max_length=identifier_maxlen(),
+    )
+    title: str = pydantic.Field(
+        description="Human-friendly title for the curve.",
+        max_length=title_maxlen(),
+    )
+    summary: str = pydantic.Field(
+        description="Short description of what the curve shows.",
+        max_length=summary_maxlen(),
+    )
+    dimensions: dict[str, ScoreSpec] = pydantic.Field(
+        description=(
+            "Per-dimension metadata. Keys must match the columns stored in CurveData.points. "
+            "Typical keys might include 'x', 'y', 'threshold', 'tp', 'fp', etc."
+        )
+    )
+
+
 class MethodBase(DyffSchemaBaseModel):
     name: str = pydantic.Field(description="Descriptive name of the Method.")
 
@@ -2131,7 +2187,7 @@ class MethodBase(DyffSchemaBaseModel):
         description="Specification of the Method output."
     )
 
-    scores: list[ScoreSpec] = pydantic.Field(
+    scores: list[Union[ScoreSpec, CurveSpec]] = pydantic.Field(
         default_factory=list,
         description="Specifications of the Scores that this Method produces.",
     )
@@ -2149,12 +2205,13 @@ class MethodBase(DyffSchemaBaseModel):
     )
 
     @pydantic.field_validator("scores")
-    def _scores_validator(cls, scores: list[ScoreSpec]):
-        if len(scores) > 0:
-            primary_count = sum(score.priority == "primary" for score in scores)
+    def _scores_validator(cls, scores):
+        score_specs = [s for s in scores if isinstance(s, ScoreSpec)]
+        if score_specs:
+            primary_count = sum(s.priority == "primary" for s in score_specs)
             if primary_count != 1:
                 raise ValueError(
-                    "scores: Must have exactly one score with .priority == 'primary'"
+                    "scores: Must have exactly one primary ScoreSpec (curves excluded)"
                 )
         return scores
 
@@ -2329,17 +2386,19 @@ class ScoreData(ScoreSpec):
         description="The Analysis that generated the current score instance."
     )
 
-    quantity: float = pydantic.Field(
-        description="The numeric quantity associated with the score."
+    quantity: float | None = pydantic.Field(
+        default=None, description="Numeric quantity for scalar scores."
+    )
+    points: dict[str, list[float]] | None = pydantic.Field(
+        default=None,
+        description="Aligned vectors for curve scores. Keys should match curve.dimensions.",
     )
 
     quantityString: str = pydantic.Field(
-        description="The formatted string representation of .quantity,"
-        " after processing with the .format specification."
+        description="Formatted string representation of .quantity (scalar) or a summary string (curve)."
     )
-
     text: str = pydantic.Field(
-        description="A short text description of what the quantity means.",
+        description="Short text description of what the value/curve means.",
         max_length=summary_maxlen(),
     )
 
@@ -2355,6 +2414,53 @@ class Score(ScoreData):
     id: str = pydantic.Field(description="Unique identifier of the entity")
 
 
+class CurveData(CurveSpec):
+    """An instance of a curve produced by an analysis.
+
+    - Inherits the curve spec (name/title/summary/dimensions) directly.
+    - `points` is a dict-of-lists: each key is a dimension name defined in `dimensions`.
+    - All lists must be the same (non-zero) length.
+
+    spec: CurveSpec = pydantic.Field(description="The CurveSpec this data conforms to.")
+    """
+
+    metadata: ScoreMetadata = pydantic.Field(
+        description="Indexing metadata (method required).",
+    )
+    analysis: str = pydantic.Field(
+        description="ID of the Analysis that produced this curve."
+    )
+    points: dict[str, list[float]] = pydantic.Field(
+        description="Aligned vectors for each dimension; all lists must have equal length >= 1."
+    )
+
+    @pydantic.model_validator(mode="after")
+    def _validate_points(self):
+        if not self.points:
+            raise ValueError("CurveData.points must not be empty")
+
+        lengths = {k: len(v) for k, v in self.points.items()}
+        uniq = set(lengths.values())
+        if len(uniq) != 1:
+            raise ValueError(
+                f"All vectors must have equal length; got lengths {lengths}"
+            )
+        n = next(iter(uniq))
+        if n < 1:
+            raise ValueError("Vectors must contain at least 1 point")
+
+        missing = [k for k in self.dimensions.keys() if k not in self.points]
+        if missing:
+            raise ValueError(f"points is missing required dimensions: {missing}")
+        return self
+
+
+class Curve(CurveData):
+    kind: Literal["Curve"] = Entities.Curve.value
+
+    id: str = pydantic.Field(description="Unique identifier of the entity")
+
+
 # ---------------------------------------------------------------------------
 # OCI artifacts
 
@@ -2635,6 +2741,19 @@ class ChallengeTaskSchedule(DyffSchemaBaseModel):
         description="Teams are limited to this many submissions per cycle.",
     )
 
+    @pydantic.model_validator(mode="after")
+    def _validate_times(self):
+        """Basic temporal sanity checks."""
+        if (
+            self.openingTime
+            and self.closingTime
+            and self.closingTime <= self.openingTime
+        ):
+            raise ValueError("closingTime must be after openingTime")
+        if self.submissionCycleDuration <= timedelta(0):
+            raise ValueError("submissionCycleDuration must be positive")
+        return self
+
 
 class ChallengeTaskRules(DyffSchemaBaseModel):
     """The rules of the challenge."""
@@ -2656,7 +2775,7 @@ class ChallengeTaskContent(DyffSchemaBaseModel):
     )
 
 
-class ChallengeSubmissionStructure(DyffSchemaBaseModel):
+class SubmissionStructure(DyffSchemaBaseModel):
     submissionKind: EntityKindLiteral = pydantic.Field(
         default=Entities.InferenceService.value,
         description="The kind of entity that you can submit to this task.",
@@ -2679,12 +2798,13 @@ class ChallengeTaskBase(DyffSchemaBaseModel):
         " This may appear in URLs and must follow naming restrictions.",
         max_length=title_maxlen(),
         pattern=r"[a-z0-9-]*",
+        min_length=1,
     )
     assessment: str = pydantic.Field(
         description="ID of the Pipeline used to assess the submission."
     )
-    submissionStructure: ChallengeSubmissionStructure = pydantic.Field(
-        default_factory=ChallengeSubmissionStructure,
+    submissionStructure: SubmissionStructure = pydantic.Field(
+        default_factory=SubmissionStructure,
         description="How to run the assessment pipeline on a new submission.",
     )
     rules: ChallengeTaskRules = pydantic.Field(description="The rules for submissions.")
@@ -2745,14 +2865,14 @@ class Challenge(DyffEntity):
         return None
 
 
-class ChallengeSubmissionBase(DyffSchemaBaseModel):
+class SubmissionBase(DyffSchemaBaseModel):
     team: str = pydantic.Field(description="The ID of the team making the submission.")
     submission: EntityIdentifier = pydantic.Field(
         description="The resource being submitted for assessment."
     )
 
 
-class ChallengeSubmission(DyffEntity, ChallengeSubmissionBase):
+class Submission(DyffEntity, SubmissionBase):
     """A submission of an inference system to a challenge by a team.
 
     All of the constituent resources must already exist. Creating a Submission simply
@@ -2787,14 +2907,33 @@ class ChallengeSubmission(DyffEntity, ChallengeSubmissionBase):
 class PipelineEvaluationRequest(EvaluationRequestBase):
     kind: Literal["PipelineEvaluationRequest"] = "PipelineEvaluationRequest"
 
+    def dependencies(self) -> list[str]:
+        if self.inferenceSession is None:
+            raise AssertionError()
+        return [self.dataset, self.inferenceSession.inferenceService]
+
+    @pydantic.model_validator(mode="after")
+    def check_session_not_reference(self):
+        if self.inferenceSession is None or self.inferenceSessionReference is not None:
+            raise ValueError(
+                "evaluations in pipelines must set inferenceSession, not inferenceSessionReference"
+            )
+        return self
+
 
 class PipelineMeasurementRequest(AnalysisRequestBase):
     kind: Literal["PipelineMeasurementRequest"] = "PipelineMeasurementRequest"
 
+    def dependencies(self) -> list[str]:
+        return [self.method] + [x.entity for x in self.inputs]
+
 
 class PipelineSafetyCaseRequest(AnalysisRequestBase):
     kind: Literal["PipelineSafetyCaseRequest"] = "PipelineSafetyCaseRequest"
 
+    def dependencies(self) -> list[str]:
+        return [self.method] + [x.entity for x in self.inputs]
+
 
 PipelineNodeRequest = Union[
     PipelineEvaluationRequest,
@@ -2836,16 +2975,25 @@ class PipelineNode(DyffSchemaBaseModel):
 
 class PipelineParameter(DyffSchemaBaseModel):
     """Declares a parameter that can be passed to the pipeline to customize its
-    behavior."""
+    behavior.
+
+    By default, the argument will be substituted for the placeholder value
+    ``$(keyword)``, where ``keyword`` is the ``.keyword`` property of the
+    parameter. In this case, the value of the argument must be a string.
 
-    keyword: str = pydantic.Field(description="The keyword of the argument.")
-    destination: str = pydantic.Field(
+    If ``.destination`` is specified, the argument will instead overwrite
+    the value at the specified JSON path.
+    """
+
+    keyword: str = pydantic.Field(description="The keyword of the parameter.")
+    destination: Optional[str] = pydantic.Field(
+        default=None,
         description="The field in a pipeline node to substitute with the"
-        " parameter value. Should be a string like 'node_name.field1.field2'."
+        " parameter value. Should be a string like 'node_name.field1.field2'.",
     )
     description: Optional[str] = pydantic.Field(
         default=None,
-        description="A description of the argument.",
+        description="A description of the parameter.",
         max_length=summary_maxlen(),
     )
 
@@ -2856,6 +3004,10 @@ class PipelineBase(DyffSchemaBaseModel):
         description="The nodes in the pipeline graph.",
         min_length=1,
     )
+    parameters: dict[str, PipelineParameter] = pydantic.Field(
+        default_factory=dict,
+        description="Input parameters used to customize the pipeline.",
+    )
 
     @pydantic.field_validator("nodes", mode="after")
     def validate_node_names_match(cls, nodes: dict[str, PipelineNode]):
@@ -2864,6 +3016,15 @@ class PipelineBase(DyffSchemaBaseModel):
                 raise ValueError(f"nodes[{k}]: dict key must match value.name")
         return nodes
 
+    @pydantic.field_validator("parameters", mode="after")
+    def validate_parameter_keywords_match(
+        cls, parameters: dict[str, PipelineParameter]
+    ):
+        for k, v in parameters.items():
+            if k != v.keyword:
+                raise ValueError(f"parameters[{k}]: dict key must match value.keyword")
+        return parameters
+
 
 class Pipeline(DyffEntity, PipelineBase):
     """A set of Dyff workflows that can be executed as a group.
@@ -3182,6 +3343,7 @@ _DyffEntityTypeRevisable = Union[
     PipelineRun,
     Report,
     SafetyCase,
+    Submission,
     Team,
     UseCase,
 ]
@@ -3261,6 +3423,7 @@ _ENTITY_CLASS: dict[Entities, type[DyffEntityType]] = {
     Entities.Report: Report,
     Entities.Revision: Revision,
     Entities.SafetyCase: SafetyCase,
+    Entities.Submission: Submission,
     Entities.Team: Team,
     Entities.UseCase: UseCase,
 }
@@ -3294,6 +3457,7 @@ DyffEntityT = TypeVar(
     Report,
     Revision,
     SafetyCase,
+    Submission,
     Team,
     UseCase,
 )
@@ -3325,8 +3489,6 @@ __all__ = [
     "Challenge",
     "ChallengeContent",
     "ChallengeContentPage",
-    "ChallengeSubmission",
-    "ChallengeSubmissionBase",
     "ChallengeTask",
     "ChallengeTaskBase",
     "ChallengeTaskContent",
@@ -3338,6 +3500,9 @@ __all__ = [
     "ConcernBase",
     "Container",
     "ContainerImageSource",
+    "Curve",
+    "CurveData",
+    "CurveSpec",
     "DataSchema",
     "Dataset",
     "DatasetBase",
@@ -3463,6 +3628,9 @@ __all__ = [
     "ScoreMetadataRefs",
     "Status",
     "StorageSignedURL",
+    "Submission",
+    "SubmissionBase",
+    "SubmissionStructure",
     "TagName",
     "TagNameType",
     "TaskSchema",

dyff/schema/v0/r1/requests.py

@@ -27,7 +27,6 @@ from .platform import (
     AnalysisRequestBase,
     AnalysisScope,
     ChallengeContent,
-    ChallengeSubmissionBase,
     ChallengeTaskBase,
     ConcernBase,
     DatasetBase,
@@ -46,6 +45,7 @@ from .platform import (
     PipelineBase,
     PipelineRunBase,
     ReportBase,
+    SubmissionBase,
     TagNameType,
     TeamBase,
     summary_maxlen,
@@ -149,9 +149,7 @@ class ChallengeCreateRequest(DyffEntityCreateRequest):
     )
 
 
-class ChallengeSubmissionCreateRequest(
-    DyffEntityCreateRequest, ChallengeSubmissionBase
-):
+class SubmissionCreateRequest(DyffEntityCreateRequest, SubmissionBase):
     pass
 
 
@@ -504,7 +502,6 @@ __all__ = [
     "ChallengeContentEditRequest",
     "ChallengeCreateRequest",
     "ChallengeQueryRequest",
-    "ChallengeSubmissionCreateRequest",
     "ChallengeTaskCreateRequest",
     "ChallengeTaskRulesEditRequest",
     "ChallengeTeamCreateRequest",
@@ -544,6 +541,7 @@ __all__ = [
     "ReportQueryRequest",
     "SafetyCaseQueryRequest",
     "ScoreQueryRequest",
+    "SubmissionCreateRequest",
     "TeamEditRequest",
     "TeamQueryRequest",
     "UseCaseQueryRequest",

{dyff_schema-0.38.7.dist-info → dyff_schema-0.39.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dyff-schema
-Version: 0.38.7
+Version: 0.39.0
 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.38.7.dist-info → dyff_schema-0.39.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
 dyff/schema/__init__.py,sha256=w7OWDFuyGKd6xt_yllNtKzHahPgywrfU4Ue02psYaMA,2244
-dyff/schema/_version.py,sha256=Lvo9jhPTm1HAF61xPJreSv-zBjPuoiu7427jQ9wl-7I,80
+dyff/schema/_version.py,sha256=I6LzRmj6u3696UihPDbtQ6SvcXb8zA4Bc4JYoFGddx0,80
 dyff/schema/adapters.py,sha256=YMTHv_2VlLGFp-Kqwa6H51hjffHmk8gXjZilHysIF5Q,123
 dyff/schema/annotations.py,sha256=nE6Jk1PLqlShj8uqjE_EzZC9zYnTDW5AVtQcjysiK8M,10018
 dyff/schema/base.py,sha256=jvaNtsSZyFfsdUZTcY_U-yfLY5_GyrMxSXhON2R9XR0,119
@@ -29,8 +29,8 @@ dyff/schema/v0/r1/adapters.py,sha256=hpwCSW8lkMkUKCLe0zaMUDu-VS_caSxJvPsECEi_XRA
 dyff/schema/v0/r1/base.py,sha256=1VJXVLKldOq3aH2HdVgxXXk4DJTZEIiaTa4GzMKzziU,20228
 dyff/schema/v0/r1/commands.py,sha256=jqbEvDRLpcVGWXqlbniuSKg3UIjlrpKt6_0hiwUpPfQ,20153
 dyff/schema/v0/r1/oci.py,sha256=YjHDVBJ2IIxqijll70OK6pM-qT6pq8tvU7D3YB9vGM0,6700
-dyff/schema/v0/r1/platform.py,sha256=oN2KgTYRvaAgUUiYi9JoY4n2OdrCq53Yx1SFTxLesvk,112123
-dyff/schema/v0/r1/requests.py,sha256=k9T-xI2DDCjvCCmEg_kZ0M6yl_ZG6uh8rocWCLZLKFA,18590
+dyff/schema/v0/r1/platform.py,sha256=qAy2yBRtaRLrWbONDxOa2Z89lFstOBq8V0SsOg7cpIE,118312
+dyff/schema/v0/r1/requests.py,sha256=OhkM9QpSimsGaX8TtjSHcWlHg1UYyPCiq-WW9DJ7FdQ,18548
 dyff/schema/v0/r1/responses.py,sha256=nxy7FPtfw2B_bljz5UGGuSE79HTkDQxKH56AJVmd4Qo,1287
 dyff/schema/v0/r1/test.py,sha256=X6dUyVd5svcPCI-PBMOAqEfK9jv3bRDvkQTJzwS96c0,10720
 dyff/schema/v0/r1/version.py,sha256=NONebgcv5Thsw_ymud6PacZdGjV6ndBrmLnap-obcpo,428
@@ -43,9 +43,9 @@ dyff/schema/v0/r1/dataset/text.py,sha256=MYG5seGODDryRSCy-g0Unh5dD0HCytmZ3FeElC-
 dyff/schema/v0/r1/dataset/vision.py,sha256=tJFF4dkhHX0UXTj1sPW-G22xTSI40gbYO465FuvmvAU,443
 dyff/schema/v0/r1/io/__init__.py,sha256=L5y8UhRnojerPYHumsxQJRcHCNz8Hj9NM8b47mewMNs,92
 dyff/schema/v0/r1/io/vllm.py,sha256=vWyLg-susbg0JDfv6VExBpgFdU2GHP2a14ChOdbckvs,5321
-dyff_schema-0.38.7.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-dyff_schema-0.38.7.dist-info/licenses/NOTICE,sha256=YONACu0s_Ui6jNi-wtEsVQbTU1JIkh8wvLH6d1-Ni_w,43
-dyff_schema-0.38.7.dist-info/METADATA,sha256=H9nvnBlCZ6iJC6lm_jsLV5Zs9B8s5Qbq7R1JOhcd9Js,3734
-dyff_schema-0.38.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-dyff_schema-0.38.7.dist-info/top_level.txt,sha256=9e3VVdeX73t_sUJOPQPCcGtYO1JhoErhHIi3WoWGcFI,5
-dyff_schema-0.38.7.dist-info/RECORD,,
+dyff_schema-0.39.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+dyff_schema-0.39.0.dist-info/licenses/NOTICE,sha256=YONACu0s_Ui6jNi-wtEsVQbTU1JIkh8wvLH6d1-Ni_w,43
+dyff_schema-0.39.0.dist-info/METADATA,sha256=ZGqsePJhzMjBYADI2vpkJL0aur7pZLhFSSZ1tOCmIZs,3734
+dyff_schema-0.39.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+dyff_schema-0.39.0.dist-info/top_level.txt,sha256=9e3VVdeX73t_sUJOPQPCcGtYO1JhoErhHIi3WoWGcFI,5
+dyff_schema-0.39.0.dist-info/RECORD,,