adcp 2.18.0__py3-none-any.whl → 3.0.0__py3-none-any.whl

adcp/types/generated_poc/content_standards/content_standards.py

@@ -0,0 +1,66 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/content_standards.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import Field
+
+from ..core import ext as ext_1
+from ..enums import channels
+from . import artifact
+
+
+class CalibrationExemplars(AdCPBaseModel):
+    fail: Annotated[
+        list[artifact.Artifact] | None,
+        Field(description='Artifacts that fail the content standards'),
+    ] = None
+    pass_: Annotated[
+        list[artifact.Artifact] | None,
+        Field(alias='pass', description='Artifacts that pass the content standards'),
+    ] = None
+
+
+class ContentStandards(AdCPBaseModel):
+    calibration_exemplars: Annotated[
+        CalibrationExemplars | None,
+        Field(
+            description='Training/test set to calibrate policy interpretation. Provides concrete examples of pass/fail decisions.'
+        ),
+    ] = None
+    channels_any: Annotated[
+        list[channels.MediaChannel] | None,
+        Field(
+            description='Advertising channels. Standards apply to ANY of the listed channels (OR logic).'
+        ),
+    ] = None
+    countries_all: Annotated[
+        list[str] | None,
+        Field(
+            description='ISO 3166-1 alpha-2 country codes. Standards apply in ALL listed countries (AND logic).'
+        ),
+    ] = None
+    ext: ext_1.ExtensionObject | None = None
+    languages_any: Annotated[
+        list[str] | None,
+        Field(
+            description="BCP 47 language tags (e.g., 'en', 'de', 'fr'). Standards apply to content in ANY of these languages (OR logic). Content in unlisted languages is not covered by these standards.",
+            min_length=1,
+        ),
+    ] = None
+    name: Annotated[
+        str | None, Field(description='Human-readable name for this standards configuration')
+    ] = None
+    policy: Annotated[
+        str | None,
+        Field(
+            description='Natural language policy describing acceptable and unacceptable content contexts. Used by LLMs and human reviewers to make judgments.'
+        ),
+    ] = None
+    standards_id: Annotated[
+        str, Field(description='Unique identifier for this standards configuration')
+    ]

adcp/types/generated_poc/content_standards/create_content_standards_request.py

