solace-agent-mesh 1.11.2__py3-none-any.whl → 1.12.0__py3-none-any.whl

solace_agent_mesh/core_a2a/core_a2a_llm.txt

@@ -1,90 +0,0 @@
-# DEVELOPER GUIDE: core_a2a
-
-## Quick Summary
-The `core_a2a` directory provides a reusable service layer for core Agent-to-Agent (A2A) interactions. It handles task submission (both regular and streaming), task cancellation, and agent discovery processing while being decoupled from specific gateway implementations and SAC messaging details.
-
-## Files Overview
-- `__init__.py` - Package initialization file for the core A2A service layer
-- `service.py` - Main service class that encapsulates A2A protocol logic and agent registry operations
-
-## Developer API Reference
-
-### __init__.py
-**Purpose:** Package initialization for the core A2A service layer
-**Import:** `import solace_agent_mesh.core_a2a`
-
-No public classes, functions, or constants defined.
-
-### service.py
-**Purpose:** Provides the main CoreA2AService class for handling A2A protocol operations
-**Import:** `from solace_agent_mesh.core_a2a.service import CoreA2AService`
-
-**Classes:**
-- `CoreA2AService(agent_registry: AgentRegistry, namespace: str)` - Main service class for A2A operations
-  - `submit_task(agent_name: str, a2a_message: A2AMessage, session_id: str, client_id: str, reply_to_topic: str, user_id: str = "default_user", a2a_user_config: Optional[Dict[str, Any]] = None, metadata_override: Optional[Dict[str, Any]] = None) -> Tuple[str, Dict, Dict]` - Constructs topic, payload, and user properties for non-streaming task requests
-  - `submit_streaming_task(agent_name: str, a2a_message: A2AMessage, session_id: str, client_id: str, reply_to_topic: str, status_to_topic: str, user_id: str = "default_user", a2a_user_config: Optional[Dict[str, Any]] = None, metadata_override: Optional[Dict[str, Any]] = None) -> Tuple[str, Dict, Dict]` - Constructs topic, payload, and user properties for streaming task requests
-  - `cancel_task(agent_name: str, task_id: str, client_id: str, user_id: str = "default_user") -> Tuple[str, Dict, Dict]` - Constructs topic, payload, and user properties for task cancellation
-  - `get_agent(agent_name: str) -> Optional[AgentCard]` - Retrieves a specific agent card by name from the registry
-  - `get_all_agents() -> List[AgentCard]` - Retrieves all currently discovered agent cards from the registry
-  - `process_discovery_message(agent_card: AgentCard)` - Processes an incoming agent card discovery message
-  - `agent_registry: AgentRegistry` - The shared agent registry instance
-  - `namespace: str` - The namespace string
-  - `log_identifier: str` - Identifier used for logging
-
-**Functions:**
-None (all functionality is encapsulated in the CoreA2AService class)
-
-**Constants/Variables:**
-None
-
-**Usage Examples:**
-```python
-# Import required dependencies
-from solace_agent_mesh.core_a2a.service import CoreA2AService
-from solace_agent_mesh.common.agent_registry import AgentRegistry
-from a2a.types import A2AMessage, AgentCard
-
-# Initialize the service
-agent_registry = AgentRegistry()
-namespace = "my_NAMESPACE"
-service = CoreA2AService(agent_registry, namespace)
-
-# Submit a regular task
-message = A2AMessage(parts=[{"type": "text", "content": "Hello"}])
-topic, payload, user_props = service.submit_task(
-    agent_name="my_agent",
-    a2a_message=message,
-    session_id="session_123",
-    client_id="client_456",
-    reply_to_topic="responses/client_456",
-    user_id="user_789"
-)
-
-# Submit a streaming task
-topic, payload, user_props = service.submit_streaming_task(
-    agent_name="my_agent",
-    a2a_message=message,
-    session_id="session_123",
-    client_id="client_456",
-    reply_to_topic="responses/client_456",
-    status_to_topic="status/client_456",
-    user_id="user_789"
-)
-
-# Cancel a task
-topic, payload, user_props = service.cancel_task(
-    agent_name="my_agent",
-    task_id="task-abc123",
-    client_id="client_456"
-)
-
-# Get agent information
-agent = service.get_agent("my_agent")
-all_agents = service.get_all_agents()
-
-# Process discovery message
-agent_card = AgentCard(name="new_agent", description="A new agent")
-service.process_discovery_message(agent_card)
-```
-
-# content_hash: 64e02756b1b097e39257e8e52df701d758df0f8d022ea6d6b088057f7025a6d9

