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

adcp/types/generated_poc/protocol/get_adcp_capabilities_response.py

@@ -0,0 +1,353 @@
+# generated by datamodel-codegen:
+#   filename:  protocol/get_adcp_capabilities_response.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, AwareDatetime, ConfigDict, Field, RootModel
+
+from ..core import context as context_1
+from ..core import error
+from ..core import ext as ext_1
+from ..core import media_buy_features
+from ..enums import channels
+from ..sponsored_intelligence import si_capabilities
+
+
+class MajorVersion(RootModel[int]):
+    root: Annotated[int, Field(ge=1)]
+
+
+class Adcp(AdCPBaseModel):
+    major_versions: Annotated[
+        list[MajorVersion],
+        Field(
+            description='AdCP major versions supported by this seller. Major versions indicate breaking changes.',
+            min_length=1,
+        ),
+    ]
+
+
+class ExtensionsSupportedItem(RootModel[str]):
+    root: Annotated[
+        str,
+        Field(
+            description="Extension namespace (lowercase alphanumeric with underscores, e.g., 'scope3', 'garm', 'iab_tcf')",
+            pattern='^[a-z][a-z0-9_]*$',
+        ),
+    ]
+
+
+class Range(AdCPBaseModel):
+    max: Annotated[float, Field(description='Maximum value')]
+    min: Annotated[float, Field(description='Minimum value')]
+
+
+class Type(Enum):
+    binary = 'binary'
+    quantitative = 'quantitative'
+    categorical = 'categorical'
+
+
+class PropertyFeature(AdCPBaseModel):
+    categories: Annotated[
+        list[str] | None, Field(description='For categorical features, the valid values')
+    ] = None
+    description: Annotated[
+        str | None, Field(description='Human-readable description of what this feature measures')
+    ] = None
+    feature_id: Annotated[
+        str,
+        Field(
+            description="Unique identifier for this feature (e.g., 'consent_quality', 'coppa_certified', 'carbon_score')"
+        ),
+    ]
+    methodology_url: Annotated[
+        AnyUrl | None,
+        Field(
+            description='URL to documentation explaining how this feature is calculated or measured. Helps buyers understand and compare methodologies across vendors.'
+        ),
+    ] = None
+    range: Annotated[
+        Range | None, Field(description='For quantitative features, the valid range')
+    ] = None
+    type: Annotated[
+        Type,
+        Field(
+            description="Data type: 'binary' for yes/no, 'quantitative' for numeric scores, 'categorical' for enum values"
+        ),
+    ]
+
+
+class Governance(AdCPBaseModel):
+    property_features: Annotated[
+        list[PropertyFeature] | None,
+        Field(
+            description='Property features this governance agent can evaluate. Each feature describes a score, rating, or certification the agent can provide for properties.'
+        ),
+    ] = None
+
+
+class MraidVersion(RootModel[str]):
+    root: Annotated[str, Field(pattern='^[0-9]+\\.[0-9]+$')]
+
+
+class VastVersion(MraidVersion):
+    pass
+
+
+class CreativeSpecs(AdCPBaseModel):
+    mraid_versions: Annotated[
+        list[MraidVersion] | None,
+        Field(description='MRAID versions supported for rich media mobile creatives'),
+    ] = None
+    simid: Annotated[bool | None, Field(description='SIMID support for interactive video ads')] = (
+        None
+    )
+    vast_versions: Annotated[
+        list[VastVersion] | None, Field(description='VAST versions supported for video creatives')
+    ] = None
+    vpaid: Annotated[bool | None, Field(description='VPAID support for interactive video ads')] = (
+        None
+    )
+
+
+class GeoMetros(AdCPBaseModel):
+    eurostat_nuts2: Annotated[
+        bool | None, Field(description='Supports Eurostat NUTS Level 2 regions (EU)')
+    ] = None
+    nielsen_dma: Annotated[
+        bool | None,
+        Field(description="Supports Nielsen DMA codes (US market, e.g., '501' for NYC)"),
+    ] = None
+    uk_itl1: Annotated[bool | None, Field(description='Supports UK ITL Level 1 regions')] = None
+    uk_itl2: Annotated[bool | None, Field(description='Supports UK ITL Level 2 regions')] = None
+
+
+class GeoPostalAreas(AdCPBaseModel):
+    au_postcode: Annotated[
+        bool | None, Field(description="Australian postcode, 4 digits (e.g., '2000')")
+    ] = None
+    ca_fsa: Annotated[
+        bool | None, Field(description="Canadian Forward Sortation Area (e.g., 'K1A')")
+    ] = None
+    ca_full: Annotated[
+        bool | None, Field(description="Canadian full postal code (e.g., 'K1A 0B1')")
+    ] = None
+    de_plz: Annotated[
+        bool | None, Field(description="German Postleitzahl, 5 digits (e.g., '10115')")
+    ] = None
+    fr_code_postal: Annotated[
+        bool | None, Field(description="French code postal, 5 digits (e.g., '75001')")
+    ] = None
+    gb_full: Annotated[bool | None, Field(description="UK full postcode (e.g., 'SW1A 1AA')")] = None
+    gb_outward: Annotated[
+        bool | None, Field(description="UK postcode district / outward code (e.g., 'SW1', 'EC1')")
+    ] = None
+    us_zip: Annotated[bool | None, Field(description="US 5-digit ZIP codes (e.g., '10001')")] = None
+    us_zip_plus_four: Annotated[
+        bool | None, Field(description="US 9-digit ZIP+4 codes (e.g., '10001-1234')")
+    ] = None
+
+
+class Targeting(AdCPBaseModel):
+    geo_countries: Annotated[
+        bool | None,
+        Field(
+            description="Supports country-level geo targeting using ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE')"
+        ),
+    ] = None
+    geo_metros: Annotated[
+        GeoMetros | None,
+        Field(
+            description='Metro area targeting support. Specifies which classification systems are supported.'
+        ),
+    ] = None
+    geo_postal_areas: Annotated[
+        GeoPostalAreas | None,
+        Field(
+            description='Postal area targeting support. Specifies which postal code systems are supported. System names encode country and precision.'
+        ),
+    ] = None
+    geo_regions: Annotated[
+        bool | None,
+        Field(
+            description="Supports region/state-level geo targeting using ISO 3166-2 subdivision codes (e.g., 'US-NY', 'GB-SCT', 'DE-BY')"
+        ),
+    ] = None
+
+
+class Execution(AdCPBaseModel):
+    axe_integrations: Annotated[
+        list[AnyUrl] | None,
+        Field(
+            description='Agentic ad exchange (AXE) integrations supported. URLs are canonical identifiers for exchanges this seller can execute through.'
+        ),
+    ] = None
+    creative_specs: Annotated[
+        CreativeSpecs | None, Field(description='Creative specification support')
+    ] = None
+    targeting: Annotated[
+        Targeting | None,
+        Field(
+            description='Targeting capabilities. If declared true/supported, buyer can use these targeting parameters and seller MUST honor them.'
+        ),
+    ] = None
+
+
+class PrimaryCountry(RootModel[str]):
+    root: Annotated[str, Field(pattern='^[A-Z]{2}$')]
+
+
+class PublisherDomain(RootModel[str]):
+    root: Annotated[
+        str, Field(pattern='^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$')
+    ]
+
+
+class Portfolio(AdCPBaseModel):
+    advertising_policies: Annotated[
+        str | None,
+        Field(
+            description='Advertising content policies, restrictions, and guidelines',
+            max_length=10000,
+        ),
+    ] = None
+    description: Annotated[
+        str | None,
+        Field(
+            description='Markdown-formatted description of the inventory portfolio', max_length=5000
+        ),
+    ] = None
+    primary_channels: Annotated[
+        list[channels.MediaChannel] | None,
+        Field(description='Primary advertising channels in this portfolio'),
+    ] = None
+    primary_countries: Annotated[
+        list[PrimaryCountry] | None,
+        Field(description='Primary countries (ISO 3166-1 alpha-2) where inventory is concentrated'),
+    ] = None
+    publisher_domains: Annotated[
+        list[PublisherDomain],
+        Field(
+            description="Publisher domains this seller is authorized to represent. Buyers should fetch each publisher's adagents.json for property definitions.",
+            min_length=1,
+        ),
+    ]
+
+
+class Signals(AdCPBaseModel):
+    features: Annotated[
+        dict[str, bool] | None, Field(description='Optional signals features supported')
+    ] = None
+
+
+class Preferred(Enum):
+    mcp = 'mcp'
+    a2a = 'a2a'
+
+
+class Transport(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    type: Annotated[Preferred, Field(description='Protocol transport type')]
+    url: Annotated[AnyUrl, Field(description='Agent endpoint URL for this transport')]
+
+
+class Endpoint(AdCPBaseModel):
+    preferred: Annotated[
+        Preferred | None, Field(description='Preferred transport when host supports multiple')
+    ] = None
+    transports: Annotated[
+        list[Transport],
+        Field(
+            description='Available protocol transports. Hosts select based on their capabilities.',
+            min_length=1,
+        ),
+    ]
+
+
+class SupportedProtocol(Enum):
+    media_buy = 'media_buy'
+    signals = 'signals'
+    governance = 'governance'
+    sponsored_intelligence = 'sponsored_intelligence'
+
+
+class MediaBuy(AdCPBaseModel):
+    execution: Annotated[
+        Execution | None, Field(description='Technical execution capabilities for media buying')
+    ] = None
+    features: media_buy_features.MediaBuyFeatures | None = None
+    portfolio: Annotated[
+        Portfolio | None,
+        Field(description="Information about the seller's media inventory portfolio"),
+    ] = None
+
+
+class SponsoredIntelligence(AdCPBaseModel):
+    brand_manifest_url: Annotated[
+        AnyUrl | None, Field(description='URL to brand manifest with colors, fonts, logos, tone')
+    ] = None
+    capabilities: Annotated[
+        si_capabilities.SiCapabilities,
+        Field(description='Modalities, components, and commerce capabilities'),
+    ]
+    endpoint: Annotated[Endpoint, Field(description='SI agent endpoint configuration')]
+
+
+class GetAdcpCapabilitiesResponse(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    adcp: Annotated[Adcp, Field(description='Core AdCP protocol information')]
+    context: context_1.ContextObject | None = None
+    errors: Annotated[
+        list[error.Error] | None, Field(description='Task-specific errors and warnings')
+    ] = None
+    ext: ext_1.ExtensionObject | None = None
+    extensions_supported: Annotated[
+        list[ExtensionsSupportedItem] | None,
+        Field(
+            description='Extension namespaces this agent supports. Buyers can expect meaningful data in ext.{namespace} fields on responses from this agent. Extension schemas are published in the AdCP extension registry.'
+        ),
+    ] = None
+    governance: Annotated[
+        Governance | None,
+        Field(
+            description='Governance protocol capabilities. Only present if governance is in supported_protocols. Governance agents provide property data like compliance scores, brand safety ratings, and sustainability metrics.'
+        ),
+    ] = None
+    last_updated: Annotated[
+        AwareDatetime | None,
+        Field(
+            description='ISO 8601 timestamp of when capabilities were last updated. Buyers can use this for cache invalidation.'
+        ),
+    ] = None
+    media_buy: Annotated[
+        MediaBuy | None,
+        Field(
+            description='Media-buy protocol capabilities. Only present if media_buy is in supported_protocols.'
+        ),
+    ] = None
+    signals: Annotated[
+        Signals | None,
+        Field(
+            description='Signals protocol capabilities. Only present if signals is in supported_protocols. Reserved for future use.'
+        ),
+    ] = None
+    sponsored_intelligence: Annotated[
+        SponsoredIntelligence | None,
+        Field(
+            description='Sponsored Intelligence protocol capabilities. Only present if sponsored_intelligence is in supported_protocols. SI agents handle conversational brand experiences.'
+        ),
+    ] = None
+    supported_protocols: Annotated[
+        list[SupportedProtocol],
+        Field(description='Which AdCP domain protocols this seller supports', min_length=1),
+    ]

adcp/types/generated_poc/protocols/adcp_extension.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  protocols/adcp_extension.json
-#   timestamp: 2026-01-14T17:08:13+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -12,42 +12,39 @@ from pydantic import ConfigDict, Field, RootModel
 
 
 class ExtensionsSupportedItem(RootModel[str]):
-    root: Annotated[
-        str,
-        Field(
-            description="Extension namespace (e.g., 'sustainability'). Must be lowercase alphanumeric with underscores.",
-            pattern="^[a-z][a-z0-9_]*$",
-        ),
-    ]
+    root: Annotated[str, Field(pattern='^[a-z][a-z0-9_]*$')]
 
 
 class ProtocolsSupportedEnum(Enum):
-    media_buy = "media_buy"
-    creative = "creative"
-    signals = "signals"
+    media_buy = 'media_buy'
+    creative = 'creative'
+    signals = 'signals'
 
 
-class AdcpAgentCardExtensionParams(AdCPBaseModel):
+class AdcpAgentCardExtensionParamsDeprecated(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     adcp_version: Annotated[
         str,
         Field(
-            description="Semantic version of the AdCP specification this agent implements (e.g., '2.5.0'). Extension schemas are versioned along with the AdCP spec.",
-            pattern="^\\d+\\.\\d+\\.\\d+$",
+            deprecated=True,
+            description='DEPRECATED: Use get_adcp_capabilities response adcp.major_versions instead.',
+            pattern='^\\d+\\.\\d+\\.\\d+$',
         ),
     ]
     extensions_supported: Annotated[
         list[ExtensionsSupportedItem] | None,
         Field(
-            description="Typed extensions this agent supports. Each extension has a formal schema in /schemas/extensions/. Extension version is determined by adcp_version."
+            deprecated=True,
+            description='DEPRECATED: Typed extensions can be declared in get_adcp_capabilities ext field.',
         ),
     ] = None
     protocols_supported: Annotated[
         list[ProtocolsSupportedEnum],
         Field(
-            description="AdCP protocol domains supported by this agent. At least one must be specified.",
+            deprecated=True,
+            description='DEPRECATED: Use get_adcp_capabilities response supported_protocols instead.',
             min_length=1,
         ),
     ]

adcp/types/generated_poc/signals/activate_signal_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  signals/activate_signal_request.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -16,17 +16,17 @@ from ..core import ext as ext_1
 
 class ActivateSignalRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     context: context_1.ContextObject | None = None
     deployments: Annotated[
         list[destination.Destination],
         Field(
-            description="Target deployment(s) for activation. If the authenticated caller matches one of these deployment targets, activation keys will be included in the response.",
+            description='Target deployment(s) for activation. If the authenticated caller matches one of these deployment targets, activation keys will be included in the response.',
             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")
+        str, Field(description='The universal identifier for the signal to activate')
     ]

adcp/types/generated_poc/signals/activate_signal_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  signals/activate_signal_response.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -16,25 +16,25 @@ from ..core import ext as ext_1
 
 class ActivateSignalResponse1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     context: context_1.ContextObject | None = None
     deployments: Annotated[
         list[deployment.Deployment],
-        Field(description="Array of deployment results for each deployment target"),
+        Field(description='Array of deployment results for each deployment target'),
     ]
     ext: ext_1.ExtensionObject | None = None
 
 
 class ActivateSignalResponse2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     context: context_1.ContextObject | None = 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,
         ),
     ]
@@ -45,7 +45,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/types/generated_poc/signals/get_signals_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  signals/get_signals_request.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -16,20 +16,20 @@ from ..core import signal_filters
 
 
 class Country(RootModel[str]):
-    root: Annotated[str, Field(pattern="^[A-Z]{2}$")]
+    root: Annotated[str, Field(pattern='^[A-Z]{2}$')]
 
 
 class DeliverTo(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     countries: Annotated[
-        list[Country], Field(description="Countries where signals will be used (ISO codes)")
+        list[Country], Field(description='Countries where signals will be used (ISO codes)')
     ]
     deployments: Annotated[
         list[destination.Destination],
         Field(
-            description="List of deployment targets (DSPs, sales agents, etc.). If the authenticated caller matches one of these deployment targets, activation keys will be included in the response.",
+            description='List of deployment targets (DSPs, sales agents, etc.). If the authenticated caller matches one of these deployment targets, activation keys will be included in the response.',
             min_length=1,
         ),
     ]
@@ -37,17 +37,17 @@ class DeliverTo(AdCPBaseModel):
 
 class GetSignalsRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     context: context_1.ContextObject | None = None
     deliver_to: Annotated[
-        DeliverTo, Field(description="Deployment targets where signals need to be activated")
+        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)
+        int | None, Field(description='Maximum number of results to return', ge=1)
     ] = None
     signal_spec: Annotated[
-        str, Field(description="Natural language description of the desired signals")
+        str, Field(description='Natural language description of the desired signals')
     ]

adcp/types/generated_poc/signals/get_signals_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  signals/get_signals_response.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -17,42 +17,42 @@ from ..enums import signal_catalog_type
 
 class Pricing(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
-    cpm: Annotated[float, Field(description="Cost per thousand impressions", ge=0.0)]
-    currency: Annotated[str, Field(description="Currency code", pattern="^[A-Z]{3}$")]
+    cpm: Annotated[float, Field(description='Cost per thousand impressions', ge=0.0)]
+    currency: Annotated[str, Field(description='Currency code', pattern='^[A-Z]{3}$')]
 
 
 class Signal(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     coverage_percentage: Annotated[
-        float, Field(description="Percentage of audience coverage", ge=0.0, le=100.0)
+        float, Field(description='Percentage of audience coverage', ge=0.0, le=100.0)
     ]
-    data_provider: Annotated[str, Field(description="Name of the data provider")]
+    data_provider: Annotated[str, Field(description='Name of the data provider')]
     deployments: Annotated[
-        list[deployment.Deployment], Field(description="Array of deployment targets")
+        list[deployment.Deployment], Field(description='Array of deployment targets')
     ]
-    description: Annotated[str, Field(description="Detailed signal description")]
-    name: Annotated[str, Field(description="Human-readable signal name")]
-    pricing: Annotated[Pricing, Field(description="Pricing information")]
-    signal_agent_segment_id: Annotated[str, Field(description="Unique identifier for the signal")]
+    description: Annotated[str, Field(description='Detailed signal description')]
+    name: Annotated[str, Field(description='Human-readable signal name')]
+    pricing: Annotated[Pricing, Field(description='Pricing information')]
+    signal_agent_segment_id: Annotated[str, Field(description='Unique identifier for the signal')]
     signal_type: Annotated[
-        signal_catalog_type.SignalCatalogType, Field(description="Type of signal")
+        signal_catalog_type.SignalCatalogType, Field(description='Type of signal')
     ]
 
 
 class GetSignalsResponse(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     context: context_1.ContextObject | None = None
     errors: Annotated[
         list[error.Error] | None,
         Field(
-            description="Task-specific errors and warnings (e.g., signal discovery or pricing issues)"
+            description='Task-specific errors and warnings (e.g., signal discovery or pricing issues)'
         ),
     ] = None
     ext: ext_1.ExtensionObject | None = None
-    signals: Annotated[list[Signal], Field(description="Array of matching signals")]
+    signals: Annotated[list[Signal], Field(description='Array of matching signals')]

adcp/types/generated_poc/sponsored_intelligence/__init__.py

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