adcp 2.12.2__py3-none-any.whl → 2.14.0__py3-none-any.whl

adcp/types/base.py

@@ -2,10 +2,189 @@ from __future__ import annotations
 
 """Base model for AdCP types with spec-compliant serialization."""
 
+from collections.abc import Callable
 from typing import Any
 
 from pydantic import BaseModel
 
+# Type alias to shorten long type annotations
+MessageFormatter = Callable[[Any], str]
+
+
+def _pluralize(count: int, singular: str, plural: str | None = None) -> str:
+    """Return singular or plural form based on count."""
+    if count == 1:
+        return singular
+    return plural if plural else f"{singular}s"
+
+
+# Registry of human-readable message formatters for response types.
+# Key is the class name, value is a callable that takes the instance and returns a message.
+_RESPONSE_MESSAGE_REGISTRY: dict[str, MessageFormatter] = {}
+
+
+def _register_response_message(cls_name: str) -> Callable[[MessageFormatter], MessageFormatter]:
+    """Decorator to register a message formatter for a response type."""
+
+    def decorator(func: MessageFormatter) -> MessageFormatter:
+        _RESPONSE_MESSAGE_REGISTRY[cls_name] = func
+        return func
+
+    return decorator
+
+
+# Response message formatters
+@_register_response_message("GetProductsResponse")
+def _get_products_message(self: Any) -> str:
+    products = getattr(self, "products", None)
+    if products is None or len(products) == 0:
+        return "No products matched your requirements."
+    count = len(products)
+    return f"Found {count} {_pluralize(count, 'product')} matching your requirements."
+
+
+@_register_response_message("ListCreativeFormatsResponse")
+def _list_creative_formats_message(self: Any) -> str:
+    formats = getattr(self, "formats", None)
+    if formats is None:
+        return "No creative formats found."
+    count = len(formats)
+    return f"Found {count} supported creative {_pluralize(count, 'format')}."
+
+
+@_register_response_message("GetSignalsResponse")
+def _get_signals_message(self: Any) -> str:
+    signals = getattr(self, "signals", None)
+    if signals is None:
+        return "No signals found."
+    count = len(signals)
+    return f"Found {count} {_pluralize(count, 'signal')} available for targeting."
+
+
+@_register_response_message("ListAuthorizedPropertiesResponse")
+def _list_authorized_properties_message(self: Any) -> str:
+    domains = getattr(self, "publisher_domains", None)
+    if domains is None:
+        return "No authorized properties found."
+    count = len(domains)
+    return f"Authorized to represent {count} publisher {_pluralize(count, 'domain')}."
+
+
+@_register_response_message("ListCreativesResponse")
+def _list_creatives_message(self: Any) -> str:
+    creatives = getattr(self, "creatives", None)
+    if creatives is None:
+        return "No creatives found."
+    count = len(creatives)
+    return f"Found {count} {_pluralize(count, 'creative')} in the system."
+
+
+@_register_response_message("CreateMediaBuyResponse1")
+def _create_media_buy_success_message(self: Any) -> str:
+    media_buy_id = getattr(self, "media_buy_id", None)
+    packages = getattr(self, "packages", None)
+    package_count = len(packages) if packages else 0
+    return (
+        f"Media buy {media_buy_id} created with "
+        f"{package_count} {_pluralize(package_count, 'package')}."
+    )
+
+
+@_register_response_message("CreateMediaBuyResponse2")
+def _create_media_buy_error_message(self: Any) -> str:
+    errors = getattr(self, "errors", None)
+    error_count = len(errors) if errors else 0
+    return f"Media buy creation failed with {error_count} {_pluralize(error_count, 'error')}."
+
+
+@_register_response_message("UpdateMediaBuyResponse1")
+def _update_media_buy_success_message(self: Any) -> str:
+    media_buy_id = getattr(self, "media_buy_id", None)
+    return f"Media buy {media_buy_id} updated successfully."
+
+
+@_register_response_message("UpdateMediaBuyResponse2")
+def _update_media_buy_error_message(self: Any) -> str:
+    errors = getattr(self, "errors", None)
+    error_count = len(errors) if errors else 0
+    return f"Media buy update failed with {error_count} {_pluralize(error_count, 'error')}."
+
+
+@_register_response_message("SyncCreativesResponse1")
+def _sync_creatives_success_message(self: Any) -> str:
+    creatives = getattr(self, "creatives", None)
+    creative_count = len(creatives) if creatives else 0
+    return f"Synced {creative_count} {_pluralize(creative_count, 'creative')} successfully."
+
+
+@_register_response_message("SyncCreativesResponse2")
+def _sync_creatives_error_message(self: Any) -> str:
+    errors = getattr(self, "errors", None)
+    error_count = len(errors) if errors else 0
+    return f"Creative sync failed with {error_count} {_pluralize(error_count, 'error')}."
+
+
+@_register_response_message("ActivateSignalResponse1")
+def _activate_signal_success_message(self: Any) -> str:
+    return "Signal activated successfully."
+
+
+@_register_response_message("ActivateSignalResponse2")
+def _activate_signal_error_message(self: Any) -> str:
+    errors = getattr(self, "errors", None)
+    error_count = len(errors) if errors else 0
+    return f"Signal activation failed with {error_count} {_pluralize(error_count, 'error')}."
+
+
+@_register_response_message("PreviewCreativeResponse1")
+def _preview_creative_single_message(self: Any) -> str:
+    previews = getattr(self, "previews", None)
+    preview_count = len(previews) if previews else 0
+    return f"Generated {preview_count} {_pluralize(preview_count, 'preview')}."
+
+
+@_register_response_message("PreviewCreativeResponse2")
+def _preview_creative_batch_message(self: Any) -> str:
+    results = getattr(self, "results", None)
+    result_count = len(results) if results else 0
+    return f"Generated previews for {result_count} {_pluralize(result_count, 'manifest')}."
+
+
+@_register_response_message("BuildCreativeResponse1")
+def _build_creative_success_message(self: Any) -> str:
+    return "Creative built successfully."
+
+
+@_register_response_message("BuildCreativeResponse2")
+def _build_creative_error_message(self: Any) -> str:
+    errors = getattr(self, "errors", None)
+    error_count = len(errors) if errors else 0
+    return f"Creative build failed with {error_count} {_pluralize(error_count, 'error')}."
+
+
+@_register_response_message("GetMediaBuyDeliveryResponse")
+def _get_media_buy_delivery_message(self: Any) -> str:
+    deliveries = getattr(self, "media_buy_deliveries", None)
+    if deliveries is None:
+        return "No delivery data available."
+    count = len(deliveries)
+    return f"Retrieved delivery data for {count} media {_pluralize(count, 'buy', 'buys')}."
+
+
+@_register_response_message("ProvidePerformanceFeedbackResponse1")
+def _provide_performance_feedback_success_message(self: Any) -> str:
+    return "Performance feedback recorded successfully."
+
+
+@_register_response_message("ProvidePerformanceFeedbackResponse2")
+def _provide_performance_feedback_error_message(self: Any) -> str:
+    errors = getattr(self, "errors", None)
+    error_count = len(errors) if errors else 0
+    return (
+        f"Performance feedback recording failed with "
+        f"{error_count} {_pluralize(error_count, 'error')}."
+    )
+
 
 class AdCPBaseModel(BaseModel):
     """Base model for AdCP types with spec-compliant serialization.
@@ -24,3 +203,17 @@ class AdCPBaseModel(BaseModel):
         if "exclude_none" not in kwargs:
             kwargs["exclude_none"] = True
         return super().model_dump_json(**kwargs)
+
+    def summary(self) -> str:
+        """Human-readable summary for protocol responses.
+
+        Returns a standardized human-readable message suitable for MCP tool
+        results, A2A task communications, and REST API responses.
+
+        For types without a registered formatter, returns a generic message
+        with the class name.
+        """
+        formatter = _RESPONSE_MESSAGE_REGISTRY.get(self.__class__.__name__)
+        if formatter:
+            return formatter(self)
+        return f"{self.__class__.__name__} response"

adcp/types/generated_poc/adagents.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  adagents.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2025-12-18T20:00:24+00:00
 
 from __future__ import annotations
 
@@ -19,7 +19,7 @@ class AuthorizedSalesAgents1(AdCPBaseModel):
     field_schema: Annotated[
         str | None,
         Field(alias='$schema', description='JSON Schema identifier for this adagents.json file'),
-    ] = 'https://adcontextprotocol.org/schemas/adagents.json'
+    ] = None
     authoritative_location: Annotated[
         AnyUrl,
         Field(
@@ -156,11 +156,7 @@ class AuthorizedAgents3(AdCPBaseModel):
         ),
     ]
     publisher_properties: Annotated[
-        list[
-            publisher_property_selector.PublisherPropertySelector1
-            | publisher_property_selector.PublisherPropertySelector2
-            | publisher_property_selector.PublisherPropertySelector3
-        ],
+        list[publisher_property_selector.PublisherPropertySelector],
         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',
             min_length=1,
@@ -202,7 +198,7 @@ class AuthorizedSalesAgents2(AdCPBaseModel):
     field_schema: Annotated[
         str | None,
         Field(alias='$schema', description='JSON Schema identifier for this adagents.json file'),
-    ] = 'https://adcontextprotocol.org/schemas/adagents.json'
+    ] = None
     authorized_agents: Annotated[
         list[AuthorizedAgents | AuthorizedAgents1 | AuthorizedAgents2 | AuthorizedAgents3],
         Field(
@@ -242,12 +238,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': 'https://adcontextprotocol.org/schemas/adagents.json',
+                    '$schema': '/schemas/latest/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',
+                    '$schema': '/schemas/latest/adagents.json',
                     'authorized_agents': [
                         {
                             'authorization_type': 'property_tags',
@@ -273,7 +269,7 @@ class AuthorizedSalesAgents(RootModel[AuthorizedSalesAgents1 | AuthorizedSalesAg
                     },
                 },
                 {
-                    '$schema': 'https://adcontextprotocol.org/schemas/adagents.json',
+                    '$schema': '/schemas/latest/adagents.json',
                     'authorized_agents': [
                         {
                             'authorization_type': 'property_tags',
@@ -338,7 +334,7 @@ class AuthorizedSalesAgents(RootModel[AuthorizedSalesAgents1 | AuthorizedSalesAg
                     },
                 },
                 {
-                    '$schema': 'https://adcontextprotocol.org/schemas/adagents.json',
+                    '$schema': '/schemas/latest/adagents.json',
                     'authorized_agents': [
                         {
                             'authorization_type': 'property_tags',
@@ -366,7 +362,7 @@ class AuthorizedSalesAgents(RootModel[AuthorizedSalesAgents1 | AuthorizedSalesAg
                     },
                 },
                 {
-                    '$schema': 'https://adcontextprotocol.org/schemas/adagents.json',
+                    '$schema': '/schemas/latest/adagents.json',
                     'authorized_agents': [
                         {
                             'authorization_type': 'publisher_properties',

adcp/types/generated_poc/core/activation_key.py

@@ -1,13 +1,13 @@
 # generated by datamodel-codegen:
 #   filename:  core/activation_key.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2025-12-11T15:09:37+00:00
 
 from __future__ import annotations
 
 from typing import Annotated, Literal
 
 from adcp.types.base import AdCPBaseModel
-from pydantic import ConfigDict, Field
+from pydantic import ConfigDict, Field, RootModel
 
 
 class ActivationKey1(AdCPBaseModel):
@@ -28,3 +28,13 @@ class ActivationKey2(AdCPBaseModel):
     key: Annotated[str, Field(description='The targeting parameter key')]
     type: Annotated[Literal['key_value'], Field(description='Key-value pair based targeting')]
     value: Annotated[str, Field(description='The targeting parameter value')]
+
+
+class ActivationKey(RootModel[ActivationKey1 | ActivationKey2]):
+    root: Annotated[
+        ActivationKey1 | ActivationKey2,
+        Field(
+            description="Universal identifier for using a signal on a destination platform. Can be either a segment ID or a key-value pair depending on the platform's targeting mechanism.",
+            title='Activation Key',
+        ),
+    ]

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

@@ -1,13 +1,13 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/daast_asset.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2025-12-11T15:09:37+00:00
 
 from __future__ import annotations
 
 from typing import Annotated, Literal
 
 from adcp.types.base import AdCPBaseModel
-from pydantic import AnyUrl, ConfigDict, Field
+from pydantic import AnyUrl, ConfigDict, Field, RootModel
 
 from ...enums import daast_tracking_event
 from ...enums import daast_version as daast_version_1
@@ -59,3 +59,13 @@ class DaastAsset2(AdCPBaseModel):
         list[daast_tracking_event.DaastTrackingEvent] | None,
         Field(description='Tracking events supported by this DAAST tag'),
     ] = None
+
+
+class DaastAsset(RootModel[DaastAsset1 | DaastAsset2]):
+    root: Annotated[
+        DaastAsset1 | DaastAsset2,
+        Field(
+            description='DAAST (Digital Audio Ad Serving Template) tag for third-party audio ad serving',
+            title='DAAST Asset',
+        ),
+    ]

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

@@ -1,19 +1,23 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/image_asset.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2025-12-18T20:00:24+00:00
 
 from __future__ import annotations
 
 from typing import Annotated
 
-from pydantic import AnyUrl, Field
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, ConfigDict, Field
 
-from ..dimensions import Dimensions
 
-
-class ImageAsset(Dimensions):
+class ImageAsset(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
     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
+    height: Annotated[int, Field(description='Height in pixels', ge=1)]
     url: Annotated[AnyUrl, Field(description='URL to the image asset')]
+    width: Annotated[int, Field(description='Width in pixels', ge=1)]

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

@@ -1,13 +1,13 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/vast_asset.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2025-12-11T15:09:37+00:00
 
 from __future__ import annotations
 
 from typing import Annotated, Literal
 
 from adcp.types.base import AdCPBaseModel
-from pydantic import AnyUrl, ConfigDict, Field
+from pydantic import AnyUrl, ConfigDict, Field, RootModel
 
 from ...enums import vast_tracking_event
 from ...enums import vast_version as vast_version_1
@@ -61,3 +61,13 @@ class VastAsset2(AdCPBaseModel):
         bool | None,
         Field(description='Whether VPAID (Video Player-Ad Interface Definition) is supported'),
     ] = None
+
+
+class VastAsset(RootModel[VastAsset1 | VastAsset2]):
+    root: Annotated[
+        VastAsset1 | VastAsset2,
+        Field(
+            description='VAST (Video Ad Serving Template) tag for third-party video ad serving',
+            title='VAST Asset',
+        ),
+    ]

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

@@ -1,17 +1,19 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/video_asset.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2025-12-18T20:00:24+00:00
 
 from __future__ import annotations
 
 from typing import Annotated
 
-from pydantic import AnyUrl, Field
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, ConfigDict, Field
 
-from ..dimensions import Dimensions
 
-
-class VideoAsset(Dimensions):
+class VideoAsset(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
     bitrate_kbps: Annotated[
         int | None, Field(description='Video bitrate in kilobits per second', ge=1)
     ] = None
@@ -21,4 +23,6 @@ class VideoAsset(Dimensions):
     format: Annotated[str | None, Field(description='Video file format (mp4, webm, mov, etc.)')] = (
         None
     )
+    height: Annotated[int, Field(description='Height in pixels', ge=1)]
     url: Annotated[AnyUrl, Field(description='URL to the video asset')]
+    width: Annotated[int, Field(description='Width in pixels', ge=1)]

adcp/types/generated_poc/core/async_response_data.py

@@ -0,0 +1,72 @@
+# generated by datamodel-codegen:
+#   filename:  core/async_response_data.json
+#   timestamp: 2025-12-11T15:09:37+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from pydantic import Field, RootModel
+
+from ..media_buy import (
+    create_media_buy_async_response_input_required,
+    create_media_buy_async_response_submitted,
+    create_media_buy_async_response_working,
+    create_media_buy_response,
+    get_products_async_response_input_required,
+    get_products_async_response_submitted,
+    get_products_async_response_working,
+    get_products_response,
+    sync_creatives_async_response_input_required,
+    sync_creatives_async_response_submitted,
+    sync_creatives_async_response_working,
+    sync_creatives_response,
+    update_media_buy_async_response_input_required,
+    update_media_buy_async_response_submitted,
+    update_media_buy_async_response_working,
+    update_media_buy_response,
+)
+
+
+class AdcpAsyncResponseData(
+    RootModel[
+        get_products_response.GetProductsResponse
+        | get_products_async_response_working.GetProductsWorking
+        | get_products_async_response_input_required.GetProductsInputRequired
+        | get_products_async_response_submitted.GetProductsSubmitted
+        | create_media_buy_response.CreateMediaBuyResponse
+        | create_media_buy_async_response_working.CreateMediaBuyWorking
+        | create_media_buy_async_response_input_required.CreateMediaBuyInputRequired
+        | create_media_buy_async_response_submitted.CreateMediaBuySubmitted
+        | update_media_buy_response.UpdateMediaBuyResponse
+        | update_media_buy_async_response_working.UpdateMediaBuyWorking
+        | update_media_buy_async_response_input_required.UpdateMediaBuyInputRequired
+        | update_media_buy_async_response_submitted.UpdateMediaBuySubmitted
+        | sync_creatives_response.SyncCreativesResponse
+        | sync_creatives_async_response_working.SyncCreativesWorking
+        | sync_creatives_async_response_input_required.SyncCreativesInputRequired
+        | sync_creatives_async_response_submitted.SyncCreativesSubmitted
+    ]
+):
+    root: Annotated[
+        get_products_response.GetProductsResponse
+        | get_products_async_response_working.GetProductsWorking
+        | get_products_async_response_input_required.GetProductsInputRequired
+        | get_products_async_response_submitted.GetProductsSubmitted
+        | create_media_buy_response.CreateMediaBuyResponse
+        | create_media_buy_async_response_working.CreateMediaBuyWorking
+        | create_media_buy_async_response_input_required.CreateMediaBuyInputRequired
+        | create_media_buy_async_response_submitted.CreateMediaBuySubmitted
+        | update_media_buy_response.UpdateMediaBuyResponse
+        | update_media_buy_async_response_working.UpdateMediaBuyWorking
+        | update_media_buy_async_response_input_required.UpdateMediaBuyInputRequired
+        | update_media_buy_async_response_submitted.UpdateMediaBuySubmitted
+        | sync_creatives_response.SyncCreativesResponse
+        | sync_creatives_async_response_working.SyncCreativesWorking
+        | sync_creatives_async_response_input_required.SyncCreativesInputRequired
+        | sync_creatives_async_response_submitted.SyncCreativesSubmitted,
+        Field(
+            description='Union of all possible data payloads for async task webhook responses. For completed/failed statuses, use the main task response schema. For working/input-required/submitted, use the status-specific schemas.',
+            title='AdCP Async Response Data',
+        ),
+    ]

adcp/types/generated_poc/core/brand_manifest_ref.py

@@ -0,0 +1,35 @@
+# generated by datamodel-codegen:
+#   filename:  core/brand_manifest_ref.json
+#   timestamp: 2025-12-11T15:09:37+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from pydantic import AnyUrl, Field, RootModel
+
+from . import brand_manifest
+
+
+class BrandManifestReference(RootModel[brand_manifest.BrandManifest | AnyUrl]):
+    root: Annotated[
+        brand_manifest.BrandManifest | AnyUrl,
+        Field(
+            description='Brand manifest provided either as an inline object or a URL string pointing to a hosted manifest',
+            examples=[
+                {
+                    'data': {
+                        'colors': {'primary': '#FF6B35'},
+                        'name': 'ACME Corporation',
+                        'url': 'https://acmecorp.com',
+                    },
+                    'description': 'Inline brand manifest',
+                },
+                {
+                    'data': 'https://cdn.acmecorp.com/brand-manifest.json',
+                    'description': 'URL string reference to hosted manifest',
+                },
+            ],
+            title='Brand Manifest Reference',
+        ),
+    ]

adcp/types/generated_poc/core/creative_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/creative_asset.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2025-12-11T15:09:37+00:00
 
 from __future__ import annotations
 
@@ -59,12 +59,10 @@ class CreativeAsset(AdCPBaseModel):
             | html_asset.HtmlAsset
             | css_asset.CssAsset
             | javascript_asset.JavascriptAsset
+            | vast_asset.VastAsset
+            | daast_asset.DaastAsset
             | promoted_offerings.PromotedOfferings
-            | url_asset.UrlAsset
-            | vast_asset.VastAsset1
-            | vast_asset.VastAsset2
-            | daast_asset.DaastAsset1
-            | daast_asset.DaastAsset2,
+            | url_asset.UrlAsset,
         ],
         Field(description='Assets required by the format, keyed by asset_role'),
     ]

adcp/types/generated_poc/core/creative_manifest.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/creative_manifest.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2025-12-11T15:09:37+00:00
 
 from __future__ import annotations
 
@@ -37,17 +37,15 @@ class CreativeManifest(AdCPBaseModel):
             image_asset.ImageAsset
             | video_asset.VideoAsset
             | audio_asset.AudioAsset
+            | vast_asset.VastAsset
             | text_asset.TextAsset
             | url_asset.UrlAsset
             | html_asset.HtmlAsset
             | javascript_asset.JavascriptAsset
             | webhook_asset.WebhookAsset
             | css_asset.CssAsset
-            | promoted_offerings.PromotedOfferings
-            | vast_asset.VastAsset1
-            | vast_asset.VastAsset2
-            | daast_asset.DaastAsset1
-            | daast_asset.DaastAsset2,
+            | daast_asset.DaastAsset
+            | promoted_offerings.PromotedOfferings,
         ],
         Field(
             description="Map of asset IDs to actual asset content. Each key MUST match an asset_id from the format's assets_required array (e.g., 'banner_image', 'clickthrough_url', 'video_file', 'vast_tag'). The asset_id is the technical identifier used to match assets to format requirements.\n\nIMPORTANT: Creative manifest validation MUST be performed in the context of the format specification. The format defines what type each asset_id should be, which eliminates any validation ambiguity."

adcp/types/generated_poc/core/deployment.py

@@ -1,13 +1,13 @@
 # generated by datamodel-codegen:
 #   filename:  core/deployment.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2025-12-11T15:09:37+00:00
 
 from __future__ import annotations
 
 from typing import Annotated, Literal
 
 from adcp.types.base import AdCPBaseModel
-from pydantic import AnyUrl, AwareDatetime, ConfigDict, Field
+from pydantic import AnyUrl, AwareDatetime, ConfigDict, Field, RootModel
 
 from . import activation_key as activation_key_1
 
@@ -18,10 +18,9 @@ class Deployment1(AdCPBaseModel):
     )
     account: Annotated[str | None, Field(description='Account identifier if applicable')] = None
     activation_key: Annotated[
-        activation_key_1.ActivationKey1 | activation_key_1.ActivationKey2 | None,
+        activation_key_1.ActivationKey | None,
         Field(
-            description='The key to use for targeting. Only present if is_live=true AND requester has access to this deployment.',
-            title='Activation Key',
+            description='The key to use for targeting. Only present if is_live=true AND requester has access to this deployment.'
         ),
     ] = None
     deployed_at: Annotated[
@@ -51,10 +50,9 @@ class Deployment2(AdCPBaseModel):
     )
     account: Annotated[str | None, Field(description='Account identifier if applicable')] = None
     activation_key: Annotated[
-        activation_key_1.ActivationKey1 | activation_key_1.ActivationKey2 | None,
+        activation_key_1.ActivationKey | None,
         Field(
-            description='The key to use for targeting. Only present if is_live=true AND requester has access to this deployment.',
-            title='Activation Key',
+            description='The key to use for targeting. Only present if is_live=true AND requester has access to this deployment.'
         ),
     ] = None
     agent_url: Annotated[AnyUrl, Field(description='URL identifying the deployment agent')]
@@ -76,3 +74,13 @@ class Deployment2(AdCPBaseModel):
         Literal['agent'],
         Field(description='Discriminator indicating this is an agent URL-based deployment'),
     ]
+
+
+class Deployment(RootModel[Deployment1 | Deployment2]):
+    root: Annotated[
+        Deployment1 | Deployment2,
+        Field(
+            description='A signal deployment to a specific deployment target with activation status and key',
+            title='Deployment',
+        ),
+    ]