solace_agent_mesh/core_a2a/core_a2a_llm_detail.txt

@@ -1,101 +0,0 @@
-# LLM Summary Detail File
-
-This file is a concatenation of all individual *llm.txt files found in the 'core_a2a' directory tree. Each section below corresponds to a specific directory's summary file.
-
-================================================================================
-
-## Section 1: solace_agent_mesh/core_a2a/core_a2a_llm.txt
-
-**Source file:** `solace_agent_mesh/core_a2a/core_a2a_llm.txt`
-
-# DEVELOPER GUIDE: core_a2a
-
-## Quick Summary
-The `core_a2a` directory provides a reusable service layer for core Agent-to-Agent (A2A) interactions. It handles task submission (both regular and streaming), task cancellation, and agent discovery processing while being decoupled from specific gateway implementations and SAC messaging details.
-
-## Files Overview
-- `__init__.py` - Package initialization file for the core A2A service layer
-- `service.py` - Main service class that encapsulates A2A protocol logic and agent registry operations
-
-## Developer API Reference
-
-### __init__.py
-**Purpose:** Package initialization for the core A2A service layer
-**Import:** `import solace_agent_mesh.core_a2a`
-
-No public classes, functions, or constants defined.
-
-### service.py
-**Purpose:** Provides the main CoreA2AService class for handling A2A protocol operations
-**Import:** `from solace_agent_mesh.core_a2a.service import CoreA2AService`
-
-**Classes:**
-- `CoreA2AService(agent_registry: AgentRegistry, namespace: str)` - Main service class for A2A operations
-  - `submit_task(agent_name: str, a2a_message: A2AMessage, session_id: str, client_id: str, reply_to_topic: str, user_id: str = "default_user", a2a_user_config: Optional[Dict[str, Any]] = None, metadata_override: Optional[Dict[str, Any]] = None) -> Tuple[str, Dict, Dict]` - Constructs topic, payload, and user properties for non-streaming task requests
-  - `submit_streaming_task(agent_name: str, a2a_message: A2AMessage, session_id: str, client_id: str, reply_to_topic: str, status_to_topic: str, user_id: str = "default_user", a2a_user_config: Optional[Dict[str, Any]] = None, metadata_override: Optional[Dict[str, Any]] = None) -> Tuple[str, Dict, Dict]` - Constructs topic, payload, and user properties for streaming task requests
-  - `cancel_task(agent_name: str, task_id: str, client_id: str, user_id: str = "default_user") -> Tuple[str, Dict, Dict]` - Constructs topic, payload, and user properties for task cancellation
-  - `get_agent(agent_name: str) -> Optional[AgentCard]` - Retrieves a specific agent card by name from the registry
-  - `get_all_agents() -> List[AgentCard]` - Retrieves all currently discovered agent cards from the registry
-  - `process_discovery_message(agent_card: AgentCard)` - Processes an incoming agent card discovery message
-  - `agent_registry: AgentRegistry` - The shared agent registry instance
-  - `namespace: str` - The namespace string
-  - `log_identifier: str` - Identifier used for logging
-
-**Functions:**
-None (all functionality is encapsulated in the CoreA2AService class)
-
-**Constants/Variables:**
-None
-
-**Usage Examples:**
-```python
-# Import required dependencies
-from solace_agent_mesh.core_a2a.service import CoreA2AService
-from solace_agent_mesh.common.agent_registry import AgentRegistry
-from a2a.types import A2AMessage, AgentCard
-
-# Initialize the service
-agent_registry = AgentRegistry()
-namespace = "my_NAMESPACE"
-service = CoreA2AService(agent_registry, namespace)
-
-# Submit a regular task
-message = A2AMessage(parts=[{"type": "text", "content": "Hello"}])
-topic, payload, user_props = service.submit_task(
-    agent_name="my_agent",
-    a2a_message=message,
-    session_id="session_123",
-    client_id="client_456",
-    reply_to_topic="responses/client_456",
-    user_id="user_789"
-)
-
-# Submit a streaming task
-topic, payload, user_props = service.submit_streaming_task(
-    agent_name="my_agent",
-    a2a_message=message,
-    session_id="session_123",
-    client_id="client_456",
-    reply_to_topic="responses/client_456",
-    status_to_topic="status/client_456",
-    user_id="user_789"
-)
-
-# Cancel a task
-topic, payload, user_props = service.cancel_task(
-    agent_name="my_agent",
-    task_id="task-abc123",
-    client_id="client_456"
-)
-
-# Get agent information
-agent = service.get_agent("my_agent")
-all_agents = service.get_all_agents()
-
-# Process discovery message
-agent_card = AgentCard(name="new_agent", description="A new agent")
-service.process_discovery_message(agent_card)
-```
-
-================================================================================
-

