adcp 3.1.0__py3-none-any.whl → 3.2.0__py3-none-any.whl

adcp/ADCP_VERSION

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

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/__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/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/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/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/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/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/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/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.")

adcp/server/governance.py

@@ -306,42 +306,31 @@ class GovernanceHandler(ADCPHandler):
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "list_creative_formats is not supported by Governance agents."
-        )
+        return not_supported("list_creative_formats is not supported by Governance agents.")
 
-    async def list_authorized_properties(
+    async def list_accounts(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "list_authorized_properties is not supported by Governance agents. "
-            "Use get_property_list with resolve=true instead."
-        )
+        return not_supported("list_accounts is not supported by Governance agents.")
 
     async def sync_creatives(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "sync_creatives is not supported by Governance agents."
-        )
+        return not_supported("sync_creatives is not supported by Governance agents.")
 
     async def list_creatives(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "list_creatives is not supported by Governance agents."
-        )
+        return not_supported("list_creatives is not supported by Governance agents.")
 
     async def build_creative(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "build_creative is not supported by Governance agents."
-        )
+        return not_supported("build_creative is not supported by Governance agents.")
 
     async def create_media_buy(
         self, params: dict[str, Any], context: ToolContext | None = None
@@ -356,41 +345,31 @@ class GovernanceHandler(ADCPHandler):
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "update_media_buy is not supported by Governance agents."
-        )
+        return not_supported("update_media_buy is not supported by Governance agents.")
 
     async def get_media_buy_delivery(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "get_media_buy_delivery is not supported by Governance agents."
-        )
+        return not_supported("get_media_buy_delivery is not supported by Governance agents.")
 
     async def get_signals(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "get_signals is not supported by Governance agents."
-        )
+        return not_supported("get_signals is not supported by Governance agents.")
 
     async def activate_signal(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "activate_signal is not supported by Governance agents."
-        )
+        return not_supported("activate_signal is not supported by Governance agents.")
 
     async def provide_performance_feedback(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "provide_performance_feedback is not supported by Governance agents."
-        )
+        return not_supported("provide_performance_feedback is not supported by Governance agents.")
 
     # ========================================================================
     # V3 Content Standards - Not supported
@@ -409,49 +388,37 @@ class GovernanceHandler(ADCPHandler):
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "get_content_standards is not supported by Governance agents."
-        )
+        return not_supported("get_content_standards is not supported by Governance agents.")
 
     async def list_content_standards(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "list_content_standards is not supported by Governance agents."
-        )
+        return not_supported("list_content_standards is not supported by Governance agents.")
 
     async def update_content_standards(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "update_content_standards is not supported by Governance agents."
-        )
+        return not_supported("update_content_standards is not supported by Governance agents.")
 
     async def calibrate_content(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "calibrate_content is not supported by Governance agents."
-        )
+        return not_supported("calibrate_content is not supported by Governance agents.")
 
     async def validate_content_delivery(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "validate_content_delivery is not supported by Governance agents."
-        )
+        return not_supported("validate_content_delivery is not supported by Governance agents.")
 
     async def get_media_buy_artifacts(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "get_media_buy_artifacts is not supported by Governance agents."
-        )
+        return not_supported("get_media_buy_artifacts is not supported by Governance agents.")
 
     # ========================================================================
     # V3 Sponsored Intelligence - Not supported
@@ -470,22 +437,16 @@ class GovernanceHandler(ADCPHandler):
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "si_initiate_session is not supported by Governance agents."
-        )
+        return not_supported("si_initiate_session is not supported by Governance agents.")
 
     async def si_send_message(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "si_send_message is not supported by Governance agents."
-        )
+        return not_supported("si_send_message is not supported by Governance agents.")
 
     async def si_terminate_session(
         self, params: dict[str, Any], context: ToolContext | None = None
     ) -> NotImplementedResponse:
         """Not supported by Governance agents."""
-        return not_supported(
-            "si_terminate_session is not supported by Governance agents."
-        )
+        return not_supported("si_terminate_session is not supported by Governance agents.")

adcp/server/mcp_tools.py

@@ -43,13 +43,17 @@ ADCP_TOOL_DEFINITIONS: list[dict[str, Any]] = [
         },
     },
     {
-        "name": "list_authorized_properties",
-        "description": "List properties authorized for ad placement",
+        "name": "list_accounts",
+        "description": "List billing accounts accessible to the authenticated agent",
         "inputSchema": {
             "type": "object",
             "properties": {
-                "filters": {"type": "object"},
-                "pagination": {"type": "object"},
+                "status": {
+                    "type": "string",
+                    "enum": ["active", "suspended", "closed", "all"],
+                    "default": "active",
+                    "description": "Filter accounts by status",
+                },
             },
         },
     },

adcp/server/proposal.py

@@ -288,9 +288,7 @@ class ProposalBuilder:
 
         total = sum(a["allocation_percentage"] for a in self._allocations)
         if abs(total - 100.0) > 0.01:
-            raise ValueError(
-                f"Allocation percentages must sum to 100, got {total}"
-            )
+            raise ValueError(f"Allocation percentages must sum to 100, got {total}")
 
         proposal: dict[str, Any] = {
             "proposal_id": self._proposal_id,