adcp 2.4.0__py3-none-any.whl → 2.4.1__py3-none-any.whl

adcp/types/generated_poc/property.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  property.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/protocol_envelope.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  protocol-envelope.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/provide_performance_feedback_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  provide-performance-feedback-request.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/provide_performance_feedback_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  provide-performance-feedback-response.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/publisher_identifier_types.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  publisher-identifier-types.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/push_notification_config.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  push-notification-config.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/reporting_capabilities.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  reporting-capabilities.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  response.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/standard_format_ids.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  standard-format-ids.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/sub_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  sub-asset.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/sync_creatives_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  sync-creatives-request.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/sync_creatives_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  sync-creatives-response.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/targeting.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  targeting.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/task_status.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  task-status.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/task_type.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  task-type.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/tasks_get_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  tasks-get-request.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/tasks_get_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  tasks-get-response.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/tasks_list_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  tasks-list-request.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/tasks_list_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  tasks-list-response.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/text_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  text-asset.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/update_media_buy_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  update-media-buy-request.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/update_media_buy_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  update-media-buy-response.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/url_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  url-asset.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/vast_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  vast-asset.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/vcpm_auction_option.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  vcpm-auction-option.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/vcpm_fixed_option.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  vcpm-fixed-option.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/video_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  video-asset.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/webhook_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  webhook-asset.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/webhook_payload.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  webhook-payload.json
-#   timestamp: 2025-11-18T03:04:10+00:00
+#   timestamp: 2025-11-18T03:35:10+00:00
 
 from __future__ import annotations
 

adcp/types/stable.py

