solace-agent-mesh 1.4.12__py3-none-any.whl → 1.5.1__py3-none-any.whl

solace_agent_mesh/agent/testing/testing_llm_detail.txt

@@ -0,0 +1,68 @@
+# LLM Summary Detail File
+
+This file is a concatenation of all individual *llm.txt files found in the 'testing' directory tree. Each section below corresponds to a specific directory's summary file.
+
+================================================================================
+
+## Section 1: solace_agent_mesh/agent/testing/testing_llm.txt
+
+**Source file:** `solace_agent_mesh/agent/testing/testing_llm.txt`
+
+## Quick Summary
+The `testing` directory provides utilities for testing the A2A (Agent-to-Agent) framework, with a focus on debugging tools that help developers understand test failures by providing readable representations of agent event histories.
+
+## Files Overview
+- `__init__.py` - Package initialization file marking the directory as a Python module
+- `debug_utils.py` - Debugging utilities including pretty-printing for A2A event history
+- `testing_llm.txt` - Documentation file (not a code module)
+
+## Developer API Reference
+
+### debug_utils.py
+**Purpose:** Provides debugging utilities for the declarative test framework, including a pretty-printer for A2A event history
+**Import:** `from solace_agent_mesh.agent.testing.debug_utils import pretty_print_event_history`
+
+**Functions:**
+- `pretty_print_event_history(event_history: List[Dict[str, Any]], max_string_length: int = 200) -> None` - Formats and prints a list of A2A event payloads for debugging, intelligently parsing different event types and truncating long strings for readability
+
+**Usage Examples:**
+```python
+# Import the debugging utility
+from solace_agent_mesh.agent.testing.debug_utils import pretty_print_event_history
+from typing import List, Dict, Any
+
+# Example: Debug a failed test by printing event history
+event_history: List[Dict[str, Any]] = [
+    {
+        "result": {
+            "status": {
+                "state": "EXECUTING",
+                "message": {
+                    "parts": [
+                        {"type": "text", "text": "Processing your request..."}
+                    ]
+                }
+            },
+            "final": False
+        }
+    },
+    {
+        "error": {
+            "code": "TIMEOUT_ERROR",
+            "message": "Request timed out after 30 seconds"
+        }
+    }
+]
+
+# Print formatted event history for debugging
+pretty_print_event_history(event_history)
+
+# Print with custom string truncation length
+pretty_print_event_history(event_history, max_string_length=100)
+
+# Handle empty event history (when test fails before any events)
+pretty_print_event_history([])
+```
+
+================================================================================
+

solace_agent_mesh/agent/tools/audio_tools.py

@@ -2,6 +2,7 @@
 Collection of Python tools for audio processing and text-to-speech generation.
 """
 
+import logging
 import asyncio
 import inspect
 import io
@@ -20,7 +21,6 @@ from google import genai
 from google.genai import types as adk_types
 from google.adk.tools import ToolContext
 from pydub import AudioSegment
-from solace_ai_connector.common.log import log
 
 from ...agent.utils.artifact_helpers import (
     load_artifact_content_or_metadata,
@@ -32,6 +32,7 @@ from ...agent.utils.context_helpers import get_original_session_id
 from .tool_definition import BuiltinTool
 from .registry import tool_registry
 
+log = logging.getLogger(__name__)
 
 VOICE_TONE_MAPPING = {
     "bright": ["Zephyr", "Autonoe"],

solace_agent_mesh/agent/tools/builtin_artifact_tools.py

@@ -5,6 +5,7 @@ use state_delta for signaling artifact return requests to the host component.
 Metadata handling is integrated via artifact_helpers.
 """
 
+import logging
 import uuid
 import json
 import re
@@ -16,7 +17,6 @@ from google.adk.tools import ToolContext
 if TYPE_CHECKING:
     from google.adk.agents.invocation_context import InvocationContext
 from google.genai import types as adk_types
