adcp 2.7.0__py3-none-any.whl → 2.9.0__py3-none-any.whl

adcp/types/stable.py

@@ -22,15 +22,35 @@ Schema Evolution:
 from __future__ import annotations
 
 from adcp.types._generated import (
+    Action,
     # Core request/response types
     ActivateSignalRequest,
     ActivateSignalResponse,
+    AggregatedTotals,
     # Assets
+    Asset,
+    AssetContentType,  # New from PR #222: consolidated asset content types
+    AssetSelectors,
+    AssetsRequired,
+    AssignedPackage,
+    Assignments,
     AudioAsset,
+    Authentication,
+    AuthorizedAgents,
+    AuthorizedSalesAgents,
+    AvailableMetric,
+    AvailableReportingFrequency,
     # Core domain types
     BrandManifest,  # Clean single type after upstream schema fix
     BuildCreativeRequest,
     BuildCreativeResponse,
+    ByPackageItem,
+    Capability,
+    CatalogType,
+    CoBranding,
+    Colors,
+    Contact,
+    Country,
     # Pricing options
     CpcPricingOption,
     CpcvPricingOption,
@@ -41,45 +61,141 @@ from adcp.types._generated import (
     CreateMediaBuyRequest,
     CreateMediaBuyResponse,
     Creative,
+    CreativeAgent,
+    CreativeAsset,
+    CreativeAssignment,
     CreativeManifest,
+    CreativePolicy,
     # Enums and constants
     CreativeStatus,
     CssAsset,
+    DaastVersion,
+    DailyBreakdownItem,
+    DeliverTo,
+    DeliveryMeasurement,
+    DeliveryMetrics,
+    DeliveryType,
+    Details,
+    Direction,
+    Disclaimer,
+    Domain,
+    DomainBreakdown,
+    DoohMetrics,
+    Embedding,
     Error,
+    FeedbackSource,
+    FeedFormat,
+    FieldModel,
+    Filters,
     FlatRatePricingOption,
+    Fonts,
     Format,
+    FormatCard,
+    FormatCardDetailed,
+    FormatCategory,  # New from PR #222: format categories (display, video, native, etc.)
     FormatId,
+    FormatType,
+    FrequencyCap,
+    FrequencyCapScope,
+    GeoCountryAnyOfItem,
     GetMediaBuyDeliveryRequest,
     GetMediaBuyDeliveryResponse,
     GetProductsRequest,
     GetProductsResponse,
     GetSignalsRequest,
     GetSignalsResponse,
+    HistoryItem,
     HtmlAsset,
+    Identifier,
     ImageAsset,
+    Input,
     JavascriptAsset,
+    LandingPage,
     ListAuthorizedPropertiesRequest,
     ListAuthorizedPropertiesResponse,
     ListCreativeFormatsRequest,
     ListCreativeFormatsResponse,
     ListCreativesRequest,
     ListCreativesResponse,
+    Logo,
     MarkdownAsset,
+    MarkdownFlavor,
+    Measurement,
+    MeasurementPeriod,
     MediaBuy,
+    MediaBuyDelivery,
     MediaBuyStatus,
+    Metadata,
+    Method,
+    MetricType,
+    ModuleType,
+    NotificationType,
+    Offering,
+    OutputFormat,
+    Pacing,
     PackageRequest,
+    Packages,
     PackageStatus,
+    Pagination,
+    Parameters,
+    Performance,
+    PerformanceFeedback,
+    Placement,
+    Preview,
     PreviewCreativeRequest,
     PreviewCreativeResponse,
+    PreviewRender,
     PriceGuidance,
+    Pricing,
     PricingModel,
+    PrimaryCountry,
     Product,
+    ProductCard,
+    ProductCardDetailed,
+    ProductCatalog,
+    Progress,
+    PromotedOfferings,
+    PromotedProducts,
     Property,
+    PropertyIdentifierTypes,
+    PropertyType,
+    ProtocolEnvelope,
+    ProtocolResponse,
     ProvidePerformanceFeedbackRequest,
     ProvidePerformanceFeedbackResponse,
+    PublisherDomain,
+    PublisherIdentifierTypes,
     PushNotificationConfig,
+    QuartileData,
+    QuerySummary,
+    Render,
+    ReportingCapabilities,
+    ReportingFrequency,
+    ReportingPeriod,
+    ReportingWebhook,
+    Request,
+    RequestedMetric,
+    Response,
+    ResponseType,
+    Responsive,
+    Results,
+    Scheme,
+    Security,
+    Signal,
+    SignalType,
+    Sort,
+    SortApplied,
+    StandardFormatIds,
+    Status,
+    StatusFilter,
+    StatusFilterEnum,
+    StatusSummary,
     SyncCreativesRequest,
     SyncCreativesResponse,
+    Tag,
+    Tags,
+    TargetingOverlay,
+    Task,
     TasksGetRequest,
     TasksGetResponse,
     TasksListRequest,
@@ -87,19 +203,29 @@ from adcp.types._generated import (
     TaskStatus,
     TaskType,
     TextAsset,
+    Totals,
+    TrackingEvent,
+    Type,
+    Unit,
+    UpdateFrequency,
     UpdateMediaBuyRequest,
     UpdateMediaBuyResponse,
     UrlAsset,
+    UrlType,
+    ValidationMode,
+    VastVersion,
     VcpmAuctionPricingOption,
     VcpmFixedRatePricingOption,
+    VenueBreakdownItem,
     VideoAsset,
+    ViewThreshold,
     WebhookAsset,
     WebhookPayload,
 )
-
-# Import all generated types from internal consolidated module
-# Import Package from _generated (uses qualified name to avoid collision)
-from adcp.types._generated import _PackageFromPackage as Package
+from adcp.types._generated import (
+    # PR #223 unified responses, no more collision
+    _PackageFromPackage as Package,
+)
 
 # 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.
@@ -108,51 +234,128 @@ from adcp.types._generated import _PackageFromPackage as Package
 # Note: BrandManifest is now a single clean type
 # Re-export BrandManifest directly (no alias needed)
 
+# Backward compatibility notes:
+# - AssetType is maintained as an alias to AssetContentType for backward compatibility
+# - Will be removed in 3.0.0
+# - Package collision resolved by PR #223 (unified responses)
+
 # Re-export all stable types
 __all__ = [
     # Request/Response types
     "ActivateSignalRequest",
     "ActivateSignalResponse",
+    "Action",
+    "AggregatedTotals",
     "BuildCreativeRequest",
     "BuildCreativeResponse",
+    "ByPackageItem",
     "CreateMediaBuyRequest",
     "CreateMediaBuyResponse",
+    "DailyBreakdownItem",
+    "Details",
+    "Domain",
+    "DomainBreakdown",
     "GetMediaBuyDeliveryRequest",
     "GetMediaBuyDeliveryResponse",
     "GetProductsRequest",
     "GetProductsResponse",
     "GetSignalsRequest",
     "GetSignalsResponse",
+    "HistoryItem",
     "ListAuthorizedPropertiesRequest",
     "ListAuthorizedPropertiesResponse",
     "ListCreativeFormatsRequest",
     "ListCreativeFormatsResponse",
     "ListCreativesRequest",
     "ListCreativesResponse",
+    "MediaBuyDelivery",
     "PreviewCreativeRequest",
     "PreviewCreativeResponse",
+    "Progress",
+    "ProtocolEnvelope",
+    "ProtocolResponse",
     "ProvidePerformanceFeedbackRequest",
     "ProvidePerformanceFeedbackResponse",
+    "QuerySummary",
+    "SortApplied",
+    "StatusSummary",
     "SyncCreativesRequest",
     "SyncCreativesResponse",
+    "Task",
     "TasksGetRequest",
     "TasksGetResponse",
     "TasksListRequest",
     "TasksListResponse",
+    "Totals",
     "UpdateMediaBuyRequest",
     "UpdateMediaBuyResponse",
     # Domain types
-    "BrandManifest",  # Stable alias for BrandManifest1 (temporary until upstream fix)
+    "Asset",
+    "AssetSelectors",
+    "AssetContentType",  # New canonical name from PR #222
+    "AssetType",  # Deprecated alias for AssetContentType
+    "FormatCategory",  # New from PR #222
+    "AssetsRequired",
+    "AssignedPackage",
+    "Assignments",
+    "BrandManifest",
+    "Capability",
+    "CoBranding",
+    "Colors",
+    "Contact",
     "Creative",
+    "CreativeAgent",
+    "CreativeAsset",
+    "CreativeAssignment",
     "CreativeManifest",
+    "CreativePolicy",
+    "DeliveryMeasurement",
+    "DeliveryMetrics",
+    "Disclaimer",
+    "DoohMetrics",
+    "Embedding",
     "Error",
+    "FeedFormat",
+    "Filters",
+    "Fonts",
     "Format",
+    "FormatCard",
+    "FormatCardDetailed",
     "FormatId",
+    "Identifier",
+    "Input",
+    "LandingPage",
+    "Logo",
     "MediaBuy",
+    "Metadata",
+    "Offering",
     "Package",
     "PackageRequest",
+    "Packages",
+    "Parameters",
+    "Performance",
+    "PerformanceFeedback",
+    "Placement",
+    "Preview",
+    "PreviewRender",
+    "Pricing",
     "Product",
+    "ProductCard",
+    "ProductCardDetailed",
+    "ProductCatalog",
+    "PromotedOfferings",
+    "PromotedProducts",
     "Property",
+    "QuartileData",
+    "Render",
+    "Request",
+    "Response",
+    "Results",
+    "Signal",
+    "Tag",
+    "Tags",
+    "TargetingOverlay",
+    "VenueBreakdownItem",
     # Pricing-related types
     "CpcPricingOption",
     "CpcvPricingOption",
@@ -164,15 +367,70 @@ __all__ = [
     "PriceGuidance",
     "VcpmAuctionPricingOption",
     "VcpmFixedRatePricingOption",
-    # Status enums
+    # Status enums & simple types
+    "CatalogType",
+    "Country",
     "CreativeStatus",
+    "DaastVersion",
+    "DeliverTo",
+    "DeliveryType",
+    "Direction",
+    "FeedbackSource",
+    "FieldModel",
+    "FormatType",
+    "FrequencyCap",
+    "FrequencyCapScope",
+    "GeoCountryAnyOfItem",
+    "MarkdownFlavor",
+    "Measurement",
+    "MeasurementPeriod",
     "MediaBuyStatus",
+    "Method",
+    "MetricType",
+    "ModuleType",
+    "NotificationType",
+    "OutputFormat",
+    "Pacing",
     "PackageStatus",
+    "Pagination",
     "PricingModel",
+    "PrimaryCountry",
+    "PropertyIdentifierTypes",
+    "PropertyType",
+    "PublisherDomain",
+    "PublisherIdentifierTypes",
+    "ResponseType",
+    "Responsive",
+    "SignalType",
+    "Sort",
+    "StandardFormatIds",
+    "Status",
+    "StatusFilter",
+    "StatusFilterEnum",
     "TaskStatus",
     "TaskType",
-    # Configuration types
+    "TrackingEvent",
+    "Type",
+    "Unit",
+    "UpdateFrequency",
+    "UrlType",
+    "ValidationMode",
+    "VastVersion",
+    "ViewThreshold",
+    # Configuration & infrastructure types
+    "Authentication",
+    "AuthorizedAgents",
+    "AuthorizedSalesAgents",
+    "AvailableMetric",
+    "AvailableReportingFrequency",
     "PushNotificationConfig",
+    "ReportingCapabilities",
+    "ReportingFrequency",
+    "ReportingPeriod",
+    "ReportingWebhook",
+    "RequestedMetric",
+    "Scheme",
+    "Security",
     # Assets
     "AudioAsset",
     "CssAsset",
@@ -186,3 +444,6 @@ __all__ = [
     "WebhookAsset",
     "WebhookPayload",
 ]
+
+# Deprecated aliases for backward compatibility - will be removed in 3.0.0
+AssetType = AssetContentType  # Use AssetContentType instead

{adcp-2.7.0.dist-info → adcp-2.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: adcp
-Version: 2.7.0
+Version: 2.9.0
 Summary: Official Python client for the Ad Context Protocol (AdCP)
 Author-email: AdCP Community <maintainers@adcontextprotocol.org>
 License: Apache-2.0
@@ -507,12 +507,183 @@ All AdCP tools with full type safety:
 - `list_creatives()` - List creative assets
 - `get_media_buy_delivery()` - Get delivery performance
 
+**Creative Management:**
+- `preview_creative()` - Preview creative before building
+- `build_creative()` - Generate production-ready creative assets
+
 **Audience & Targeting:**
 - `list_authorized_properties()` - Get authorized properties
 - `get_signals()` - Get audience signals
 - `activate_signal()` - Activate audience signals
 - `provide_performance_feedback()` - Send performance feedback
 
+## Workflow Examples
+
+### Complete Media Buy Workflow
+
+A typical media buy workflow involves discovering products, creating the buy, and managing creatives:
+
+```python
+from adcp import ADCPClient, AgentConfig, GetProductsRequest, CreateMediaBuyRequest
+from adcp import BrandManifest, PublisherPropertiesAll
+
+# 1. Connect to agent
+config = AgentConfig(id="sales_agent", agent_uri="https://...", protocol="mcp")
+async with ADCPClient(config) as client:
+
+    # 2. Discover available products
+    products_result = await client.get_products(
+        GetProductsRequest(brief="Premium video inventory for coffee brand")
+    )
+
+    if products_result.success:
+        product = products_result.data.products[0]
+        print(f"Found product: {product.name}")
+
+    # 3. Create media buy reservation
+    media_buy_result = await client.create_media_buy(
+        CreateMediaBuyRequest(
+            brand_manifest=BrandManifest(
+                name="Coffee Co",
+                brand_url="https://coffeeco.com",
+                logo_url="https://coffeeco.com/logo.png",
+                # ... additional brand details
+            ),
+            packages=[{
+                "package_id": product.packages[0].package_id,
+                "quantity": 1000000  # impressions
+            }],
+            publisher_properties=PublisherPropertiesAll(
+                selection_type="all"  # Target all authorized properties
+            )
+        )
+    )
+
+    if media_buy_result.success:
+        media_buy_id = media_buy_result.data.media_buy_id
+        print(f"✅ Media buy created: {media_buy_id}")
+
+    # 4. Update media buy if needed
+    from adcp import UpdateMediaBuyPackagesRequest
+
+    update_result = await client.update_media_buy(
+        UpdateMediaBuyPackagesRequest(
+            media_buy_id=media_buy_id,
+            packages=[{
+                "package_id": product.packages[0].package_id,
+                "quantity": 1500000  # Increase budget
+            }]
+        )
+    )
+
+    if update_result.success:
+        print("✅ Media buy updated")
+```
+
+### Complete Creative Workflow
+
+Build and deliver production-ready creatives:
+
+```python
+from adcp import ADCPClient, AgentConfig
+from adcp import PreviewCreativeFormatRequest, BuildCreativeRequest
+from adcp import CreativeManifest, PlatformDeployment
+
+# 1. Connect to creative agent
+config = AgentConfig(id="creative_agent", agent_uri="https://...", protocol="mcp")
+async with ADCPClient(config) as client:
+
+    # 2. List available formats
+    formats_result = await client.list_creative_formats()
+
+    if formats_result.success:
+        format_id = formats_result.data.formats[0].format_id
+        print(f"Using format: {format_id.id}")
+
+    # 3. Preview creative (test before building)
+    preview_result = await client.preview_creative(
+        PreviewCreativeFormatRequest(
+            target_format_id=format_id.id,
+            inputs={
+                "headline": "Fresh Coffee Daily",
+                "cta": "Order Now"
+            },
+            output_format="url"  # Get preview URL
+        )
+    )
+
+    if preview_result.success:
+        preview_url = preview_result.data.renders[0].url
+        print(f"Preview at: {preview_url}")
+
+    # 4. Build production creative
+    build_result = await client.build_creative(
+        BuildCreativeRequest(
+            manifest=CreativeManifest(
+                format_id=format_id,
+                brand_url="https://coffeeco.com",
+                # ... creative content
+            ),
+            target_format_id=format_id.id,
+            deployment=PlatformDeployment(
+                type="platform",
+                platform_id="google_admanager"
+            )
+        )
+    )
+
+    if build_result.success:
+        vast_url = build_result.data.assets[0].url
+        print(f"✅ Creative ready: {vast_url}")
+```
+
+### Integrated Workflow: Media Buy + Creatives
+
+Combine both workflows for a complete campaign setup:
+
+```python
+from adcp import ADCPMultiAgentClient, AgentConfig
+from adcp import GetProductsRequest, CreateMediaBuyRequest, BuildCreativeRequest
+
+# Connect to both sales and creative agents
+async with ADCPMultiAgentClient(
+    agents=[
+        AgentConfig(id="sales", agent_uri="https://sales-agent.com", protocol="mcp"),
+        AgentConfig(id="creative", agent_uri="https://creative-agent.com", protocol="mcp"),
+    ]
+) as client:
+
+    # 1. Get products from sales agent
+    sales_agent = client.agent("sales")
+    products = await sales_agent.simple.get_products(
+        brief="Premium video inventory"
+    )
+
+    # 2. Get creative formats from creative agent
+    creative_agent = client.agent("creative")
+    formats = await creative_agent.simple.list_creative_formats()
+
+    # 3. Build creative asset
+    creative_result = await creative_agent.build_creative(
+        BuildCreativeRequest(
+            manifest=creative_manifest,
+            target_format_id=formats.formats[0].format_id.id
+        )
+    )
+
+    # 4. Create media buy with creative
+    media_buy_result = await sales_agent.create_media_buy(
+        CreateMediaBuyRequest(
+            brand_manifest=brand_manifest,
+            packages=[{"package_id": products.products[0].packages[0].package_id}],
+            publisher_properties=publisher_properties,
+            creative_urls=[creative_result.data.assets[0].url]
+        )
+    )
+
+    print(f"✅ Campaign live: {media_buy_result.data.media_buy_id}")
+```
+
 ## Property Discovery (AdCP v2.2.0)
 
 Build agent registries by discovering properties agents can sell: