adcp 2.11.1__py3-none-any.whl → 2.12.1__py3-none-any.whl

adcp/types/generated_poc/adagents.py

@@ -1,15 +1,35 @@
 # generated by datamodel-codegen:
 #   filename:  adagents.json
-#   timestamp: 2025-11-21T20:45:16+00:00
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 
 from typing import Annotated, Literal
 
 from adcp.types.base import AdCPBaseModel
-from pydantic import AnyUrl, AwareDatetime, ConfigDict, EmailStr, Field
+from pydantic import AnyUrl, AwareDatetime, ConfigDict, EmailStr, Field, RootModel
 
-from . import property, property_id, property_tag, publisher_property_selector
+from .core import property, property_id, property_tag, publisher_property_selector
+
+
+class AuthorizedSalesAgents1(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    field_schema: Annotated[
+        str | None,
+        Field(alias='$schema', description='JSON Schema identifier for this adagents.json file'),
+    ] = 'https://adcontextprotocol.org/schemas/adagents.json'
+    authoritative_location: Annotated[
+        AnyUrl,
+        Field(
+            description='HTTPS URL of the authoritative adagents.json file. When present, this file is a reference and the authoritative location contains the actual agent authorization data.'
+        ),
+    ]
+    last_updated: Annotated[
+        AwareDatetime | None,
+        Field(description='ISO 8601 timestamp indicating when this reference was last updated'),
+    ] = None
 
 
 class Contact(AdCPBaseModel):
@@ -117,13 +137,15 @@ class AuthorizedAgents1(AdCPBaseModel):
     url: Annotated[AnyUrl, Field(description="The authorized agent's API endpoint URL")]
 
 
-class AuthorizedAgents2(AdCPBaseModel):
+class AuthorizedAgents3(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
     authorization_type: Annotated[
-        Literal['inline_properties'],
-        Field(description='Discriminator indicating authorization by inline property definitions'),
+        Literal['publisher_properties'],
+        Field(
+            description='Discriminator indicating authorization for properties from other publisher domains'
+        ),
     ]
     authorized_for: Annotated[
         str,
@@ -133,25 +155,27 @@ class AuthorizedAgents2(AdCPBaseModel):
             min_length=1,
         ),
     ]
-    properties: Annotated[
-        list[property.Property],
+    publisher_properties: Annotated[
+        list[
+            publisher_property_selector.PublisherPropertySelector1
+            | publisher_property_selector.PublisherPropertySelector2
+            | publisher_property_selector.PublisherPropertySelector3
+        ],
         Field(
-            description='Specific properties this agent is authorized for (alternative to property_ids/property_tags)',
+            description='Properties from other publisher domains this agent is authorized for. Each entry specifies a publisher domain and which of their properties this agent can sell',
             min_length=1,
         ),
     ]
     url: Annotated[AnyUrl, Field(description="The authorized agent's API endpoint URL")]
 
 
-class AuthorizedAgents3(AdCPBaseModel):
+class AuthorizedAgents2(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
     authorization_type: Annotated[
-        Literal['publisher_properties'],
-        Field(
-            description='Discriminator indicating authorization for properties from other publisher domains'
-        ),
+        Literal['inline_properties'],
+        Field(description='Discriminator indicating authorization by inline property definitions'),
     ]
     authorized_for: Annotated[
         str,
@@ -161,28 +185,24 @@ class AuthorizedAgents3(AdCPBaseModel):
             min_length=1,
         ),
     ]
-    publisher_properties: Annotated[
-        list[
-            publisher_property_selector.PublisherPropertySelector1
-            | publisher_property_selector.PublisherPropertySelector2
-            | publisher_property_selector.PublisherPropertySelector3
-        ],
+    properties: Annotated[
+        list[property.Property],
         Field(
-            description='Properties from other publisher domains this agent is authorized for. Each entry specifies a publisher domain and which of their properties this agent can sell',
+            description='Specific properties this agent is authorized for (alternative to property_ids/property_tags)',
             min_length=1,
         ),
     ]
     url: Annotated[AnyUrl, Field(description="The authorized agent's API endpoint URL")]
 
 
-class AuthorizedSalesAgents(AdCPBaseModel):
+class AuthorizedSalesAgents2(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
     field_schema: Annotated[
         str | None,
         Field(alias='$schema', description='JSON Schema identifier for this adagents.json file'),
-    ] = 'https://adcontextprotocol.org/schemas/v1/adagents.json'
+    ] = 'https://adcontextprotocol.org/schemas/adagents.json'
     authorized_agents: Annotated[
         list[AuthorizedAgents | AuthorizedAgents1 | AuthorizedAgents2 | AuthorizedAgents3],
         Field(
@@ -203,13 +223,189 @@ class AuthorizedSalesAgents(AdCPBaseModel):
     properties: Annotated[
         list[property.Property] | None,
         Field(
-            description='Array of all properties covered by this adagents.json file. Same structure as list_authorized_properties response.',
+            description='Array of all properties covered by this adagents.json file. Defines the canonical property list that authorized agents reference.',
             min_length=1,
         ),
     ] = None
     tags: Annotated[
         dict[str, Tags] | None,
         Field(
-            description='Metadata for each tag referenced by properties. Same structure as list_authorized_properties response.'
+            description='Metadata for each tag referenced by properties. Provides human-readable context for property tag values.'
         ),
     ] = None
+
+
+class AuthorizedSalesAgents(RootModel[AuthorizedSalesAgents1 | AuthorizedSalesAgents2]):
+    root: Annotated[
+        AuthorizedSalesAgents1 | AuthorizedSalesAgents2,
+        Field(
+            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': 'https://adcontextprotocol.org/schemas/adagents.json',
+                    'authoritative_location': 'https://cdn.example.com/adagents/v2/adagents.json',
+                    'last_updated': '2025-01-15T10:00:00Z',
+                },
+                {
+                    '$schema': 'https://adcontextprotocol.org/schemas/adagents.json',
+                    'authorized_agents': [
+                        {
+                            'authorization_type': 'property_tags',
+                            'authorized_for': 'Official sales agent',
+                            'property_tags': ['all'],
+                            'url': 'https://agent.example.com',
+                        }
+                    ],
+                    'last_updated': '2025-01-10T12:00:00Z',
+                    'properties': [
+                        {
+                            'identifiers': [{'type': 'domain', 'value': 'example.com'}],
+                            'name': 'Example Site',
+                            'property_type': 'website',
+                            'publisher_domain': 'example.com',
+                        }
+                    ],
+                    'tags': {
+                        'all': {
+                            'description': 'All properties in this file',
+                            'name': 'All Properties',
+                        }
+                    },
+                },
+                {
+                    '$schema': 'https://adcontextprotocol.org/schemas/adagents.json',
+                    'authorized_agents': [
+                        {
+                            'authorization_type': 'property_tags',
+                            'authorized_for': 'All Meta properties',
+                            'property_tags': ['meta_network'],
+                            'url': 'https://meta-ads.com',
+                        }
+                    ],
+                    'contact': {
+                        'domain': 'meta.com',
+                        'email': 'adops@meta.com',
+                        'name': 'Meta Advertising Operations',
+                        'seller_id': 'pub-meta-12345',
+                        'tag_id': '12345',
+                    },
+                    'last_updated': '2025-01-10T15:30:00Z',
+                    'properties': [
+                        {
+                            'identifiers': [
+                                {'type': 'ios_bundle', 'value': 'com.burbn.instagram'},
+                                {'type': 'android_package', 'value': 'com.instagram.android'},
+                            ],
+                            'name': 'Instagram',
+                            'property_type': 'mobile_app',
+                            'publisher_domain': 'instagram.com',
+                            'tags': ['meta_network', 'social_media'],
+                        },
+                        {
+                            'identifiers': [
+                                {'type': 'ios_bundle', 'value': 'com.facebook.Facebook'},
+                                {'type': 'android_package', 'value': 'com.facebook.katana'},
+                            ],
+                            'name': 'Facebook',
+                            'property_type': 'mobile_app',
+                            'publisher_domain': 'facebook.com',
+                            'tags': ['meta_network', 'social_media'],
+                        },
+                        {
+                            'identifiers': [
+                                {'type': 'ios_bundle', 'value': 'net.whatsapp.WhatsApp'},
+                                {'type': 'android_package', 'value': 'com.whatsapp'},
+                            ],
+                            'name': 'WhatsApp',
+                            'property_type': 'mobile_app',
+                            'publisher_domain': 'whatsapp.com',
+                            'tags': ['meta_network', 'messaging'],
+                        },
+                    ],
+                    'tags': {
+                        'messaging': {
+                            'description': 'Messaging and communication apps',
+                            'name': 'Messaging Apps',
+                        },
+                        'meta_network': {
+                            'description': 'All Meta-owned properties',
+                            'name': 'Meta Network',
+                        },
+                        'social_media': {
+                            'description': 'Social networking applications',
+                            'name': 'Social Media Apps',
+                        },
+                    },
+                },
+                {
+                    '$schema': 'https://adcontextprotocol.org/schemas/adagents.json',
+                    'authorized_agents': [
+                        {
+                            'authorization_type': 'property_tags',
+                            'authorized_for': 'Tumblr corporate properties only',
+                            'property_tags': ['corporate'],
+                            'url': 'https://tumblr-sales.com',
+                        }
+                    ],
+                    'contact': {'name': 'Tumblr Advertising'},
+                    'last_updated': '2025-01-10T16:00:00Z',
+                    'properties': [
+                        {
+                            'identifiers': [{'type': 'domain', 'value': 'tumblr.com'}],
+                            'name': 'Tumblr Corporate',
+                            'property_type': 'website',
+                            'publisher_domain': 'tumblr.com',
+                            'tags': ['corporate'],
+                        }
+                    ],
+                    'tags': {
+                        'corporate': {
+                            'description': 'Tumblr-owned corporate properties (not user blogs)',
+                            'name': 'Corporate Properties',
+                        }
+                    },
+                },
+                {
+                    '$schema': 'https://adcontextprotocol.org/schemas/adagents.json',
+                    'authorized_agents': [
+                        {
+                            'authorization_type': 'publisher_properties',
+                            'authorized_for': 'CNN CTV properties via publisher authorization',
+                            'publisher_properties': [
+                                {
+                                    'property_ids': ['cnn_ctv_app'],
+                                    'publisher_domain': 'cnn.com',
+                                    'selection_type': 'by_id',
+                                }
+                            ],
+                            'url': 'https://agent.example/api',
+                        },
+                        {
+                            'authorization_type': 'publisher_properties',
+                            'authorized_for': 'All CTV properties from multiple publishers',
+                            'publisher_properties': [
+                                {
+                                    'property_tags': ['ctv'],
+                                    'publisher_domain': 'cnn.com',
+                                    'selection_type': 'by_tag',
+                                },
+                                {
+                                    'property_tags': ['ctv'],
+                                    'publisher_domain': 'espn.com',
+                                    'selection_type': 'by_tag',
+                                },
+                            ],
+                            'url': 'https://agent.example/api',
+                        },
+                    ],
+                    'contact': {
+                        'domain': 'agent.example',
+                        'email': 'sales@agent.example',
+                        'name': 'Example Third-Party Sales Agent',
+                    },
+                    'last_updated': '2025-01-10T17:00:00Z',
+                },
+            ],
+            title='Authorized Sales Agents',
+        ),
+    ]

adcp/types/generated_poc/core/__init__.py

@@ -0,0 +1,3 @@
+# generated by datamodel-codegen:
+#   filename:  .schema_temp
+#   timestamp: 2025-11-22T15:23:24+00:00

adcp/types/generated_poc/{activation_key.py → core/activation_key.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  activation-key.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/activation_key.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/assets/__init__.py

@@ -0,0 +1,3 @@
+# generated by datamodel-codegen:
+#   filename:  .schema_temp
+#   timestamp: 2025-11-22T15:23:24+00:00

adcp/types/generated_poc/{audio_asset.py → core/assets/audio_asset.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  audio-asset.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/assets/audio_asset.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/{css_asset.py → core/assets/css_asset.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  css-asset.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/assets/css_asset.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/{daast_asset.py → core/assets/daast_asset.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  daast-asset.json
-#   timestamp: 2025-11-21T12:49:05+00:00
+#   filename:  core/assets/daast_asset.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 
@@ -9,8 +9,8 @@ from typing import Annotated, Literal
 from adcp.types.base import AdCPBaseModel
 from pydantic import AnyUrl, ConfigDict, Field
 
-from . import daast_tracking_event
-from . import daast_version as daast_version_1
+from ...enums import daast_tracking_event
+from ...enums import daast_version as daast_version_1
 
 
 class DaastAsset1(AdCPBaseModel):

adcp/types/generated_poc/{html_asset.py → core/assets/html_asset.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  html-asset.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/assets/html_asset.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/assets/image_asset.py

@@ -0,0 +1,19 @@
+# generated by datamodel-codegen:
+#   filename:  core/assets/image_asset.json
+#   timestamp: 2025-11-22T19:16:02+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from pydantic import AnyUrl, Field
+
+from ..dimensions import Dimensions
+
+
+class ImageAsset(Dimensions):
+    alt_text: Annotated[str | None, Field(description='Alternative text for accessibility')] = None
+    format: Annotated[
+        str | None, Field(description='Image file format (jpg, png, gif, webp, etc.)')
+    ] = None
+    url: Annotated[AnyUrl, Field(description='URL to the image asset')]

adcp/types/generated_poc/{javascript_asset.py → core/assets/javascript_asset.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  javascript-asset.json
-#   timestamp: 2025-11-21T12:49:05+00:00
+#   filename:  core/assets/javascript_asset.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 
@@ -9,7 +9,7 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field
 
-from . import javascript_module_type
+from ...enums import javascript_module_type
 
 
 class JavascriptAsset(AdCPBaseModel):

adcp/types/generated_poc/{text_asset.py → core/assets/text_asset.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  text-asset.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/assets/text_asset.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/{url_asset.py → core/assets/url_asset.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  url-asset.json
-#   timestamp: 2025-11-21T12:49:05+00:00
+#   filename:  core/assets/url_asset.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 
@@ -9,7 +9,7 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import AnyUrl, ConfigDict, Field
 
-from . import url_asset_type
+from ...enums import url_asset_type
 
 
 class UrlAsset(AdCPBaseModel):

adcp/types/generated_poc/{vast_asset.py → core/assets/vast_asset.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  vast-asset.json
-#   timestamp: 2025-11-21T12:49:05+00:00
+#   filename:  core/assets/vast_asset.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 
@@ -9,8 +9,8 @@ from typing import Annotated, Literal
 from adcp.types.base import AdCPBaseModel
 from pydantic import AnyUrl, ConfigDict, Field
 
-from . import vast_tracking_event
-from . import vast_version as vast_version_1
+from ...enums import vast_tracking_event
+from ...enums import vast_version as vast_version_1
 
 
 class VastAsset1(AdCPBaseModel):

adcp/types/generated_poc/{video_asset.py → core/assets/video_asset.py}

@@ -1,28 +1,24 @@
 # generated by datamodel-codegen:
-#   filename:  video-asset.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/assets/video_asset.json
+#   timestamp: 2025-11-22T19:16:02+00:00
 
 from __future__ import annotations
 
 from typing import Annotated
 
-from adcp.types.base import AdCPBaseModel
-from pydantic import AnyUrl, ConfigDict, Field
+from pydantic import AnyUrl, Field
 
+from ..dimensions import Dimensions
 
-class VideoAsset(AdCPBaseModel):
-    model_config = ConfigDict(
-        extra='forbid',
-    )
+
+class VideoAsset(Dimensions):
     bitrate_kbps: Annotated[
         int | None, Field(description='Video bitrate in kilobits per second', ge=1)
     ] = None
     duration_ms: Annotated[
-        int | None, Field(description='Video duration in milliseconds', ge=0)
+        int | None, Field(description='Video duration in milliseconds', ge=1)
     ] = None
     format: Annotated[str | None, Field(description='Video file format (mp4, webm, mov, etc.)')] = (
         None
     )
-    height: Annotated[int | None, Field(description='Video height in pixels', ge=1)] = None
     url: Annotated[AnyUrl, Field(description='URL to the video asset')]
-    width: Annotated[int | None, Field(description='Video width in pixels', ge=1)] = None

adcp/types/generated_poc/{webhook_asset.py → core/assets/webhook_asset.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  webhook-asset.json
-#   timestamp: 2025-11-21T12:49:05+00:00
+#   filename:  core/assets/webhook_asset.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 
@@ -9,7 +9,7 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import AnyUrl, ConfigDict, Field
 
-from . import http_method, webhook_response_type, webhook_security_method
+from ...enums import http_method, webhook_response_type, webhook_security_method
 
 
 class Security(AdCPBaseModel):

adcp/types/generated_poc/{brand_manifest.py → core/brand_manifest.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  brand-manifest.json
-#   timestamp: 2025-11-20T11:58:34+00:00
+#   filename:  core/brand_manifest.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 
@@ -10,7 +10,7 @@ from typing import Annotated, Any
 from adcp.types.base import AdCPBaseModel
 from pydantic import AnyUrl, AwareDatetime, ConfigDict, EmailStr, Field
 
-from . import asset_content_type
+from ..enums import asset_content_type
 
 
 class Asset(AdCPBaseModel):

adcp/types/generated_poc/core/context.py

@@ -0,0 +1,15 @@
+# generated by datamodel-codegen:
+#   filename:  core/context.json
+#   timestamp: 2025-11-22T15:23:24+00:00
+
+from __future__ import annotations
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict
+
+
+class ContextObject(AdCPBaseModel):
+    pass
+    model_config = ConfigDict(
+        extra='allow',
+    )

adcp/types/generated_poc/{creative_asset.py → core/creative_asset.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  creative-asset.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/creative_asset.json
+#   timestamp: 2025-11-22T19:54:03+00:00
 
 from __future__ import annotations
 
@@ -9,13 +9,15 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field
 
-from . import audio_asset, css_asset, daast_asset
 from . import format_id as format_id_1
-from . import (
+from . import promoted_offerings
+from .assets import (
+    audio_asset,
+    css_asset,
+    daast_asset,
     html_asset,
     image_asset,
     javascript_asset,
-    promoted_offerings,
     text_asset,
     url_asset,
     vast_asset,
@@ -69,7 +71,9 @@ class CreativeAsset(AdCPBaseModel):
     creative_id: Annotated[str, Field(description='Unique identifier for the creative')]
     format_id: Annotated[
         format_id_1.FormatId,
-        Field(description='Format identifier specifying which format this creative conforms to'),
+        Field(
+            description='Format identifier specifying which format this creative conforms to. Can be: (1) concrete format_id referencing a format with fixed dimensions, (2) template format_id referencing a template format, or (3) parameterized format_id with dimensions/duration parameters for template formats.'
+        ),
     ]
     inputs: Annotated[
         list[Input] | None,
@@ -78,6 +82,21 @@ class CreativeAsset(AdCPBaseModel):
         ),
     ] = None
     name: Annotated[str, Field(description='Human-readable creative name')]
+    placement_ids: Annotated[
+        list[str] | None,
+        Field(
+            description="Optional array of placement IDs where this creative should run when uploading via create_media_buy or update_media_buy. References placement_id values from the product's placements array. If omitted, creative runs on all placements. Only used during upload to media buy - not stored in creative library.",
+            min_length=1,
+        ),
+    ] = None
     tags: Annotated[
         list[str] | None, Field(description='User-defined tags for organization and searchability')
     ] = None
+    weight: Annotated[
+        float | None,
+        Field(
+            description='Optional delivery weight for creative rotation when uploading via create_media_buy or update_media_buy (0-100). If omitted, platform determines rotation. Only used during upload to media buy - not stored in creative library.',
+            ge=0.0,
+            le=100.0,
+        ),
+    ] = None

adcp/types/generated_poc/{creative_assignment.py → core/creative_assignment.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  creative-assignment.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/creative_assignment.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations