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

adcp/types/generated_poc/{sync_creatives_request.py → media_buy/sync_creatives_request.py}

@@ -1,17 +1,19 @@
 # generated by datamodel-codegen:
-#   filename:  sync-creatives-request.json
-#   timestamp: 2025-11-21T12:49:05+00:00
+#   filename:  media_buy/sync_creatives_request.json
+#   timestamp: 2025-11-22T16:02:47+00:00
 
 from __future__ import annotations
 
-from typing import Annotated, Any
+from typing import Annotated
 
 from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field
 
-from . import creative_asset
-from . import push_notification_config as push_notification_config_1
-from . import validation_mode as validation_mode_1
+from ..core import context as context_1
+from ..core import creative_asset
+from ..core import ext as ext_1
+from ..core import push_notification_config as push_notification_config_1
+from ..enums import validation_mode as validation_mode_1
 
 
 class SyncCreativesRequest(AdCPBaseModel):
@@ -22,10 +24,12 @@ class SyncCreativesRequest(AdCPBaseModel):
         dict[str, list[str]] | None,
         Field(description='Optional bulk assignment of creatives to packages'),
     ] = None
-    context: Annotated[
-        dict[str, Any] | None,
+    context: context_1.ContextObject | None = None
+    creative_ids: Annotated[
+        list[str] | None,
         Field(
-            description='Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.'
+            description='Optional filter to limit sync scope to specific creative IDs. When provided, only these creatives will be created/updated. Other creatives in the library are unaffected. Useful for partial updates and error recovery.',
+            max_length=100,
         ),
     ] = None
     creatives: Annotated[
@@ -44,12 +48,7 @@ class SyncCreativesRequest(AdCPBaseModel):
             description='When true, preview changes without applying them. Returns what would be created/updated/deleted.'
         ),
     ] = False