-from solace_ai_connector.common.log import log
 from .tool_definition import BuiltinTool
 from .registry import tool_registry
 from ...agent.utils.artifact_helpers import (
@@ -38,6 +38,8 @@ from google.adk.models import LlmRequest
 from google.adk.models.registry import LLMRegistry
 from ...common.utils.mime_helpers import is_text_based_file
 
+log = logging.getLogger(__name__)
+
 CATEGORY_NAME = "Artifact Management"
 CATEGORY_DESCRIPTION = "List, read, create, update, and delete artifacts."
 

solace_agent_mesh/agent/tools/builtin_data_analysis_tools.py

@@ -2,6 +2,7 @@
 Built-in ADK Tools for Data Analysis (SQL, JQ, Plotly).
 """
 
+import logging
 import json
 from typing import Any, Dict, Tuple, Optional, Literal
 from datetime import datetime, timezone
@@ -31,7 +32,6 @@ except ImportError:
 
 from google.adk.tools import ToolContext
 from google.genai import types as adk_types
-from solace_ai_connector.common.log import log
 
 from ...agent.utils.artifact_helpers import (
     ensure_correct_extension,
@@ -44,6 +44,8 @@ from ...agent.utils.context_helpers import get_original_session_id
 from .tool_definition import BuiltinTool
 from .registry import tool_registry
 
+log = logging.getLogger(__name__)
+
 CATEGORY_NAME = "Data Analysis"
 CATEGORY_DESCRIPTION = "Create static chart images from data in JSON or YAML format."
 

solace_agent_mesh/agent/tools/dynamic_tool.py

@@ -4,6 +4,7 @@ Dynamic tools allow for programmatic definition of tool names, descriptions,
 and parameter schemas, offering more flexibility than standard Python tools.
 """
 
+import logging
 from abc import ABC, abstractmethod
 from typing import (
     Optional,
@@ -23,7 +24,6 @@ import inspect
 from pydantic import BaseModel
 from google.adk.tools import BaseTool, ToolContext
 from google.genai import types as adk_types
-from solace_ai_connector.common.log import log
 
 from solace_agent_mesh.agent.utils.context_helpers import get_original_session_id
 
@@ -35,6 +35,7 @@ from ...common.utils.embeds import (
     EMBED_DELIMITER_OPEN,
 )
 
+log = logging.getLogger(__name__)
 
 if TYPE_CHECKING:
     from ..sac.component import SamAgentComponent

solace_agent_mesh/agent/tools/general_agent_tools.py

@@ -2,6 +2,7 @@
 Collection of Python tools that can be configured for general purpose agents.
 """
 
+import logging
 import asyncio
 import inspect
 import json
@@ -13,7 +14,6 @@ from typing import Any, Dict, Optional, Tuple
 from playwright.async_api import async_playwright
 
 from google.adk.tools import ToolContext
-from solace_ai_connector.common.log import log
 
 from markitdown import MarkItDown, UnsupportedFormatException
 from mermaid_cli import render_mermaid
@@ -30,6 +30,7 @@ from google.genai import types as adk_types
 from .tool_definition import BuiltinTool
 from .registry import tool_registry
 
+log = logging.getLogger(__name__)
 
 def _simple_truncate_text(text: str, max_bytes: int = 2048) -> Tuple[str, bool]:
     """Truncates text to a maximum number of bytes for preview."""

solace_agent_mesh/agent/tools/image_tools.py

@@ -3,6 +3,7 @@ Collection of Python tools for image generation, manipulation, and multimodal co
 Includes tools for image description and audio description using vision and audio APIs.
 """
 
+import logging
 import asyncio
 import base64
 import inspect
@@ -14,7 +15,6 @@ from typing import Any, Dict, Optional
 
 import httpx
 from google.adk.tools import ToolContext
-from solace_ai_connector.common.log import log
 
 from ..utils.artifact_helpers import (
     save_artifact_with_metadata,
@@ -26,6 +26,7 @@ from google.genai import types as adk_types
 from .tool_definition import BuiltinTool
 from .registry import tool_registry
 
+log = logging.getLogger(__name__)
 
 async def create_image_from_description(
     image_description: str,

solace_agent_mesh/agent/tools/peer_agent_tool.py

@@ -2,13 +2,13 @@
 ADK Tool implementation for delegating tasks to peer A2A agents over Solace.
 """
 
+import logging
 from typing import Any, Dict, Optional, List, Union
 import uuid
 
 from google.adk.tools import BaseTool, ToolContext
 from google.genai import types as adk_types
 from pydantic import BaseModel, Field
-from solace_ai_connector.common.log import log
 
 from ...common.a2a.types import ContentPart
 from a2a.types import (
@@ -18,6 +18,7 @@ from ...common import a2a
 from ...common.constants import DEFAULT_COMMUNICATION_TIMEOUT
 from ...common.exceptions import MessageSizeExceededError
 
+log = logging.getLogger(__name__)
 
 class ArtifactIdentifier(BaseModel):
     """Identifies a specific version of an artifact."""

solace_agent_mesh/agent/tools/registry.py

@@ -2,9 +2,11 @@
 A singleton registry for discovering and holding all BuiltinTool definitions.
 """
 
+import logging
 from typing import Dict, List, Optional
 from .tool_definition import BuiltinTool
-from solace_ai_connector.common.log import log
+
+log = logging.getLogger(__name__)
 
 
 class _ToolRegistry:

solace_agent_mesh/agent/tools/test_tools.py

@@ -2,16 +2,17 @@
 Test-specific ADK Tools.
 """
 
+import logging
 import asyncio
 from typing import Dict, Optional, Any
 
 from google.adk.tools import ToolContext
-from solace_ai_connector.common.log import log
 
 from google.genai import types as adk_types
 from .tool_definition import BuiltinTool
 from .registry import tool_registry
 
+log = logging.getLogger(__name__)
 
 async def time_delay(
     seconds: float,