adcp 2.2.0__tar.gz → 2.4.0__tar.gz

{adcp-2.2.0/src/adcp.egg-info → adcp-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: adcp
-Version: 2.2.0
+Version: 2.4.0
 Summary: Official Python client for the Ad Context Protocol (AdCP)
 Author-email: AdCP Community <maintainers@adcontextprotocol.org>
 License: Apache-2.0
@@ -26,6 +26,7 @@ Requires-Dist: pydantic>=2.0.0
 Requires-Dist: typing-extensions>=4.5.0
 Requires-Dist: a2a-sdk>=0.3.0
 Requires-Dist: mcp>=0.9.0
+Requires-Dist: email-validator>=2.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
@@ -34,7 +35,6 @@ Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: datamodel-code-generator[http]>=0.35.0; extra == "dev"
-Requires-Dist: email-validator>=2.0.0; extra == "dev"
 Dynamic: license-file
 
 # adcp - Python Client for Ad Context Protocol
@@ -544,6 +544,42 @@ is_authorized = await verify_agent_for_property(
 
 See `examples/adagents_validation.py` for complete examples.
 
+### Authorization Discovery
+
+Discover which publishers have authorized your agent using two approaches:
+
+**1. "Push" Approach** - Ask the agent (recommended, fastest):
+```python
+from adcp import ADCPClient
+
+async with ADCPClient(agent_config) as client:
+    # Single API call to agent
+    response = await client.simple.list_authorized_properties()
+    print(f"Authorized for: {response.publisher_domains}")
+```
+
+**2. "Pull" Approach** - Check publisher adagents.json files (when you need property details):
+```python
+from adcp import fetch_agent_authorizations
+
+# Check specific publishers (fetches in parallel)
+contexts = await fetch_agent_authorizations(
+    "https://our-sales-agent.com",
+    ["nytimes.com", "wsj.com", "cnn.com"]
+)
+
+for domain, ctx in contexts.items():
+    print(f"{domain}:")
+    print(f"  Property IDs: {ctx.property_ids}")
+    print(f"  Tags: {ctx.property_tags}")
+```
+
+**When to use which:**
+- **Push**: Quick discovery, portfolio overview, high-level authorization check
+- **Pull**: Property-level details, specific publisher list, works offline
+
+See `examples/fetch_agent_authorizations.py` for complete examples.
+
 ## CLI Tool
 
 The `adcp` command-line tool provides easy interaction with AdCP agents without writing code.

{adcp-2.2.0 → adcp-2.4.0}/README.md

@@ -505,6 +505,42 @@ is_authorized = await verify_agent_for_property(
 
 See `examples/adagents_validation.py` for complete examples.
 
+### Authorization Discovery
+
+Discover which publishers have authorized your agent using two approaches:
+
+**1. "Push" Approach** - Ask the agent (recommended, fastest):
+```python
+from adcp import ADCPClient
+
+async with ADCPClient(agent_config) as client:
+    # Single API call to agent
+    response = await client.simple.list_authorized_properties()
+    print(f"Authorized for: {response.publisher_domains}")
+```
+
+**2. "Pull" Approach** - Check publisher adagents.json files (when you need property details):
+```python
+from adcp import fetch_agent_authorizations
+
+# Check specific publishers (fetches in parallel)
+contexts = await fetch_agent_authorizations(
+    "https://our-sales-agent.com",
+    ["nytimes.com", "wsj.com", "cnn.com"]
+)
+
+for domain, ctx in contexts.items():
+    print(f"{domain}:")
+    print(f"  Property IDs: {ctx.property_ids}")
+    print(f"  Tags: {ctx.property_tags}")
+```
+
+**When to use which:**
+- **Push**: Quick discovery, portfolio overview, high-level authorization check
+- **Pull**: Property-level details, specific publisher list, works offline
+
+See `examples/fetch_agent_authorizations.py` for complete examples.
+
 ## CLI Tool
 
 The `adcp` command-line tool provides easy interaction with AdCP agents without writing code.

{adcp-2.2.0 → adcp-2.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "adcp"
-version = "2.2.0"
+version = "2.4.0"
 description = "Official Python client for the Ad Context Protocol (AdCP)"
 authors = [
     {name = "AdCP Community", email = "maintainers@adcontextprotocol.org"}
@@ -31,6 +31,7 @@ dependencies = [
     "typing-extensions>=4.5.0",
     "a2a-sdk>=0.3.0",
     "mcp>=0.9.0",
+    "email-validator>=2.0.0",
 ]
 
 [project.scripts]
@@ -45,7 +46,6 @@ dev = [
     "black>=23.0.0",
     "ruff>=0.1.0",
     "datamodel-code-generator[http]>=0.35.0",
-    "email-validator>=2.0.0",
 ]
 
 [project.urls]

{adcp-2.2.0 → adcp-2.4.0}/src/adcp/__init__.py

@@ -8,8 +8,10 @@ Supports both A2A and MCP protocols with full type safety.
 """
 
 from adcp.adagents import (
+    AuthorizationContext,
     domain_matches,
     fetch_adagents,
+    fetch_agent_authorizations,
     get_all_properties,
     get_all_tags,
     get_properties_by_agent,
@@ -134,7 +136,7 @@ from adcp.validation import (
     validate_publisher_properties_item,
 )
 
-__version__ = "2.2.0"
+__version__ = "2.4.0"
 
 __all__ = [
     # Client classes
@@ -178,7 +180,9 @@ __all__ = [
     "Product",
     "Property",
     # Adagents validation
+    "AuthorizationContext",
     "fetch_adagents",
+    "fetch_agent_authorizations",
     "verify_agent_authorization",
     "verify_agent_for_property",
     "domain_matches",

{adcp-2.2.0 → adcp-2.4.0}/src/adcp/adagents.py

@@ -518,3 +518,125 @@ def get_properties_by_agent(adagents_data: dict[str, Any], agent_url: str) -> li
         return [p for p in properties if isinstance(p, dict)]
 
     return []
+
+
+class AuthorizationContext:
+    """Authorization context for a publisher domain.
+
+    Attributes:
+        property_ids: List of property IDs the agent is authorized for
+        property_tags: List of property tags the agent is authorized for
+        raw_properties: Raw property data from adagents.json
+    """
+
+    def __init__(self, properties: list[dict[str, Any]]):
+        """Initialize from list of properties.
+
+        Args:
+            properties: List of property dictionaries from adagents.json
+        """
+        self.property_ids: list[str] = []
+        self.property_tags: list[str] = []
+        self.raw_properties = properties
+
+        # Extract property IDs and tags
+        for prop in properties:
+            if not isinstance(prop, dict):
+                continue
+
+            # Extract property ID
+            prop_id = prop.get("id")
+            if prop_id and isinstance(prop_id, str):
+                self.property_ids.append(prop_id)
+
+            # Extract tags
+            tags = prop.get("tags", [])
+            if isinstance(tags, list):
+                for tag in tags:
+                    if isinstance(tag, str) and tag not in self.property_tags:
+                        self.property_tags.append(tag)
+
+    def __repr__(self) -> str:
+        return (
+            f"AuthorizationContext("
+            f"property_ids={self.property_ids}, "
+            f"property_tags={self.property_tags})"
+        )
+
+
+async def fetch_agent_authorizations(
+    agent_url: str,
+    publisher_domains: list[str],
+    timeout: float = 10.0,
+    client: httpx.AsyncClient | None = None,
+) -> dict[str, AuthorizationContext]:
+    """Fetch authorization contexts by checking publisher adagents.json files.
+
+    This function discovers what publishers have authorized your agent by fetching
+    their adagents.json files from the .well-known directory and extracting the
+    properties your agent can access.
+
+    This is the "pull" approach - you query publishers to see if they've authorized you.
+    For the "push" approach where the agent tells you what it's authorized for,
+    use the agent's list_authorized_properties endpoint via ADCPClient.
+
+    Args:
+        agent_url: URL of your sales agent
+        publisher_domains: List of publisher domains to check (e.g., ["nytimes.com", "wsj.com"])
+        timeout: Request timeout in seconds for each fetch
+        client: Optional httpx.AsyncClient for connection pooling
+
+    Returns:
+        Dictionary mapping publisher domain to AuthorizationContext.
+        Only includes domains where the agent is authorized.
+
+    Example:
+        >>> # "Pull" approach - check what publishers have authorized you
+        >>> contexts = await fetch_agent_authorizations(
+        ...     "https://our-sales-agent.com",
+        ...     ["nytimes.com", "wsj.com", "cnn.com"]
+        ... )
+        >>> for domain, ctx in contexts.items():
+        ...     print(f"{domain}:")
+        ...     print(f"  Property IDs: {ctx.property_ids}")
+        ...     print(f"  Tags: {ctx.property_tags}")
+
+    See Also:
+        ADCPClient.list_authorized_properties: "Push" approach using the agent's API
+
+    Notes:
+        - Silently skips domains where adagents.json is not found or invalid
+        - Only returns domains where the agent is explicitly authorized
+        - For production use with many domains, pass a shared httpx.AsyncClient
+          to enable connection pooling
+    """
+    import asyncio
+
+    # Create tasks to fetch all adagents.json files in parallel
+    async def fetch_authorization_for_domain(
+        domain: str,
+    ) -> tuple[str, AuthorizationContext | None]:
+        """Fetch authorization context for a single domain."""
+        try:
+            adagents_data = await fetch_adagents(domain, timeout=timeout, client=client)
+
+            # Check if agent is authorized
+            if not verify_agent_authorization(adagents_data, agent_url):
+                return (domain, None)
+
+            # Get properties for this agent
+            properties = get_properties_by_agent(adagents_data, agent_url)
+
+            # Create authorization context
+            return (domain, AuthorizationContext(properties))
+
+        except (AdagentsNotFoundError, AdagentsValidationError, AdagentsTimeoutError):
+            # Silently skip domains with missing or invalid adagents.json
+            return (domain, None)
+
+    # Fetch all domains in parallel
+    tasks = [fetch_authorization_for_domain(domain) for domain in publisher_domains]
+    results = await asyncio.gather(*tasks)
+
+    # Build result dictionary, filtering out None values
+    return {domain: ctx for domain, ctx in results if ctx is not None}

adcp-2.4.0/src/adcp/types/generated.py

@@ -0,0 +1,119 @@
+"""Generated AdCP types.
+
+Auto-generated by datamodel-code-generator from JSON schemas.
+DO NOT EDIT MANUALLY.
+
+Generated from: https://github.com/adcontextprotocol/adcp/tree/main/schemas
+Generation date: 2025-11-18 03:04:43 UTC
+"""
+
+from __future__ import annotations
+
+# Import all types from generated_poc modules
+from adcp.types.generated_poc.activate_signal_request import ActivateSignalRequest
+from adcp.types.generated_poc.activate_signal_response import ActivateSignalResponse, ActivateSignalResponse1, ActivateSignalResponse2
+from adcp.types.generated_poc.activation_key import ActivationKey1, ActivationKey2
+from adcp.types.generated_poc.adagents import AuthorizedAgents, AuthorizedAgents1, AuthorizedAgents2, AuthorizedAgents3, AuthorizedSalesAgents, Contact, PropertyId, PropertyTag, PublisherProperties, PublisherProperties1, Tags
+from adcp.types.generated_poc.asset_type import AssetTypeSchema, ContentLength, Dimensions, Duration, FileSize, Quality, Requirements, Type
+from adcp.types.generated_poc.audio_asset import AudioAsset
+from adcp.types.generated_poc.brand_manifest import Asset, Asset1, AssetType, BrandManifest1, BrandManifest2, Colors, Disclaimer, FeedFormat, Fonts, Logo, Metadata, ProductCatalog, ProductCatalog1, UpdateFrequency
+from adcp.types.generated_poc.brand_manifest_ref import BrandManifest, BrandManifestReference
+from adcp.types.generated_poc.build_creative_request import BuildCreativeRequest
+from adcp.types.generated_poc.build_creative_response import BuildCreativeResponse, BuildCreativeResponse1, BuildCreativeResponse2
+from adcp.types.generated_poc.channels import AdvertisingChannels
+from adcp.types.generated_poc.cpc_option import CpcPricingOption
+from adcp.types.generated_poc.cpcv_option import CpcvPricingOption
+from adcp.types.generated_poc.cpm_auction_option import CpmAuctionPricingOption, PriceGuidance
+from adcp.types.generated_poc.cpm_fixed_option import CpmFixedRatePricingOption
+from adcp.types.generated_poc.cpp_option import CppPricingOption, Parameters
+from adcp.types.generated_poc.cpv_option import CpvPricingOption, ViewThreshold, ViewThreshold1
+from adcp.types.generated_poc.create_media_buy_request import CreateMediaBuyRequest, ReportingFrequency, ReportingWebhook, RequestedMetric
+from adcp.types.generated_poc.create_media_buy_response import CreateMediaBuyResponse, CreateMediaBuyResponse1, CreateMediaBuyResponse2, Package
+from adcp.types.generated_poc.creative_asset import CreativeAsset, Input
+from adcp.types.generated_poc.creative_assignment import CreativeAssignment
+from adcp.types.generated_poc.creative_manifest import CreativeManifest
+from adcp.types.generated_poc.creative_policy import CoBranding, CreativePolicy, LandingPage
+from adcp.types.generated_poc.creative_status import CreativeStatus
+from adcp.types.generated_poc.css_asset import CssAsset
+from adcp.types.generated_poc.daast_asset import DaastAsset1, DaastAsset2, DaastVersion, TrackingEvent
+from adcp.types.generated_poc.delivery_metrics import DeliveryMetrics, DoohMetrics, QuartileData, VenueBreakdownItem
+from adcp.types.generated_poc.delivery_type import DeliveryType
+from adcp.types.generated_poc.deployment import Deployment1, Deployment2
+from adcp.types.generated_poc.destination import Destination1, Destination2
+from adcp.types.generated_poc.error import Error
+from adcp.types.generated_poc.flat_rate_option import FlatRatePricingOption
+from adcp.types.generated_poc.format import AssetsRequired, AssetsRequired1, Format, FormatCard, FormatCardDetailed, Render, Responsive, Unit
+from adcp.types.generated_poc.format_id import FormatId
+from adcp.types.generated_poc.frequency_cap import FrequencyCap
+from adcp.types.generated_poc.frequency_cap_scope import FrequencyCapScope
+from adcp.types.generated_poc.get_media_buy_delivery_request import GetMediaBuyDeliveryRequest, StatusFilter, StatusFilterEnum
+from adcp.types.generated_poc.get_media_buy_delivery_response import AggregatedTotals, ByPackageItem, DailyBreakdownItem, GetMediaBuyDeliveryResponse, MediaBuyDelivery, NotificationType, ReportingPeriod, Status, Totals
+from adcp.types.generated_poc.get_products_request import Filters, FormatType, GetProductsRequest
+from adcp.types.generated_poc.get_products_response import GetProductsResponse
+from adcp.types.generated_poc.get_signals_request import CatalogType, Country, DeliverTo, GetSignalsRequest
+from adcp.types.generated_poc.get_signals_response import GetSignalsResponse, Pricing, Signal, SignalType
+from adcp.types.generated_poc.html_asset import HtmlAsset
+from adcp.types.generated_poc.identifier_types import PropertyIdentifierTypes
+from adcp.types.generated_poc.image_asset import ImageAsset
+from adcp.types.generated_poc.index import AdcpAssetTypeRegistry
+from adcp.types.generated_poc.javascript_asset import JavascriptAsset, ModuleType
+from adcp.types.generated_poc.list_authorized_properties_request import ListAuthorizedPropertiesRequest, PublisherDomain
+from adcp.types.generated_poc.list_authorized_properties_response import ListAuthorizedPropertiesResponse, PrimaryCountry
+from adcp.types.generated_poc.list_creative_formats_request import ListCreativeFormatsRequest
+from adcp.types.generated_poc.list_creative_formats_response import Capability, CreativeAgent, ListCreativeFormatsResponse
+from adcp.types.generated_poc.list_creatives_request import Direction, Field1, FieldModel, ListCreativesRequest, Pagination, Sort
+from adcp.types.generated_poc.list_creatives_response import AssignedPackage, Assignments, Creative, ListCreativesResponse, Performance, QuerySummary, SortApplied, StatusSummary
+from adcp.types.generated_poc.markdown_asset import MarkdownAsset, MarkdownFlavor
+from adcp.types.generated_poc.measurement import Measurement
+from adcp.types.generated_poc.media_buy import MediaBuy
+from adcp.types.generated_poc.media_buy_status import MediaBuyStatus
+from adcp.types.generated_poc.pacing import Pacing
+from adcp.types.generated_poc.package_request import PackageRequest
+from adcp.types.generated_poc.package_status import PackageStatus
+from adcp.types.generated_poc.performance_feedback import FeedbackSource, MeasurementPeriod, MetricType, PerformanceFeedback
+from adcp.types.generated_poc.placement import Placement
+from adcp.types.generated_poc.preview_creative_request import Input2, OutputFormat, PreviewCreativeRequest, PreviewCreativeRequest1, PreviewCreativeRequest2, Request
+from adcp.types.generated_poc.preview_creative_response import Input4, Preview, Preview1, Preview2, PreviewCreativeResponse, PreviewCreativeResponse1, PreviewCreativeResponse2, Response, Response1, Results, Results1
+from adcp.types.generated_poc.preview_render import Embedding, PreviewRender, PreviewRender1, PreviewRender2, PreviewRender3
+from adcp.types.generated_poc.pricing_model import PricingModel
+from adcp.types.generated_poc.pricing_option import CpcOption, CpcvOption, CpmAuctionOption, CpmFixedOption, CppOption, CpvOption, FlatRateOption, Parameters1, Parameters2, PriceGuidance1, PricingOption, VcpmAuctionOption, VcpmFixedOption
+from adcp.types.generated_poc.product import DeliveryMeasurement, Product, ProductCard, ProductCardDetailed, PublisherProperties3
+from adcp.types.generated_poc.promoted_offerings import AssetSelectors, Offering, PromotedOfferings
+from adcp.types.generated_poc.promoted_products import PromotedProducts
+from adcp.types.generated_poc.property import Identifier, Property, PropertyType, Tag
+from adcp.types.generated_poc.protocol_envelope import ProtocolEnvelope
+from adcp.types.generated_poc.provide_performance_feedback_request import ProvidePerformanceFeedbackRequest
+from adcp.types.generated_poc.provide_performance_feedback_response import ProvidePerformanceFeedbackResponse, ProvidePerformanceFeedbackResponse1, ProvidePerformanceFeedbackResponse2
+from adcp.types.generated_poc.publisher_identifier_types import PublisherIdentifierTypes
+from adcp.types.generated_poc.push_notification_config import Authentication, PushNotificationConfig, Scheme
+from adcp.types.generated_poc.reporting_capabilities import AvailableMetric, AvailableReportingFrequency, ReportingCapabilities
+from adcp.types.generated_poc.response import ProtocolResponse
+from adcp.types.generated_poc.standard_format_ids import StandardFormatIds
+from adcp.types.generated_poc.start_timing import StartTiming
+from adcp.types.generated_poc.sub_asset import SubAsset1, SubAsset2
+from adcp.types.generated_poc.sync_creatives_request import SyncCreativesRequest, ValidationMode
+from adcp.types.generated_poc.sync_creatives_response import Action, SyncCreativesResponse, SyncCreativesResponse1, SyncCreativesResponse2
+from adcp.types.generated_poc.targeting import GeoCountryAnyOfItem, TargetingOverlay
+from adcp.types.generated_poc.task_status import TaskStatus
+from adcp.types.generated_poc.task_type import TaskType
+from adcp.types.generated_poc.tasks_get_request import TasksGetRequest
+from adcp.types.generated_poc.tasks_get_response import Details, Domain, HistoryItem, Progress, TasksGetResponse
+from adcp.types.generated_poc.tasks_list_request import TasksListRequest
+from adcp.types.generated_poc.tasks_list_response import DomainBreakdown, Task, TasksListResponse
+from adcp.types.generated_poc.text_asset import TextAsset
+from adcp.types.generated_poc.update_media_buy_request import Packages, Packages1, Packages2, Packages3, UpdateMediaBuyRequest, UpdateMediaBuyRequest1, UpdateMediaBuyRequest2
+from adcp.types.generated_poc.update_media_buy_response import AffectedPackage, UpdateMediaBuyResponse, UpdateMediaBuyResponse1, UpdateMediaBuyResponse2
+from adcp.types.generated_poc.url_asset import UrlAsset, UrlType
+from adcp.types.generated_poc.vast_asset import VastAsset1, VastAsset2, VastVersion
+from adcp.types.generated_poc.vcpm_auction_option import VcpmAuctionPricingOption
+from adcp.types.generated_poc.vcpm_fixed_option import VcpmFixedRatePricingOption
+from adcp.types.generated_poc.video_asset import VideoAsset
+from adcp.types.generated_poc.webhook_asset import Method, Method1, ResponseType, Security, WebhookAsset
+from adcp.types.generated_poc.webhook_payload import WebhookPayload
+
+# Backward compatibility aliases for renamed types
+BrandManifestRef = BrandManifestReference
+Channels = AdvertisingChannels
+
+# Explicit exports
+__all__ = ['Action', 'ActivateSignalRequest', 'ActivateSignalResponse', 'ActivateSignalResponse1', 'ActivateSignalResponse2', 'ActivationKey1', 'ActivationKey2', 'AdcpAssetTypeRegistry', 'AdvertisingChannels', 'AffectedPackage', 'AggregatedTotals', 'Asset', 'Asset1', 'AssetSelectors', 'AssetType', 'AssetTypeSchema', 'AssetsRequired', 'AssetsRequired1', 'AssignedPackage', 'Assignments', 'AudioAsset', 'Authentication', 'AuthorizedAgents', 'AuthorizedAgents1', 'AuthorizedAgents2', 'AuthorizedAgents3', 'AuthorizedSalesAgents', 'AvailableMetric', 'AvailableReportingFrequency', 'BrandManifest', 'BrandManifest1', 'BrandManifest2', 'BrandManifestRef', 'BrandManifestReference', 'BuildCreativeRequest', 'BuildCreativeResponse', 'BuildCreativeResponse1', 'BuildCreativeResponse2', 'ByPackageItem', 'Capability', 'CatalogType', 'Channels', 'CoBranding', 'Colors', 'Contact', 'ContentLength', 'Country', 'CpcOption', 'CpcPricingOption', 'CpcvOption', 'CpcvPricingOption', 'CpmAuctionOption', 'CpmAuctionPricingOption', 'CpmFixedOption', 'CpmFixedRatePricingOption', 'CppOption', 'CppPricingOption', 'CpvOption', 'CpvPricingOption', 'CreateMediaBuyRequest', 'CreateMediaBuyResponse', 'CreateMediaBuyResponse1', 'CreateMediaBuyResponse2', 'Creative', 'CreativeAgent', 'CreativeAsset', 'CreativeAssignment', 'CreativeManifest', 'CreativePolicy', 'CreativeStatus', 'CssAsset', 'DaastAsset1', 'DaastAsset2', 'DaastVersion', 'DailyBreakdownItem', 'DeliverTo', 'DeliveryMeasurement', 'DeliveryMetrics', 'DeliveryType', 'Deployment1', 'Deployment2', 'Destination1', 'Destination2', 'Details', 'Dimensions', 'Direction', 'Disclaimer', 'Domain', 'DomainBreakdown', 'DoohMetrics', 'Duration', 'Embedding', 'Error', 'FeedFormat', 'FeedbackSource', 'Field1', 'FieldModel', 'FileSize', 'Filters', 'FlatRateOption', 'FlatRatePricingOption', 'Fonts', 'Format', 'FormatCard', 'FormatCardDetailed', 'FormatId', 'FormatType', 'FrequencyCap', 'FrequencyCapScope', 'GeoCountryAnyOfItem', 'GetMediaBuyDeliveryRequest', 'GetMediaBuyDeliveryResponse', 'GetProductsRequest', 'GetProductsResponse', 'GetSignalsRequest', 'GetSignalsResponse', 'HistoryItem', 'HtmlAsset', 'Identifier', 'ImageAsset', 'Input', 'Input2', 'Input4', 'JavascriptAsset', 'LandingPage', 'ListAuthorizedPropertiesRequest', 'ListAuthorizedPropertiesResponse', 'ListCreativeFormatsRequest', 'ListCreativeFormatsResponse', 'ListCreativesRequest', 'ListCreativesResponse', 'Logo', 'MarkdownAsset', 'MarkdownFlavor', 'Measurement', 'MeasurementPeriod', 'MediaBuy', 'MediaBuyDelivery', 'MediaBuyStatus', 'Metadata', 'Method', 'Method1', 'MetricType', 'ModuleType', 'NotificationType', 'Offering', 'OutputFormat', 'Pacing', 'Package', 'PackageRequest', 'PackageStatus', 'Packages', 'Packages1', 'Packages2', 'Packages3', 'Pagination', 'Parameters', 'Parameters1', 'Parameters2', 'Performance', 'PerformanceFeedback', 'Placement', 'Preview', 'Preview1', 'Preview2', 'PreviewCreativeRequest', 'PreviewCreativeRequest1', 'PreviewCreativeRequest2', 'PreviewCreativeResponse', 'PreviewCreativeResponse1', 'PreviewCreativeResponse2', 'PreviewRender', 'PreviewRender1', 'PreviewRender2', 'PreviewRender3', 'PriceGuidance', 'PriceGuidance1', 'Pricing', 'PricingModel', 'PricingOption', 'PrimaryCountry', 'Product', 'ProductCard', 'ProductCardDetailed', 'ProductCatalog', 'ProductCatalog1', 'Progress', 'PromotedOfferings', 'PromotedProducts', 'Property', 'PropertyId', 'PropertyIdentifierTypes', 'PropertyTag', 'PropertyType', 'ProtocolEnvelope', 'ProtocolResponse', 'ProvidePerformanceFeedbackRequest', 'ProvidePerformanceFeedbackResponse', 'ProvidePerformanceFeedbackResponse1', 'ProvidePerformanceFeedbackResponse2', 'PublisherDomain', 'PublisherIdentifierTypes', 'PublisherProperties', 'PublisherProperties1', 'PublisherProperties3', 'PushNotificationConfig', 'Quality', 'QuartileData', 'QuerySummary', 'Render', 'ReportingCapabilities', 'ReportingFrequency', 'ReportingPeriod', 'ReportingWebhook', 'Request', 'RequestedMetric', 'Requirements', 'Response', 'Response1', 'ResponseType', 'Responsive', 'Results', 'Results1', 'Scheme', 'Security', 'Signal', 'SignalType', 'Sort', 'SortApplied', 'StandardFormatIds', 'StartTiming', 'Status', 'StatusFilter', 'StatusFilterEnum', 'StatusSummary', 'SubAsset1', 'SubAsset2', 'SyncCreativesRequest', 'SyncCreativesResponse', 'SyncCreativesResponse1', 'SyncCreativesResponse2', 'Tag', 'Tags', 'TargetingOverlay', 'Task', 'TaskStatus', 'TaskType', 'TasksGetRequest', 'TasksGetResponse', 'TasksListRequest', 'TasksListResponse', 'TextAsset', 'Totals', 'TrackingEvent', 'Type', 'Unit', 'UpdateFrequency', 'UpdateMediaBuyRequest', 'UpdateMediaBuyRequest1', 'UpdateMediaBuyRequest2', 'UpdateMediaBuyResponse', 'UpdateMediaBuyResponse1', 'UpdateMediaBuyResponse2', 'UrlAsset', 'UrlType', 'ValidationMode', 'VastAsset1', 'VastAsset2', 'VastVersion', 'VcpmAuctionOption', 'VcpmAuctionPricingOption', 'VcpmFixedOption', 'VcpmFixedRatePricingOption', 'VenueBreakdownItem', 'VideoAsset', 'ViewThreshold', 'ViewThreshold1', 'WebhookAsset', 'WebhookPayload']

{adcp-2.2.0 → adcp-2.4.0}/src/adcp/types/generated_poc/__init__.py

@@ -1,3 +1,3 @@
 # generated by datamodel-codegen:
 #   filename:  .schema_temp
-#   timestamp: 2025-11-15T22:03:55+00:00
+#   timestamp: 2025-11-18T03:04:10+00:00

{adcp-2.2.0 → adcp-2.4.0}/src/adcp/types/generated_poc/activate_signal_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  activate-signal-request.json
-#   timestamp: 2025-11-15T22:03:55+00:00
+#   timestamp: 2025-11-18T03:04:10+00:00
 
 from __future__ import annotations
 
@@ -14,21 +14,21 @@ from . import destination
 
 class ActivateSignalRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        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."
+            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
     destinations: Annotated[
         list[destination.Destination1 | destination.Destination2],
         Field(
-            description="Target destination(s) for activation. If the authenticated caller matches one of these destinations, activation keys will be included in the response.",
+            description='Target destination(s) for activation. If the authenticated caller matches one of these destinations, activation keys will be included in the response.',
             min_length=1,
         ),
     ]
     signal_agent_segment_id: Annotated[
-        str, Field(description="The universal identifier for the signal to activate")
+        str, Field(description='The universal identifier for the signal to activate')
     ]

{adcp-2.2.0 → adcp-2.4.0}/src/adcp/types/generated_poc/activate_signal_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  activate-signal-response.json
-#   timestamp: 2025-11-15T22:03:55+00:00
+#   timestamp: 2025-11-18T03:04:10+00:00
 
 from __future__ import annotations
 
@@ -14,34 +14,34 @@ from . import deployment, error
 
 class ActivateSignalResponse1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        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."
+            description='Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.'
         ),
     ] = None
     deployments: Annotated[
         list[deployment.Deployment1 | deployment.Deployment2],
-        Field(description="Array of deployment results for each destination"),
+        Field(description='Array of deployment results for each destination'),
     ]
 
 
 class ActivateSignalResponse2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        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."
+            description='Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.'
         ),
     ] = None
     errors: Annotated[
         list[error.Error],
         Field(
-            description="Array of errors explaining why activation failed (e.g., platform connectivity issues, signal definition problems, authentication failures)",
+            description='Array of errors explaining why activation failed (e.g., platform connectivity issues, signal definition problems, authentication failures)',
             min_length=1,
         ),
     ]
@@ -51,7 +51,7 @@ class ActivateSignalResponse(RootModel[ActivateSignalResponse1 | ActivateSignalR
     root: Annotated[
         ActivateSignalResponse1 | ActivateSignalResponse2,
         Field(
-            description="Response payload for activate_signal task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - the signal is either fully activated or not activated at all.",
-            title="Activate Signal Response",
+            description='Response payload for activate_signal task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - the signal is either fully activated or not activated at all.',
+            title='Activate Signal Response',
         ),
     ]

adcp-2.4.0/src/adcp/types/generated_poc/activation_key.py

@@ -0,0 +1,30 @@
+# generated by datamodel-codegen:
+#   filename:  activation-key.json
+#   timestamp: 2025-11-18T03:04:10+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Literal
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+
+class ActivationKey1(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    segment_id: Annotated[
+        str,
+        Field(description='The platform-specific segment identifier to use in campaign targeting'),
+    ]
+    type: Annotated[Literal['segment_id'], Field(description='Segment ID based targeting')]
+
+
+class ActivationKey2(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    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')]