-    patch: Annotated[
-        bool | None,
-        Field(
-            description='When true, only provided fields are updated (partial update). When false, entire creative is replaced (full upsert).'
-        ),
-    ] = False
+    ext: ext_1.ExtensionObject | None = None
     push_notification_config: Annotated[
         push_notification_config_1.PushNotificationConfig | None,
         Field(

adcp/types/generated_poc/{sync_creatives_response.py → media_buy/sync_creatives_response.py}

@@ -1,15 +1,18 @@
 # generated by datamodel-codegen:
-#   filename:  sync-creatives-response.json
-#   timestamp: 2025-11-21T12:49:05+00:00
+#   filename:  media_buy/sync_creatives_response.json
+#   timestamp: 2025-11-22T19:16:02+00:00
 
 from __future__ import annotations
 
-from typing import Annotated, Any
+from typing import Annotated
 
 from adcp.types.base import AdCPBaseModel
 from pydantic import AnyUrl, AwareDatetime, ConfigDict, Field, RootModel
 
-from . import creative_action, error
+from ..core import context as context_1
+from ..core import error
+from ..core import ext as ext_1
+from ..enums import creative_action
 
 
 class Creative(AdCPBaseModel):
@@ -64,12 +67,7 @@ class SyncCreativesResponse1(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    context: Annotated[
-        dict[str, Any] | None,
-        Field(
-            description='Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.'
-        ),
-    ] = None
+    context: context_1.ContextObject | None = None
     creatives: Annotated[
         list[Creative],
         Field(
@@ -79,18 +77,14 @@ class SyncCreativesResponse1(AdCPBaseModel):
     dry_run: Annotated[
         bool | None, Field(description='Whether this was a dry run (no actual changes made)')
     ] = None
+    ext: ext_1.ExtensionObject | None = None
 
 
 class SyncCreativesResponse2(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    context: Annotated[
-        dict[str, Any] | None,
-        Field(
-            description='Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.'
-        ),
-    ] = None
+    context: context_1.ContextObject | None = None
     errors: Annotated[
         list[error.Error],
         Field(
@@ -98,6 +92,7 @@ class SyncCreativesResponse2(AdCPBaseModel):
             min_length=1,
         ),
     ]
+    ext: ext_1.ExtensionObject | None = None
 
 
 class SyncCreativesResponse(RootModel[SyncCreativesResponse1 | SyncCreativesResponse2]):

adcp/types/generated_poc/{update_media_buy_request.py → media_buy/update_media_buy_request.py}

@@ -1,24 +1,26 @@
 # generated by datamodel-codegen:
-#   filename:  update-media-buy-request.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  media_buy/update_media_buy_request.json
+#   timestamp: 2025-11-22T16:02:47+00:00
 
 from __future__ import annotations
 
-from typing import Annotated, Any
+from typing import Annotated
 
 from adcp.types.base import AdCPBaseModel
 from pydantic import AwareDatetime, ConfigDict, Field, RootModel
 
-from . import pacing as pacing_1
-from . import push_notification_config as push_notification_config_1
-from . import targeting
+from ..core import context as context_1
+from ..core import creative_asset, creative_assignment
+from ..core import ext as ext_1
+from ..core import push_notification_config as push_notification_config_1
+from ..core import targeting
+from ..enums import pacing as pacing_1
 
 
 class Packages(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    active: Annotated[bool | None, Field(description='Pause/resume specific package')] = None
     bid_price: Annotated[
         float | None,
         Field(
@@ -36,11 +38,29 @@ class Packages(AdCPBaseModel):
     buyer_ref: Annotated[
         str | None, Field(description="Buyer's reference for the package to update")
     ] = None
-    creative_ids: Annotated[list[str] | None, Field(description='Update creative assignments')] = (
-        None
-    )
+    creative_assignments: Annotated[
+        list[creative_assignment.CreativeAssignment] | None,
+        Field(
+            description='Full creative assignment objects with weights and placement targeting (alternative to creative_ids - provides granular control over weights and placement targeting). Uses replacement semantics like creative_ids.'
+        ),
+    ] = None
+    creative_ids: Annotated[
+        list[str] | None,
+        Field(description='Update creative assignments (references existing library creatives)'),
+    ] = None
+    creatives: Annotated[
+        list[creative_asset.CreativeAsset] | None,
+        Field(
+            description='Full creative objects to upload and assign to this package (alternative to creative_ids - creatives will be added to library). Supports both static and generative creatives.',
+            max_length=100,
+        ),
+    ] = None
     pacing: pacing_1.Pacing | None = None
     package_id: Annotated[str, Field(description="Publisher's ID of package to update")]
+    paused: Annotated[
+        bool | None,
+        Field(description='Pause/resume specific package (true = paused, false = active)'),
+    ] = None
     targeting_overlay: targeting.TargetingOverlay | None = None
 
 
@@ -48,7 +68,6 @@ class Packages1(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    active: Annotated[bool | None, Field(description='Pause/resume specific package')] = None
     bid_price: Annotated[
         float | None,
         Field(
@@ -64,13 +83,31 @@ class Packages1(AdCPBaseModel):
         ),
     ] = None
     buyer_ref: Annotated[str, Field(description="Buyer's reference for the package to update")]
-    creative_ids: Annotated[list[str] | None, Field(description='Update creative assignments')] = (
-        None
-    )
+    creative_assignments: Annotated[
+        list[creative_assignment.CreativeAssignment] | None,
+        Field(
+            description='Full creative assignment objects with weights and placement targeting (alternative to creative_ids - provides granular control over weights and placement targeting). Uses replacement semantics like creative_ids.'
+        ),
+    ] = None
+    creative_ids: Annotated[
+        list[str] | None,
+        Field(description='Update creative assignments (references existing library creatives)'),
+    ] = None
+    creatives: Annotated[
+        list[creative_asset.CreativeAsset] | None,
+        Field(
+            description='Full creative objects to upload and assign to this package (alternative to creative_ids - creatives will be added to library). Supports both static and generative creatives.',
+            max_length=100,
+        ),
+    ] = None
     pacing: pacing_1.Pacing | None = None
     package_id: Annotated[str | None, Field(description="Publisher's ID of package to update")] = (
         None
     )
+    paused: Annotated[
+        bool | None,
+        Field(description='Pause/resume specific package (true = paused, false = active)'),
+    ] = None
     targeting_overlay: targeting.TargetingOverlay | None = None
 
 
@@ -78,23 +115,22 @@ class UpdateMediaBuyRequest1(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    active: Annotated[bool | None, Field(description='Pause/resume the entire media buy')] = None
     buyer_ref: Annotated[
         str | None, Field(description="Buyer's reference for the media buy to update")
     ] = None
-    context: Annotated[
-        dict[str, Any] | None,
-        Field(
-            description='Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.'
-        ),
-    ] = None
+    context: context_1.ContextObject | None = None
     end_time: Annotated[
         AwareDatetime | None, Field(description='New end date/time in ISO 8601 format')
     ] = None
+    ext: ext_1.ExtensionObject | None = None
     media_buy_id: Annotated[str, Field(description="Publisher's ID of the media buy to update")]
     packages: Annotated[
         list[Packages | Packages1] | None, Field(description='Package-specific updates')
     ] = None
+    paused: Annotated[
+        bool | None,
+        Field(description='Pause/resume the entire media buy (true = paused, false = active)'),
+    ] = None
     push_notification_config: Annotated[
         push_notification_config_1.PushNotificationConfig | None,
         Field(
@@ -119,23 +155,22 @@ class UpdateMediaBuyRequest2(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    active: Annotated[bool | None, Field(description='Pause/resume the entire media buy')] = None
     buyer_ref: Annotated[str, Field(description="Buyer's reference for the media buy to update")]
-    context: Annotated[
-        dict[str, Any] | None,
-        Field(
-            description='Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.'
-        ),
-    ] = None
+    context: context_1.ContextObject | None = None
     end_time: Annotated[
         AwareDatetime | None, Field(description='New end date/time in ISO 8601 format')
     ] = None
+    ext: ext_1.ExtensionObject | None = None
     media_buy_id: Annotated[
         str | None, Field(description="Publisher's ID of the media buy to update")
     ] = None
     packages: Annotated[
         list[Packages2 | Packages3] | None, Field(description='Package-specific updates')
     ] = None
+    paused: Annotated[
+        bool | None,
+        Field(description='Pause/resume the entire media buy (true = paused, false = active)'),
+    ] = None
     push_notification_config: Annotated[
         push_notification_config_1.PushNotificationConfig | None,
         Field(

adcp/types/generated_poc/{update_media_buy_response.py → media_buy/update_media_buy_response.py}

@@ -1,31 +1,30 @@
 # generated by datamodel-codegen:
-#   filename:  update-media-buy-response.json
-#   timestamp: 2025-11-20T11:58:34+00:00
+#   filename:  media_buy/update_media_buy_response.json
+#   timestamp: 2025-11-22T19:16:02+00:00
 
 from __future__ import annotations
 
-from typing import Annotated, Any
+from typing import Annotated
 
 from adcp.types.base import AdCPBaseModel
 from pydantic import AwareDatetime, ConfigDict, Field, RootModel
 
-from . import error, package
+from ..core import context as context_1
+from ..core import error
+from ..core import ext as ext_1
+from ..core import package
 
 
 class UpdateMediaBuyResponse2(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    context: Annotated[
-        dict[str, Any] | None,
-        Field(
-            description='Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.'
-        ),
-    ] = None
+    context: context_1.ContextObject | None = None
     errors: Annotated[
         list[error.Error],
         Field(description='Array of errors explaining why the operation failed', min_length=1),
     ]
+    ext: ext_1.ExtensionObject | None = None
 
 
 class UpdateMediaBuyResponse1(AdCPBaseModel):
@@ -37,12 +36,8 @@ class UpdateMediaBuyResponse1(AdCPBaseModel):
         Field(description='Array of packages that were modified with complete state information'),
     ] = None
     buyer_ref: Annotated[str, Field(description="Buyer's reference identifier for the media buy")]
-    context: Annotated[
-        dict[str, Any] | None,
-        Field(
-            description='Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.'
-        ),
-    ] = None
+    context: context_1.ContextObject | None = None
+    ext: ext_1.ExtensionObject | None = None
     implementation_date: Annotated[
         AwareDatetime | None,
         Field(description='ISO 8601 timestamp when changes take effect (null if pending approval)'),

adcp/types/generated_poc/pricing_options/__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/{cpc_option.py → pricing_options/cpc_option.py}

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

adcp/types/generated_poc/{cpcv_option.py → pricing_options/cpcv_option.py}

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

adcp/types/generated_poc/{cpm_auction_option.py → pricing_options/cpm_auction_option.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  cpm-auction-option.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  pricing_options/cpm_auction_option.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/{cpm_fixed_option.py → pricing_options/cpm_fixed_option.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  cpm-fixed-option.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  pricing_options/cpm_fixed_option.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/{cpp_option.py → pricing_options/cpp_option.py}

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

adcp/types/generated_poc/{cpv_option.py → pricing_options/cpv_option.py}

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

adcp/types/generated_poc/{flat_rate_option.py → pricing_options/flat_rate_option.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  flat-rate-option.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  pricing_options/flat_rate_option.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/{vcpm_auction_option.py → pricing_options/vcpm_auction_option.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  vcpm-auction-option.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  pricing_options/vcpm_auction_option.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/{vcpm_fixed_option.py → pricing_options/vcpm_fixed_option.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  vcpm-fixed-option.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  pricing_options/vcpm_fixed_option.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/protocols/__init__.py

@@ -0,0 +1,3 @@
+# generated by datamodel-codegen:
+#   filename:  .schema_temp
+#   timestamp: 2025-11-22T16:02:47+00:00

adcp/types/generated_poc/protocols/adcp_extension.py

@@ -0,0 +1,37 @@
+# generated by datamodel-codegen:
+#   filename:  protocols/adcp_extension.json
+#   timestamp: 2025-11-22T16:02:47+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+
+class ProtocolsSupportedEnum(Enum):
+    media_buy = 'media_buy'
+    creative = 'creative'
+    signals = 'signals'
+
+
+class AdcpAgentCardExtension(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    adcp_version: Annotated[
+        str,
+        Field(
+            description="Semantic version of the AdCP specification this agent implements (e.g., '2.4.0')",
+            pattern='^\\d+\\.\\d+\\.\\d+$',
+        ),
+    ]
+    protocols_supported: Annotated[
+        list[ProtocolsSupportedEnum],
+        Field(
+            description='AdCP protocol domains supported by this agent. At least one must be specified.',
+            min_length=1,
+        ),
+    ]

adcp/types/generated_poc/signals/__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/{activate_signal_request.py → signals/activate_signal_request.py}

@@ -1,27 +1,24 @@
 # generated by datamodel-codegen:
-#   filename:  activate-signal-request.json
-#   timestamp: 2025-11-20T20:44:40+00:00
+#   filename:  signals/activate_signal_request.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 
-from typing import Annotated, Any
+from typing import Annotated
 
 from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field
 
-from . import destination
+from ..core import context as context_1
+from ..core import destination
+from ..core import ext as ext_1
 
 
 class ActivateSignalRequest(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    context: Annotated[
-        dict[str, Any] | None,
-        Field(
-            description='Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.'
-        ),
-    ] = None
+    context: context_1.ContextObject | None = None
     deployments: Annotated[
         list[destination.Destination1 | destination.Destination2],
         Field(
@@ -29,6 +26,7 @@ class ActivateSignalRequest(AdCPBaseModel):
             min_length=1,
         ),
     ]
+    ext: ext_1.ExtensionObject | None = None
     signal_agent_segment_id: Annotated[
         str, Field(description='The universal identifier for the signal to activate')
     ]

adcp/types/generated_poc/{activate_signal_response.py → signals/activate_signal_response.py}

@@ -1,43 +1,36 @@
 # generated by datamodel-codegen:
-#   filename:  activate-signal-response.json
-#   timestamp: 2025-11-20T20:44:40+00:00
+#   filename:  signals/activate_signal_response.json
+#   timestamp: 2025-11-22T19:16:02+00:00
 
 from __future__ import annotations
 
-from typing import Annotated, Any
+from typing import Annotated
 
 from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field, RootModel
 
-from . import deployment, error
+from ..core import context as context_1
+from ..core import deployment, error
+from ..core import ext as ext_1
 
 
 class ActivateSignalResponse1(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    context: Annotated[
-        dict[str, Any] | None,
-        Field(
-            description='Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.'
-        ),
-    ] = None
+    context: context_1.ContextObject | None = None
     deployments: Annotated[
         list[deployment.Deployment1 | deployment.Deployment2],
         Field(description='Array of deployment results for each deployment target'),
     ]
+    ext: ext_1.ExtensionObject | None = None
 
 
 class ActivateSignalResponse2(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    context: Annotated[
-        dict[str, Any] | None,
-        Field(
-            description='Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.'
-        ),
-    ] = None
+    context: context_1.ContextObject | None = None
     errors: Annotated[
         list[error.Error],
         Field(
@@ -45,6 +38,7 @@ class ActivateSignalResponse2(AdCPBaseModel):
             min_length=1,
         ),
     ]
+    ext: ext_1.ExtensionObject | None = None
 
 
 class ActivateSignalResponse(RootModel[ActivateSignalResponse1 | ActivateSignalResponse2]):

adcp/types/generated_poc/{get_signals_request.py → signals/get_signals_request.py}

@@ -1,15 +1,18 @@
 # generated by datamodel-codegen:
-#   filename:  get-signals-request.json
-#   timestamp: 2025-11-21T12:49:05+00:00
+#   filename:  signals/get_signals_request.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 
-from typing import Annotated, Any
+from typing import Annotated
 
 from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field, RootModel
 
-from . import destination, signal_filters
+from ..core import context as context_1
+from ..core import destination
+from ..core import ext as ext_1
+from ..core import signal_filters
 
 
 class Country(RootModel[str]):
@@ -36,15 +39,11 @@ class GetSignalsRequest(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    context: Annotated[
-        dict[str, Any] | None,
-        Field(
-            description='Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.'
-        ),
-    ] = None
+    context: context_1.ContextObject | None = None
     deliver_to: Annotated[
         DeliverTo, Field(description='Deployment targets where signals need to be activated')
     ]
+    ext: ext_1.ExtensionObject | None = None
     filters: signal_filters.SignalFilters | None = None
     max_results: Annotated[
         int | None, Field(description='Maximum number of results to return', ge=1)