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

adcp/types/aliases.py

@@ -35,9 +35,6 @@ from adcp.types._generated import (
     # Activation responses
     ActivateSignalResponse1,
     ActivateSignalResponse2,
-    # Activation keys
-    ActivationKey1,
-    ActivationKey2,
     # Authorized agents
     AuthorizedAgents,
     AuthorizedAgents1,
@@ -64,10 +61,10 @@ from adcp.types._generated import (
     # Preview creative responses
     PreviewCreativeResponse1,
     PreviewCreativeResponse2,
-    # Preview renders
-    PreviewRender1,
-    PreviewRender2,
-    PreviewRender3,
+    # Preview renders (discriminated union by output_format)
+    PreviewRender1,  # output_format='url'
+    PreviewRender2,  # output_format='html'
+    PreviewRender3,  # output_format='both'
     # Publisher properties types
     PropertyId,
     PropertyTag,
@@ -198,12 +195,11 @@ UpdateMediaBuyPropertiesRequest = UpdateMediaBuyRequest2
 # ============================================================================
 # ACTIVATION KEY ALIASES
 # ============================================================================
-
-PropertyIdActivationKey = ActivationKey1
-"""Activation key using property_id for identification."""
-
-PropertyTagActivationKey = ActivationKey2
-"""Activation key using property_tags for identification."""
+# Note: Activation key schema changed from property_id/property_tag variants
+# to segment_id/key_value variants. Import directly from _generated:
+#   from adcp.types._generated import ActivationKey1 as SegmentIdActivationKey
+#   from adcp.types._generated import ActivationKey2 as KeyValueActivationKey
+# These will be added once the types are regenerated with proper schema.
 
 # ============================================================================
 # PREVIEW/RENDER TYPE ALIASES
@@ -216,15 +212,15 @@ PreviewCreativeStaticResponse = PreviewCreativeResponse1
 PreviewCreativeInteractiveResponse = PreviewCreativeResponse2
 """Preview response with interactive renders (iframe embedding)."""
 
-# Preview Render Variants (discriminated by output_format)
+# Preview Render Aliases (discriminated union by output_format)
 UrlPreviewRender = PreviewRender1
-"""Preview render with output_format='url' - provides preview_url for iframe embedding."""
+"""Preview render with output_format='url' and preview_url for iframe embedding."""
 
 HtmlPreviewRender = PreviewRender2
-"""Preview render with output_format='html' - provides preview_html for direct embedding."""
+"""Preview render with output_format='html' and preview_html for direct embedding."""
 
 BothPreviewRender = PreviewRender3
-"""Preview render with output_format='both' - provides both preview_url and preview_html."""
+"""Preview render with output_format='both' and both preview_url and preview_html."""
 
 # ============================================================================
 # ASSET TYPE ALIASES - Delivery & Kind Discriminated Unions
@@ -700,9 +696,6 @@ __all__ = [
     # Activation responses
     "ActivateSignalSuccessResponse",
     "ActivateSignalErrorResponse",
-    # Activation keys
-    "PropertyIdActivationKey",
-    "PropertyTagActivationKey",
     # Asset type aliases
     "BothPreviewRender",
     "HtmlPreviewRender",

adcp/types/base.py

@@ -204,7 +204,7 @@ class AdCPBaseModel(BaseModel):
             kwargs["exclude_none"] = True
         return super().model_dump_json(**kwargs)
 
-    def summary(self) -> str:
+    def model_summary(self) -> str:
         """Human-readable summary for protocol responses.
 
         Returns a standardized human-readable message suitable for MCP tool

adcp/types/generated_poc/adagents.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  adagents.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-26T13:22:19+00:00
 
 from __future__ import annotations
 
@@ -59,6 +59,12 @@ class Contact(AdCPBaseModel):
             min_length=1,
         ),
     ]
+    privacy_policy_url: Annotated[
+        AnyUrl | None,
+        Field(
+            description="URL to the entity's privacy policy. Used for consumer consent flows when interacting with this sales agent."
+        ),
+    ] = None
     seller_id: Annotated[
         str | None,
         Field(
@@ -77,6 +83,32 @@ class Contact(AdCPBaseModel):
     ] = None
 
 
+class PropertyFeature(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    features: Annotated[
+        list[str],
+        Field(
+            description="Feature IDs this agent provides (e.g., 'carbon_score', 'tag_certified_against_fraud'). Use list_property_features on the agent for full definitions.",
+            min_length=1,
+        ),
+    ]
+    name: Annotated[
+        str,
+        Field(
+            description="Human-readable name of the vendor/agent (e.g., 'Scope3', 'TAG', 'OneTrust')"
+        ),
+    ]
+    publisher_id: Annotated[
+        str | None, Field(description='Optional publisher identifier at this agent (for lookup)')
+    ] = None
+    url: Annotated[
+        AnyUrl,
+        Field(description="The agent's API endpoint URL (must implement get_property_features)"),
+    ]
+
+
 class Tags(AdCPBaseModel):
     model_config = ConfigDict(
         extra='allow',
@@ -223,6 +255,12 @@ class AuthorizedSalesAgents2(AdCPBaseModel):
             min_length=1,
         ),
     ] = None
+    property_features: Annotated[
+        list[PropertyFeature] | None,
+        Field(
+            description="[AdCP 3.0] Optional list of agents that provide property feature data (certifications, scores, compliance status). Used for discovery - actual data comes from querying the agent's get_property_features task."
+        ),
+    ] = None
     tags: Annotated[
         dict[str, Tags] | None,
         Field(
@@ -238,12 +276,12 @@ class AuthorizedSalesAgents(RootModel[AuthorizedSalesAgents1 | AuthorizedSalesAg
             description='Declaration of authorized sales agents for advertising inventory. Hosted at /.well-known/adagents.json on publisher domains. Can either contain the full structure inline or reference an authoritative URL.',
             examples=[
                 {
-                    '$schema': '/schemas/2.6.0/adagents.json',
+                    '$schema': '/schemas/3.0.0-beta.1/adagents.json',
                     'authoritative_location': 'https://cdn.example.com/adagents/v2/adagents.json',
                     'last_updated': '2025-01-15T10:00:00Z',
                 },
                 {
-                    '$schema': '/schemas/2.6.0/adagents.json',
+                    '$schema': '/schemas/3.0.0-beta.1/adagents.json',
                     'authorized_agents': [
                         {
                             'authorization_type': 'property_tags',
@@ -269,7 +307,7 @@ class AuthorizedSalesAgents(RootModel[AuthorizedSalesAgents1 | AuthorizedSalesAg
                     },
                 },
                 {
-                    '$schema': '/schemas/2.6.0/adagents.json',
+                    '$schema': '/schemas/3.0.0-beta.1/adagents.json',
                     'authorized_agents': [
                         {
                             'authorization_type': 'property_tags',
@@ -282,6 +320,7 @@ class AuthorizedSalesAgents(RootModel[AuthorizedSalesAgents1 | AuthorizedSalesAg
                         'domain': 'meta.com',
                         'email': 'adops@meta.com',
                         'name': 'Meta Advertising Operations',
+                        'privacy_policy_url': 'https://www.meta.com/privacy/policy',
                         'seller_id': 'pub-meta-12345',
                         'tag_id': '12345',
                     },
@@ -334,7 +373,7 @@ class AuthorizedSalesAgents(RootModel[AuthorizedSalesAgents1 | AuthorizedSalesAg
                     },
                 },
                 {
-                    '$schema': '/schemas/2.6.0/adagents.json',
+                    '$schema': '/schemas/3.0.0-beta.1/adagents.json',
                     'authorized_agents': [
                         {
                             'authorization_type': 'property_tags',
@@ -362,7 +401,7 @@ class AuthorizedSalesAgents(RootModel[AuthorizedSalesAgents1 | AuthorizedSalesAg
                     },
                 },
                 {
-                    '$schema': '/schemas/2.6.0/adagents.json',
+                    '$schema': '/schemas/3.0.0-beta.1/adagents.json',
                     'authorized_agents': [
                         {
                             'authorization_type': 'publisher_properties',
@@ -401,6 +440,64 @@ class AuthorizedSalesAgents(RootModel[AuthorizedSalesAgents1 | AuthorizedSalesAg
                     },
                     'last_updated': '2025-01-10T17:00:00Z',
                 },
+                {
+                    '$schema': '/schemas/3.0.0-beta.1/adagents.json',
+                    'authorized_agents': [
+                        {
+                            'authorization_type': 'property_tags',
+                            'authorized_for': 'All news properties',
+                            'property_tags': ['news'],
+                            'url': 'https://sales.news.example.com',
+                        }
+                    ],
+                    'contact': {
+                        'domain': 'news.example.com',
+                        'email': 'adops@news.example.com',
+                        'name': 'Premium News Publisher',
+                    },
+                    'last_updated': '2025-01-10T18:00:00Z',
+                    'properties': [
+                        {
+                            'identifiers': [{'type': 'domain', 'value': 'news.example.com'}],
+                            'name': 'News Example',
+                            'property_type': 'website',
+                            'publisher_domain': 'news.example.com',
+                            'tags': ['premium', 'news'],
+                        }
+                    ],
+                    'property_features': [
+                        {
+                            'features': ['carbon_score', 'sustainability_grade'],
+                            'name': 'Scope3',
+                            'publisher_id': 'pub_news_12345',
+                            'url': 'https://api.scope3.com',
+                        },
+                        {
+                            'features': [
+                                'tag_certified_against_fraud',
+                                'tag_brand_safety_certified',
+                            ],
+                            'name': 'TAG',
+                            'url': 'https://api.tagtoday.net',
+                        },
+                        {
+                            'features': ['gdpr_compliant', 'tcf_registered', 'ccpa_compliant'],
+                            'name': 'OneTrust',
+                            'publisher_id': 'ot_news_67890',
+                            'url': 'https://api.onetrust.com',
+                        },
+                    ],
+                    'tags': {
+                        'news': {
+                            'description': 'News and journalism content',
+                            'name': 'News Properties',
+                        },
+                        'premium': {
+                            'description': 'High-quality, brand-safe properties',
+                            'name': 'Premium Properties',
+                        },
+                    },
+                },
             ],
             title='Authorized Sales Agents',
         ),

adcp/types/generated_poc/content_standards/__init__.py

@@ -0,0 +1,3 @@
+# generated by datamodel-codegen:
+#   filename:  .schema_temp
+#   timestamp: 2026-01-25T21:17:54+00:00

adcp/types/generated_poc/content_standards/artifact.py

@@ -0,0 +1,208 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/artifact.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated, Any, Literal
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, AwareDatetime, ConfigDict, Field, RootModel
+
+from ..core import format_id as format_id_1
+from ..core import identifier
+
+
+class Role(Enum):
+    title_ = 'title'
+    paragraph = 'paragraph'
+    heading = 'heading'
+    caption = 'caption'
+    quote = 'quote'
+    list_item = 'list_item'
+    description = 'description'
+
+
+class Assets(AdCPBaseModel):
+    content: Annotated[str, Field(description='Text content')]
+    heading_level: Annotated[
+        int | None, Field(description='Heading level (1-6), only for role=heading', ge=1, le=6)
+    ] = None
+    language: Annotated[
+        str | None,
+        Field(
+            description="BCP 47 language tag for this text (e.g., 'en', 'es-MX'). Useful when artifact contains mixed-language content."
+        ),
+    ] = None
+    role: Annotated[
+        Role | None,
+        Field(
+            description="Role of this text in the document. Use 'title' for the main artifact title, 'description' for summaries."
+        ),
+    ] = None
+    type: Literal['text']
+
+
+class TranscriptSource(Enum):
+    original_script = 'original_script'
+    subtitles = 'subtitles'
+    closed_captions = 'closed_captions'
+    dub = 'dub'
+    generated = 'generated'
+
+
+class TranscriptSource1(Enum):
+    original_script = 'original_script'
+    closed_captions = 'closed_captions'
+    generated = 'generated'
+
+
+class Identifiers(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    apple_podcast_id: Annotated[str | None, Field(description='Apple Podcasts ID')] = None
+    podcast_guid: Annotated[str | None, Field(description='Podcast GUID (from RSS feed)')] = None
+    rss_url: Annotated[AnyUrl | None, Field(description='RSS feed URL')] = None
+    spotify_show_id: Annotated[str | None, Field(description='Spotify show ID')] = None
+    youtube_video_id: Annotated[str | None, Field(description='YouTube video ID')] = None
+
+
+class Metadata(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    author: Annotated[str | None, Field(description='Artifact author name')] = None
+    canonical: Annotated[AnyUrl | None, Field(description='Canonical URL')] = None
+    json_ld: Annotated[
+        list[dict[str, Any]] | None, Field(description='JSON-LD structured data (schema.org)')
+    ] = None
+    keywords: Annotated[str | None, Field(description='Artifact keywords')] = None
+    open_graph: Annotated[
+        dict[str, Any] | None, Field(description='Open Graph protocol metadata')
+    ] = None
+    twitter_card: Annotated[dict[str, Any] | None, Field(description='Twitter Card metadata')] = (
+        None
+    )
+
+
+class AssetAccess1(AdCPBaseModel):
+    method: Literal['bearer_token']
+    token: Annotated[str, Field(description='OAuth2 bearer token for Authorization header')]
+
+
+class Provider(Enum):
+    gcp = 'gcp'
+    aws = 'aws'
+
+
+class AssetAccess2(AdCPBaseModel):
+    credentials: Annotated[
+        dict[str, Any] | None, Field(description='Service account credentials')
+    ] = None
+    method: Literal['service_account']
+    provider: Annotated[Provider, Field(description='Cloud provider')]
+
+
+class AssetAccess3(AdCPBaseModel):
+    method: Literal['signed_url']
+
+
+class AssetAccess(RootModel[AssetAccess1 | AssetAccess2 | AssetAccess3]):
+    root: Annotated[
+        AssetAccess1 | AssetAccess2 | AssetAccess3,
+        Field(description='Authentication for accessing secured asset URLs'),
+    ]
+
+
+class Assets1(AdCPBaseModel):
+    access: Annotated[AssetAccess | None, Field(description='Authentication for secured URLs')] = (
+        None
+    )
+    alt_text: Annotated[str | None, Field(description='Alt text or image description')] = None
+    caption: Annotated[str | None, Field(description='Image caption')] = None
+    height: Annotated[int | None, Field(description='Image height in pixels')] = None
+    type: Literal['image']
+    url: Annotated[AnyUrl, Field(description='Image URL')]
+    width: Annotated[int | None, Field(description='Image width in pixels')] = None
+
+
+class Assets2(AdCPBaseModel):
+    access: Annotated[AssetAccess | None, Field(description='Authentication for secured URLs')] = (
+        None
+    )
+    duration_ms: Annotated[int | None, Field(description='Video duration in milliseconds')] = None
+    thumbnail_url: Annotated[AnyUrl | None, Field(description='Video thumbnail URL')] = None
+    transcript: Annotated[str | None, Field(description='Video transcript')] = None
+    transcript_source: Annotated[
+        TranscriptSource | None, Field(description='How the transcript was generated')
+    ] = None
+    type: Literal['video']
+    url: Annotated[AnyUrl, Field(description='Video URL')]
+
+
+class Assets3(AdCPBaseModel):
+    access: Annotated[AssetAccess | None, Field(description='Authentication for secured URLs')] = (
+        None
+    )
+    duration_ms: Annotated[int | None, Field(description='Audio duration in milliseconds')] = None
+    transcript: Annotated[str | None, Field(description='Audio transcript')] = None
+    transcript_source: Annotated[
+        TranscriptSource1 | None, Field(description='How the transcript was generated')
+    ] = None
+    type: Literal['audio']
+    url: Annotated[AnyUrl, Field(description='Audio URL')]
+
+
+class Artifact(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    artifact_id: Annotated[
+        str,
+        Field(
+            description="Identifier for this artifact within the property. The property owner defines the scheme (e.g., 'article_12345', 'episode_42_segment_3', 'post_abc123')."
+        ),
+    ]
+    assets: Annotated[
+        list[Assets | Assets1 | Assets2 | Assets3],
+        Field(
+            description='Artifact assets in document flow order - text blocks, images, video, audio'
+        ),
+    ]
+    format_id: Annotated[
+        format_id_1.FormatId | None,
+        Field(
+            description='Optional reference to a format definition. Uses the same format registry as creative formats.'
+        ),
+    ] = None
+    identifiers: Annotated[
+        Identifiers | None, Field(description='Platform-specific identifiers for this artifact')
+    ] = None
+    last_update_time: Annotated[
+        AwareDatetime | None,
+        Field(description='When the artifact was last modified (ISO 8601 format)'),
+    ] = None
+    metadata: Annotated[
+        Metadata | None, Field(description='Rich metadata extracted from the artifact')
+    ] = None
+    property_id: Annotated[
+        identifier.Identifier,
+        Field(description='Identifier for the property where this artifact appears'),
+    ]
+    published_time: Annotated[
+        AwareDatetime | None, Field(description='When the artifact was published (ISO 8601 format)')
+    ] = None
+    url: Annotated[
+        AnyUrl | None,
+        Field(
+            description='Optional URL for this artifact (web page, podcast feed, video page). Not all artifacts have URLs (e.g., Instagram content, podcast segments, TV scenes).'
+        ),
+    ] = None
+    variant_id: Annotated[
+        str | None,
+        Field(
+            description="Identifies a specific variant of this artifact. Use for A/B tests, translations, or temporal versions. Examples: 'en', 'es-MX', 'v2', 'headline_test_b'. The combination of artifact_id + variant_id must be unique."
+        ),
+    ] = None

adcp/types/generated_poc/content_standards/artifact_webhook_payload.py

@@ -0,0 +1,64 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/artifact_webhook_payload.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 AwareDatetime, ConfigDict, Field
+
+from ..core import ext as ext_1
+from . import artifact as artifact_1
+
+
+class Pagination(AdCPBaseModel):
+    batch_number: Annotated[int | None, Field(description='Current batch number (1-indexed)')] = (
+        None
+    )
+    total_artifacts: Annotated[
+        int | None, Field(description='Total artifacts in the delivery period')
+    ] = None
+    total_batches: Annotated[
+        int | None, Field(description='Total batches for this delivery period')
+    ] = None
+
+
+class Artifact(AdCPBaseModel):
+    artifact: Annotated[artifact_1.Artifact, Field(description='The content artifact')]
+    delivered_at: Annotated[
+        AwareDatetime, Field(description='When the impression was delivered (ISO 8601)')
+    ]
+    impression_id: Annotated[
+        str | None,
+        Field(description='Optional impression identifier for correlation with delivery reports'),
+    ] = None
+    package_id: Annotated[
+        str | None, Field(description='Package within the media buy this artifact relates to')
+    ] = None
+
+
+class ArtifactWebhookPayload(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    artifacts: Annotated[
+        list[Artifact], Field(description='Content artifacts from delivered impressions')
+    ]
+    batch_id: Annotated[
+        str,
+        Field(
+            description='Unique identifier for this batch of artifacts. Use for deduplication and acknowledgment.'
+        ),
+    ]
+    ext: ext_1.ExtensionObject | None = None
+    media_buy_id: Annotated[
+        str, Field(description='Media buy identifier these artifacts belong to')
+    ]
+    pagination: Annotated[
+        Pagination | None, Field(description='Pagination info when batching large artifact sets')
+    ] = None
+    timestamp: Annotated[
+        AwareDatetime, Field(description='When this batch was generated (ISO 8601)')
+    ]

adcp/types/generated_poc/content_standards/calibrate_content_request.py

@@ -0,0 +1,17 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/calibrate_content_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 . import artifact as artifact_1
+
+
+class CalibrateContentRequest(AdCPBaseModel):
+    artifact: Annotated[artifact_1.Artifact, Field(description='Artifact to evaluate')]
+    standards_id: Annotated[str, Field(description='Standards configuration to calibrate against')]

adcp/types/generated_poc/content_standards/calibrate_content_response.py

@@ -0,0 +1,74 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/calibrate_content_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 Field, RootModel
+
+from ..core import error
+
+
+class Status(Enum):
+    passed = 'passed'
+    failed = 'failed'
+    warning = 'warning'
+    unevaluated = 'unevaluated'
+
+
+class Feature(AdCPBaseModel):
+    explanation: Annotated[
+        str | None,
+        Field(description='Human-readable explanation of why this feature passed or failed'),
+    ] = None
+    feature_id: Annotated[
+        str,
+        Field(
+            description='Which feature was evaluated (e.g., brand_safety, brand_suitability, competitor_adjacency)'
+        ),
+    ]
+    status: Annotated[Status, Field(description='Evaluation status for this feature')]
+
+
+class Verdict(Enum):
+    pass_ = 'pass'
+    fail = 'fail'
+
+
+class CalibrateContentResponse1(AdCPBaseModel):
+    confidence: Annotated[
+        float | None, Field(description='Model confidence in the verdict (0-1)', ge=0.0, le=1.0)
+    ] = None
+    errors: Annotated[
+        Any | None, Field(description='Field must not be present in success response')
+    ] = None
+    explanation: Annotated[
+        str | None, Field(description='Detailed natural language explanation of the decision')
+    ] = None
+    features: Annotated[
+        list[Feature] | None, Field(description='Per-feature breakdown with explanations')
+    ] = None
+    verdict: Annotated[
+        Verdict, Field(description='Overall pass/fail verdict for the content evaluation')
+    ]
+
+
+class CalibrateContentResponse2(AdCPBaseModel):
+    errors: list[error.Error]
+    verdict: Annotated[
+        Any | None, Field(description='Field must not be present in error response')
+    ] = None
+
+
+class CalibrateContentResponse(RootModel[CalibrateContentResponse1 | CalibrateContentResponse2]):
+    root: Annotated[
+        CalibrateContentResponse1 | CalibrateContentResponse2,
+        Field(
+            description='Response payload with verdict and detailed explanations for collaborative calibration',
+            title='Calibrate Content Response',
+        ),
+    ]