adcp 1.2.1__tar.gz → 1.3.0__tar.gz

{adcp-1.2.1/src/adcp.egg-info → adcp-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: adcp
-Version: 1.2.1
+Version: 1.3.0
 Summary: Official Python client for the Ad Context Protocol (AdCP)
 Author-email: AdCP Community <maintainers@adcontextprotocol.org>
 License: Apache-2.0
@@ -61,8 +61,43 @@ pip install adcp
 
 > **Note**: This client requires Python 3.10 or later and supports both synchronous and asynchronous workflows.
 
+## Quick Start: Test Helpers
+
+The fastest way to get started is using the pre-configured test agents:
+
+```python
+from adcp.testing import test_agent
+from adcp.types.generated import GetProductsRequest
+
+# Zero configuration - just import and use!
+result = await test_agent.get_products(
+    GetProductsRequest(
+        brief="Coffee subscription service",
+        promoted_offering="Premium coffee deliveries"
+    )
+)
+
+if result.success:
+    print(f"Found {len(result.data.products)} products")
+```
+
+Test helpers include:
+- **`test_agent`**: Pre-configured MCP test agent with authentication
+- **`test_agent_a2a`**: Pre-configured A2A test agent with authentication
+- **`test_agent_no_auth`**: Pre-configured MCP test agent WITHOUT authentication
+- **`test_agent_a2a_no_auth`**: Pre-configured A2A test agent WITHOUT authentication
+- **`creative_agent`**: Reference creative agent for preview functionality
+- **`test_agent_client`**: Multi-agent client with both protocols
+- **`create_test_agent()`**: Factory for custom test configurations
+
+> **Note**: Test agents are rate-limited and for testing/examples only. DO NOT use in production.
+
+See [examples/test_helpers_demo.py](examples/test_helpers_demo.py) for more examples.
+
 ## Quick Start: Distributed Operations
 
+For production use, configure your own agents:
+
 ```python
 from adcp import ADCPMultiAgentClient, AgentConfig, GetProductsRequest
 
@@ -112,6 +147,66 @@ async with ADCPMultiAgentClient(
 
 ## Features
 
+### Test Helpers
+
+Pre-configured test agents for instant prototyping and testing:
+
+```python
+from adcp.testing import (
+    test_agent, test_agent_a2a,
+    test_agent_no_auth, test_agent_a2a_no_auth,
+    creative_agent, test_agent_client, create_test_agent
+)
+from adcp.types.generated import GetProductsRequest, PreviewCreativeRequest
+
+# 1. Single agent with authentication (MCP)
+result = await test_agent.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 2. Single agent with authentication (A2A)
+result = await test_agent_a2a.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 3. Single agent WITHOUT authentication (MCP)
+# Useful for testing unauthenticated behavior
+result = await test_agent_no_auth.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 4. Single agent WITHOUT authentication (A2A)
+result = await test_agent_a2a_no_auth.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 5. Creative agent (preview functionality, no auth required)
+result = await creative_agent.preview_creative(
+    PreviewCreativeRequest(
+        manifest={"format_id": "banner_300x250", "assets": {...}}
+    )
+)
+
+# 6. Multi-agent (parallel execution with both protocols)
+results = await test_agent_client.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 7. Custom configuration
+from adcp.client import ADCPClient
+config = create_test_agent(id="my-test", timeout=60.0)
+client = ADCPClient(config)
+```
+
+**Use cases:**
+- Quick prototyping and experimentation
+- Example code and documentation
+- Integration testing without mock servers
+- Testing authentication behavior (comparing auth vs no-auth results)
+- Learning AdCP concepts
+
+**Important:** Test agents are public, rate-limited, and for testing only. Never use in production.
+
 ### Full Protocol Support
 - **A2A Protocol**: Native support for Agent-to-Agent protocol
 - **MCP Protocol**: Native support for Model Context Protocol
@@ -377,6 +472,46 @@ uvx adcp --json myagent get_products '{"brief":"TV ads"}'
 uvx adcp --debug myagent get_products '{"brief":"TV ads"}'
 ```
 
+### Using Test Agents from CLI
+
+The CLI provides easy access to public test agents without configuration:
+
+```bash
+# Use test agent with authentication (MCP)
+uvx adcp https://test-agent.adcontextprotocol.org/mcp/ \
+  --auth 1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ \
+  get_products '{"brief":"Coffee brands"}'
+
+# Use test agent WITHOUT authentication (MCP)
+uvx adcp https://test-agent.adcontextprotocol.org/mcp/ \
+  get_products '{"brief":"Coffee brands"}'
+
+# Use test agent with authentication (A2A)
+uvx adcp --protocol a2a \
+  --auth 1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ \
+  https://test-agent.adcontextprotocol.org \
+  get_products '{"brief":"Coffee brands"}'
+
+# Save test agent for easier access
+uvx adcp --save-auth test-agent https://test-agent.adcontextprotocol.org/mcp/ mcp
+# Enter token when prompted: 1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ
+
+# Now use saved config
+uvx adcp test-agent get_products '{"brief":"Coffee brands"}'
+
+# Use creative agent (no auth required)
+uvx adcp https://creative.adcontextprotocol.org/mcp \
+  preview_creative @creative_manifest.json
+```
+
+**Test Agent Details:**
+- **URL (MCP)**: `https://test-agent.adcontextprotocol.org/mcp/`
+- **URL (A2A)**: `https://test-agent.adcontextprotocol.org`
+- **Auth Token**: `1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ` (optional, public token)
+- **Rate Limited**: For testing only, not for production
+- **No Auth Mode**: Omit `--auth` flag to test unauthenticated behavior
+```
+
 ### Configuration Management
 
 ```bash

{adcp-1.2.1 → adcp-1.3.0}/README.md

@@ -24,8 +24,43 @@ pip install adcp
 
 > **Note**: This client requires Python 3.10 or later and supports both synchronous and asynchronous workflows.
 
+## Quick Start: Test Helpers
+
+The fastest way to get started is using the pre-configured test agents:
+
+```python
+from adcp.testing import test_agent
+from adcp.types.generated import GetProductsRequest
+
+# Zero configuration - just import and use!
+result = await test_agent.get_products(
+    GetProductsRequest(
+        brief="Coffee subscription service",
+        promoted_offering="Premium coffee deliveries"
+    )
+)
+
+if result.success:
+    print(f"Found {len(result.data.products)} products")
+```
+
+Test helpers include:
+- **`test_agent`**: Pre-configured MCP test agent with authentication
+- **`test_agent_a2a`**: Pre-configured A2A test agent with authentication
+- **`test_agent_no_auth`**: Pre-configured MCP test agent WITHOUT authentication
+- **`test_agent_a2a_no_auth`**: Pre-configured A2A test agent WITHOUT authentication
+- **`creative_agent`**: Reference creative agent for preview functionality
+- **`test_agent_client`**: Multi-agent client with both protocols
+- **`create_test_agent()`**: Factory for custom test configurations
+
+> **Note**: Test agents are rate-limited and for testing/examples only. DO NOT use in production.
+
+See [examples/test_helpers_demo.py](examples/test_helpers_demo.py) for more examples.
+
 ## Quick Start: Distributed Operations
 
+For production use, configure your own agents:
+
 ```python
 from adcp import ADCPMultiAgentClient, AgentConfig, GetProductsRequest
 
@@ -75,6 +110,66 @@ async with ADCPMultiAgentClient(
 
 ## Features
 
+### Test Helpers
+
+Pre-configured test agents for instant prototyping and testing:
+
+```python
+from adcp.testing import (
+    test_agent, test_agent_a2a,
+    test_agent_no_auth, test_agent_a2a_no_auth,
+    creative_agent, test_agent_client, create_test_agent
+)
+from adcp.types.generated import GetProductsRequest, PreviewCreativeRequest
+
+# 1. Single agent with authentication (MCP)
+result = await test_agent.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 2. Single agent with authentication (A2A)
+result = await test_agent_a2a.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 3. Single agent WITHOUT authentication (MCP)
+# Useful for testing unauthenticated behavior
+result = await test_agent_no_auth.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 4. Single agent WITHOUT authentication (A2A)
+result = await test_agent_a2a_no_auth.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 5. Creative agent (preview functionality, no auth required)
+result = await creative_agent.preview_creative(
+    PreviewCreativeRequest(
+        manifest={"format_id": "banner_300x250", "assets": {...}}
+    )
+)
+
+# 6. Multi-agent (parallel execution with both protocols)
+results = await test_agent_client.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 7. Custom configuration
+from adcp.client import ADCPClient
+config = create_test_agent(id="my-test", timeout=60.0)
+client = ADCPClient(config)
+```
+
+**Use cases:**
+- Quick prototyping and experimentation
+- Example code and documentation
+- Integration testing without mock servers
+- Testing authentication behavior (comparing auth vs no-auth results)
+- Learning AdCP concepts
+
+**Important:** Test agents are public, rate-limited, and for testing only. Never use in production.
+
 ### Full Protocol Support
 - **A2A Protocol**: Native support for Agent-to-Agent protocol
 - **MCP Protocol**: Native support for Model Context Protocol
@@ -340,6 +435,46 @@ uvx adcp --json myagent get_products '{"brief":"TV ads"}'
 uvx adcp --debug myagent get_products '{"brief":"TV ads"}'
 ```
 
+### Using Test Agents from CLI
+
+The CLI provides easy access to public test agents without configuration:
+
+```bash
+# Use test agent with authentication (MCP)
+uvx adcp https://test-agent.adcontextprotocol.org/mcp/ \
+  --auth 1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ \
+  get_products '{"brief":"Coffee brands"}'
+
+# Use test agent WITHOUT authentication (MCP)
+uvx adcp https://test-agent.adcontextprotocol.org/mcp/ \
+  get_products '{"brief":"Coffee brands"}'
+
+# Use test agent with authentication (A2A)
+uvx adcp --protocol a2a \
+  --auth 1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ \
+  https://test-agent.adcontextprotocol.org \
+  get_products '{"brief":"Coffee brands"}'
+
+# Save test agent for easier access
+uvx adcp --save-auth test-agent https://test-agent.adcontextprotocol.org/mcp/ mcp
+# Enter token when prompted: 1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ
+
+# Now use saved config
+uvx adcp test-agent get_products '{"brief":"Coffee brands"}'
+
+# Use creative agent (no auth required)
+uvx adcp https://creative.adcontextprotocol.org/mcp \
+  preview_creative @creative_manifest.json
+```
+
+**Test Agent Details:**
+- **URL (MCP)**: `https://test-agent.adcontextprotocol.org/mcp/`
+- **URL (A2A)**: `https://test-agent.adcontextprotocol.org`
+- **Auth Token**: `1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ` (optional, public token)
+- **Rate Limited**: For testing only, not for production
+- **No Auth Mode**: Omit `--auth` flag to test unauthenticated behavior
+```
+
 ### Configuration Management
 
 ```bash

{adcp-1.2.1 → adcp-1.3.0}/pyproject.toml

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

{adcp-1.2.1 → adcp-1.3.0}/src/adcp/__init__.py

@@ -18,6 +18,19 @@ from adcp.exceptions import (
     ADCPWebhookError,
     ADCPWebhookSignatureError,
 )
+
+# Test helpers
+from adcp.testing import (
+    CREATIVE_AGENT_CONFIG,
+    TEST_AGENT_A2A_CONFIG,
+    TEST_AGENT_MCP_CONFIG,
+    TEST_AGENT_TOKEN,
+    create_test_agent,
+    creative_agent,
+    test_agent,
+    test_agent_a2a,
+    test_agent_client,
+)
 from adcp.types.core import AgentConfig, Protocol, TaskResult, TaskStatus, WebhookMetadata
 from adcp.types.generated import (
     ActivateSignalError,
@@ -133,7 +146,7 @@ from adcp.types.generated import (
     TaskStatus as GeneratedTaskStatus,
 )
 
-__version__ = "1.2.1"
+__version__ = "1.3.0"
 
 __all__ = [
     # Client classes
@@ -145,6 +158,16 @@ __all__ = [
     "TaskResult",
     "TaskStatus",
     "WebhookMetadata",
+    # Test helpers
+    "test_agent",
+    "test_agent_a2a",
+    "creative_agent",
+    "test_agent_client",
+    "create_test_agent",
+    "TEST_AGENT_TOKEN",
+    "TEST_AGENT_MCP_CONFIG",
+    "TEST_AGENT_A2A_CONFIG",
+    "CREATIVE_AGENT_CONFIG",
     # Exceptions
     "ADCPError",
     "ADCPConnectionError",

adcp-1.3.0/src/adcp/testing/__init__.py

@@ -0,0 +1,38 @@
+"""Test helpers for AdCP client library.
+
+Provides pre-configured test agents for examples and quick testing.
+"""
+
+from __future__ import annotations
+
+from adcp.testing.test_helpers import (
+    CREATIVE_AGENT_CONFIG,
+    TEST_AGENT_A2A_CONFIG,
+    TEST_AGENT_A2A_NO_AUTH_CONFIG,
+    TEST_AGENT_MCP_CONFIG,
+    TEST_AGENT_MCP_NO_AUTH_CONFIG,
+    TEST_AGENT_TOKEN,
+    create_test_agent,
+    creative_agent,
+    test_agent,
+    test_agent_a2a,
+    test_agent_a2a_no_auth,
+    test_agent_client,
+    test_agent_no_auth,
+)
+
+__all__ = [
+    "test_agent",
+    "test_agent_a2a",
+    "test_agent_no_auth",
+    "test_agent_a2a_no_auth",
+    "creative_agent",
+    "test_agent_client",
+    "create_test_agent",
+    "TEST_AGENT_TOKEN",
+    "TEST_AGENT_MCP_CONFIG",
+    "TEST_AGENT_A2A_CONFIG",
+    "TEST_AGENT_MCP_NO_AUTH_CONFIG",
+    "TEST_AGENT_A2A_NO_AUTH_CONFIG",
+    "CREATIVE_AGENT_CONFIG",
+]

adcp-1.3.0/src/adcp/testing/test_helpers.py

@@ -0,0 +1,311 @@
+"""Test agent helpers for easy examples and quick testing.
+
+These provide pre-configured access to AdCP's public test agent.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from adcp.client import ADCPClient, ADCPMultiAgentClient
+from adcp.types.core import AgentConfig, Protocol
+
+# Public test agent auth token
+# This token is public and rate-limited, for testing/examples only.
+TEST_AGENT_TOKEN = "1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ"
+
+# Public test agent configuration - MCP protocol
+TEST_AGENT_MCP_CONFIG = AgentConfig(
+    id="test-agent-mcp",
+    agent_uri="https://test-agent.adcontextprotocol.org/mcp/",
+    protocol=Protocol.MCP,
+    auth_token=TEST_AGENT_TOKEN,
+)
+
+# Public test agent configuration - A2A protocol
+TEST_AGENT_A2A_CONFIG = AgentConfig(
+    id="test-agent-a2a",
+    agent_uri="https://test-agent.adcontextprotocol.org",
+    protocol=Protocol.A2A,
+    auth_token=TEST_AGENT_TOKEN,
+)
+
+# Public test agent configuration (no auth) - MCP protocol
+TEST_AGENT_MCP_NO_AUTH_CONFIG = AgentConfig(
+    id="test-agent-mcp-no-auth",
+    agent_uri="https://test-agent.adcontextprotocol.org/mcp/",
+    protocol=Protocol.MCP,
+)
+
+# Public test agent configuration (no auth) - A2A protocol
+TEST_AGENT_A2A_NO_AUTH_CONFIG = AgentConfig(
+    id="test-agent-a2a-no-auth",
+    agent_uri="https://test-agent.adcontextprotocol.org",
+    protocol=Protocol.A2A,
+)
+
+# Reference creative agent configuration - MCP protocol
+# No authentication required for the reference creative agent
+CREATIVE_AGENT_CONFIG = AgentConfig(
+    id="creative-agent",
+    agent_uri="https://creative.adcontextprotocol.org/mcp",
+    protocol=Protocol.MCP,
+)
+
+
+def _create_test_agent_client() -> ADCPClient:
+    """Create pre-configured test agent client using MCP protocol.
+
+    Returns:
+        ADCPClient instance configured for the public test agent
+
+    Note:
+        This agent is rate-limited and intended for testing/examples only.
+        The auth token is public and may be rotated without notice.
+        DO NOT use in production applications.
+    """
+    return ADCPClient(TEST_AGENT_MCP_CONFIG)
+
+
+def _create_test_agent_a2a_client() -> ADCPClient:
+    """Create pre-configured test agent client using A2A protocol.
+
+    Returns:
+        ADCPClient instance configured for the public test agent
+
+    Note:
+        This agent is rate-limited and intended for testing/examples only.
+        The auth token is public and may be rotated without notice.
+        DO NOT use in production applications.
+    """
+    return ADCPClient(TEST_AGENT_A2A_CONFIG)
+
+
+def _create_test_agent_no_auth_client() -> ADCPClient:
+    """Create pre-configured test agent client (no auth) using MCP protocol.
+
+    Returns:
+        ADCPClient instance configured for the public test agent without authentication
+
+    Note:
+        This agent is rate-limited and intended for testing scenarios where no auth is provided.
+        Useful for testing behavior differences between authenticated and unauthenticated requests.
+        DO NOT use in production applications.
+    """
+    return ADCPClient(TEST_AGENT_MCP_NO_AUTH_CONFIG)
+
+
+def _create_test_agent_a2a_no_auth_client() -> ADCPClient:
+    """Create pre-configured test agent client (no auth) using A2A protocol.
+
+    Returns:
+        ADCPClient instance configured for the public test agent without authentication
+
+    Note:
+        This agent is rate-limited and intended for testing scenarios where no auth is provided.
+        Useful for testing behavior differences between authenticated and unauthenticated requests.
+        DO NOT use in production applications.
+    """
+    return ADCPClient(TEST_AGENT_A2A_NO_AUTH_CONFIG)
+
+
+def _create_creative_agent_client() -> ADCPClient:
+    """Create pre-configured creative agent client.
+
+    Returns:
+        ADCPClient instance configured for the reference creative agent
+
+    Note:
+        The reference creative agent is public and requires no authentication.
+        It provides creative preview functionality for testing and examples.
+    """
+    return ADCPClient(CREATIVE_AGENT_CONFIG)
+
+
+def _create_test_multi_agent_client() -> ADCPMultiAgentClient:
+    """Create multi-agent client with both test agents configured.
+
+    Returns:
+        ADCPMultiAgentClient with both MCP and A2A test agents
+
+    Note:
+        This client is rate-limited and intended for testing/examples only.
+        DO NOT use in production applications.
+    """
+    return ADCPMultiAgentClient([TEST_AGENT_MCP_CONFIG, TEST_AGENT_A2A_CONFIG])
+
+
+# Pre-configured test agent client using MCP protocol.
+# Ready to use for examples, documentation, and quick testing.
+#
+# Example:
+#     ```python
+#     from adcp.testing import test_agent
+#
+#     # Simple get_products call
+#     result = await test_agent.get_products(
+#         GetProductsRequest(
+#             brief="Coffee subscription service for busy professionals",
+#             promoted_offering="Premium monthly coffee deliveries"
+#         )
+#     )
+#
+#     if result.success:
+#         print(f"Found {len(result.data.products)} products")
+#     ```
+#
+# Note:
+#     This agent is rate-limited and intended for testing/examples only.
+#     The auth token is public and may be rotated without notice.
+#     DO NOT use in production applications.
+test_agent: ADCPClient = _create_test_agent_client()
+
+# Pre-configured test agent client using A2A protocol.
+# Identical functionality to test_agent but uses A2A instead of MCP.
+#
+# Example:
+#     ```python
+#     from adcp.testing import test_agent_a2a
+#
+#     result = await test_agent_a2a.get_products(
+#         GetProductsRequest(
+#             brief="Sustainable fashion brands",
+#             promoted_offering="Eco-friendly clothing"
+#         )
+#     )
+#     ```
+#
+# Note:
+#     This agent is rate-limited and intended for testing/examples only.
+#     The auth token is public and may be rotated without notice.
+#     DO NOT use in production applications.
+test_agent_a2a: ADCPClient = _create_test_agent_a2a_client()
+
+# Pre-configured test agent client (no auth) using MCP protocol.
+# Useful for testing scenarios where authentication is not provided,
+# such as testing how agents handle unauthenticated requests or
+# comparing behavior between authenticated and unauthenticated calls.
+#
+# Example:
+#     ```python
+#     from adcp.testing import test_agent_no_auth
+#
+#     # Test behavior without authentication
+#     result = await test_agent_no_auth.get_products(
+#         GetProductsRequest(
+#             brief="Coffee subscription service",
+#             promoted_offering="Premium monthly coffee"
+#         )
+#     )
+#     ```
+#
+# Note:
+#     This agent is rate-limited and intended for testing/examples only.
+#     DO NOT use in production applications.
+test_agent_no_auth: ADCPClient = _create_test_agent_no_auth_client()
+
+# Pre-configured test agent client (no auth) using A2A protocol.
+# Identical functionality to test_agent_no_auth but uses A2A instead of MCP.
+#
+# Example:
+#     ```python
+#     from adcp.testing import test_agent_a2a_no_auth
+#
+#     # Test A2A behavior without authentication
+#     result = await test_agent_a2a_no_auth.get_products(
+#         GetProductsRequest(
+#             brief="Sustainable fashion brands",
+#             promoted_offering="Eco-friendly clothing"
+#         )
+#     )
+#     ```
+#
+# Note:
+#     This agent is rate-limited and intended for testing/examples only.
+#     DO NOT use in production applications.
+test_agent_a2a_no_auth: ADCPClient = _create_test_agent_a2a_no_auth_client()
+
+# Pre-configured reference creative agent.
+# Provides creative preview functionality without authentication.
+#
+# Example:
+#     ```python
+#     from adcp.testing import creative_agent
+#     from adcp.types.generated import PreviewCreativeRequest
+#
+#     result = await creative_agent.preview_creative(
+#         PreviewCreativeRequest(
+#             manifest={
+#                 "format_id": "banner_300x250",
+#                 "assets": {...}
+#             }
+#         )
+#     )
+#     ```
+#
+# Note:
+#     The reference creative agent is public and requires no authentication.
+#     Perfect for testing creative rendering and preview functionality.
+creative_agent: ADCPClient = _create_creative_agent_client()
+
+# Multi-agent client with both test agents configured.
+# Useful for testing multi-agent patterns and protocol comparisons.
+#
+# Example:
+#     ```python
+#     from adcp.testing import test_agent_client
+#
+#     # Access individual agents
+#     mcp_agent = test_agent_client.agent("test-agent-mcp")
+#     a2a_agent = test_agent_client.agent("test-agent-a2a")
+#
+#     # Use for parallel operations
+#     results = await test_agent_client.get_products(
+#         GetProductsRequest(
+#             brief="Premium coffee brands",
+#             promoted_offering="Artisan coffee"
+#         )
+#     )
+#     ```
+#
+# Note:
+#     This client is rate-limited and intended for testing/examples only.
+#     DO NOT use in production applications.
+test_agent_client: ADCPMultiAgentClient = _create_test_multi_agent_client()
+
+
+def create_test_agent(**overrides: Any) -> AgentConfig:
+    """Create a custom test agent configuration.
+
+    Useful when you need to modify the default test agent setup.
+
+    Args:
+        **overrides: Keyword arguments to override default config values
+
+    Returns:
+        Complete agent configuration
+
+    Example:
+        ```python
+        from adcp.testing import create_test_agent
+        from adcp.client import ADCPClient
+
+        # Use default test agent with custom ID
+        config = create_test_agent(id="my-test-agent")
+        client = ADCPClient(config)
+        ```
+
+    Example:
+        ```python
+        # Use A2A protocol instead of MCP
+        from adcp.types.core import Protocol
+
+        config = create_test_agent(
+            protocol=Protocol.A2A,
+            agent_uri="https://test-agent.adcontextprotocol.org"
+        )
+        ```
+    """
+    base_config = TEST_AGENT_MCP_CONFIG.model_dump()
+    base_config.update(overrides)
+    return AgentConfig(**base_config)

{adcp-1.2.1 → adcp-1.3.0/src/adcp.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: adcp
-Version: 1.2.1
+Version: 1.3.0
 Summary: Official Python client for the Ad Context Protocol (AdCP)
 Author-email: AdCP Community <maintainers@adcontextprotocol.org>
 License: Apache-2.0
@@ -61,8 +61,43 @@ pip install adcp
 
 > **Note**: This client requires Python 3.10 or later and supports both synchronous and asynchronous workflows.
 
+## Quick Start: Test Helpers
+
+The fastest way to get started is using the pre-configured test agents:
+
+```python
+from adcp.testing import test_agent
+from adcp.types.generated import GetProductsRequest
+
+# Zero configuration - just import and use!
+result = await test_agent.get_products(
+    GetProductsRequest(
+        brief="Coffee subscription service",
+        promoted_offering="Premium coffee deliveries"
+    )
+)
+
+if result.success:
+    print(f"Found {len(result.data.products)} products")
+```
+
+Test helpers include:
+- **`test_agent`**: Pre-configured MCP test agent with authentication
+- **`test_agent_a2a`**: Pre-configured A2A test agent with authentication
+- **`test_agent_no_auth`**: Pre-configured MCP test agent WITHOUT authentication
+- **`test_agent_a2a_no_auth`**: Pre-configured A2A test agent WITHOUT authentication
+- **`creative_agent`**: Reference creative agent for preview functionality
+- **`test_agent_client`**: Multi-agent client with both protocols
+- **`create_test_agent()`**: Factory for custom test configurations
+
+> **Note**: Test agents are rate-limited and for testing/examples only. DO NOT use in production.
+
+See [examples/test_helpers_demo.py](examples/test_helpers_demo.py) for more examples.
+
 ## Quick Start: Distributed Operations
 
+For production use, configure your own agents:
+
 ```python
 from adcp import ADCPMultiAgentClient, AgentConfig, GetProductsRequest
 
@@ -112,6 +147,66 @@ async with ADCPMultiAgentClient(
 
 ## Features
 
+### Test Helpers
+
+Pre-configured test agents for instant prototyping and testing:
+
+```python
+from adcp.testing import (
+    test_agent, test_agent_a2a,
+    test_agent_no_auth, test_agent_a2a_no_auth,
+    creative_agent, test_agent_client, create_test_agent
+)
+from adcp.types.generated import GetProductsRequest, PreviewCreativeRequest
+
+# 1. Single agent with authentication (MCP)
+result = await test_agent.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 2. Single agent with authentication (A2A)
+result = await test_agent_a2a.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 3. Single agent WITHOUT authentication (MCP)
+# Useful for testing unauthenticated behavior
+result = await test_agent_no_auth.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 4. Single agent WITHOUT authentication (A2A)
+result = await test_agent_a2a_no_auth.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 5. Creative agent (preview functionality, no auth required)
+result = await creative_agent.preview_creative(
+    PreviewCreativeRequest(
+        manifest={"format_id": "banner_300x250", "assets": {...}}
+    )
+)
+
+# 6. Multi-agent (parallel execution with both protocols)
+results = await test_agent_client.get_products(
+    GetProductsRequest(brief="Coffee brands")
+)
+
+# 7. Custom configuration
+from adcp.client import ADCPClient
+config = create_test_agent(id="my-test", timeout=60.0)
+client = ADCPClient(config)
+```
+
+**Use cases:**
+- Quick prototyping and experimentation
+- Example code and documentation
+- Integration testing without mock servers
+- Testing authentication behavior (comparing auth vs no-auth results)
+- Learning AdCP concepts
+
+**Important:** Test agents are public, rate-limited, and for testing only. Never use in production.
+
 ### Full Protocol Support
 - **A2A Protocol**: Native support for Agent-to-Agent protocol
 - **MCP Protocol**: Native support for Model Context Protocol
@@ -377,6 +472,46 @@ uvx adcp --json myagent get_products '{"brief":"TV ads"}'
 uvx adcp --debug myagent get_products '{"brief":"TV ads"}'
 ```
 
+### Using Test Agents from CLI
+
+The CLI provides easy access to public test agents without configuration:
+
+```bash
+# Use test agent with authentication (MCP)
+uvx adcp https://test-agent.adcontextprotocol.org/mcp/ \
+  --auth 1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ \
+  get_products '{"brief":"Coffee brands"}'
+
+# Use test agent WITHOUT authentication (MCP)
+uvx adcp https://test-agent.adcontextprotocol.org/mcp/ \
+  get_products '{"brief":"Coffee brands"}'
+
+# Use test agent with authentication (A2A)
+uvx adcp --protocol a2a \
+  --auth 1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ \
+  https://test-agent.adcontextprotocol.org \
+  get_products '{"brief":"Coffee brands"}'
+
+# Save test agent for easier access
+uvx adcp --save-auth test-agent https://test-agent.adcontextprotocol.org/mcp/ mcp
+# Enter token when prompted: 1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ
+
+# Now use saved config
+uvx adcp test-agent get_products '{"brief":"Coffee brands"}'
+
+# Use creative agent (no auth required)
+uvx adcp https://creative.adcontextprotocol.org/mcp \
+  preview_creative @creative_manifest.json
+```
+
+**Test Agent Details:**
+- **URL (MCP)**: `https://test-agent.adcontextprotocol.org/mcp/`
+- **URL (A2A)**: `https://test-agent.adcontextprotocol.org`
+- **Auth Token**: `1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ` (optional, public token)
+- **Rate Limited**: For testing only, not for production
+- **No Auth Mode**: Omit `--auth` flag to test unauthenticated behavior
+```
+
 ### Configuration Management
 
 ```bash

{adcp-1.2.1 → adcp-1.3.0}/src/adcp.egg-info/SOURCES.txt

@@ -16,6 +16,8 @@ src/adcp/protocols/__init__.py
 src/adcp/protocols/a2a.py
 src/adcp/protocols/base.py
 src/adcp/protocols/mcp.py
+src/adcp/testing/__init__.py
+src/adcp/testing/test_helpers.py
 src/adcp/types/__init__.py
 src/adcp/types/core.py
 src/adcp/types/generated.py
@@ -29,6 +31,7 @@ tests/test_client.py
 tests/test_code_generation.py
 tests/test_discriminated_unions.py
 tests/test_format_id_validation.py
+tests/test_helpers.py
 tests/test_preview_html.py
 tests/test_protocols.py
 tests/test_response_parser.py

adcp-1.3.0/tests/test_helpers.py

@@ -0,0 +1,239 @@
+"""Tests for the test helpers module."""
+
+from __future__ import annotations
+
+from adcp.client import ADCPClient, ADCPMultiAgentClient
+from adcp.testing import (
+    CREATIVE_AGENT_CONFIG,
+    TEST_AGENT_A2A_CONFIG,
+    TEST_AGENT_A2A_NO_AUTH_CONFIG,
+    TEST_AGENT_MCP_CONFIG,
+    TEST_AGENT_MCP_NO_AUTH_CONFIG,
+    TEST_AGENT_TOKEN,
+    create_test_agent,
+    creative_agent,
+    test_agent,
+    test_agent_a2a,
+    test_agent_a2a_no_auth,
+    test_agent_client,
+    test_agent_no_auth,
+)
+from adcp.types.core import Protocol
+
+
+def test_exports_from_testing_module():
+    """Test that all expected exports are available from testing module."""
+    # These imports should work without errors
+    from adcp.testing import (
+        TEST_AGENT_A2A_CONFIG,
+        TEST_AGENT_A2A_NO_AUTH_CONFIG,
+        TEST_AGENT_MCP_CONFIG,
+        TEST_AGENT_MCP_NO_AUTH_CONFIG,
+        TEST_AGENT_TOKEN,
+        create_test_agent,
+        test_agent,
+        test_agent_a2a,
+        test_agent_a2a_no_auth,
+        test_agent_client,
+        test_agent_no_auth,
+    )
+
+    assert test_agent is not None
+    assert test_agent_a2a is not None
+    assert test_agent_no_auth is not None
+    assert test_agent_a2a_no_auth is not None
+    assert test_agent_client is not None
+    assert callable(create_test_agent)
+    assert isinstance(TEST_AGENT_TOKEN, str)
+    assert TEST_AGENT_MCP_CONFIG is not None
+    assert TEST_AGENT_A2A_CONFIG is not None
+    assert TEST_AGENT_MCP_NO_AUTH_CONFIG is not None
+    assert TEST_AGENT_A2A_NO_AUTH_CONFIG is not None
+
+
+def test_test_agent_token():
+    """Test that TEST_AGENT_TOKEN is a valid string."""
+    assert isinstance(TEST_AGENT_TOKEN, str)
+    assert len(TEST_AGENT_TOKEN) > 0
+    assert TEST_AGENT_TOKEN == "1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ"
+
+
+def test_mcp_config_structure():
+    """Test TEST_AGENT_MCP_CONFIG has correct structure."""
+    assert TEST_AGENT_MCP_CONFIG.id == "test-agent-mcp"
+    assert TEST_AGENT_MCP_CONFIG.protocol == Protocol.MCP
+    # AgentConfig validator strips trailing slashes for consistency
+    assert TEST_AGENT_MCP_CONFIG.agent_uri == "https://test-agent.adcontextprotocol.org/mcp"
+    assert TEST_AGENT_MCP_CONFIG.auth_token is not None
+
+
+def test_a2a_config_structure():
+    """Test TEST_AGENT_A2A_CONFIG has correct structure."""
+    assert TEST_AGENT_A2A_CONFIG.id == "test-agent-a2a"
+    assert TEST_AGENT_A2A_CONFIG.protocol == Protocol.A2A
+    assert TEST_AGENT_A2A_CONFIG.agent_uri == "https://test-agent.adcontextprotocol.org"
+    assert TEST_AGENT_A2A_CONFIG.auth_token is not None
+
+
+def test_test_agent_is_adcp_client():
+    """Test that test_agent is an ADCPClient instance."""
+    assert isinstance(test_agent, ADCPClient)
+    assert hasattr(test_agent, "get_products")
+    assert hasattr(test_agent, "list_creative_formats")
+    assert callable(test_agent.get_products)
+    assert callable(test_agent.list_creative_formats)
+
+
+def test_test_agent_a2a_is_adcp_client():
+    """Test that test_agent_a2a is an ADCPClient instance."""
+    assert isinstance(test_agent_a2a, ADCPClient)
+    assert hasattr(test_agent_a2a, "get_products")
+    assert hasattr(test_agent_a2a, "list_creative_formats")
+    assert callable(test_agent_a2a.get_products)
+    assert callable(test_agent_a2a.list_creative_formats)
+
+
+def test_test_agent_client_is_multi_agent():
+    """Test that test_agent_client is an ADCPMultiAgentClient instance."""
+    assert isinstance(test_agent_client, ADCPMultiAgentClient)
+    assert hasattr(test_agent_client, "agent")
+    assert hasattr(test_agent_client, "agents")
+    assert callable(test_agent_client.agent)
+    assert len(test_agent_client.agent_ids) == 2
+
+
+def test_test_agent_client_provides_access_to_both_agents():
+    """Test that test_agent_client provides access to both MCP and A2A agents."""
+    mcp_agent = test_agent_client.agent("test-agent-mcp")
+    a2a_agent = test_agent_client.agent("test-agent-a2a")
+
+    assert mcp_agent is not None
+    assert a2a_agent is not None
+    assert isinstance(mcp_agent, ADCPClient)
+    assert isinstance(a2a_agent, ADCPClient)
+    assert hasattr(mcp_agent, "get_products")
+    assert hasattr(a2a_agent, "get_products")
+
+
+def test_create_test_agent_default():
+    """Test that create_test_agent creates valid config with defaults."""
+    config = create_test_agent()
+
+    assert config.id == "test-agent-mcp"
+    assert config.protocol == Protocol.MCP
+    assert config.auth_token is not None
+
+
+def test_create_test_agent_with_overrides():
+    """Test that create_test_agent allows overrides."""
+    config = create_test_agent(
+        id="custom-test-agent",
+        timeout=60.0,
+    )
+
+    assert config.id == "custom-test-agent"
+    assert config.timeout == 60.0
+    assert config.protocol == Protocol.MCP  # unchanged
+    assert config.auth_token is not None  # retained
+
+
+def test_create_test_agent_protocol_override():
+    """Test that create_test_agent allows protocol override."""
+    config = create_test_agent(
+        protocol=Protocol.A2A,
+        agent_uri="https://test-agent.adcontextprotocol.org",
+    )
+
+    assert config.protocol == Protocol.A2A
+    assert config.agent_uri == "https://test-agent.adcontextprotocol.org"
+
+
+def test_test_agent_config_match():
+    """Test that test_agent uses TEST_AGENT_MCP_CONFIG."""
+    assert test_agent.agent_config.id == TEST_AGENT_MCP_CONFIG.id
+    assert test_agent.agent_config.protocol == TEST_AGENT_MCP_CONFIG.protocol
+
+
+def test_test_agent_a2a_config_match():
+    """Test that test_agent_a2a uses TEST_AGENT_A2A_CONFIG."""
+    assert test_agent_a2a.agent_config.id == TEST_AGENT_A2A_CONFIG.id
+    assert test_agent_a2a.agent_config.protocol == TEST_AGENT_A2A_CONFIG.protocol
+
+
+def test_agent_ids_in_test_agent_client():
+    """Test that test_agent_client has correct agent IDs."""
+    agent_ids = test_agent_client.agent_ids
+    assert "test-agent-mcp" in agent_ids
+    assert "test-agent-a2a" in agent_ids
+
+
+def test_creative_agent_config_structure():
+    """Test CREATIVE_AGENT_CONFIG has correct structure."""
+    assert CREATIVE_AGENT_CONFIG.id == "creative-agent"
+    assert CREATIVE_AGENT_CONFIG.protocol == Protocol.MCP
+    assert CREATIVE_AGENT_CONFIG.agent_uri == "https://creative.adcontextprotocol.org/mcp"
+    # Creative agent requires no authentication
+    assert CREATIVE_AGENT_CONFIG.auth_token is None
+
+
+def test_creative_agent_is_adcp_client():
+    """Test that creative_agent is an ADCPClient instance."""
+    assert isinstance(creative_agent, ADCPClient)
+    assert hasattr(creative_agent, "preview_creative")
+    assert hasattr(creative_agent, "list_creative_formats")
+    assert callable(creative_agent.preview_creative)
+    assert callable(creative_agent.list_creative_formats)
+
+
+def test_creative_agent_config_match():
+    """Test that creative_agent uses CREATIVE_AGENT_CONFIG."""
+    assert creative_agent.agent_config.id == CREATIVE_AGENT_CONFIG.id
+    assert creative_agent.agent_config.protocol == CREATIVE_AGENT_CONFIG.protocol
+
+
+def test_mcp_no_auth_config_structure():
+    """Test TEST_AGENT_MCP_NO_AUTH_CONFIG has correct structure."""
+    assert TEST_AGENT_MCP_NO_AUTH_CONFIG.id == "test-agent-mcp-no-auth"
+    assert TEST_AGENT_MCP_NO_AUTH_CONFIG.protocol == Protocol.MCP
+    assert TEST_AGENT_MCP_NO_AUTH_CONFIG.agent_uri == "https://test-agent.adcontextprotocol.org/mcp"
+    assert TEST_AGENT_MCP_NO_AUTH_CONFIG.auth_token is None
+
+
+def test_a2a_no_auth_config_structure():
+    """Test TEST_AGENT_A2A_NO_AUTH_CONFIG has correct structure."""
+    assert TEST_AGENT_A2A_NO_AUTH_CONFIG.id == "test-agent-a2a-no-auth"
+    assert TEST_AGENT_A2A_NO_AUTH_CONFIG.protocol == Protocol.A2A
+    assert TEST_AGENT_A2A_NO_AUTH_CONFIG.agent_uri == "https://test-agent.adcontextprotocol.org"
+    assert TEST_AGENT_A2A_NO_AUTH_CONFIG.auth_token is None
+
+
+def test_test_agent_no_auth_is_adcp_client():
+    """Test that test_agent_no_auth is an ADCPClient instance."""
+    assert isinstance(test_agent_no_auth, ADCPClient)
+    assert hasattr(test_agent_no_auth, "get_products")
+    assert hasattr(test_agent_no_auth, "list_creative_formats")
+    assert callable(test_agent_no_auth.get_products)
+    assert callable(test_agent_no_auth.list_creative_formats)
+
+
+def test_test_agent_a2a_no_auth_is_adcp_client():
+    """Test that test_agent_a2a_no_auth is an ADCPClient instance."""
+    assert isinstance(test_agent_a2a_no_auth, ADCPClient)
+    assert hasattr(test_agent_a2a_no_auth, "get_products")
+    assert hasattr(test_agent_a2a_no_auth, "list_creative_formats")
+    assert callable(test_agent_a2a_no_auth.get_products)
+    assert callable(test_agent_a2a_no_auth.list_creative_formats)
+
+
+def test_test_agent_no_auth_config_match():
+    """Test that test_agent_no_auth uses TEST_AGENT_MCP_NO_AUTH_CONFIG."""
+    assert test_agent_no_auth.agent_config.id == TEST_AGENT_MCP_NO_AUTH_CONFIG.id
+    assert test_agent_no_auth.agent_config.protocol == TEST_AGENT_MCP_NO_AUTH_CONFIG.protocol
+    assert test_agent_no_auth.agent_config.auth_token is None
+
+
+def test_test_agent_a2a_no_auth_config_match():
+    """Test that test_agent_a2a_no_auth uses TEST_AGENT_A2A_NO_AUTH_CONFIG."""
+    assert test_agent_a2a_no_auth.agent_config.id == TEST_AGENT_A2A_NO_AUTH_CONFIG.id
+    assert test_agent_a2a_no_auth.agent_config.protocol == TEST_AGENT_A2A_NO_AUTH_CONFIG.protocol
+    assert test_agent_a2a_no_auth.agent_config.auth_token is None