solace_agent_mesh/gateway/base/base_llm.txt

@@ -1,226 +0,0 @@
-# DEVELOPER GUIDE: base
-
-## Quick Summary
-The `base` directory provides foundational abstract classes for building Gateway implementations within the Solace AI Connector. It establishes a framework for handling common gateway tasks such as application configuration, Solace broker integration, A2A (Agent-to-Agent) message protocol handling, and managing the lifecycle of requests from external platforms. Developers should subclass `BaseGatewayApp` and `BaseGatewayComponent` to create new gateways.
-
-## Files Overview
-- `__init__.py` - Marks the directory as a Python package
-- `app.py` - Contains the base application class that handles configuration, schema merging, and broker setup
-- `component.py` - Contains the core logic class for processing A2A messages and integrating with external platforms
-- `task_context.py` - Provides a thread-safe manager for mapping A2A task IDs to their original request context
-
-## Developer API Reference
-
-### __init__.py
-**Purpose:** Initializes the `gateway.base` Python package
-**Import:** `from solace_agent_mesh.gateway.base import ...`
-
----
-
-### app.py
-**Purpose:** Provides the base application class for gateway implementations with automated configuration schema merging, Solace broker setup, and component instantiation
-**Import:** `from solace_agent_mesh.gateway.base.app import BaseGatewayApp, BaseGatewayComponent`
-
-**Classes:**
-- `BaseGatewayComponent(ComponentBase)` - Base marker class for gateway components
-- `BaseGatewayApp(app_info: Dict[str, Any], **kwargs)` - Main application class to be subclassed for new gateways
-  - `_get_gateway_component_class(self) -> Type[BaseGatewayComponent]` - **[Abstract Method]** Must return the specific gateway component class
-  - `namespace: str` - Absolute topic prefix for A2A communication (e.g., 'myorg/dev')
-  - `gateway_id: str` - Unique ID for this gateway instance (auto-generated if not provided)
-  - `artifact_service_config: Dict` - Configuration for the shared ADK Artifact Service
-  - `enable_embed_resolution: bool` - Flag to enable/disable late-stage 'artifact_content' embed resolution
-  - `gateway_max_artifact_resolve_size_bytes: int` - Maximum size for resolving artifacts (default: 104857600)
-  - `gateway_recursive_embed_depth: int` - Maximum depth for recursive embed resolution (default: 12)
-  - `artifact_handling_mode: str` - How gateway handles file parts: "reference", "embed", or "passthrough"
-  - `gateway_max_message_size_bytes: int` - Maximum message size in bytes (default: 10MB)
-
-**Constants/Variables:**
-- `BASE_GATEWAY_APP_SCHEMA: Dict[str, List[Dict[str, Any]]]` - Base configuration schema automatically merged with subclass parameters
-- `SPECIFIC_APP_SCHEMA_PARAMS_ATTRIBUTE_NAME: str` - Class attribute name ("SPECIFIC_APP_SCHEMA_PARAMS") for subclass-specific config parameters
-
-**Usage Examples:**
-```python
-from typing import Type, List, Dict, Any
-from solace_agent_mesh.gateway.base.app import BaseGatewayApp, BaseGatewayComponent
-
-class MyGatewayComponent(BaseGatewayComponent):
-    # Implementation details...
-    pass
-
-class MyGatewayApp(BaseGatewayApp):
-    """Custom gateway application for My Platform."""
-    
-    # Define additional configuration parameters
-    SPECIFIC_APP_SCHEMA_PARAMS: List[Dict[str, Any]] = [
-        {
-            "name": "my_platform_api_key",
-            "required": True,
-            "type": "string",
-            "description": "API key for connecting to My Platform."
-        }
-    ]
-
-    def _get_gateway_component_class(self) -> Type[BaseGatewayComponent]:
-        return MyGatewayComponent
-
-# Usage in YAML config:
-# app_config:
-#   namespace: "myorg/prod"
-#   gateway_id: "my-gateway-instance-01"
-#   artifact_service:
-#     type: "local_file"
-#     base_path: "/data/artifacts"
-#   my_platform_api_key: "secret-key-here"
-```
-
----
-
-### component.py
-**Purpose:** Provides the abstract base class for gateway components containing core A2A protocol logic, service management, and external platform integration interface
-**Import:** `from solace_agent_mesh.gateway.base.component import BaseGatewayComponent`
-
-**Classes:**
-- `BaseGatewayComponent(resolve_artifact_uris_in_gateway: bool = True, **kwargs: Any)` - Abstract base class for gateway components
-  - **Public Methods:**
-    - `get_config(self, key: str, default: Any = None) -> Any` - Retrieves configuration from nested app_config or component_config
-    - `authenticate_and_enrich_user(self, external_event_data: Any) -> Optional[Dict[str, Any]]` - Orchestrates user authentication and identity enrichment
-    - `submit_a2a_task(self, target_agent_name: str, a2a_parts: List[ContentPart], external_request_context: Dict[str, Any], user_identity: Any, is_streaming: bool = True, api_version: str = "v2") -> str` - Submits task to target agent, returns task_id
-  - **Abstract Methods (Must be Implemented):**
-    - `_extract_initial_claims(self, external_event_data: Any) -> Optional[Dict[str, Any]]` - Extract identity claims from platform event (must return dict with 'id' key)
-    - `_start_listener(self) -> None` - Start external platform listener (e.g., web server, WebSocket)
-    - `_stop_listener(self) -> None` - Stop external platform listener
-    - `_translate_external_input(self, external_event: Any) -> Tuple[str, List[ContentPart], Dict[str, Any]]` - Convert external event to A2A format: (target_agent_name, a2a_parts, context)
-    - `_send_update_to_external(self, external_request_context: Dict[str, Any], event_data: Union[TaskStatusUpdateEvent, TaskArtifactUpdateEvent], is_final_chunk_of_update: bool) -> None` - Send streaming update to external platform
-    - `_send_final_response_to_external(self, external_request_context: Dict[str, Any], task_data: Task) -> None` - Send final response to external platform
-    - `_send_error_to_external(self, external_request_context: Dict[str, Any], error_data: JSONRPCError) -> None` - Send error to external platform
-  - **Properties:**
-    - `namespace: str` - A2A communication namespace
-    - `gateway_id: str` - Unique gateway instance ID
-    - `agent_registry: AgentRegistry` - Registry for discovered agents
-    - `core_a2a_service: CoreA2AService` - Core A2A protocol service
-    - `shared_artifact_service: Optional[BaseArtifactService]` - Artifact service instance
-    - `task_context_manager: TaskContextManager` - Thread-safe task context storage
-    - `identity_service: Optional[BaseIdentityService]` - Identity enrichment service
-
-**Usage Examples:**
-```python
-from typing import Any, Dict, List, Optional, Tuple, Union
-from solace_agent_mesh.gateway.base.component import BaseGatewayComponent
-from solace_agent_mesh.common.a2a.types import ContentPart
-from a2a.types import TextPart, Task, TaskStatusUpdateEvent, TaskArtifactUpdateEvent, JSONRPCError
-
-class MyGatewayComponent(BaseGatewayComponent):
-    
-    async def _extract_initial_claims(self, external_event_data: Any) -> Optional[Dict[str, Any]]:
-        """Extract user identity from platform-specific event."""
-        # Example for HTTP request
-        if hasattr(external_event_data, 'headers'):
-            user_id = external_event_data.headers.get('X-User-ID')
-            if user_id:
-                return {"id": user_id, "source": "http_header"}
-        return None
-    
-    def _start_listener(self) -> None:
-        """Start your platform listener (web server, etc.)."""
-        # Example: Start FastAPI server, WebSocket connection, etc.
-        pass
-    
-    def _stop_listener(self) -> None:
-        """Stop your platform listener."""
-        pass
-    
-    async def _translate_external_input(self, external_event: Any) -> Tuple[str, List[ContentPart], Dict[str, Any]]:
-        """Convert external event to A2A format."""
-        # Example translation
-        target_agent = "my-agent"
-        message_text = getattr(external_event, 'message', 'Hello')
-        a2a_parts = [TextPart(text=message_text)]
-        context = {
-            "platform": "my_platform",
-            "user_id_for_artifacts": "user123",
-            "a2a_session_id": "session456"
-        }
-        return target_agent, a2a_parts, context
-    
-    async def _send_update_to_external(self, external_request_context: Dict[str, Any], 
-                                     event_data: Union[TaskStatusUpdateEvent, TaskArtifactUpdateEvent], 
-                                     is_final_chunk_of_update: bool) -> None:
-        """Send streaming update back to external platform."""
-        # Extract text from event and send to your platform
-        pass
-    
-    async def _send_final_response_to_external(self, external_request_context: Dict[str, Any], 
-                                             task_data: Task) -> None:
-        """Send final response back to external platform."""
-        # Extract final result and send to your platform
-        pass
-    
-    async def _send_error_to_external(self, external_request_context: Dict[str, Any], 
-                                     error_data: JSONRPCError) -> None:
-        """Send error back to external platform."""
-        # Send error message to your platform
-        pass
-
-# Usage in your handler:
-async def handle_external_request(request):
-    # Authenticate user
-    user_identity = await component.authenticate_and_enrich_user(request)
-    if not user_identity:
-        return "Authentication failed"
-    
-    # Translate request
-    target_agent, a2a_parts, context = await component._translate_external_input(request)
-    
-    # Submit to A2A system
-    task_id = await component.submit_a2a_task(
-        target_agent_name=target_agent,
-        a2a_parts=a2a_parts,
-        external_request_context=context,
-        user_identity=user_identity,
-        is_streaming=True
-    )
-    
-    return f"Task submitted: {task_id}"
-```
-
----
-
-### task_context.py
-**Purpose:** Provides thread-safe storage for mapping A2A task IDs to their original external request context
-**Import:** `from solace_agent_mesh.gateway.base.task_context import TaskContextManager`
-
-**Classes:**
-- `TaskContextManager()` - Thread-safe context storage manager
-  - `store_context(self, task_id: str, context_data: Dict[str, Any]) -> None` - Store context for a task ID
-  - `get_context(self, task_id: str) -> Optional[Dict[str, Any]]` - Retrieve context for a task ID
-  - `remove_context(self, task_id: str) -> Optional[Dict[str, Any]]` - Remove and return context for a task ID
-  - `clear_all_contexts_for_testing(self) -> None` - Clear all contexts (testing only)
-
-**Usage Examples:**
-```python
-from solace_agent_mesh.gateway.base.task_context import TaskContextManager
-
-# Initialize manager
-context_manager = TaskContextManager()
-
-# Store context when submitting task
-task_id = "gdk-task-abc123"
-context = {
-    "platform": "slack",
-    "channel_id": "C1234567890",
-    "thread_ts": "1234567890.123456",
-    "user_identity": {"id": "user123", "name": "John Doe"}
-}
-context_manager.store_context(task_id, context)
-
-# Retrieve context when processing response
-retrieved_context = context_manager.get_context(task_id)
-if retrieved_context:
-    channel_id = retrieved_context["channel_id"]
-    # Send response back to Slack channel
-
-# Clean up when task is complete
-context_manager.remove_context(task_id)
-```
-
-# content_hash: 74574cc0c8234142d9ecddd116cc306b5420f938289ab4eab77feaa225adae7a

