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

adcp/__init__.py

@@ -104,6 +104,7 @@ from adcp.types.aliases import (
     BothPreviewRender,
     BuildCreativeErrorResponse,
     BuildCreativeSuccessResponse,
+    CreatedPackageReference,
     CreateMediaBuyErrorResponse,
     CreateMediaBuySuccessResponse,
     HtmlPreviewRender,
@@ -164,7 +165,7 @@ from adcp.validation import (
     validate_publisher_properties_item,
 )
 
-__version__ = "2.4.1"
+__version__ = "2.5.0"
 
 __all__ = [
     # Client classes
@@ -213,6 +214,8 @@ __all__ = [
     "CreativeManifest",
     "MediaBuy",
     "Package",
+    # Package type aliases
+    "CreatedPackageReference",
     # Status enums (for control flow)
     "CreativeStatus",
     "MediaBuyStatus",

adcp/types/__init__.py

@@ -12,6 +12,7 @@ adcp.types or adcp.types.stable for stable, versioned types.
 
 from adcp.types.aliases import (
     BothPreviewRender,
+    CreatedPackageReference,
     HtmlPreviewRender,
     InlineDaastAsset,
     InlineVastAsset,
@@ -86,6 +87,8 @@ __all__ = [
     "UrlDaastAsset",
     "UrlPreviewRender",
     "UrlVastAsset",
+    # Package type aliases
+    "CreatedPackageReference",
     # Stable API types (commonly used)
     "BrandManifest",
     "Creative",

adcp/types/_generated.py

@@ -10,7 +10,7 @@ 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: 2025-11-18 12:11:55 UTC
+Generation date: 2025-11-18 12:52:17 UTC
 """
 # ruff: noqa: E501, I001
 from __future__ import annotations

adcp/types/aliases.py

@@ -78,6 +78,12 @@ from adcp.types._generated import (
     VastAsset2,
 )
 
+# Import Package types directly from their modules to avoid collision issues
+from adcp.types.generated_poc.create_media_buy_response import (
+    Package as CreatedPackageInternal,
+)
+from adcp.types.generated_poc.package import Package as FullPackageInternal
+
 # ============================================================================
 # RESPONSE TYPE ALIASES - Success/Error Discriminated Unions
 # ============================================================================
@@ -201,6 +207,51 @@ MediaSubAsset = SubAsset1
 TextSubAsset = SubAsset2
 """SubAsset for text content (headlines, body text) - asset_kind='text', provides content."""
 
+# ============================================================================
+# PACKAGE TYPE ALIASES - Resolving Type Name Collisions
+# ============================================================================
+# The AdCP schemas define two genuinely different types both named "Package":
+#
+# 1. Full Package (from package.json schema):
+#    - Complete operational package with all fields (budget, pricing_option_id, etc.)
+#    - Used in MediaBuy, update operations, and package management
+#    - Has 12+ fields for full package configuration
+#
+# 2. Created Package (from create-media-buy-response.json schema):
+#    - Minimal response type with only IDs (buyer_ref, package_id)
+#    - Used in CreateMediaBuy success responses
+#    - Only 2 fields - represents newly created package references
+#
+# The code generator's "first wins" collision handling exports the Created Package
+# as "Package", shadowing the Full Package. These semantic aliases provide clear,
+# unambiguous names for both types.
+
+Package = FullPackageInternal
+"""Complete package configuration with all operational fields.
+
+This is the canonical Package type used throughout AdCP for package management.
+
+Used in:
+- MediaBuy.packages (list of full package details)
+- Update operations (modifying existing packages)
+- Package management (creating/configuring packages)
+
+Fields include: budget, pricing_option_id, product_id, status, bid_price,
+creative_assignments, format_ids_to_provide, impressions, pacing, targeting_overlay
+"""
+
+CreatedPackageReference = CreatedPackageInternal
+"""Minimal package reference with only IDs returned after creation.
+
+This is NOT the full Package type - it's a lightweight reference returned
+in CreateMediaBuySuccessResponse to indicate which packages were created.
+
+Used in:
+- CreateMediaBuySuccessResponse.packages (list of created package references)
+
+Fields: buyer_ref, package_id only
+"""
+
 # ============================================================================
 # EXPORTS
 # ============================================================================
@@ -246,4 +297,7 @@ __all__ = [
     # Update media buy responses
     "UpdateMediaBuySuccessResponse",
     "UpdateMediaBuyErrorResponse",
+    # Package type aliases
+    "CreatedPackageReference",
+    "Package",
 ]

adcp/types/stable.py

@@ -21,7 +21,6 @@ Schema Evolution:
 
 from __future__ import annotations
 
-# Import all generated types from internal consolidated module
 from adcp.types._generated import (
     # Core request/response types
     ActivateSignalRequest,
@@ -67,7 +66,6 @@ from adcp.types._generated import (
     MarkdownAsset,
     MediaBuy,
     MediaBuyStatus,
-    Package,
     PackageStatus,
     PreviewCreativeRequest,
     PreviewCreativeResponse,
@@ -94,6 +92,10 @@ from adcp.types._generated import (
     WebhookAsset,
 )
 
+# Import all generated types from internal consolidated module
+# Import Package directly from its module to avoid collision with Response Package
+from adcp.types.generated_poc.package import 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.
 # For now, users should use BrandManifest1 (url required) which is most common.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: adcp
-Version: 2.4.1
+Version: 2.5.0
 Summary: Official Python client for the Ad Context Protocol (AdCP)
 Author-email: AdCP Community <maintainers@adcontextprotocol.org>
 License: Apache-2.0
@@ -35,6 +35,8 @@ Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: datamodel-code-generator[http]>=0.35.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: pdoc3>=0.10.0; extra == "docs"
 Dynamic: license-file
 
 # adcp - Python Client for Ad Context Protocol
@@ -177,6 +179,18 @@ async with ADCPMultiAgentClient(
 # Connections automatically cleaned up here
 ```
 
+## Documentation
+
+- **[API Reference](https://adcontextprotocol.github.io/adcp-client-python/)** - Complete API documentation with type signatures and examples
+- **[Protocol Spec](https://github.com/adcontextprotocol/adcp)** - Ad Context Protocol specification
+- **[Examples](examples/)** - Code examples and usage patterns
+
+The API reference documentation is automatically generated from the code and includes:
+- Full type signatures for all methods
+- Field descriptions from JSON Schema
+- Method documentation with examples
+- Searchable interface
+
 ## Features
 
 ### Test Helpers
@@ -801,6 +815,7 @@ Apache 2.0 License - see [LICENSE](LICENSE) file for details.
 
 ## Support
 
-- **Documentation**: [docs.adcontextprotocol.org](https://docs.adcontextprotocol.org)
+- **API Reference**: [adcontextprotocol.github.io/adcp-client-python](https://adcontextprotocol.github.io/adcp-client-python/)
+- **Protocol Documentation**: [docs.adcontextprotocol.org](https://docs.adcontextprotocol.org)
 - **Issues**: [GitHub Issues](https://github.com/adcontextprotocol/adcp-client-python/issues)
 - **Protocol Spec**: [AdCP Specification](https://github.com/adcontextprotocol/adcp)

{adcp-2.4.1.dist-info → adcp-2.5.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-adcp/__init__.py,sha256=2ZLisXqlBpyfz7EqJMNgmpPsYWWM-Mbe0NNitcdIiuw,8505
+adcp/__init__.py,sha256=09hCpp_u_UXT672Lo8HbPTu_RNiWWzQf-UGBVIqFjds,8592
 adcp/__main__.py,sha256=YF2GUXF1LICW1TPxNQiGIfSp5cpAsejoEG2fuOgbzrc,12839
 adcp/adagents.py,sha256=o-vTBmdZvu9aER-TAlLLL3s-WGYY8N67jnrAH24lST8,22333
 adcp/client.py,sha256=Z70D0bHcLNmr0NBGXbFUvW8dBdzHkcv8CmFcYo3pIjw,28803
@@ -13,12 +13,12 @@ adcp/protocols/base.py,sha256=vBHD23Fzl_CCk_Gy9nvSbBYopcJlYkYyzoz-rhI8wHg,5214
 adcp/protocols/mcp.py,sha256=d9uSpGd0BKvQ0JxztkfDvHwoDrDYhuiw5oivpYOAbmM,16647
 adcp/testing/__init__.py,sha256=ZWp_floWjVZfy8RBG5v_FUXQ8YbN7xjXvVcX-_zl_HU,1416
 adcp/testing/test_helpers.py,sha256=-UKuxxyKQald5EvXxguQH34b3J0JdsxKH_nRT6GTjkQ,10029
-adcp/types/__init__.py,sha256=evh_YdppRd55wiOop5RR7FMbxfQD_7ejcFc5g5HjZIo,2521
-adcp/types/_generated.py,sha256=srPaLXmb8nQ4mkfuFNU87t_77k6ZrDyIFNHZLpqPLO8,14926
-adcp/types/aliases.py,sha256=Rj5_0Lo62RrNglrPMtYptVZkNSgcigFGyUVuG82k_2w,9013
+adcp/types/__init__.py,sha256=CXlUUpMRWyM20focXgl8pEz3WMqvpjAW9PzmyHXKRzA,2608
+adcp/types/_generated.py,sha256=p4U_P3BROGjCnS0Cd2o9ZJ_bShQLffB3D9_0D29JB0g,14926
+adcp/types/aliases.py,sha256=FGb7zYy6V2gKtzWWc2c_vx3NLwXYpEsyjts9peyOixQ,11244
 adcp/types/base.py,sha256=QoEuVfI4yzefup0dc2KN11AcJTbcGxRep7xOw5hXfs8,837
 adcp/types/core.py,sha256=RXkKCWCXS9BVJTNpe3Opm5O1I_LaQPMUuVwa-ipvS1Q,4839
-adcp/types/stable.py,sha256=AyTdam6W2AachsGi27GX_cAitw8TfogI0O62tuePKXk,4873
+adcp/types/stable.py,sha256=Q_rxnpLuUGfqGusiJcMuPADIGLQgs2uLp98S4YnAksw,4997
 adcp/types/generated_poc/__init__.py,sha256=bgFFvPK1-e04eOnyw0qmtVMzoA2V7GeAMPDVrx-VIwA,103
 adcp/types/generated_poc/activate_signal_request.py,sha256=mI1MskO30yEcbQQ7ueEExMF7FhfARQj0_kbz5CAdSzQ,1188
 adcp/types/generated_poc/activate_signal_response.py,sha256=ltt5yDsocK3VfELeRuMjUiNMmUZe__VP5az6fsMCOuc,2015
@@ -121,9 +121,9 @@ adcp/utils/__init__.py,sha256=uetvSJB19CjQbtwEYZiTnumJG11GsafQmXm5eR3hL7E,153
 adcp/utils/operation_id.py,sha256=wQX9Bb5epXzRq23xoeYPTqzu5yLuhshg7lKJZihcM2k,294
 adcp/utils/preview_cache.py,sha256=oc1AUkPrHHmUqfZa5920OCKY7qrDDR86XO6oi1PEHTA,18504
 adcp/utils/response_parser.py,sha256=uPk2vIH-RYZmq7y3i8lC4HTMQ3FfKdlgXKTjgJ1955M,6253
-adcp-2.4.1.dist-info/licenses/LICENSE,sha256=PF39NR3Ae8PLgBhg3Uxw6ju7iGVIf8hfv9LRWQdii_U,629
-adcp-2.4.1.dist-info/METADATA,sha256=UyKdK_BgJI9O3Cd3u1nPuCYTxk50-RlToMY0aZYlA_I,25057
-adcp-2.4.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-adcp-2.4.1.dist-info/entry_points.txt,sha256=DQKpcGsJX8DtVI_SGApQ7tNvqUB4zkTLaTAEpFgmi3U,44
-adcp-2.4.1.dist-info/top_level.txt,sha256=T1_NF0GefncFU9v_k56oDwKSJREyCqIM8lAwNZf0EOs,5
-adcp-2.4.1.dist-info/RECORD,,
+adcp-2.5.0.dist-info/licenses/LICENSE,sha256=PF39NR3Ae8PLgBhg3Uxw6ju7iGVIf8hfv9LRWQdii_U,629
+adcp-2.5.0.dist-info/METADATA,sha256=FckzUUiNpYqMSnMYPC810uZJL8il646fzXbR_-ooPXI,25810
+adcp-2.5.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+adcp-2.5.0.dist-info/entry_points.txt,sha256=DQKpcGsJX8DtVI_SGApQ7tNvqUB4zkTLaTAEpFgmi3U,44
+adcp-2.5.0.dist-info/top_level.txt,sha256=T1_NF0GefncFU9v_k56oDwKSJREyCqIM8lAwNZf0EOs,5
+adcp-2.5.0.dist-info/RECORD,,