@@ -0,0 +1,175 @@
+"""Stable public API for AdCP types.
+
+This module provides a stable, versioned API that shields users from internal
+implementation details and schema evolution. All types exported here are
+guaranteed to be stable within a major version.
+
+Internal Implementation:
+- Types are generated from JSON schemas into adcp.types.generated_poc
+- The generator may create numbered variants (e.g., BrandManifest1, BrandManifest2)
+  when schema evolution creates multiple valid structures
+- This module provides clean, unnumbered aliases pointing to the canonical version
+
+**IMPORTANT**: Never import directly from adcp.types.generated_poc or adcp.types.generated.
+Always import from adcp.types or adcp.types.stable.
+
+Schema Evolution:
+- When schemas change, we update the alias targets here
+- Users see stable names (BrandManifest, Product, etc.)
+- Breaking changes require major version bumps
+"""
+
+from __future__ import annotations
+
+# Import all generated types from internal consolidated module
+from adcp.types._generated import (
+    # Core request/response types
+    ActivateSignalRequest,
+    ActivateSignalResponse,
+    # Assets
+    AudioAsset,
+    # Core domain types
+    BrandManifest,  # Clean single type after upstream schema fix
+    BuildCreativeRequest,
+    BuildCreativeResponse,
+    # Pricing options
+    CpcPricingOption,
+    CpcvPricingOption,
+    CpmAuctionPricingOption,
+    CpmFixedRatePricingOption,
+    CppPricingOption,
+    CpvPricingOption,
+    CreateMediaBuyRequest,
+    CreateMediaBuyResponse,
+    Creative,
+    CreativeManifest,
+    # Enums and constants
+    CreativeStatus,
+    CssAsset,
+    Error,
+    FlatRatePricingOption,
+    Format,
+    GetMediaBuyDeliveryRequest,
+    GetMediaBuyDeliveryResponse,
+    GetProductsRequest,
+    GetProductsResponse,
+    GetSignalsRequest,
+    GetSignalsResponse,
+    HtmlAsset,
+    ImageAsset,
+    JavascriptAsset,
+    ListAuthorizedPropertiesRequest,
+    ListAuthorizedPropertiesResponse,
+    ListCreativeFormatsRequest,
+    ListCreativeFormatsResponse,
+    ListCreativesRequest,
+    ListCreativesResponse,
+    MarkdownAsset,
+    MediaBuy,
+    MediaBuyStatus,
+    Package,
+    PackageStatus,
+    PreviewCreativeRequest,
+    PreviewCreativeResponse,
+    PricingModel,
+    Product,
+    Property,
+    ProvidePerformanceFeedbackRequest,
+    ProvidePerformanceFeedbackResponse,
+    SyncCreativesRequest,
+    SyncCreativesResponse,
+    TasksGetRequest,
+    TasksGetResponse,
+    TasksListRequest,
+    TasksListResponse,
+    TaskStatus,
+    TaskType,
+    TextAsset,
+    UpdateMediaBuyRequest,
+    UpdateMediaBuyResponse,
+    UrlAsset,
+    VcpmAuctionPricingOption,
+    VcpmFixedRatePricingOption,
+    VideoAsset,
+    WebhookAsset,
+)
+
+# Note: BrandManifest is currently split into BrandManifest1/2 due to upstream schema
+# using anyOf incorrectly. This will be fixed upstream to create a single BrandManifest type.
+# For now, users should use BrandManifest1 (url required) which is most common.
+
+# Note: BrandManifest is now a single clean type
+# Re-export BrandManifest directly (no alias needed)
+
+# Re-export all stable types
+__all__ = [
+    # Request/Response types
+    "ActivateSignalRequest",
+    "ActivateSignalResponse",
+    "BuildCreativeRequest",
+    "BuildCreativeResponse",
+    "CreateMediaBuyRequest",
+    "CreateMediaBuyResponse",
+    "GetMediaBuyDeliveryRequest",
+    "GetMediaBuyDeliveryResponse",
+    "GetProductsRequest",
+    "GetProductsResponse",
+    "GetSignalsRequest",
+    "GetSignalsResponse",
+    "ListAuthorizedPropertiesRequest",
+    "ListAuthorizedPropertiesResponse",
+    "ListCreativeFormatsRequest",
+    "ListCreativeFormatsResponse",
+    "ListCreativesRequest",
+    "ListCreativesResponse",
+    "PreviewCreativeRequest",
+    "PreviewCreativeResponse",
+    "ProvidePerformanceFeedbackRequest",
+    "ProvidePerformanceFeedbackResponse",
+    "SyncCreativesRequest",
+    "SyncCreativesResponse",
+    "TasksGetRequest",
+    "TasksGetResponse",
+    "TasksListRequest",
+    "TasksListResponse",
+    "UpdateMediaBuyRequest",
+    "UpdateMediaBuyResponse",
+    # Domain types
+    "BrandManifest",  # Stable alias for BrandManifest1 (temporary until upstream fix)
+    "Creative",
+    "CreativeManifest",
+    "Error",
+    "Format",
+    "MediaBuy",
+    "Package",
+    "Product",
+    "Property",
+    # Pricing options
+    "CpcPricingOption",
+    "CpcvPricingOption",
+    "CpmAuctionPricingOption",
+    "CpmFixedRatePricingOption",
+    "CppPricingOption",
+    "CpvPricingOption",
+    "FlatRatePricingOption",
+    "VcpmAuctionPricingOption",
+    "VcpmFixedRatePricingOption",
+    # Status enums
+    "CreativeStatus",
+    "MediaBuyStatus",
+    "PackageStatus",
+    "PricingModel",
+    "TaskStatus",
+    "TaskType",
+    # Assets
+    "AudioAsset",
+    "CssAsset",
+    "HtmlAsset",
+    "ImageAsset",
+    "JavascriptAsset",
+    "MarkdownAsset",
+    "TextAsset",
+    "UrlAsset",
+    "VideoAsset",
+    "WebhookAsset",
+]

adcp/utils/preview_cache.py

@@ -10,7 +10,7 @@ from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
     from adcp.client import ADCPClient
-    from adcp.types.generated import CreativeManifest, Format, FormatId, Product
+    from adcp.types._generated import CreativeManifest, Format, FormatId, Product
 
 logger = logging.getLogger(__name__)
 
@@ -67,7 +67,7 @@ class PreviewURLGenerator:
         Returns:
             Preview data with preview_url and metadata, or None if generation fails
         """
-        from adcp.types.generated import PreviewCreativeRequest1
+        from adcp.types._generated import PreviewCreativeRequest1
 
         cache_key = _make_manifest_cache_key(format_id, manifest.model_dump(exclude_none=True))
 
@@ -123,7 +123,7 @@ class PreviewURLGenerator:
         Returns:
             List of preview data dicts (or None for failures), in same order as requests
         """
