adcp 2.18.0__py3-none-any.whl → 3.0.0__py3-none-any.whl

adcp/protocols/a2a.py

@@ -593,3 +593,87 @@ class A2AAdapter(ProtocolAdapter):
                 agent_id=self.agent_config.id,
                 agent_uri=self.agent_config.agent_uri,
             ) from e
+
+    # ========================================================================
+    # V3 Protocol Methods - Protocol Discovery
+    # ========================================================================
+
+    async def get_adcp_capabilities(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get AdCP capabilities from the agent."""
+        return await self._call_a2a_tool("get_adcp_capabilities", params)
+
+    # ========================================================================
+    # V3 Protocol Methods - Content Standards
+    # ========================================================================
+
+    async def create_content_standards(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Create content standards configuration."""
+        return await self._call_a2a_tool("create_content_standards", params)
+
+    async def get_content_standards(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get content standards configuration."""
+        return await self._call_a2a_tool("get_content_standards", params)
+
+    async def list_content_standards(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """List content standards configurations."""
+        return await self._call_a2a_tool("list_content_standards", params)
+
+    async def update_content_standards(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Update content standards configuration."""
+        return await self._call_a2a_tool("update_content_standards", params)
+
+    async def calibrate_content(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Calibrate content against standards."""
+        return await self._call_a2a_tool("calibrate_content", params)
+
+    async def validate_content_delivery(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Validate content delivery against standards."""
+        return await self._call_a2a_tool("validate_content_delivery", params)
+
+    async def get_media_buy_artifacts(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get artifacts associated with a media buy."""
+        return await self._call_a2a_tool("get_media_buy_artifacts", params)
+
+    # ========================================================================
+    # V3 Protocol Methods - Sponsored Intelligence
+    # ========================================================================
+
+    async def si_get_offering(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get sponsored intelligence offering."""
+        return await self._call_a2a_tool("si_get_offering", params)
+
+    async def si_initiate_session(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Initiate sponsored intelligence session."""
+        return await self._call_a2a_tool("si_initiate_session", params)
+
+    async def si_send_message(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Send message in sponsored intelligence session."""
+        return await self._call_a2a_tool("si_send_message", params)
+
+    async def si_terminate_session(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Terminate sponsored intelligence session."""
+        return await self._call_a2a_tool("si_terminate_session", params)
+
+    # ========================================================================
+    # V3 Protocol Methods - Governance (Property Lists)
+    # ========================================================================
+
+    async def create_property_list(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Create a property list for governance."""
+        return await self._call_a2a_tool("create_property_list", params)
+
+    async def get_property_list(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get a property list with optional resolution."""
+        return await self._call_a2a_tool("get_property_list", params)
+
+    async def list_property_lists(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """List property lists."""
+        return await self._call_a2a_tool("list_property_lists", params)
+
+    async def update_property_list(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Update a property list."""
+        return await self._call_a2a_tool("update_property_list", params)
+
+    async def delete_property_list(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Delete a property list."""
+        return await self._call_a2a_tool("delete_property_list", params)

adcp/protocols/base.py

@@ -188,3 +188,104 @@ class ProtocolAdapter(ABC):
         Implementations should close any open connections, clients, or other resources.
         """
         pass
+
+    # ========================================================================
+    # V3 Protocol Methods - Protocol Discovery
+    # ========================================================================
+
+    @abstractmethod
+    async def get_adcp_capabilities(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get AdCP capabilities from the agent."""
+        pass
+
+    # ========================================================================
+    # V3 Protocol Methods - Content Standards
+    # ========================================================================
+
+    @abstractmethod
+    async def create_content_standards(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Create content standards configuration."""
+        pass
+
+    @abstractmethod
+    async def get_content_standards(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get content standards configuration."""
+        pass
+
+    @abstractmethod
+    async def list_content_standards(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """List content standards configurations."""
+        pass
+
+    @abstractmethod
+    async def update_content_standards(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Update content standards configuration."""
+        pass
+
+    @abstractmethod
+    async def calibrate_content(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Calibrate content against standards."""
+        pass
+
+    @abstractmethod
+    async def validate_content_delivery(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Validate content delivery against standards."""
+        pass
+
+    @abstractmethod
+    async def get_media_buy_artifacts(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get artifacts associated with a media buy."""
+        pass
+
+    # ========================================================================
+    # V3 Protocol Methods - Sponsored Intelligence
+    # ========================================================================
+
+    @abstractmethod
+    async def si_get_offering(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get sponsored intelligence offering."""
+        pass
+
+    @abstractmethod
+    async def si_initiate_session(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Initiate sponsored intelligence session."""
+        pass
+
+    @abstractmethod
+    async def si_send_message(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Send message in sponsored intelligence session."""
+        pass
+
+    @abstractmethod
+    async def si_terminate_session(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Terminate sponsored intelligence session."""
+        pass
+
+    # ========================================================================
+    # V3 Protocol Methods - Governance (Property Lists)
+    # ========================================================================
+
+    @abstractmethod
+    async def create_property_list(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Create a property list for governance."""
+        pass
+
+    @abstractmethod
+    async def get_property_list(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get a property list with optional resolution."""
+        pass
+
+    @abstractmethod
+    async def list_property_lists(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """List property lists."""
+        pass
+
+    @abstractmethod
+    async def update_property_list(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Update a property list."""
+        pass
+
+    @abstractmethod
+    async def delete_property_list(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Delete a property list."""
+        pass

adcp/protocols/mcp.py

@@ -136,7 +136,9 @@ class MCPAdapter(ProtocolAdapter):
             and ("cancel scope" in exc_str or "async context" in exc_str)
         ) or (
             # HTTP errors during cleanup (if httpx is available)
-            HTTPX_AVAILABLE and HTTPStatusError is not None and isinstance(exc, HTTPStatusError)
+            HTTPX_AVAILABLE
+            and HTTPStatusError is not None
+            and isinstance(exc, HTTPStatusError)
         )
 
         if is_known_cleanup_error:
@@ -515,3 +517,87 @@ class MCPAdapter(ProtocolAdapter):
     async def close(self) -> None:
         """Close the MCP session and clean up resources."""
         await self._cleanup_failed_connection("during close")
+
+    # ========================================================================
+    # V3 Protocol Methods - Protocol Discovery
+    # ========================================================================
+
+    async def get_adcp_capabilities(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get AdCP capabilities from the agent."""
+        return await self._call_mcp_tool("get_adcp_capabilities", params)
+
+    # ========================================================================
+    # V3 Protocol Methods - Content Standards
+    # ========================================================================
+
+    async def create_content_standards(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Create content standards configuration."""
+        return await self._call_mcp_tool("create_content_standards", params)
+
+    async def get_content_standards(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get content standards configuration."""
+        return await self._call_mcp_tool("get_content_standards", params)
+
+    async def list_content_standards(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """List content standards configurations."""
+        return await self._call_mcp_tool("list_content_standards", params)
+
+    async def update_content_standards(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Update content standards configuration."""
+        return await self._call_mcp_tool("update_content_standards", params)
+
+    async def calibrate_content(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Calibrate content against standards."""
+        return await self._call_mcp_tool("calibrate_content", params)
+
+    async def validate_content_delivery(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Validate content delivery against standards."""
+        return await self._call_mcp_tool("validate_content_delivery", params)
+
+    async def get_media_buy_artifacts(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get artifacts associated with a media buy."""
+        return await self._call_mcp_tool("get_media_buy_artifacts", params)
+
+    # ========================================================================
+    # V3 Protocol Methods - Sponsored Intelligence
+    # ========================================================================
+
+    async def si_get_offering(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get sponsored intelligence offering."""
+        return await self._call_mcp_tool("si_get_offering", params)
+
+    async def si_initiate_session(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Initiate sponsored intelligence session."""
+        return await self._call_mcp_tool("si_initiate_session", params)
+
+    async def si_send_message(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Send message in sponsored intelligence session."""
+        return await self._call_mcp_tool("si_send_message", params)
+
+    async def si_terminate_session(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Terminate sponsored intelligence session."""
+        return await self._call_mcp_tool("si_terminate_session", params)
+
+    # ========================================================================
+    # V3 Protocol Methods - Governance (Property Lists)
+    # ========================================================================
+
+    async def create_property_list(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Create a property list for governance."""
+        return await self._call_mcp_tool("create_property_list", params)
+
+    async def get_property_list(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Get a property list with optional resolution."""
+        return await self._call_mcp_tool("get_property_list", params)
+
+    async def list_property_lists(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """List property lists."""
+        return await self._call_mcp_tool("list_property_lists", params)
+
+    async def update_property_list(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Update a property list."""
+        return await self._call_mcp_tool("update_property_list", params)
+
+    async def delete_property_list(self, params: dict[str, Any]) -> TaskResult[Any]:
+        """Delete a property list."""
+        return await self._call_mcp_tool("delete_property_list", params)

adcp/server/__init__.py

@@ -0,0 +1,49 @@
+"""ADCP Server Framework.
+
+Provides base classes and adapters for building ADCP-compliant servers/agents.
+Supports selective protocol implementation via protocol-specific adapters.
+
+Examples:
+    # Content Standards agent (stubs media buy operations)
+    from adcp.server import ContentStandardsHandler, create_mcp_tools
+
+    class MyContentHandler(ContentStandardsHandler):
+        async def create_content_standards(self, request):
+            # Implement your logic
+            pass
+
+    # Register with MCP server
+    tools = create_mcp_tools(MyContentHandler())
+"""
+
+from __future__ import annotations
+
+from adcp.server.base import (
+    ADCPHandler,
+    NotImplementedResponse,
+    ToolContext,
+    not_supported,
+)
+from adcp.server.content_standards import ContentStandardsHandler
+from adcp.server.governance import GovernanceHandler
+from adcp.server.mcp_tools import MCPToolSet, create_mcp_tools
+from adcp.server.proposal import ProposalBuilder, ProposalNotSupported
+from adcp.server.sponsored_intelligence import SponsoredIntelligenceHandler
+
+__all__ = [
+    # Base classes
+    "ADCPHandler",
+    "ToolContext",
+    "NotImplementedResponse",
+    "not_supported",
+    # Protocol handlers
+    "ContentStandardsHandler",
+    "GovernanceHandler",
+    "SponsoredIntelligenceHandler",
+    # Proposal helpers
+    "ProposalBuilder",
+    "ProposalNotSupported",
+    # MCP integration
+    "MCPToolSet",
+    "create_mcp_tools",
+]