adcp 2.7.0__tar.gz → 2.9.0__tar.gz

{adcp-2.7.0/src/adcp.egg-info → adcp-2.9.0}/PKG-INFO

@@ -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:

{adcp-2.7.0 → adcp-2.9.0}/README.md

@@ -466,12 +466,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:

{adcp-2.7.0 → adcp-2.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "adcp"
-version = "2.7.0"
+version = "2.9.0"
 description = "Official Python client for the Ad Context Protocol (AdCP)"
 authors = [
     {name = "AdCP Community", email = "maintainers@adcontextprotocol.org"}

{adcp-2.7.0 → adcp-2.9.0}/src/adcp/__init__.py

@@ -65,7 +65,6 @@ from adcp.types.aliases import (
     BothPreviewRender,
     BuildCreativeErrorResponse,
     BuildCreativeSuccessResponse,
-    CreatedPackageReference,
     CreateMediaBuyErrorResponse,
     CreateMediaBuySuccessResponse,
     HtmlPreviewRender,
@@ -109,6 +108,8 @@ from adcp.types.stable import (
     # Audience & Targeting
     ActivateSignalRequest,
     ActivateSignalResponse,
+    # Type enums from PR #222
+    AssetContentType,
     # Core domain types
     BrandManifest,
     # Creative Operations
@@ -132,6 +133,7 @@ from adcp.types.stable import (
     Error,
     FlatRatePricingOption,
     Format,
+    FormatCategory,
     FormatId,
     GetMediaBuyDeliveryRequest,
     GetMediaBuyDeliveryResponse,
@@ -177,7 +179,7 @@ from adcp.validation import (
     validate_publisher_properties_item,
 )
 
-__version__ = "2.7.0"
+__version__ = "2.9.0"
 
 __all__ = [
     # Client classes
@@ -219,6 +221,9 @@ __all__ = [
     "Error",
     "Format",
     "FormatId",
+    # New type enums from PR #222
+    "AssetContentType",
+    "FormatCategory",
     "Product",
     "Property",
     # Core domain types (from stable API)
@@ -228,8 +233,6 @@ __all__ = [
     "MediaBuy",
     "Package",
     "PackageRequest",
-    # Package type aliases
-    "CreatedPackageReference",
     # Status enums (for control flow)
     "CreativeStatus",
     "MediaBuyStatus",

{adcp-2.7.0 → adcp-2.9.0}/src/adcp/__main__.py

@@ -83,11 +83,17 @@ async def execute_tool(
 
 # Tool dispatch mapping - single source of truth for ADCP methods
 # Types are filled at runtime to avoid circular imports
+# Special case: list_tools takes no parameters (None means no request type)
 TOOL_DISPATCH: dict[str, tuple[str, type | None]] = {
+    "list_tools": ("list_tools", None),  # Protocol introspection - no request type
     "get_products": ("get_products", None),
     "list_creative_formats": ("list_creative_formats", None),
+    "preview_creative": ("preview_creative", None),
+    "build_creative": ("build_creative", None),
     "sync_creatives": ("sync_creatives", None),
     "list_creatives": ("list_creatives", None),
+    "create_media_buy": ("create_media_buy", None),
+    "update_media_buy": ("update_media_buy", None),
     "get_media_buy_delivery": ("get_media_buy_delivery", None),
     "list_authorized_properties": ("list_authorized_properties", None),
     "get_signals": ("get_signals", None),
@@ -122,8 +128,12 @@ async def _dispatch_tool(client: ADCPClient, tool_name: str, payload: dict[str,
             "list_creative_formats",
             gen.ListCreativeFormatsRequest,
         )
+        TOOL_DISPATCH["preview_creative"] = ("preview_creative", gen.PreviewCreativeRequest)
+        TOOL_DISPATCH["build_creative"] = ("build_creative", gen.BuildCreativeRequest)
         TOOL_DISPATCH["sync_creatives"] = ("sync_creatives", gen.SyncCreativesRequest)
         TOOL_DISPATCH["list_creatives"] = ("list_creatives", gen.ListCreativesRequest)
+        TOOL_DISPATCH["create_media_buy"] = ("create_media_buy", gen.CreateMediaBuyRequest)
+        TOOL_DISPATCH["update_media_buy"] = ("update_media_buy", gen.UpdateMediaBuyRequest)
         TOOL_DISPATCH["get_media_buy_delivery"] = (
             "get_media_buy_delivery",
             gen.GetMediaBuyDeliveryRequest,
@@ -144,21 +154,38 @@ async def _dispatch_tool(client: ADCPClient, tool_name: str, payload: dict[str,
         available = ", ".join(sorted(TOOL_DISPATCH.keys()))
         return TaskResult(
             status=TaskStatus.FAILED,
+            success=False,
             error=f"Unknown tool: {tool_name}. Available tools: {available}",
         )
 
     # Get method and request type
     method_name, request_type = TOOL_DISPATCH[tool_name]
+    method = getattr(client, method_name)
 
-    # Type guard - request_type should be initialized by this point
+    # Special case: list_tools takes no parameters and returns list[str], not TaskResult
+    if tool_name == "list_tools":
+        try:
+            tools = await method()
+            return TaskResult(
+                status=TaskStatus.COMPLETED,
+                data={"tools": tools},
+                success=True,
+            )
+        except Exception as e:
+            return TaskResult(
+                status=TaskStatus.FAILED,
+                success=False,
+                error=f"Failed to list tools: {e}",
+            )
+
+    # Type guard - request_type should be initialized by this point for non-list_tools
     if request_type is None:
         return TaskResult(
             status=TaskStatus.FAILED,
+            success=False,
             error=f"Internal error: {tool_name} request type not initialized",
         )
 
-    method = getattr(client, method_name)
-
     # Validate and invoke
     try:
         request = request_type(**payload)
@@ -173,6 +200,7 @@ async def _dispatch_tool(client: ADCPClient, tool_name: str, payload: dict[str,
 
         return TaskResult(
             status=TaskStatus.FAILED,
+            success=False,
             error=f"Invalid request payload for {tool_name}:\n" + "\n".join(error_details),
         )