@@ -0,0 +1,97 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/create_content_standards_request.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Literal
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, ConfigDict, Field
+
+from ..core import context as context_1
+from ..core import ext as ext_1
+from ..enums import channels
+from . import artifact
+
+
+class Fail(AdCPBaseModel):
+    language: Annotated[
+        str | None, Field(description='BCP 47 language tag for content at this URL')
+    ] = None
+    type: Annotated[Literal['url'], Field(description='Indicates this is a URL reference')]
+    value: Annotated[
+        AnyUrl,
+        Field(
+            description="Full URL to a specific page (e.g., 'https://news.example.com/controversial-article')"
+        ),
+    ]
+
+
+class Pass(AdCPBaseModel):
+    language: Annotated[
+        str | None, Field(description='BCP 47 language tag for content at this URL')
+    ] = None
+    type: Annotated[Literal['url'], Field(description='Indicates this is a URL reference')]
+    value: Annotated[
+        AnyUrl,
+        Field(
+            description="Full URL to a specific page (e.g., 'https://espn.com/nba/story/_/id/12345/lakers-win')"
+        ),
+    ]
+
+
+class Scope(AdCPBaseModel):
+    channels_any: Annotated[
+        list[channels.MediaChannel] | None,
+        Field(
+            description='Advertising channels. Standards apply to ANY of the listed channels (OR logic).'
+        ),
+    ] = None
+    countries_all: Annotated[
+        list[str] | None,
+        Field(
+            description='ISO 3166-1 alpha-2 country codes. Standards apply in ALL listed countries (AND logic).'
+        ),
+    ] = None
+    description: Annotated[
+        str | None, Field(description='Human-readable description of this scope')
+    ] = None
+    languages_any: Annotated[
+        list[str],
+        Field(
+            description="BCP 47 language tags (e.g., 'en', 'de', 'fr'). Standards apply to content in ANY of these languages (OR logic). Content in unlisted languages is not covered by these standards.",
+            min_length=1,
+        ),
+    ]
+
+
+class CalibrationExemplars(AdCPBaseModel):
+    fail: Annotated[
+        list[Fail | artifact.Artifact] | None, Field(description='Content that fails the standards')
+    ] = None
+    pass_: Annotated[
+        list[Pass | artifact.Artifact] | None,
+        Field(alias='pass', description='Content that passes the standards'),
+    ] = None
+
+
+class CreateContentStandardsRequest(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    calibration_exemplars: Annotated[
+        CalibrationExemplars | None,
+        Field(
+            description='Training/test set to calibrate policy interpretation. Use URL references for pages to be fetched and analyzed, or full artifacts for pre-extracted content.'
+        ),
+    ] = None
+    context: context_1.ContextObject | None = None
+    ext: ext_1.ExtensionObject | None = None
+    policy: Annotated[
+        str,
+        Field(
+            description='Natural language policy describing acceptable and unacceptable content contexts. Used by LLMs and human reviewers to make judgments.'
+        ),
+    ]
+    scope: Annotated[Scope, Field(description='Where this standards configuration applies')]

adcp/types/generated_poc/content_standards/create_content_standards_response.py

@@ -0,0 +1,52 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/create_content_standards_response.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Any
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import Field, RootModel
+
+from ..core import context as context_1
+from ..core import error
+from ..core import ext as ext_1
+
+
+class CreateContentStandardsResponse1(AdCPBaseModel):
+    context: context_1.ContextObject | None = None
+    errors: Annotated[
+        Any | None, Field(description='Field must not be present in success response')
+    ] = None
+    ext: ext_1.ExtensionObject | None = None
+    standards_id: Annotated[
+        str, Field(description='Unique identifier for the created standards configuration')
+    ]
+
+
+class CreateContentStandardsResponse2(AdCPBaseModel):
+    conflicting_standards_id: Annotated[
+        str | None,
+        Field(
+            description='If the error is a scope conflict, the ID of the existing standards that conflict'
+        ),
+    ] = None
+    context: context_1.ContextObject | None = None
+    errors: list[error.Error]
+    ext: ext_1.ExtensionObject | None = None
+    standards_id: Annotated[
+        Any | None, Field(description='Field must not be present in error response')
+    ] = None
+
+
+class CreateContentStandardsResponse(
+    RootModel[CreateContentStandardsResponse1 | CreateContentStandardsResponse2]
+):
+    root: Annotated[
+        CreateContentStandardsResponse1 | CreateContentStandardsResponse2,
+        Field(
+            description='Response payload for creating a content standards configuration',
+            title='Create Content Standards Response',
+        ),
+    ]

adcp/types/generated_poc/content_standards/get_content_standards_request.py

@@ -0,0 +1,21 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/get_content_standards_request.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import Field
+
+from ..core import context as context_1
+from ..core import ext as ext_1
+
+
+class GetContentStandardsRequest(AdCPBaseModel):
+    context: context_1.ContextObject | None = None
+    ext: ext_1.ExtensionObject | None = None
+    standards_id: Annotated[
+        str, Field(description='Identifier for the standards configuration to retrieve')
+    ]

adcp/types/generated_poc/content_standards/get_content_standards_response.py

@@ -0,0 +1,43 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/get_content_standards_response.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Any
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import Field, RootModel
+
+from ..core import context as context_1
+from ..core import error
+from ..core import ext as ext_1
+from .content_standards import ContentStandards
+
+
+class GetContentStandardsResponse2(AdCPBaseModel):
+    context: context_1.ContextObject | None = None
+    errors: list[error.Error]
+    ext: ext_1.ExtensionObject | None = None
+    standards_id: Annotated[
+        Any | None, Field(description='Field must not be present in error response')
+    ] = None
+
+
+class GetContentStandardsResponse1(ContentStandards):
+    context: context_1.ContextObject | None = None
+    errors: Annotated[
+        Any | None, Field(description='Field must not be present in success response')
+    ] = None
+
+
+class GetContentStandardsResponse(
+    RootModel[GetContentStandardsResponse1 | GetContentStandardsResponse2]
+):
+    root: Annotated[
+        GetContentStandardsResponse1 | GetContentStandardsResponse2,
+        Field(
+            description='Response payload with content safety policies',
+            title='Get Content Standards Response',
+        ),
+    ]

adcp/types/generated_poc/content_standards/get_media_buy_artifacts_request.py

@@ -0,0 +1,64 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/get_media_buy_artifacts_request.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AwareDatetime, Field
+
+from ..core import context as context_1
+from ..core import ext as ext_1
+
+
+class Method(Enum):
+    random = 'random'
+    stratified = 'stratified'
+    recent = 'recent'
+    failures_only = 'failures_only'
+
+
+class Sampling(AdCPBaseModel):
+    method: Annotated[Method | None, Field(description='How to select the sample')] = None
+    rate: Annotated[
+        float | None,
+        Field(
+            description='Sampling rate (0-1). 1.0 = all deliveries, 0.25 = 25% sample.',
+            ge=0.0,
+            le=1.0,
+        ),
+    ] = None
+
+
+class TimeRange(AdCPBaseModel):
+    end: Annotated[AwareDatetime | None, Field(description='End of time range (exclusive)')] = None
+    start: Annotated[AwareDatetime | None, Field(description='Start of time range (inclusive)')] = (
+        None
+    )
+
+
+class GetMediaBuyArtifactsRequest(AdCPBaseModel):
+    context: context_1.ContextObject | None = None
+    cursor: Annotated[
+        str | None, Field(description='Pagination cursor for fetching subsequent pages')
+    ] = None
+    ext: ext_1.ExtensionObject | None = None
+    limit: Annotated[
+        int | None, Field(description='Maximum artifacts to return per request', ge=1, le=10000)
+    ] = 1000
+    media_buy_id: Annotated[str, Field(description='Media buy to get artifacts from')]
+    package_ids: Annotated[
+        list[str] | None, Field(description='Filter to specific packages within the media buy')
+    ] = None
+    sampling: Annotated[
+        Sampling | None,
+        Field(
+            description='Sampling parameters. Defaults to the sampling rate agreed in the media buy.'
+        ),
+    ] = None
+    time_range: Annotated[TimeRange | None, Field(description='Filter to specific time period')] = (
+        None
+    )

adcp/types/generated_poc/content_standards/get_media_buy_artifacts_response.py

@@ -0,0 +1,117 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/get_media_buy_artifacts_response.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated, Any
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AwareDatetime, Field, RootModel
+
+from ..core import context as context_1
+from ..core import error
+from ..core import ext as ext_1
+from . import artifact as artifact_1
+
+
+class BrandContext(AdCPBaseModel):
+    brand_id: Annotated[str | None, Field(description='Brand identifier')] = None
+    sku_id: Annotated[str | None, Field(description='Product/SKU identifier if applicable')] = None
+
+
+class LocalVerdict(Enum):
+    pass_ = 'pass'
+    fail = 'fail'
+    unevaluated = 'unevaluated'
+
+
+class Pagination(AdCPBaseModel):
+    cursor: Annotated[str | None, Field(description='Cursor for fetching the next page')] = None
+    has_more: Annotated[bool | None, Field(description='Whether more results are available')] = None
+
+
+class Method(Enum):
+    random = 'random'
+    stratified = 'stratified'
+    recent = 'recent'
+    failures_only = 'failures_only'
+
+
+class SamplingInfo(AdCPBaseModel):
+    effective_rate: Annotated[float | None, Field(description='Actual sampling rate achieved')] = (
+        None
+    )
+    method: Annotated[Method | None, Field(description='Sampling method used')] = None
+    sampled_count: Annotated[
+        int | None, Field(description='Number of artifacts in this response')
+    ] = None
+    total_deliveries: Annotated[
+        int | None, Field(description='Total deliveries in the time range')
+    ] = None
+
+
+class GetMediaBuyArtifactsResponse2(AdCPBaseModel):
+    context: context_1.ContextObject | None = None
+    errors: list[error.Error]
+    ext: ext_1.ExtensionObject | None = None
+    media_buy_id: Annotated[
+        Any | None, Field(description='Field must not be present in error response')
+    ] = None
+
+
+class Artifact(AdCPBaseModel):
+    artifact: Annotated[artifact_1.Artifact, Field(description='Full artifact with content assets')]
+    brand_context: Annotated[
+        BrandContext | None,
+        Field(
+            description='Brand information for policy evaluation. Schema TBD - placeholder for brand identifiers.'
+        ),
+    ] = None
+    channel: Annotated[
+        str | None, Field(description='Channel type (e.g., display, video, audio, social)')
+    ] = None
+    country: Annotated[
+        str | None, Field(description='ISO 3166-1 alpha-2 country code where delivery occurred')
+    ] = None
+    local_verdict: Annotated[
+        LocalVerdict | None, Field(description="Seller's local model verdict for this artifact")
+    ] = None
+    package_id: Annotated[
+        str | None, Field(description='Which package this delivery belongs to')
+    ] = None
+    record_id: Annotated[str, Field(description='Unique identifier for this delivery record')]
+    timestamp: Annotated[AwareDatetime | None, Field(description='When the delivery occurred')] = (
+        None
+    )
+
+
+class GetMediaBuyArtifactsResponse1(AdCPBaseModel):
+    artifacts: Annotated[
+        list[Artifact], Field(description='Delivery records with full artifact content')
+    ]
+    context: context_1.ContextObject | None = None
+    errors: Annotated[
+        Any | None, Field(description='Field must not be present in success response')
+    ] = None
+    ext: ext_1.ExtensionObject | None = None
+    media_buy_id: Annotated[str, Field(description='Media buy these artifacts belong to')]
+    pagination: Annotated[
+        Pagination | None, Field(description='Pagination information for large result sets')
+    ] = None
+    sampling_info: Annotated[
+        SamplingInfo | None, Field(description='Information about how the sample was generated')
+    ] = None
+
+
+class GetMediaBuyArtifactsResponse(
+    RootModel[GetMediaBuyArtifactsResponse1 | GetMediaBuyArtifactsResponse2]
+):
+    root: Annotated[
+        GetMediaBuyArtifactsResponse1 | GetMediaBuyArtifactsResponse2,
+        Field(
+            description='Response containing content artifacts from a media buy for validation',
+            title='Get Media Buy Artifacts Response',
+        ),
+    ]

adcp/types/generated_poc/content_standards/list_content_standards_request.py

@@ -0,0 +1,31 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/list_content_standards_request.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+from ..core import context as context_1
+from ..core import ext as ext_1
+from ..enums import channels as channels_1
+
+
+class ListContentStandardsRequest(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    channels: Annotated[
+        list[channels_1.MediaChannel] | None, Field(description='Filter by channel')
+    ] = None
+    context: context_1.ContextObject | None = None
+    countries: Annotated[
+        list[str] | None, Field(description='Filter by ISO 3166-1 alpha-2 country codes')
+    ] = None
+    ext: ext_1.ExtensionObject | None = None
+    languages: Annotated[list[str] | None, Field(description='Filter by BCP 47 language tags')] = (
+        None
+    )

adcp/types/generated_poc/content_standards/list_content_standards_response.py

@@ -0,0 +1,48 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/list_content_standards_response.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Any
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import Field, RootModel
+
+from ..core import context as context_1
+from ..core import error
+from ..core import ext as ext_1
+from . import content_standards
+
+
+class ListContentStandardsResponse2(AdCPBaseModel):
+    context: context_1.ContextObject | None = None
+    errors: list[error.Error]
+    ext: ext_1.ExtensionObject | None = None
+    standards: Annotated[
+        Any | None, Field(description='Field must not be present in error response')
+    ] = None
+
+
+class ListContentStandardsResponse1(AdCPBaseModel):
+    context: context_1.ContextObject | None = None
+    errors: Annotated[
+        Any | None, Field(description='Field must not be present in success response')
+    ] = None
+    ext: ext_1.ExtensionObject | None = None
+    standards: Annotated[
+        list[content_standards.ContentStandards],
+        Field(description='Array of content standards configurations matching the filter criteria'),
+    ]
+
+
+class ListContentStandardsResponse(
+    RootModel[ListContentStandardsResponse1 | ListContentStandardsResponse2]
+):
+    root: Annotated[
+        ListContentStandardsResponse1 | ListContentStandardsResponse2,
+        Field(
+            description='Response payload with list of content standards configurations',
+            title='List Content Standards Response',
+        ),
+    ]

adcp/types/generated_poc/content_standards/update_content_standards_request.py

@@ -0,0 +1,101 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/update_content_standards_request.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Literal
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, ConfigDict, Field
+
+from ..core import context as context_1
+from ..core import ext as ext_1
+from ..enums import channels
+from . import artifact
+
+
+class Fail(AdCPBaseModel):
+    language: Annotated[
+        str | None, Field(description='BCP 47 language tag for content at this URL')
+    ] = None
+    type: Annotated[Literal['url'], Field(description='Indicates this is a URL reference')]
+    value: Annotated[
+        AnyUrl,
+        Field(
+            description="Full URL to a specific page (e.g., 'https://news.example.com/controversial-article')"
+        ),
+    ]
+
+
+class Pass(AdCPBaseModel):
+    language: Annotated[
+        str | None, Field(description='BCP 47 language tag for content at this URL')
+    ] = None
+    type: Annotated[Literal['url'], Field(description='Indicates this is a URL reference')]
+    value: Annotated[
+        AnyUrl,
+        Field(
+            description="Full URL to a specific page (e.g., 'https://espn.com/nba/story/_/id/12345/lakers-win')"
+        ),
+    ]
+
+
+class Scope(AdCPBaseModel):
+    channels_any: Annotated[
+        list[channels.MediaChannel] | None,
+        Field(
+            description='Advertising channels. Standards apply to ANY of the listed channels (OR logic).'
+        ),
+    ] = None
+    countries_all: Annotated[
+        list[str] | None,
+        Field(
+            description='ISO 3166-1 alpha-2 country codes. Standards apply in ALL listed countries (AND logic).'
+        ),
+    ] = None
+    description: Annotated[
+        str | None, Field(description='Human-readable description of this scope')
+    ] = None
+    languages_any: Annotated[
+        list[str] | None,
+        Field(
+            description="BCP 47 language tags (e.g., 'en', 'de', 'fr'). Standards apply to content in ANY of these languages (OR logic). Content in unlisted languages is not covered by these standards.",
+            min_length=1,
+        ),
+    ] = None
+
+
+class CalibrationExemplars(AdCPBaseModel):
+    fail: Annotated[
+        list[Fail | artifact.Artifact] | None, Field(description='Content that fails the standards')
+    ] = None
+    pass_: Annotated[
+        list[Pass | artifact.Artifact] | None,
+        Field(alias='pass', description='Content that passes the standards'),
+    ] = None
+
+
+class UpdateContentStandardsRequest(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    calibration_exemplars: Annotated[
+        CalibrationExemplars | None,
+        Field(
+            description='Updated training/test set to calibrate policy interpretation. Use URL references for pages to be fetched and analyzed, or full artifacts for pre-extracted content.'
+        ),
+    ] = None
+    context: context_1.ContextObject | None = None
+    ext: ext_1.ExtensionObject | None = None
+    policy: Annotated[
+        str | None,
+        Field(
+            description='Updated natural language policy describing acceptable and unacceptable content contexts.'
+        ),
+    ] = None
+    scope: Annotated[
+        Scope | None,
+        Field(description='Updated scope for where this standards configuration applies'),
+    ] = None
+    standards_id: Annotated[str, Field(description='ID of the standards configuration to update')]

adcp/types/generated_poc/content_standards/update_content_standards_response.py

@@ -0,0 +1,34 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/update_content_standards_response.json
+#   timestamp: 2026-01-26T11:40:01+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+from ..core import context as context_1
+from ..core import error
+from ..core import ext as ext_1
+
+
+class UpdateContentStandardsResponse(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    conflicting_standards_id: Annotated[
+        str | None,
+        Field(
+            description='If scope change conflicts with another configuration, the ID of the conflicting standards'
+        ),
+    ] = None
+    context: context_1.ContextObject | None = None
+    errors: Annotated[
+        list[error.Error] | None, Field(description='Errors that occurred during the update')
+    ] = None
+    ext: ext_1.ExtensionObject | None = None
+    standards_id: Annotated[
+        str | None, Field(description='ID of the updated standards configuration')
+    ] = None