adcp 3.1.0__tar.gz → 3.2.0__tar.gz

{adcp-3.1.0/src/adcp.egg-info → adcp-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: adcp
-Version: 3.1.0
+Version: 3.2.0
 Summary: Official Python client for the Ad Context Protocol (AdCP)
 Author-email: AdCP Community <maintainers@adcontextprotocol.org>
 License: Apache-2.0
@@ -511,8 +511,11 @@ All AdCP tools with full type safety:
 - `preview_creative()` - Preview creative before building
 - `build_creative()` - Generate production-ready creative assets
 
+**Discovery & Accounts:**
+- `get_adcp_capabilities()` - Discover agent capabilities and authorized publishers
+- `list_accounts()` - List billing accounts
+
 **Audience & Targeting:**
-- `list_authorized_properties()` - Get authorized properties
 - `get_signals()` - Get audience signals
 - `activate_signal()` - Activate audience signals
 - `provide_performance_feedback()` - Send performance feedback
@@ -760,12 +763,14 @@ Discover which publishers have authorized your agent using two approaches:
 
 **1. "Push" Approach** - Ask the agent (recommended, fastest):
 ```python
-from adcp import ADCPClient
+from adcp import ADCPClient, GetAdcpCapabilitiesRequest
 
 async with ADCPClient(agent_config) as client:
     # Single API call to agent
-    response = await client.simple.list_authorized_properties()
-    print(f"Authorized for: {response.publisher_domains}")
+    result = await client.get_adcp_capabilities(GetAdcpCapabilitiesRequest())
+    if result.success and result.data.media_buy:
+        portfolio = result.data.media_buy.portfolio
+        print(f"Authorized for: {portfolio.publisher_domains}")
 ```
 
 **2. "Pull" Approach** - Check publisher adagents.json files (when you need property details):

{adcp-3.1.0 → adcp-3.2.0}/README.md

@@ -470,8 +470,11 @@ All AdCP tools with full type safety:
 - `preview_creative()` - Preview creative before building
 - `build_creative()` - Generate production-ready creative assets
 
+**Discovery & Accounts:**
+- `get_adcp_capabilities()` - Discover agent capabilities and authorized publishers
+- `list_accounts()` - List billing accounts
+
 **Audience & Targeting:**
-- `list_authorized_properties()` - Get authorized properties
 - `get_signals()` - Get audience signals
 - `activate_signal()` - Activate audience signals
 - `provide_performance_feedback()` - Send performance feedback
@@ -719,12 +722,14 @@ Discover which publishers have authorized your agent using two approaches:
 
 **1. "Push" Approach** - Ask the agent (recommended, fastest):
 ```python
-from adcp import ADCPClient
+from adcp import ADCPClient, GetAdcpCapabilitiesRequest
 
 async with ADCPClient(agent_config) as client:
     # Single API call to agent
-    response = await client.simple.list_authorized_properties()
-    print(f"Authorized for: {response.publisher_domains}")
+    result = await client.get_adcp_capabilities(GetAdcpCapabilitiesRequest())
+    if result.success and result.data.media_buy:
+        portfolio = result.data.media_buy.portfolio
+        print(f"Authorized for: {portfolio.publisher_domains}")
 ```
 
 **2. "Pull" Approach** - Check publisher adagents.json files (when you need property details):

{adcp-3.1.0 → adcp-3.2.0}/pyproject.toml

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

adcp-3.2.0/src/adcp/ADCP_VERSION

@@ -0,0 +1 @@
+3.0.0-beta.2

{adcp-3.1.0 → adcp-3.2.0}/src/adcp/__init__.py

@@ -94,8 +94,8 @@ from adcp.types import (
     GetProductsResponse,
     GetSignalsRequest,
     GetSignalsResponse,
-    ListAuthorizedPropertiesRequest,
-    ListAuthorizedPropertiesResponse,
+    ListAccountsRequest,
+    ListAccountsResponse,
     ListCreativeFormatsRequest,
     ListCreativeFormatsResponse,
     ListCreativesRequest,
@@ -197,7 +197,7 @@ from adcp.webhooks import (
     get_adcp_signed_headers_for_webhook,
 )
 
-__version__ = "3.1.0"
+__version__ = "3.2.0"
 
 
 def get_adcp_version() -> str:
@@ -263,8 +263,8 @@ __all__ = [
     "GetSignalsRequest",
     "GetSignalsResponse",
     "SignalFilters",
-    "ListAuthorizedPropertiesRequest",
-    "ListAuthorizedPropertiesResponse",
+    "ListAccountsRequest",
+    "ListAccountsResponse",
     "ProvidePerformanceFeedbackRequest",
     "ProvidePerformanceFeedbackResponse",
     "Error",

{adcp-3.1.0 → adcp-3.2.0}/src/adcp/__main__.py

@@ -193,9 +193,9 @@ def _get_dispatch_table() -> dict[str, tuple[str, type | None]]:
         "create_media_buy": ("create_media_buy", gen.CreateMediaBuyRequest),
         "update_media_buy": ("update_media_buy", gen.UpdateMediaBuyRequest),
         "get_media_buy_delivery": ("get_media_buy_delivery", gen.GetMediaBuyDeliveryRequest),
-        "list_authorized_properties": (
-            "list_authorized_properties",
-            gen.ListAuthorizedPropertiesRequest,
+        "list_accounts": (
+            "list_accounts",
+            gen.ListAccountsRequest,
         ),
         # Signals
         "get_signals": ("get_signals", gen.GetSignalsRequest),
@@ -491,7 +491,7 @@ def main() -> None:
         print("  adcp https://agent.example.com list_tools")
         print("\nV3 Protocol Examples:")
         print("  adcp myagent get_adcp_capabilities")
-        print("  adcp cs-agent calibrate_content '{\"content_standards_id\":\"cs-123\"}'")
+        print('  adcp cs-agent calibrate_content \'{"content_standards_id":"cs-123"}\'')
         print("  adcp si-agent si_get_offering")
         print("  adcp gov-agent list_property_lists")
         sys.exit(0)

{adcp-3.1.0 → adcp-3.2.0}/src/adcp/adagents.py

@@ -330,9 +330,7 @@ async def fetch_adagents(
     for depth in range(MAX_REDIRECT_DEPTH + 1):
         # Check for redirect loop
         if url in visited_urls:
-            raise AdagentsValidationError(
-                f"Circular redirect detected: {url} already visited"
-            )
+            raise AdagentsValidationError(f"Circular redirect detected: {url} already visited")
         visited_urls.add(url)
 
         data = await _fetch_adagents_url(url, timeout, user_agent, client)
@@ -427,9 +425,7 @@ async def _fetch_adagents_url(
             try:
                 validate_adagents(data)
             except ValidationError as e:
-                raise AdagentsValidationError(
-                    f"Invalid adagents.json structure: {e}"
-                ) from e
+                raise AdagentsValidationError(f"Invalid adagents.json structure: {e}") from e
         elif "authoritative_location" not in data:
             # Neither authorized_agents nor authoritative_location
             raise AdagentsValidationError(
@@ -693,8 +689,8 @@ async def fetch_agent_authorizations(
     properties your agent can access.
 
     This is the "pull" approach - you query publishers to see if they've authorized you.
-    For the "push" approach where the agent tells you what it's authorized for,
-    use the agent's list_authorized_properties endpoint via ADCPClient.
+    For the "push" approach where the agent tells you what billing accounts you can use,
+    use the agent's list_accounts endpoint via ADCPClient.
 
     Args:
         agent_url: URL of your sales agent
@@ -718,7 +714,7 @@ async def fetch_agent_authorizations(
         ...     print(f"  Tags: {ctx.property_tags}")
 
     See Also:
-        ADCPClient.list_authorized_properties: "Push" approach using the agent's API
+        ADCPClient.list_accounts: "Push" approach using the agent's API to list billing accounts
 
     Notes:
         - Silently skips domains where adagents.json is not found or invalid

{adcp-3.1.0 → adcp-3.2.0}/src/adcp/client.py

@@ -32,8 +32,8 @@ from adcp.types import (
     GetProductsResponse,
     GetSignalsRequest,
     GetSignalsResponse,
-    ListAuthorizedPropertiesRequest,
-    ListAuthorizedPropertiesResponse,
+    ListAccountsRequest,
+    ListAccountsResponse,
     ListCreativeFormatsRequest,
     ListCreativeFormatsResponse,
     ListCreativesRequest,
@@ -525,18 +525,20 @@ class ADCPClient:
 
         return self.adapter._parse_response(raw_result, GetMediaBuyDeliveryResponse)
 
-    async def list_authorized_properties(
+    async def list_accounts(
         self,
-        request: ListAuthorizedPropertiesRequest,
-    ) -> TaskResult[ListAuthorizedPropertiesResponse]:
+        request: ListAccountsRequest,
+    ) -> TaskResult[ListAccountsResponse]:
         """
-        List Authorized Properties.
+        List Accounts.
+
+        Lists billing accounts accessible to the authenticated agent.
 
         Args:
             request: Request parameters
 
         Returns:
-            TaskResult containing ListAuthorizedPropertiesResponse
+            TaskResult containing ListAccountsResponse
         """
         operation_id = create_operation_id()
         params = request.model_dump(exclude_none=True)
@@ -546,25 +548,25 @@ class ADCPClient:
                 type=ActivityType.PROTOCOL_REQUEST,
                 operation_id=operation_id,
                 agent_id=self.agent_config.id,
-                task_type="list_authorized_properties",
+                task_type="list_accounts",
                 timestamp=datetime.now(timezone.utc).isoformat(),
             )
         )
 
-        raw_result = await self.adapter.list_authorized_properties(params)
+        raw_result = await self.adapter.list_accounts(params)
 
         self._emit_activity(
             Activity(
                 type=ActivityType.PROTOCOL_RESPONSE,
                 operation_id=operation_id,
                 agent_id=self.agent_config.id,
-                task_type="list_authorized_properties",
+                task_type="list_accounts",
                 status=raw_result.status,
                 timestamp=datetime.now(timezone.utc).isoformat(),
             )
         )
 
-        return self.adapter._parse_response(raw_result, ListAuthorizedPropertiesResponse)
+        return self.adapter._parse_response(raw_result, ListAccountsResponse)
 
     async def get_signals(
         self,
@@ -1759,7 +1761,7 @@ class ADCPClient:
             "sync_creatives": SyncCreativesResponse,  # Union type
             "list_creatives": ListCreativesResponse,
             "get_media_buy_delivery": GetMediaBuyDeliveryResponse,
-            "list_authorized_properties": ListAuthorizedPropertiesResponse,
+            "list_accounts": ListAccountsResponse,
             "get_signals": GetSignalsResponse,
             "activate_signal": ActivateSignalResponse,  # Union type
             "provide_performance_feedback": ProvidePerformanceFeedbackResponse,

{adcp-3.1.0 → adcp-3.2.0}/src/adcp/protocols/a2a.py

@@ -437,9 +437,9 @@ class A2AAdapter(ProtocolAdapter):
         """Get media buy delivery."""
         return await self._call_a2a_tool("get_media_buy_delivery", params)
 
-    async def list_authorized_properties(self, params: dict[str, Any]) -> TaskResult[Any]:
-        """List authorized properties."""
-        return await self._call_a2a_tool("list_authorized_properties", params)
+    async def list_accounts(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """List billing accounts accessible to the authenticated agent."""
+        return await self._call_a2a_tool("list_accounts", params)
 
     async def get_signals(self, params: dict[str, Any]) -> TaskResult[Any]:
         """Get signals."""

{adcp-3.1.0 → adcp-3.2.0}/src/adcp/protocols/base.py

@@ -120,8 +120,8 @@ class ProtocolAdapter(ABC):
         pass
 
     @abstractmethod
-    async def list_authorized_properties(self, params: dict[str, Any]) -> TaskResult[Any]:
-        """List authorized properties."""
+    async def list_accounts(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """List billing accounts accessible to the authenticated agent."""
         pass
 
     @abstractmethod

{adcp-3.1.0 → adcp-3.2.0}/src/adcp/protocols/mcp.py

@@ -432,9 +432,9 @@ class MCPAdapter(ProtocolAdapter):
         """Get media buy delivery."""
         return await self._call_mcp_tool("get_media_buy_delivery", params)
 
-    async def list_authorized_properties(self, params: dict[str, Any]) -> TaskResult[Any]:
-        """List authorized properties."""
-        return await self._call_mcp_tool("list_authorized_properties", params)
+    async def list_accounts(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """List billing accounts accessible to the authenticated agent."""
+        return await self._call_mcp_tool("list_accounts", params)
 
     async def get_signals(self, params: dict[str, Any]) -> TaskResult[Any]:
         """Get signals."""

{adcp-3.1.0 → adcp-3.2.0}/src/adcp/server/base.py

@@ -74,9 +74,7 @@ class ADCPHandler(ABC):
     # Core Catalog Operations
     # ========================================================================
 
-    async def get_products(
-        self, params: dict[str, Any], context: ToolContext | None = None
-    ) -> Any:
+    async def get_products(self, params: dict[str, Any], context: ToolContext | None = None) -> Any:
         """Get advertising products.
 
         Override this to provide product catalog functionality.
@@ -92,14 +90,14 @@ class ADCPHandler(ABC):
         """
         return not_supported("list_creative_formats is not implemented by this agent")
 
-    async def list_authorized_properties(
+    async def list_accounts(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> Any:
-        """List authorized properties.
+        """List billing accounts accessible to the authenticated agent.
 
-        Override this to provide property authorization information.
+        Override this to provide account information.
         """
-        return not_supported("list_authorized_properties is not implemented by this agent")
+        return not_supported("list_accounts is not implemented by this agent")
 
     # ========================================================================
     # Creative Operations
@@ -167,9 +165,7 @@ class ADCPHandler(ABC):
     # Signal Operations
     # ========================================================================
 
-    async def get_signals(
-        self, params: dict[str, Any], context: ToolContext | None = None
-    ) -> Any:
+    async def get_signals(self, params: dict[str, Any], context: ToolContext | None = None) -> Any:
         """Get available signals.
 
         Override this to provide signal catalog.

{adcp-3.1.0 → adcp-3.2.0}/src/adcp/server/content_standards.py

@@ -393,41 +393,31 @@ class ContentStandardsHandler(ADCPHandler):
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "list_creative_formats is not supported by Content Standards agents."
-        )
+        return not_supported("list_creative_formats is not supported by Content Standards agents.")
 
-    async def list_authorized_properties(
+    async def list_accounts(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "list_authorized_properties is not supported by Content Standards agents."
-        )
+        return not_supported("list_accounts is not supported by Content Standards agents.")
 
     async def sync_creatives(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "sync_creatives is not supported by Content Standards agents."
-        )
+        return not_supported("sync_creatives is not supported by Content Standards agents.")
 
     async def list_creatives(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "list_creatives is not supported by Content Standards agents."
-        )
+        return not_supported("list_creatives is not supported by Content Standards agents.")
 
     async def build_creative(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "build_creative is not supported by Content Standards agents."
-        )
+        return not_supported("build_creative is not supported by Content Standards agents.")
 
     async def create_media_buy(
         self, params: dict[str, Any], context: ToolContext | None = None
@@ -442,33 +432,25 @@ class ContentStandardsHandler(ADCPHandler):
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "update_media_buy is not supported by Content Standards agents."
-        )
+        return not_supported("update_media_buy is not supported by Content Standards agents.")
 
     async def get_media_buy_delivery(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "get_media_buy_delivery is not supported by Content Standards agents."
-        )
+        return not_supported("get_media_buy_delivery is not supported by Content Standards agents.")
 
     async def get_signals(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "get_signals is not supported by Content Standards agents."
-        )
+        return not_supported("get_signals is not supported by Content Standards agents.")
 
     async def activate_signal(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "activate_signal is not supported by Content Standards agents."
-        )
+        return not_supported("activate_signal is not supported by Content Standards agents.")
 
     async def provide_performance_feedback(
         self, params: dict[str, Any], context: ToolContext | None = None
@@ -495,25 +477,19 @@ class ContentStandardsHandler(ADCPHandler):
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "si_initiate_session is not supported by Content Standards agents."
-        )
+        return not_supported("si_initiate_session is not supported by Content Standards agents.")
 
     async def si_send_message(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "si_send_message is not supported by Content Standards agents."
-        )
+        return not_supported("si_send_message is not supported by Content Standards agents.")
 
     async def si_terminate_session(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "si_terminate_session is not supported by Content Standards agents."
-        )
+        return not_supported("si_terminate_session is not supported by Content Standards agents.")
 
     # ========================================================================
     # V3 Governance (Property Lists) - Not supported
@@ -532,30 +508,22 @@ class ContentStandardsHandler(ADCPHandler):
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "get_property_list is not supported by Content Standards agents."
-        )
+        return not_supported("get_property_list is not supported by Content Standards agents.")
 
     async def list_property_lists(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "list_property_lists is not supported by Content Standards agents."
-        )
+        return not_supported("list_property_lists is not supported by Content Standards agents.")
 
     async def update_property_list(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "update_property_list is not supported by Content Standards agents."
-        )
+        return not_supported("update_property_list is not supported by Content Standards agents.")
 
     async def delete_property_list(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Content Standards agents."""
-        return not_supported(
-            "delete_property_list is not supported by Content Standards agents."
-        )
+        return not_supported("delete_property_list is not supported by Content Standards agents.")