-        from adcp.types.generated import PreviewCreativeRequest
+        from adcp.types._generated import PreviewCreativeRequest
 
         if not requests:
             return []
@@ -396,7 +396,7 @@ def _create_sample_manifest_for_format(fmt: Format) -> CreativeManifest | None:
     Returns:
         Sample CreativeManifest, or None if unable to create one
     """
-    from adcp.types.generated import CreativeManifest
+    from adcp.types._generated import CreativeManifest
 
     if not fmt.assets_required:
         return None
@@ -436,7 +436,7 @@ def _create_sample_manifest_for_format_id(
     Returns:
         Sample CreativeManifest with placeholder assets
     """
-    from adcp.types.generated import CreativeManifest, ImageAsset, UrlAsset
+    from adcp.types._generated import CreativeManifest, ImageAsset, UrlAsset
 
     assets = {
         "primary_asset": ImageAsset(url="https://example.com/sample-image.jpg"),
@@ -456,7 +456,7 @@ def _create_sample_asset(asset_type: str | None) -> Any:
     Returns:
         Sample asset object (Pydantic model)
     """
-    from adcp.types.generated import (
+    from adcp.types._generated import (
         HtmlAsset,
         ImageAsset,
         TextAsset,

{adcp-2.4.0.dist-info → adcp-2.4.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: adcp
-Version: 2.4.0
+Version: 2.4.1
 Summary: Official Python client for the Ad Context Protocol (AdCP)
 Author-email: AdCP Community <maintainers@adcontextprotocol.org>
 License: Apache-2.0
@@ -246,10 +246,16 @@ client = ADCPClient(config)
 
 ### Type Safety
 
-Full type hints with Pydantic validation and auto-generated types from the AdCP spec:
+Full type hints with Pydantic validation and auto-generated types from the AdCP spec. All commonly-used types are exported from the main `adcp` package for convenience:
 
 ```python
-from adcp import GetProductsRequest
+from adcp import (
+    GetProductsRequest,
+    BrandManifest,
+    Package,
+    CpmFixedRatePricingOption,
+    MediaBuyStatus,
+)
 
 # All methods require typed request objects
 request = GetProductsRequest(brief="Coffee brands", max_results=10)
@@ -259,8 +265,27 @@ result = await agent.get_products(request)
 if result.success:
     for product in result.data.products:
         print(product.name, product.pricing_options)  # Full IDE autocomplete!
+
+# Type-safe pricing with discriminators
+pricing = CpmFixedRatePricingOption(
+    pricing_option_id="cpm_usd",
+    pricing_model="cpm",
+    is_fixed=True,  # Literal[True] - type checked!
+    currency="USD",
+    rate=5.0
+)
+
+# Type-safe status enums
+if media_buy.status == MediaBuyStatus.active:
+    print("Media buy is active")
 ```
 
+**Exported from main package:**
+- **Core domain types**: `BrandManifest`, `Creative`, `CreativeManifest`, `MediaBuy`, `Package`
+- **Status enums**: `CreativeStatus`, `MediaBuyStatus`, `PackageStatus`, `PricingModel`
+- **All 9 pricing options**: `CpcPricingOption`, `CpmFixedRatePricingOption`, `VcpmAuctionPricingOption`, etc.
+- **Request/Response types**: All 16 operations with full request/response types
+
 #### Semantic Type Aliases
 
 For discriminated union types (success/error responses), use semantic aliases for clearer code:
@@ -291,7 +316,7 @@ See `examples/type_aliases_demo.py` for more examples.
 **Import guidelines:**
 - ✅ **DO**: Import from main package: `from adcp import GetProductsRequest`
 - ✅ **DO**: Use semantic aliases: `from adcp import CreateMediaBuySuccessResponse`
-- ⚠️ **AVOID**: Import from internal modules: `from adcp.types.generated import CreateMediaBuyResponse1`
+- ⚠️ **AVOID**: Import from internal modules: `from adcp.types._generated import CreateMediaBuyResponse1`
 
 The main package exports provide a stable API while internal generated types may change.