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

adcp/server/proposal.py

@@ -288,9 +288,7 @@ class ProposalBuilder:
 
         total = sum(a["allocation_percentage"] for a in self._allocations)
         if abs(total - 100.0) > 0.01:
-            raise ValueError(
-                f"Allocation percentages must sum to 100, got {total}"
-            )
+            raise ValueError(f"Allocation percentages must sum to 100, got {total}")
 
         proposal: dict[str, Any] = {
             "proposal_id": self._proposal_id,

adcp/server/sponsored_intelligence.py

@@ -256,37 +256,29 @@ class SponsoredIntelligenceHandler(ADCPHandler):
             "list_creative_formats is not supported by Sponsored Intelligence agents."
         )
 
-    async def list_authorized_properties(
+    async def list_accounts(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Sponsored Intelligence agents."""
-        return not_supported(
-            "list_authorized_properties is not supported by Sponsored Intelligence agents."
-        )
+        return not_supported("list_accounts is not supported by Sponsored Intelligence agents.")
 
     async def sync_creatives(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Sponsored Intelligence agents."""
-        return not_supported(
-            "sync_creatives is not supported by Sponsored Intelligence agents."
-        )
+        return not_supported("sync_creatives is not supported by Sponsored Intelligence agents.")
 
     async def list_creatives(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Sponsored Intelligence agents."""
-        return not_supported(
-            "list_creatives is not supported by Sponsored Intelligence agents."
-        )
+        return not_supported("list_creatives is not supported by Sponsored Intelligence agents.")
 
     async def build_creative(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Sponsored Intelligence agents."""
-        return not_supported(
-            "build_creative is not supported by Sponsored Intelligence agents."
-        )
+        return not_supported("build_creative is not supported by Sponsored Intelligence agents.")
 
     async def create_media_buy(
         self, params: dict[str, Any], context: ToolContext | None = None
@@ -301,9 +293,7 @@ class SponsoredIntelligenceHandler(ADCPHandler):
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Sponsored Intelligence agents."""
-        return not_supported(
-            "update_media_buy is not supported by Sponsored Intelligence agents."
-        )
+        return not_supported("update_media_buy is not supported by Sponsored Intelligence agents.")
 
     async def get_media_buy_delivery(
         self, params: dict[str, Any], context: ToolContext | None = None
@@ -317,17 +307,13 @@ class SponsoredIntelligenceHandler(ADCPHandler):
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Sponsored Intelligence agents."""
-        return not_supported(
-            "get_signals is not supported by Sponsored Intelligence agents."
-        )
+        return not_supported("get_signals is not supported by Sponsored Intelligence agents.")
 
     async def activate_signal(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Sponsored Intelligence agents."""
-        return not_supported(
-            "activate_signal is not supported by Sponsored Intelligence agents."
-        )
+        return not_supported("activate_signal is not supported by Sponsored Intelligence agents.")
 
     async def provide_performance_feedback(
         self, params: dict[str, Any], context: ToolContext | None = None
@@ -378,9 +364,7 @@ class SponsoredIntelligenceHandler(ADCPHandler):
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Sponsored Intelligence agents."""
-        return not_supported(
-            "calibrate_content is not supported by Sponsored Intelligence agents."
-        )
+        return not_supported("calibrate_content is not supported by Sponsored Intelligence agents.")
 
     async def validate_content_delivery(
         self, params: dict[str, Any], context: ToolContext | None = None
@@ -415,9 +399,7 @@ class SponsoredIntelligenceHandler(ADCPHandler):
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Sponsored Intelligence agents."""
-        return not_supported(
-            "get_property_list is not supported by Sponsored Intelligence agents."
-        )
+        return not_supported("get_property_list is not supported by Sponsored Intelligence agents.")
 
     async def list_property_lists(
         self, params: dict[str, Any], context: ToolContext | None = None

adcp/simple.py

@@ -36,8 +36,8 @@ from adcp.types import (
     GetProductsResponse,
     GetSignalsRequest,
     GetSignalsResponse,
-    ListAuthorizedPropertiesRequest,
-    ListAuthorizedPropertiesResponse,
+    ListAccountsRequest,
+    ListAccountsResponse,
     ListCreativeFormatsRequest,
     ListCreativeFormatsResponse,
     ListCreativesRequest,
@@ -252,26 +252,26 @@ class SimpleAPI:
             )
         return result.data
 
-    async def list_authorized_properties(
+    async def list_accounts(
         self,
         **kwargs: Any,
-    ) -> ListAuthorizedPropertiesResponse:
-        """List authorized properties.
+    ) -> ListAccountsResponse:
+        """List billing accounts accessible to the authenticated agent.
 
         Args:
-            **kwargs: Arguments passed to ListAuthorizedPropertiesRequest
+            **kwargs: Arguments passed to ListAccountsRequest
 
         Returns:
-            ListAuthorizedPropertiesResponse
+            ListAccountsResponse
 
         Raises:
             Exception: If the request fails
         """
-        request = ListAuthorizedPropertiesRequest(**kwargs)
-        result = await self._client.list_authorized_properties(request)
+        request = ListAccountsRequest(**kwargs)
+        result = await self._client.list_accounts(request)
         if not result.success or not result.data:
             raise ADCPSimpleAPIError(
-                operation="list_authorized_properties",
+                operation="list_accounts",
                 error_message=result.error,
                 agent_id=self._client.agent_config.id,
             )

adcp/types/__init__.py

@@ -40,6 +40,9 @@ from adcp.types import _generated as generated  # noqa: F401
 # V3 Sponsored Intelligence types
 # V3 Governance (Property Lists) types
 from adcp.types._generated import (
+    A2UiComponent,
+    A2UiSurface,
+    Account,
     ActivateSignalRequest,
     ActivateSignalResponse,
     AggregatedTotals,
@@ -47,7 +50,6 @@ from adcp.types._generated import (
     Asset,
     AssetContentType,
     AssetSelectors,
-    AssetsRequired,
     AssignedPackage,
     Assignments,
     AudioAsset,
@@ -141,8 +143,8 @@ from adcp.types._generated import (
     JavascriptAsset,
     JavascriptModuleType,
     LandingPageRequirement,
-    ListAuthorizedPropertiesRequest,
-    ListAuthorizedPropertiesResponse,
+    ListAccountsRequest,
+    ListAccountsResponse,
     ListContentStandardsRequest,
     ListContentStandardsResponse,
     ListCreativeFormatsRequest,
@@ -289,10 +291,12 @@ from adcp.types.aliases import (
     PreviewCreativeInteractiveResponse,
     PreviewCreativeManifestRequest,
     PreviewCreativeStaticResponse,
+    PricingOption,
     PropertyId,
     PropertyTag,
     ProvidePerformanceFeedbackErrorResponse,
     ProvidePerformanceFeedbackSuccessResponse,
+    PublisherProperties,
     PublisherPropertiesAll,
     PublisherPropertiesById,
     PublisherPropertiesByTag,
@@ -356,8 +360,8 @@ __all__ = [
     "GetProductsResponse",
     "GetSignalsRequest",
     "GetSignalsResponse",
-    "ListAuthorizedPropertiesRequest",
-    "ListAuthorizedPropertiesResponse",
+    "ListAccountsRequest",
+    "ListAccountsResponse",
     "ListCreativeFormatsRequest",
     "ListCreativeFormatsResponse",
     "ListCreativesRequest",
@@ -398,6 +402,8 @@ __all__ = [
     "ValidateContentDeliveryRequest",
     "ValidateContentDeliveryResponse",
     # V3 Sponsored Intelligence
+    "A2UiComponent",
+    "A2UiSurface",
     "SiCapabilities",
     "SiGetOfferingRequest",
     "SiGetOfferingResponse",
@@ -430,7 +436,7 @@ __all__ = [
     "AssetContentType",
     "AssetType",  # Deprecated
     "FormatCategory",
-    "AssetsRequired",
+    "Account",
     "AssignedPackage",
     "Assignments",
     "BrandManifest",
@@ -602,10 +608,12 @@ __all__ = [
     "PreviewCreativeInteractiveResponse",
     "PreviewCreativeManifestRequest",
     "PreviewCreativeStaticResponse",
+    "PricingOption",
     "PropertyId",
     "PropertyTag",
     "ProvidePerformanceFeedbackErrorResponse",
     "ProvidePerformanceFeedbackSuccessResponse",
+    "PublisherProperties",
     "PublisherPropertiesAll",
     "PublisherPropertiesById",
     "PublisherPropertiesByTag",

adcp/types/_generated.py

@@ -10,13 +10,17 @@ 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: 2026-01-26 13:22:20 UTC
+Generation date: 2026-02-02 17:45:22 UTC
 """
 
 # ruff: noqa: E501, I001
 from __future__ import annotations
 
 # Import all types from generated_poc modules
+from adcp.types.generated_poc.a2ui.component import A2UiComponent
+from adcp.types.generated_poc.a2ui.surface import A2UiSurface
+from adcp.types.generated_poc.account.list_accounts_request import ListAccountsRequest, Status
+from adcp.types.generated_poc.account.list_accounts_response import ListAccountsResponse
 from adcp.types.generated_poc.adagents import (
     AuthorizedAgents,
     AuthorizedAgents1,
@@ -58,7 +62,6 @@ from adcp.types.generated_poc.content_standards.calibrate_content_response impor
     CalibrateContentResponse1,
     CalibrateContentResponse2,
     Feature,
-    Status,
     Verdict,
 )
 from adcp.types.generated_poc.content_standards.content_standards import (
@@ -123,12 +126,13 @@ from adcp.types.generated_poc.content_standards.validate_content_delivery_respon
     ValidateContentDeliveryResponse1,
     ValidateContentDeliveryResponse2,
 )
+from adcp.types.generated_poc.core.account import Account, CreditLimit
 from adcp.types.generated_poc.core.activation_key import (
     ActivationKey,
     ActivationKey1,
     ActivationKey2,
 )
-from adcp.types.generated_poc.core.assets.audio_asset import AudioAsset
+from adcp.types.generated_poc.core.assets.audio_asset import AudioAsset, BitDepth, Channels
 from adcp.types.generated_poc.core.assets.css_asset import CssAsset
 from adcp.types.generated_poc.core.assets.daast_asset import DaastAsset, DaastAsset1, DaastAsset2
 from adcp.types.generated_poc.core.assets.html_asset import HtmlAsset
@@ -137,7 +141,19 @@ from adcp.types.generated_poc.core.assets.javascript_asset import JavascriptAsse
 from adcp.types.generated_poc.core.assets.text_asset import TextAsset
 from adcp.types.generated_poc.core.assets.url_asset import UrlAsset
 from adcp.types.generated_poc.core.assets.vast_asset import VastAsset, VastAsset1, VastAsset2
-from adcp.types.generated_poc.core.assets.video_asset import VideoAsset
+from adcp.types.generated_poc.core.assets.video_asset import (
+    AudioBitDepth,
+    AudioChannels,
+    ChromaSubsampling,
+    ColorSpace,
+    FrameRateType,
+    GopType,
+    HdrFormat,
+    MoovAtomPosition,
+    ScanType,
+    VideoAsset,
+    VideoBitDepth,
+)
 from adcp.types.generated_poc.core.assets.webhook_asset import Security, WebhookAsset
 from adcp.types.generated_poc.core.async_response_data import AdcpAsyncResponseData
 from adcp.types.generated_poc.core.brand_manifest import (
@@ -172,10 +188,7 @@ from adcp.types.generated_poc.core.destination import Destination, Destination1,
 from adcp.types.generated_poc.core.error import Error
 from adcp.types.generated_poc.core.ext import ExtensionObject
 from adcp.types.generated_poc.core.format import (
-    Asset2,
     Assets5,
-    AssetsRequired,
-    AssetsRequired1,
     Dimensions,
     Dimensions1,
     Format,
@@ -383,14 +396,6 @@ from adcp.types.generated_poc.media_buy.get_products_async_response_working impo
 )
 from adcp.types.generated_poc.media_buy.get_products_request import GetProductsRequest
 from adcp.types.generated_poc.media_buy.get_products_response import GetProductsResponse
-from adcp.types.generated_poc.media_buy.list_authorized_properties_request import (
-    ListAuthorizedPropertiesRequest,
-    PublisherDomain,
-)
-from adcp.types.generated_poc.media_buy.list_authorized_properties_response import (
-    ListAuthorizedPropertiesResponse,
-    PrimaryCountry,
-)
 from adcp.types.generated_poc.media_buy.list_creative_formats_request import (
     ListCreativeFormatsRequest,
 )
@@ -462,7 +467,7 @@ from adcp.types.generated_poc.media_buy.update_media_buy_response import (
     UpdateMediaBuyResponse1,
     UpdateMediaBuyResponse2,
 )
-from adcp.types.generated_poc.pricing_options.cpc_option import CpcPricingOption, PriceGuidance
+from adcp.types.generated_poc.pricing_options.cpc_option import CpcPricingOption
 from adcp.types.generated_poc.pricing_options.cpcv_option import CpcvPricingOption
 from adcp.types.generated_poc.pricing_options.cpm_option import CpmPricingOption
 from adcp.types.generated_poc.pricing_options.cpp_option import CppPricingOption, Parameters
@@ -472,6 +477,7 @@ from adcp.types.generated_poc.pricing_options.cpv_option import (
     ViewThreshold1,
 )
 from adcp.types.generated_poc.pricing_options.flat_rate_option import FlatRatePricingOption
+from adcp.types.generated_poc.pricing_options.price_guidance import PriceGuidance
 from adcp.types.generated_poc.pricing_options.vcpm_option import VcpmPricingOption
 from adcp.types.generated_poc.property.base_property_source import (
     BasePropertySource,
@@ -529,16 +535,14 @@ from adcp.types.generated_poc.protocol.get_adcp_capabilities_response import (
     MraidVersion,
     Portfolio,
     Preferred,
+    PrimaryCountry,
+    PublisherDomain,
     Signals,
     SponsoredIntelligence,
     SupportedProtocol,
     Targeting,
     Transport,
 )
-from adcp.types.generated_poc.protocols.adcp_extension import (
-    AdcpAgentCardExtensionParamsDeprecated,
-    ProtocolsSupportedEnum,
-)
 from adcp.types.generated_poc.signals.activate_signal_request import ActivateSignalRequest
 from adcp.types.generated_poc.signals.activate_signal_response import (
     ActivateSignalResponse,
@@ -552,6 +556,7 @@ from adcp.types.generated_poc.signals.get_signals_response import (
     Signal,
 )
 from adcp.types.generated_poc.sponsored_intelligence.si_capabilities import (
+    A2ui,
     Commerce,
     Components,
     Modalities,
@@ -611,6 +616,10 @@ from adcp.types.generated_poc.core.package import Package as _PackageFromPackage
 
 # Explicit exports
 __all__ = [
+    "A2UiComponent",
+    "A2UiSurface",
+    "A2ui",
+    "Account",
     "AcpHandoff",
     "Action",
     "ActionResponse",
@@ -622,7 +631,6 @@ __all__ = [
     "ActivationKey1",
     "ActivationKey2",
     "Adcp",
-    "AdcpAgentCardExtensionParamsDeprecated",
     "AdcpAsyncResponseData",
     "AdcpDomain",
     "AdcpExtensionFileSchema",
@@ -632,7 +640,6 @@ __all__ = [
     "ArtifactWebhook",
     "ArtifactWebhookPayload",
     "Asset",
-    "Asset2",
     "AssetAccess",
     "AssetAccess1",
     "AssetAccess2",
@@ -645,11 +652,11 @@ __all__ = [
     "Assets2",
     "Assets3",
     "Assets5",
-    "AssetsRequired",
-    "AssetsRequired1",
     "AssignedPackage",
     "Assignments",
     "AudioAsset",
+    "AudioBitDepth",
+    "AudioChannels",
     "Authentication",
     "AuthenticationScheme",
     "AuthorizedAgents",
@@ -666,6 +673,7 @@ __all__ = [
     "BasePropertySource2",
     "BasePropertySource3",
     "BatchFrequency",
+    "BitDepth",
     "BrandContext",
     "BrandManifest",
     "BrandManifestReference",
@@ -682,8 +690,11 @@ __all__ = [
     "CalibrateContentResponse2",
     "CalibrationExemplars",
     "ChangeSummary",
+    "Channels",
+    "ChromaSubsampling",
     "CoBrandingRequirement",
     "Code",
+    "ColorSpace",
     "Colors",
     "Commerce",
     "Components",
@@ -725,6 +736,7 @@ __all__ = [
     "CreativeSortField",
     "CreativeSpecs",
     "CreativeStatus",
+    "CreditLimit",
     "CssAsset",
     "DaastAsset",
     "DaastAsset1",
@@ -772,6 +784,7 @@ __all__ = [
     "FormatCategory",
     "FormatId",
     "FormatIdParameter",
+    "FrameRateType",
     "FrequencyCap",
     "FrequencyCapScope",
     "GeoCountry",
@@ -802,8 +815,10 @@ __all__ = [
     "GetPropertyListResponse",
     "GetSignalsRequest",
     "GetSignalsResponse",
+    "GopType",
     "Governance",
     "Handoff",
+    "HdrFormat",
     "HistoryEntryType",
     "HtmlAsset",
     "HttpMethod",
@@ -818,8 +833,8 @@ __all__ = [
     "JavascriptAsset",
     "JavascriptModuleType",
     "LandingPageRequirement",
-    "ListAuthorizedPropertiesRequest",
-    "ListAuthorizedPropertiesResponse",
+    "ListAccountsRequest",
+    "ListAccountsResponse",
     "ListContentStandardsRequest",
     "ListContentStandardsResponse",
     "ListContentStandardsResponse1",
@@ -851,6 +866,7 @@ __all__ = [
     "Metro",
     "MetroAreaSystem",
     "Modalities",
+    "MoovAtomPosition",
     "MraidVersion",
     "NotificationType",
     "Offering",
@@ -913,7 +929,6 @@ __all__ = [
     "Protocol",
     "ProtocolEnvelope",
     "ProtocolResponse",
-    "ProtocolsSupportedEnum",
     "ProvidePerformanceFeedbackRequest",
     "ProvidePerformanceFeedbackRequest1",
     "ProvidePerformanceFeedbackRequest2",
@@ -951,6 +966,7 @@ __all__ = [
     "Role",
     "Sampling",
     "SamplingInfo",
+    "ScanType",
     "Scope",
     "Security",
     "SessionStatus",
@@ -1040,6 +1056,7 @@ __all__ = [
     "Verdict",
     "Video",
     "VideoAsset",
+    "VideoBitDepth",
     "ViewThreshold",
     "ViewThreshold1",
     "Voice",

adcp/types/aliases.py

@@ -43,6 +43,11 @@ from adcp.types._generated import (
     # Build creative responses
     BuildCreativeResponse1,
     BuildCreativeResponse2,
+    CpcPricingOption,
+    CpcvPricingOption,
+    CpmPricingOption,
+    CppPricingOption,
+    CpvPricingOption,
     # Create media buy responses
     CreateMediaBuyResponse1,
     CreateMediaBuyResponse2,
@@ -55,6 +60,7 @@ from adcp.types._generated import (
     # Destination types
     Destination1,
     Destination2,
+    FlatRatePricingOption,
     # Preview creative requests
     PreviewCreativeRequest1,
     PreviewCreativeRequest2,
@@ -86,6 +92,7 @@ from adcp.types._generated import (
     # VAST assets
     VastAsset1,
     VastAsset2,
+    VcpmPricingOption,
 )
 from adcp.types._generated import (
     PublisherPropertySelector1 as PublisherPropertiesInternal,
@@ -688,6 +695,52 @@ Example:
     ```
 """
 
+# ============================================================================
+# PRICING OPTION UNION TYPE - For Type Hints Without RootModel Wrapper
+# ============================================================================
+# The generated PricingOption is a RootModel wrapper that mypy doesn't recognize
+# as compatible with the individual variant types. This union alias provides a
+# way to type-hint pricing options without the wrapper, fixing mypy list-item errors.
+
+PricingOption = (
+    CpmPricingOption
+    | VcpmPricingOption
+    | CpcPricingOption
+    | CpcvPricingOption
+    | CpvPricingOption
+    | CppPricingOption
+    | FlatRatePricingOption
+)
+"""Union type for all pricing option variants.
+
+Use this for type hints when constructing Product.pricing_options or any field
+that accepts pricing options. This fixes mypy list-item errors that occur when
+using the individual variant types.
+
+Example:
+    ```python
+    from adcp.types import Product, CpmPricingOption, PricingOption
+
+    # Type hint for a list of pricing options
+    def get_pricing(options: list[PricingOption]) -> None:
+        for opt in options:
+            print(f"Model: {opt.pricing_model}")
+
+    # Use in Product construction (no more mypy errors!)
+    product = Product(
+        product_id="test",
+        name="Test Product",
+        pricing_options=[
+            CpmPricingOption(
+                pricing_model="cpm",
+                floor_price=1.50,
+                currency="USD"
+            )
+        ]
+    )
+    ```
+"""
+
 # ============================================================================
 # EXPORTS
 # ============================================================================
@@ -759,4 +812,6 @@ __all__ = [
     "AgentDestination",
     # Destination union
     "Destination",
+    # Pricing option union
+    "PricingOption",
 ]

adcp/types/base.py

@@ -61,13 +61,13 @@ def _get_signals_message(self: Any) -> str:
     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("ListAccountsResponse")
+def _list_accounts_message(self: Any) -> str:
+    accounts = getattr(self, "accounts", None)
+    if accounts is None:
+        return "No accounts found."
+    count = len(accounts)
+    return f"Found {count} accessible {_pluralize(count, 'account')}."
 
 
 @_register_response_message("ListCreativesResponse")

adcp/types/generated_poc/{protocols → a2ui}/__init__.py

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

adcp/types/generated_poc/a2ui/component.py

@@ -0,0 +1,24 @@
+# generated by datamodel-codegen:
+#   filename:  a2ui/component.json
+#   timestamp: 2026-02-02T17:45:21+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Any
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+
+class A2UiComponent(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    component: Annotated[
+        dict[str, dict[str, Any]],
+        Field(description="Component definition (keyed by component type)"),
+    ]
+    id: Annotated[str, Field(description="Unique identifier for this component within the surface")]
+    parentId: Annotated[
+        str | None, Field(description="ID of the parent component (null for root)")
+    ] = None

adcp/types/generated_poc/a2ui/surface.py

@@ -0,0 +1,33 @@
+# generated by datamodel-codegen:
+#   filename:  a2ui/surface.json
+#   timestamp: 2026-02-02T17:45:21+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Any
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+from . import component
+
+
+class A2UiSurface(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    catalogId: Annotated[
+        str | None, Field(description="Component catalog to use for rendering")
+    ] = "standard"
+    components: Annotated[
+        list[component.A2UiComponent],
+        Field(description="Flat list of components (adjacency list structure)"),
+    ]
+    dataModel: Annotated[
+        dict[str, Any] | None, Field(description="Application data that components can bind to")
+    ] = None
+    rootId: Annotated[
+        str | None,
+        Field(description="ID of the root component (if not specified, first component is root)"),
+    ] = None
+    surfaceId: Annotated[str, Field(description="Unique identifier for this surface")]

adcp/types/generated_poc/account/__init__.py

@@ -0,0 +1,3 @@
+# generated by datamodel-codegen:
+#   filename:  .schema_temp
+#   timestamp: 2026-02-02T17:45:21+00:00