dyff-schema 0.38.6__tar.gz → 0.38.9__tar.gz

{dyff_schema-0.38.6/dyff_schema.egg-info → dyff_schema-0.38.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dyff-schema
-Version: 0.38.6
+Version: 0.38.9
 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.9/dyff/schema/_version.py

@@ -0,0 +1,2 @@
+__version__ = version = "0.38.9"
+__version_tuple__ = version_tuple = (0, 38, 9)

{dyff_schema-0.38.6 → dyff_schema-0.38.9}/dyff/schema/v0/r1/platform.py

@@ -2656,6 +2656,18 @@ class ChallengeTaskContent(DyffSchemaBaseModel):
     )
 
 
+class ChallengeSubmissionStructure(DyffSchemaBaseModel):
+    submissionKind: EntityKindLiteral = pydantic.Field(
+        default=Entities.InferenceService.value,
+        description="The kind of entity that you can submit to this task.",
+    )
+    pipelineKeyword: str = pydantic.Field(
+        default="submission",
+        description="The keyword parameter where the submitted entity ID"
+        " should be passed to the assessment Pipeline.",
+    )
+
+
 class ChallengeTaskBase(DyffSchemaBaseModel):
     """The part of the ChallengeTask spec that is not system-populated."""
 
@@ -2669,7 +2681,11 @@ class ChallengeTaskBase(DyffSchemaBaseModel):
         pattern=r"[a-z0-9-]*",
     )
     assessment: str = pydantic.Field(
-        description="ID of the Assessment that the task runs."
+        description="ID of the Pipeline used to assess the submission."
+    )
+    submissionStructure: ChallengeSubmissionStructure = pydantic.Field(
+        default_factory=ChallengeSubmissionStructure,
+        description="How to run the assessment pipeline on a new submission.",
     )
     rules: ChallengeTaskRules = pydantic.Field(description="The rules for submissions.")
     content: ChallengeTaskContent = pydantic.Field(
@@ -2729,7 +2745,14 @@ class Challenge(DyffEntity):
         return None
 
 
-class ChallengeSubmission(DyffEntity):
+class ChallengeSubmissionBase(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):
     """A submission of an inference system to a challenge by a team.
 
     All of the constituent resources must already exist. Creating a Submission simply
@@ -2746,9 +2769,8 @@ class ChallengeSubmission(DyffEntity):
     task: str = pydantic.Field(
         description="The key of the task within the challenge being submitted to."
     )
-    team: str = pydantic.Field(description="The ID of the team making the submission.")
-    inferenceService: str = pydantic.Field(
-        description="The ID of the inference service being submitted."
+    pipelineRun: str = pydantic.Field(
+        description="The ID of the PipelineRun for this submission."
     )
 
     def dependencies(self) -> list[str]:
@@ -2765,14 +2787,29 @@ class ChallengeSubmission(DyffEntity):
 class PipelineEvaluationRequest(EvaluationRequestBase):
     kind: Literal["PipelineEvaluationRequest"] = "PipelineEvaluationRequest"
 
+    def dependencies(self) -> list[str]:
+        # This is a dirty hack that works because the types are structurally
+        # equivalent as far as .dependencies() cares
+        return Evaluation.dependencies(self)  # type: ignore[arg-type]
+
 
 class PipelineMeasurementRequest(AnalysisRequestBase):
     kind: Literal["PipelineMeasurementRequest"] = "PipelineMeasurementRequest"
 
+    def dependencies(self) -> list[str]:
+        # This is a dirty hack that works because the types are structurally
+        # equivalent as far as .dependencies() cares
+        return Measurement.dependencies(self)  # type: ignore[arg-type]
+
 
 class PipelineSafetyCaseRequest(AnalysisRequestBase):
     kind: Literal["PipelineSafetyCaseRequest"] = "PipelineSafetyCaseRequest"
 
+    def dependencies(self) -> list[str]:
+        # This is a dirty hack that works because the types are structurally
+        # equivalent as far as .dependencies() cares
+        return SafetyCase.dependencies(self)  # type: ignore[arg-type]
+
 
 PipelineNodeRequest = Union[
     PipelineEvaluationRequest,
@@ -2814,16 +2851,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(),
     )
 
@@ -2834,6 +2880,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]):
@@ -2842,6 +2892,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.
@@ -3144,6 +3203,7 @@ _DyffEntityTypeRevisable = Union[
     Audit,
     AuditProcedure,
     Challenge,
+    ChallengeSubmission,
     DataSource,
     Dataset,
     Evaluation,
@@ -3239,6 +3299,7 @@ _ENTITY_CLASS: dict[Entities, type[DyffEntityType]] = {
     Entities.Report: Report,
     Entities.Revision: Revision,
     Entities.SafetyCase: SafetyCase,
+    Entities.Submission: ChallengeSubmission,
     Entities.Team: Team,
     Entities.UseCase: UseCase,
 }
@@ -3254,6 +3315,7 @@ DyffEntityT = TypeVar(
     Audit,
     AuditProcedure,
     Challenge,
+    ChallengeSubmission,
     DataSource,
     Dataset,
     Evaluation,
@@ -3304,6 +3366,7 @@ __all__ = [
     "ChallengeContent",
     "ChallengeContentPage",
     "ChallengeSubmission",
+    "ChallengeSubmissionBase",
     "ChallengeTask",
     "ChallengeTaskBase",
     "ChallengeTaskContent",

{dyff_schema-0.38.6 → dyff_schema-0.38.9}/dyff/schema/v0/r1/requests.py

@@ -27,6 +27,7 @@ from .platform import (
     AnalysisRequestBase,
     AnalysisScope,
     ChallengeContent,
+    ChallengeSubmissionBase,
     ChallengeTaskBase,
     ConcernBase,
     DatasetBase,
@@ -148,6 +149,12 @@ class ChallengeCreateRequest(DyffEntityCreateRequest):
     )
 
 
+class ChallengeSubmissionCreateRequest(
+    DyffEntityCreateRequest, ChallengeSubmissionBase
+):
+    pass
+
+
 class ChallengeTaskCreateRequest(DyffEntityCreateRequest, ChallengeTaskBase):
     pass
 
@@ -497,6 +504,7 @@ __all__ = [
     "ChallengeContentEditRequest",
     "ChallengeCreateRequest",
     "ChallengeQueryRequest",
+    "ChallengeSubmissionCreateRequest",
     "ChallengeTaskCreateRequest",
     "ChallengeTaskRulesEditRequest",
     "ChallengeTeamCreateRequest",

{dyff_schema-0.38.6 → dyff_schema-0.38.9/dyff_schema.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dyff-schema
-Version: 0.38.6
+Version: 0.38.9
 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.6/dyff/schema/_version.py

@@ -1,2 +0,0 @@
-__version__ = version = "0.38.6"
-__version_tuple__ = version_tuple = (0, 38, 6)