solace_agent_mesh/gateway/base/base_llm_detail.txt

@@ -1,235 +0,0 @@
-# LLM Summary Detail File
-
-This file is a concatenation of all individual *llm.txt files found in the 'base' directory tree. Each section below corresponds to a specific directory's summary file.
-
-================================================================================
-
-## Section 1: solace_agent_mesh/gateway/base/base_llm.txt
-
-**Source file:** `solace_agent_mesh/gateway/base/base_llm.txt`
-
-# DEVELOPER GUIDE: base
-
-## Quick Summary
-The `base` directory provides foundational abstract classes for building Gateway implementations within the Solace AI Connector. It establishes a framework for handling common gateway tasks such as application configuration, Solace broker integration, A2A (Agent-to-Agent) message protocol handling, and managing the lifecycle of requests from external platforms. Developers should subclass `BaseGatewayApp` and `BaseGatewayComponent` to create new gateways.
-
-## Files Overview
-- `__init__.py` - Marks the directory as a Python package
-- `app.py` - Contains the base application class that handles configuration, schema merging, and broker setup
-- `component.py` - Contains the core logic class for processing A2A messages and integrating with external platforms
-- `task_context.py` - Provides a thread-safe manager for mapping A2A task IDs to their original request context
-
-## Developer API Reference
-
-### __init__.py
-**Purpose:** Initializes the `gateway.base` Python package
-**Import:** `from solace_agent_mesh.gateway.base import ...`
-
----
-
-### app.py
-**Purpose:** Provides the base application class for gateway implementations with automated configuration schema merging, Solace broker setup, and component instantiation
-**Import:** `from solace_agent_mesh.gateway.base.app import BaseGatewayApp, BaseGatewayComponent`
-
-**Classes:**
-- `BaseGatewayComponent(ComponentBase)` - Base marker class for gateway components
-- `BaseGatewayApp(app_info: Dict[str, Any], **kwargs)` - Main application class to be subclassed for new gateways
-  - `_get_gateway_component_class(self) -> Type[BaseGatewayComponent]` - **[Abstract Method]** Must return the specific gateway component class
-  - `namespace: str` - Absolute topic prefix for A2A communication (e.g., 'myorg/dev')
-  - `gateway_id: str` - Unique ID for this gateway instance (auto-generated if not provided)
-  - `artifact_service_config: Dict` - Configuration for the shared ADK Artifact Service
-  - `enable_embed_resolution: bool` - Flag to enable/disable late-stage 'artifact_content' embed resolution
-  - `gateway_max_artifact_resolve_size_bytes: int` - Maximum size for resolving artifacts (default: 104857600)
-  - `gateway_recursive_embed_depth: int` - Maximum depth for recursive embed resolution (default: 12)
-
-**Constants/Variables:**
-- `BASE_GATEWAY_APP_SCHEMA: Dict[str, List[Dict[str, Any]]]` - Base configuration schema automatically merged with subclass parameters
-- `SPECIFIC_APP_SCHEMA_PARAMS_ATTRIBUTE_NAME: str` - Class attribute name ("SPECIFIC_APP_SCHEMA_PARAMS") for subclass-specific config parameters
-
-**Usage Examples:**
-```python
-from typing import Type, List, Dict, Any
-from solace_agent_mesh.gateway.base.app import BaseGatewayApp
-from .component import MyGatewayComponent
-
-class MyGatewayApp(BaseGatewayApp):
-    """Custom gateway application for My Platform."""
-    
-    # Define additional configuration parameters
-    SPECIFIC_APP_SCHEMA_PARAMS: List[Dict[str, Any]] = [
-        {
-            "name": "my_platform_api_key",
-            "required": True,
-            "type": "string",
-            "description": "API key for connecting to My Platform."
-        }
-    ]
-
-    def _get_gateway_component_class(self) -> Type[MyGatewayComponent]:
-        return MyGatewayComponent
-
-# Usage in YAML config:
-# app_config:
-#   namespace: "myorg/prod"
-#   gateway_id: "my-gateway-instance-01"
-#   artifact_service:
-#     type: "local_file"
-#     base_path: "/data/artifacts"
-#   my_platform_api_key: "secret-key-here"
-```
-
----
-
-### component.py
-**Purpose:** Provides the abstract base class for gateway components containing core A2A protocol logic, service management, and external platform integration interface
-**Import:** `from solace_agent_mesh.gateway.base.component import BaseGatewayComponent`
-
-**Classes:**
-- `BaseGatewayComponent(**kwargs: Any)` - Abstract base class for gateway components
-  - **Public Methods:**
-    - `get_config(self, key: str, default: Any = None) -> Any` - Retrieves configuration from nested app_config or component_config
-    - `publish_a2a_message(self, topic: str, payload: Dict, user_properties: Optional[Dict] = None) -> None` - Publishes A2A messages to Solace broker
-    - `authenticate_and_enrich_user(self, external_event_data: Any) -> Optional[Dict[str, Any]]` - Orchestrates user authentication and identity enrichment
-    - `submit_a2a_task(self, target_agent_name: str, a2a_parts: List[ContentPart], external_request_context: Dict[str, Any], user_identity: Any, is_streaming: bool = True, api_version: str = "v2") -> str` - Submits task to target agent, returns task_id
-    - `run(self) -> None` - Starts component's async operations and external platform listener
-    - `cleanup(self) -> None` - Cleans up resources and stops background threads
-  - **Abstract Methods (Must be Implemented):**
-    - `_extract_initial_claims(self, external_event_data: Any) -> Optional[Dict[str, Any]]` - Extract identity claims from platform event (must return dict with 'id' key)
-    - `_start_listener(self) -> None` - Start external platform listener (e.g., web server, WebSocket)
-    - `_stop_listener(self) -> None` - Stop external platform listener
-    - `_translate_external_input(self, external_event: Any) -> Tuple[str, List[ContentPart], Dict[str, Any]]` - Convert external event to A2A format: (target_agent_name, a2a_parts, context)
-    - `_send_update_to_external(self, external_request_context: Dict[str, Any], event_data: Union[TaskStatusUpdateEvent, TaskArtifactUpdateEvent], is_final_chunk_of_update: bool) -> None` - Send streaming update to external platform
-    - `_send_final_response_to_external(self, external_request_context: Dict[str, Any], task_data: Task) -> None` - Send final response to external platform
-    - `_send_error_to_external(self, external_request_context: Dict[str, Any], error_data: JSONRPCError) -> None` - Send error to external platform
-  - **Properties:**
-    - `namespace: str` - A2A communication namespace
-    - `gateway_id: str` - Unique gateway instance ID
-    - `agent_registry: AgentRegistry` - Registry for discovered agents
-    - `core_a2a_service: CoreA2AService` - Core A2A protocol service
-    - `shared_artifact_service: Optional[BaseArtifactService]` - Artifact service instance
-    - `task_context_manager: TaskContextManager` - Thread-safe task context storage
-    - `identity_service: Optional[BaseIdentityService]` - Identity enrichment service
-
-**Usage Examples:**
-```python
-from typing import Any, Dict, List, Optional, Tuple, Union
-from solace_agent_mesh.gateway.base.component import BaseGatewayComponent
-from solace_agent_mesh.common.a2a.types import ContentPart
-from a2a.types import TextPart, Task, TaskStatusUpdateEvent, TaskArtifactUpdateEvent, JSONRPCError
-
-class MyGatewayComponent(BaseGatewayComponent):
-    
-    async def _extract_initial_claims(self, external_event_data: Any) -> Optional[Dict[str, Any]]:
-        """Extract user identity from platform-specific event."""
-        # Example for HTTP request
-        if hasattr(external_event_data, 'headers'):
-            user_id = external_event_data.headers.get('X-User-ID')
-            if user_id:
-                return {"id": user_id, "source": "http_header"}
-        return None
-    
-    def _start_listener(self) -> None:
-        """Start your platform listener (web server, etc.)."""
-        # Example: Start FastAPI server, WebSocket connection, etc.
-        pass
-    
-    def _stop_listener(self) -> None:
-        """Stop your platform listener."""
-        pass
-    
-    async def _translate_external_input(self, external_event: Any) -> Tuple[str, List[ContentPart], Dict[str, Any]]:
-        """Convert external event to A2A format."""
-        # Example translation
-        target_agent = "my-agent"
-        message_text = getattr(external_event, 'message', 'Hello')
-        a2a_parts = [TextPart(text=message_text)]
-        context = {
-            "platform": "my_platform",
-            "user_id_for_artifacts": "user123",
-            "a2a_session_id": "session456"
-        }
-        return target_agent, a2a_parts, context
-    
-    async def _send_update_to_external(self, external_request_context: Dict[str, Any], 
-                                     event_data: Union[TaskStatusUpdateEvent, TaskArtifactUpdateEvent], 
-                                     is_final_chunk_of_update: bool) -> None:
-        """Send streaming update back to external platform."""
-        # Extract text from event and send to your platform
-        pass
-    
-    async def _send_final_response_to_external(self, external_request_context: Dict[str, Any], 
-                                             task_data: Task) -> None:
-        """Send final response back to external platform."""
-        # Extract final result and send to your platform
-        pass
-    
-    async def _send_error_to_external(self, external_request_context: Dict[str, Any], 
-                                     error_data: JSONRPCError) -> None:
-        """Send error back to external platform."""
-        # Send error message to your platform
-        pass
-
-# Usage in your handler:
-async def handle_external_request(request):
-    # Authenticate user
-    user_identity = await component.authenticate_and_enrich_user(request)
-    if not user_identity:
-        return "Authentication failed"
-    
-    # Translate request
-    target_agent, a2a_parts, context = await component._translate_external_input(request)
-    
-    # Submit to A2A system
-    task_id = await component.submit_a2a_task(
-        target_agent_name=target_agent,
-        a2a_parts=a2a_parts,
-        external_request_context=context,
-        user_identity=user_identity,
-        is_streaming=True
-    )
-    
-    return f"Task submitted: {task_id}"
-```
-
----
-
-### task_context.py
-**Purpose:** Provides thread-safe storage for mapping A2A task IDs to their original external request context
-**Import:** `from solace_agent_mesh.gateway.base.task_context import TaskContextManager`
-
-**Classes:**
-- `TaskContextManager()` - Thread-safe context storage manager
-  - `store_context(self, task_id: str, context_data: Dict[str, Any]) -> None` - Store context for a task ID
-  - `get_context(self, task_id: str) -> Optional[Dict[str, Any]]` - Retrieve context for a task ID
-  - `remove_context(self, task_id: str) -> Optional[Dict[str, Any]]` - Remove and return context for a task ID
-  - `clear_all_contexts_for_testing(self) -> None` - Clear all contexts (testing only)
-
-**Usage Examples:**
-```python
-from solace_agent_mesh.gateway.base.task_context import TaskContextManager
-
-# Initialize manager
-context_manager = TaskContextManager()
-
-# Store context when submitting task
-task_id = "gdk-task-abc123"
-context = {
-    "platform": "slack",
-    "channel_id": "C1234567890",
-    "thread_ts": "1234567890.123456",
-    "user_identity": {"id": "user123", "name": "John Doe"}
-}
-context_manager.store_context(task_id, context)
-
-# Retrieve context when processing response
-retrieved_context = context_manager.get_context(task_id)
-if retrieved_context:
-    channel_id = retrieved_context["channel_id"]
-    # Send response back to Slack channel
-
-# Clean up when task is complete
-context_manager.remove_context(task_id)
-```
-
-================================================================================
-