solace-agent-mesh 0.2.3__py3-none-any.whl → 1.0.1__py3-none-any.whl

solace_agent_mesh/templates/main_orchestrator.yaml

@@ -0,0 +1,55 @@
+# Solace Agent Mesh Orchestrator Agent Configurations
+
+log:
+  stdout_log_level: INFO
+  log_file_level: INFO
+  log_file: __LOG_FILE_NAME__
+
+# Shared SAM config
+!include ../shared_config.yaml
+
+apps:
+  - name: __APP_NAME__
+    app_base_path: .
+    app_module: solace_agent_mesh.agent.sac.app
+    broker:
+      <<: *broker_connection
+
+    app_config:
+      namespace: __NAMESPACE__ 
+      supports_streaming: __SUPPORTS_STREAMING__
+      agent_name: "__AGENT_NAME__"
+      display_name: "__AGENT_NAME__"
+      model: *planning_model 
+
+      instruction: |
+        __INSTRUCTION__
+      inject_system_purpose: true
+      inject_response_format: true
+      inject_user_profile: true
+      session_service: __SESSION_SERVICE__
+      artifact_service: __ARTIFACT_SERVICE__
+      artifact_handling_mode: "__ARTIFACT_HANDLING_MODE__" 
+      enable_embed_resolution: __ENABLE_EMBED_RESOLUTION__ 
+      enable_artifact_content_instruction: __ENABLE_ARTIFACT_CONTENT_INSTRUCTION__ 
+      data_tools_config: *default_data_tools_config
+      tools: 
+        - group_name: artifact_management
+          tool_type: builtin-group
+        - tool_type: builtin-group
+          group_name: "data_analysis"
+
+      agent_card:
+        description: "__AGENT_CARD_DESCRIPTION__"
+        defaultInputModes: __DEFAULT_INPUT_MODES__
+        defaultOutputModes: __DEFAULT_OUTPUT_MODES__
+        skills: [] 
+
+      agent_card_publishing: 
+        interval_seconds: __AGENT_CARD_PUBLISHING_INTERVAL__
+      agent_discovery: 
+        enabled: __AGENT_DISCOVERY_ENABLED__
+      inter_agent_communication:
+        allow_list: __INTER_AGENT_COMMUNICATION_ALLOW_LIST__
+        __INTER_AGENT_COMMUNICATION_DENY_LIST_LINE__
+        request_timeout_seconds: __INTER_AGENT_COMMUNICATION_TIMEOUT__

solace_agent_mesh/templates/plugin_agent_config_template.yaml

@@ -0,0 +1,122 @@
+# Plugin Metadata:
+# Name: __PLUGIN_KEBAB_CASE_NAME__
+# Version: __PLUGIN_VERSION__
+# Description: __PLUGIN_DESCRIPTION__
+# Author: __PLUGIN_AUTHOR_NAME__ <__PLUGIN_AUTHOR_EMAIL__>
+# 
+# --- Start of Agent Configuration Template ---
+# Solace Agent Mesh: Plugin Configuration Template
+#
+# This file serves as a template for creating new agent configurations from this plugin.
+# Use placeholders like __COMPONENT_KEBAB_CASE_NAME__, __COMPONENT_PASCAL_CASE_NAME__,
+# and __COMPONENT_UPPER_SNAKE_CASE_NAME__ where the specific component name should be inserted.
+
+log:
+  stdout_log_level: INFO
+  log_file_level: DEBUG
+  log_file: __COMPONENT_KEBAB_CASE_NAME__.log
+
+# To use the `shared_config.yaml` file, uncomment the following line and remove the `shared_config` section below.
+# !include ../shared_config.yaml
+shared_config:
+  - broker_connection: &broker_connection
+      dev_mode: ${SOLACE_DEV_MODE, false}
+      broker_url: ${SOLACE_BROKER_URL, ws://localhost:8080}
+      broker_username: ${SOLACE_BROKER_USERNAME, default}
+      broker_password: ${SOLACE_BROKER_PASSWORD, default}
+      broker_vpn: ${SOLACE_BROKER_VPN, default}
+      temporary_queue: ${USE_TEMPORARY_QUEUES, true}
+
+  - models:
+    general: &general_model
+      # This dictionary structure tells ADK to use the LiteLlm wrapper.
+      # 'model' uses the specific model identifier your endpoint expects.
+      model: ${LLM_SERVICE_GENERAL_MODEL_NAME} # Use env var for model name
+      # 'api_base' tells LiteLLM where to send the request.
+      api_base: ${LLM_SERVICE_ENDPOINT} # Use env var for endpoint URL
+      # 'api_key' provides authentication.
+      api_key: ${LLM_SERVICE_API_KEY} # Use env var for API key
+
+  - services:
+    # Default session service configuration
+    session_service: &default_session_service
+      type: "memory"
+      default_behavior: "PERSISTENT"
+    
+    # Default artifact service configuration
+    artifact_service: &default_artifact_service
+      type: "filesystem"
+      base_path: "/tmp/samv2"
+      artifact_scope: namespace # Or "namespace", "app", "custom"
+
+apps:
+  - name: __COMPONENT_KEBAB_CASE_NAME__-app
+    app_base_path: . 
+    app_module: solace_agent_mesh.agent.sac.app 
+    broker:
+      <<: *broker_connection
+
+    # App Level Config
+    app_config:
+      namespace: ${NAMESPACE} 
+      supports_streaming: true 
+      agent_name: "__COMPONENT_PASCAL_CASE_NAME__" 
+      display_name: "__COMPONENT_PASCAL_CASE_NAME__ Agent"
+      model: *general_model 
+
+      instruction: |
+        This is a component created from the __COMPONENT_PASCAL_CASE_NAME__ plugin.
+        Configure its specific instructions here.
+
+      tools:
+        - group_name: artifact_management
+          tool_type: builtin-group
+
+        # Example: Plugin creator should define their tools.
+        # - tool_type: mcp
+        #   connection_params:
+        #     type: stdio
+        #     command: "my-mcp-server-command"
+        #     args: ["--arg1", "value1"]
+        #     timeout: 30
+
+        # --- Example Python Tools (defined in tools.py) ---
+        # - tool_type: python
+        #   component_module: __PLUGIN_SNAKE_CASE_NAME__.tools
+        #   component_base_path: . # Relative to where the agent runs
+        #   function_name: example_text_processor_tool
+        #   tool_config:
+        #     prefix: "PluginProcessed: "
+        
+        # - tool_type: python
+        #   component_module: __PLUGIN_SNAKE_CASE_NAME__.tools
+        #   component_base_path: .
+        #   function_name: example_file_creator_tool
+        #   tool_config: {} # Add specific config if needed by the tool
+
+        # --- Example Builtin Tools ---
+        # - tool_type: builtin-group
+        #   group_name: "text_to_speech"
+        #   tool_config: {}
+
+      session_service: *default_session_service
+      artifact_service: *default_artifact_service
+
+      artifact_handling_mode: "embed"
+      enable_embed_resolution: true
+      enable_artifact_content_instruction: true
+
+      agent_card:
+        description: "__PLUGIN_DESCRIPTION__"
+        defaultInputModes: ["text"]
+        defaultOutputModes: ["text"]
+        skills: 
+          # - id: "example_tool"
+          #   name: "Example Tool"
+          #   description: "An example tool provided by the __PLUGIN_PASCAL_CASE_NAME__ plugin."
+
+      agent_card_publishing: { interval_seconds: 10 }
+      agent_discovery: { enabled: false }
+      inter_agent_communication:
+        allow_list: []
+        request_timeout_seconds: 30

solace_agent_mesh/templates/plugin_custom_config_template.yaml

@@ -0,0 +1,27 @@
+# Plugin Metadata:
+# Name: __PLUGIN_KEBAB_CASE_NAME__
+# Version: __PLUGIN_VERSION__
+# Description: __PLUGIN_DESCRIPTION__
+# Author: __PLUGIN_AUTHOR_NAME__ <__PLUGIN_AUTHOR_EMAIL__>
+# 
+# --- Start of Custom Configuration Template ---
+# Solace Agent Mesh: Custom Configuration Template
+#
+# This file serves as a template for creating new custom configurations from this plugin.
+# Use placeholders like __COMPONENT_KEBAB_CASE_NAME__, __COMPONENT_PASCAL_CASE_NAME__,
+# and __COMPONENT_UPPER_SNAKE_CASE_NAME__ where the specific component name should be inserted.
+
+# To use the `shared_config.yaml` file, uncomment the following line and remove the `shared_config` section below.
+# !include ../shared_config.yaml
+
+shared_config:
+  - broker_connection: &broker_connection
+      dev_mode: ${SOLACE_DEV_MODE, false}
+      broker_url: ${SOLACE_BROKER_URL, ws://localhost:8080}
+      broker_username: ${SOLACE_BROKER_USERNAME, default}
+      broker_password: ${SOLACE_BROKER_PASSWORD, default}
+      broker_vpn: ${SOLACE_BROKER_VPN, default}
+      temporary_queue: ${USE_TEMPORARY_QUEUES, true}
+
+
+__PLUGIN_SNAKE_CASE_NAME__: {}

solace_agent_mesh/templates/plugin_custom_template.py

@@ -0,0 +1,10 @@
+# Solace Agent Mesh Custom Plugin
+
+class __COMPONENT_PASCAL_CASE_NAME__:
+    def template_function(self):
+        """
+        This function serves as a placeholder for custom template logic.
+        It can be modified to include specific functionality as needed.
+        """
+        # Custom logic goes here
+        print("This is a custom template function.")

solace_agent_mesh/templates/plugin_gateway_config_template.yaml

@@ -0,0 +1,63 @@
+# Plugin Metadata:
+# Name: __PLUGIN_KEBAB_CASE_NAME__
+# Version: __PLUGIN_VERSION__
+# Description: __PLUGIN_DESCRIPTION__
+# Author: __PLUGIN_AUTHOR_NAME__ <__PLUGIN_AUTHOR_EMAIL__>
+# 
+# --- Start of Gateway Configuration Template ---
+# Solace Agent Mesh: Gateway Configuration Template
+#
+# This file serves as a template for creating new gateway configurations from this plugin.
+# Use placeholders like __COMPONENT_KEBAB_CASE_NAME__, __COMPONENT_PASCAL_CASE_NAME__,
+# and __COMPONENT_UPPER_SNAKE_CASE_NAME__ where the specific component name should be inserted.
+
+log:
+  stdout_log_level: INFO
+  log_file_level: DEBUG
+  log_file: __COMPONENT_KEBAB_CASE_NAME__.log
+
+# To use the `shared_config.yaml` file, uncomment the following line and remove the `shared_config` section below.
+# !include ../shared_config.yaml
+
+shared_config:
+  - broker_connection: &broker_connection
+      dev_mode: ${SOLACE_DEV_MODE, false}
+      broker_url: ${SOLACE_BROKER_URL, ws://localhost:8080}
+      broker_username: ${SOLACE_BROKER_USERNAME, default}
+      broker_password: ${SOLACE_BROKER_PASSWORD, default}
+      broker_vpn: ${SOLACE_BROKER_VPN, default}
+      temporary_queue: ${USE_TEMPORARY_QUEUES, true}
+
+  - services:
+    # Default artifact service configuration
+    artifact_service: &default_artifact_service
+      type: "filesystem"
+      base_path: "/tmp/samv2"
+      artifact_scope: namespace # Or "namespace", "app", "custom"
+
+apps:
+  # --- App Definition ---
+  - name: __COMPONENT_PASCAL_CASE_NAME____app # Unique name for this gateway app instance
+    app_module: __PLUGIN_SNAKE_CASE_NAME__.app # Points to the plugin's App class
+    broker:
+      <<: *broker_connection
+
+    app_config:
+      namespace: "${NAMESPACE}" 
+      gateway_id: __COMPONENT_KEBAB_CASE_NAME__-gw-01
+      artifact_service: *default_artifact_service
+
+      authorization_service:
+        type: "none" # Or "default_rbac"
+
+      system_purpose: >
+            The system is an AI Chatbot with agentic capabilities.
+            It will use the agents available to provide information,
+            reasoning and general assistance for the users in this system.
+            **Always return useful artifacts and files that you create to the user.**
+            Provide a status update before each tool call.
+            Your external name is Agent Mesh.
+
+      response_format: >
+            Responses should be clear, concise, and professionally toned.
+            Format responses to the user in Markdown using appropriate formatting.

solace_agent_mesh/templates/plugin_pyproject_template.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.metadata]
+allow-direct-references = true
+
+[tool.__PLUGIN_SNAKE_CASE_NAME__.metadata]
+type = "__PLUGIN_META_DATA_TYPE__"
+
+[project]
+name = "__PLUGIN_SNAKE_CASE_NAME__"
+version = "__PLUGIN_VERSION__"
+authors = [
+  { name="__PLUGIN_AUTHOR_NAME__", email="__PLUGIN_AUTHOR_EMAIL__" },
+]
+description = "__PLUGIN_DESCRIPTION__"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "solace_agent_mesh~=__SAM_VERSION__",
+    # Add plugin-specific dependencies here
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/__PLUGIN_SNAKE_CASE_NAME__"]
+src-path = "src"
+
+[tool.hatch.build.targets.wheel.force-include]
+"src/__PLUGIN_SNAKE_CASE_NAME__" = "__PLUGIN_SNAKE_CASE_NAME__/"
+"config.yaml" = "__PLUGIN_SNAKE_CASE_NAME__/config.yaml"
+"README.md" = "__PLUGIN_SNAKE_CASE_NAME__/README.md"
+"pyproject.toml" = "__PLUGIN_SNAKE_CASE_NAME__/pyproject.toml"

solace_agent_mesh/templates/plugin_readme_template.md

@@ -0,0 +1,34 @@
+# __PLUGIN_KEBAB_CASE_NAME__ SAM Plugin
+
+__PLUGIN_DESCRIPTION__
+
+This is a plugin for the Solace Agent Mesh (SAM).
+
+## Configuration (`config.yaml`)
+
+The `config.yaml` in this plugin serves as a template. When you use `sam plugin add <component_name> --plugin __PLUGIN_KEBAB_CASE_NAME__`, the following placeholders in the YAML structure will be replaced with variations of `<component_name>`:
+- `__COMPONENT_UPPER_SNAKE_CASE_NAME__`
+- `__COMPONENT_KEBAB_CASE_NAME__`
+- `__COMPONENT_PASCAL_CASE_NAME__`
+
+Customize the `config.yaml` in this plugin directory to define the base configuration for components created from it.
+
+## Source Code (`src/`)
+The `src/` directory contains the Python source code for your plugin.
+
+## Installation (as a developer of this plugin)
+
+To build and install this plugin locally for testing:
+```bash
+sam plugin build
+pip install dist/*.whl 
+```
+(Or `pip install .` if preferred, `sam plugin build` is for creating the distributable wheel)
+
+## Usage (as a user of this plugin)
+
+Once the plugin is installed (e.g., from PyPI or a local wheel file):
+```bash
+sam plugin add <your-new-component-name> --plugin __PLUGIN_KEBAB_CASE_NAME__
+```
+This will create a new component configuration at `configs/plugins/<your-new-component-name-kebab-case>.yaml`.

solace_agent_mesh/templates/plugin_tools_template.py

@@ -0,0 +1,224 @@
+import asyncio
+import uuid
+from datetime import datetime, timezone
+from typing import Any, Dict, Optional
+
+from google.adk.tools import ToolContext
+from solace_ai_connector.common.log import log
+from solace_agent_mesh.agent.utils.artifact_helpers import (
+    save_artifact_with_metadata,
+    DEFAULT_SCHEMA_MAX_KEYS,
+)
+from solace_agent_mesh.agent.utils.context_helpers import get_original_session_id
+
+
+async def example_text_processor_tool(
+    text_input: str,
+    uppercase: bool = False,  # Example of a boolean parameter
+    tool_context: Optional[ToolContext] = None,
+    tool_config: Optional[Dict[str, Any]] = None,
+) -> Dict[str, Any]:
+    """
+    An example tool that processes input text, optionally converts it to uppercase,
+    and adds a prefix from tool_config.
+    """
+    plugin_name = "__PLUGIN_SPACED_NAME__"
+    log_identifier = f"[{plugin_name}:example_text_processor_tool]"
+    log.info(f"{log_identifier} Received text: '{text_input}', uppercase: {uppercase}")
+
+    current_tool_config = tool_config if tool_config is not None else {}
+    prefix = current_tool_config.get("prefix", "Processed: ")
+
+    processed_text = text_input
+    if uppercase:
+        processed_text = processed_text.upper()
+
+    final_text = f"{prefix}{processed_text}"
+
+    log.info(f"{log_identifier} Processed text: '{final_text}'")
+    return {
+        "status": "success",
+        "message": "Text processed successfully by example_text_processor_tool.",
+        "original_input": text_input,
+        "processed_text": final_text,
+        "was_uppercased": uppercase,
+    }
+
+
+async def example_text_file_creator_tool(
+    filename: str,
+    content: str,
+    tool_context: Optional[ToolContext] = None,
+    tool_config: Optional[Dict[str, Any]] = None,
+) -> Dict[str, Any]:
+    """
+    An example tool that creates a text file and saves it as an artifact
+    using the Solace Agent Mesh artifact service.
+    """
+    plugin_name = "__PLUGIN_SPACED_NAME__"
+    log_identifier = f"[{plugin_name}:example_text_file_creator_tool]"
+    log.info(
+        f"{log_identifier} Received request to create file: '{filename}' with content starting: '{content[:50]}...'"
+    )
+
+    if not tool_context or not tool_context._invocation_context:
+        log.error(
+            f"{log_identifier} ToolContext or InvocationContext is missing. Cannot save artifact."
+        )
+        return {
+            "status": "error",
+            "message": "ToolContext or InvocationContext is missing.",
+        }
+
+    inv_context = tool_context._invocation_context
+    app_name = getattr(inv_context, "app_name", None)
+    user_id = getattr(inv_context, "user_id", None)
+    session_id = get_original_session_id(inv_context)
+    artifact_service = getattr(inv_context, "artifact_service", None)
+
+    if not all([app_name, user_id, session_id, artifact_service]):
+        missing_parts = [
+            part
+            for part, val in [
+                ("app_name", app_name),
+                ("user_id", user_id),
+                ("session_id", session_id),
+                ("artifact_service", artifact_service),
+            ]
+            if not val
+        ]
+        log.error(
+            f"{log_identifier} Missing required context parts for artifact saving: {', '.join(missing_parts)}"
+        )
+        return {
+            "status": "error",
+            "message": f"Missing required context parts for artifact saving: {', '.join(missing_parts)}",
+        }
+
+    output_filename = filename
+    if not output_filename.lower().endswith(".txt"):
+        output_filename += ".txt"
+
+    content_bytes = content.encode("utf-8")
+    mime_type = "text/plain"
+    timestamp = datetime.now(timezone.utc)
+
+    metadata_dict = {
+        "description": f"Text file created by {plugin_name}'s example_text_file_creator_tool.",
+        "source_tool": "example_text_file_creator_tool",
+        "original_requested_filename": filename,
+        "creation_timestamp_iso": timestamp.isoformat(),
+        "content_character_count": len(content),
+    }
+
+    log.info(
+        f"{log_identifier} Attempting to save artifact '{output_filename}' via artifact_service."
+    )
+    try:
+        save_result = await save_artifact_with_metadata(
+            artifact_service=artifact_service,
+            app_name=app_name,
+            user_id=user_id,
+            session_id=session_id,
+            filename=output_filename,
+            content_bytes=content_bytes,
+            mime_type=mime_type,
+            metadata_dict=metadata_dict,
+            timestamp=timestamp,
+            schema_max_keys=DEFAULT_SCHEMA_MAX_KEYS,
+            tool_context=tool_context,
+        )
+        if save_result.get("status") == "error":
+            log.error(
+                f"{log_identifier} Failed to save artifact: {save_result.get('message')}"
+            )
+            return {
+                "status": "error",
+                "message": f"Failed to save artifact: {save_result.get('message')}",
+            }
+
+        log.info(
+            f"{log_identifier} Artifact '{output_filename}' v{save_result['data_version']} saved successfully."
+        )
+        return {
+            "status": "success",
+            "message": f"File '{output_filename}' created and saved as artifact v{save_result['data_version']}.",
+            "output_filename": output_filename,
+            "output_version": save_result["data_version"],
+        }
+    except Exception as e:
+        log.exception(f"{log_identifier} Unexpected error during artifact saving: {e}")
+        return {
+            "status": "error",
+            "message": f"An unexpected error occurred during artifact saving: {e}",
+        }
+
+
+# Example of how these might be tested or run if this file was executed directly.
+# This assumes the script is run in an environment where solace_agent_mesh is importable,
+# or the imports at the top will fail.
+if __name__ == "__main__":
+
+    async def run_tests():
+        print("--- Testing example_text_processor_tool ---")
+        # For standalone testing, ToolContext might be minimal or None if ADK is not fully available.
+        # The tool should handle tool_context=None gracefully if it's designed to be testable standalone.
+
+        # A more complete mock for standalone testing if needed:
+        class MockArtifactService:
+            async def save_artifact(
+                self, **kwargs
+            ):  # Match expected signature elements
+                log.info(
+                    f"MockArtifactService.save_artifact called with filename: {kwargs.get('filename')}"
+                )
+                return {
+                    "uri": f"mock://{kwargs.get('filename')}",
+                    "version": 1,
+                }  # Simulate ADK response
+
+            async def save_artifact_metadata(self, **kwargs):
+                log.info(
+                    f"MockArtifactService.save_artifact_metadata called for: {kwargs.get('filename')}"
+                )
+                return {
+                    "uri": f"mock://{kwargs.get('filename')}.metadata",
+                    "version": 1,
+                }
+
+        class MockInvocationContext:
+            def __init__(self):
+                self.app_name = "test_app"
+                self.user_id = "test_user"
+                self.session_id = "test_session_123"
+                self.artifact_service = MockArtifactService()
+                # Add other attributes if your tool or helpers expect them
+
+        class MockToolContext:
+            def __init__(self):
+                self._invocation_context = MockInvocationContext()
+
+        mock_context = MockToolContext()
+
+        text_result1 = await example_text_processor_tool(
+            "hello world",
+            uppercase=True,
+            tool_context=mock_context,
+            tool_config={"prefix": "TestPrefix: "},
+        )
+        print(f"Text tool result 1: {text_result1}")
+
+        text_result2 = await example_text_processor_tool(
+            "another test", tool_context=mock_context
+        )
+        print(f"Text tool result 2: {text_result2}")
+
+        print("\n--- Testing example_text_file_creator_tool ---")
+        file_result = await example_text_file_creator_tool(
+            "my_example_file.txt",
+            "This is the content of the example file created by the plugin template.",
+            tool_context=mock_context,  # Using the mock context with a mock artifact service
+        )
+        print(f"File tool result: {file_result}")
+
+    asyncio.run(run_tests())

solace_agent_mesh/templates/shared_config.yaml

@@ -0,0 +1,66 @@
+shared_config:
+  - broker_connection: &broker_connection
+      dev_mode: ${SOLACE_DEV_MODE, false}
+      broker_url: ${SOLACE_BROKER_URL, ws://localhost:8080}
+      broker_username: ${SOLACE_BROKER_USERNAME, default}
+      broker_password: ${SOLACE_BROKER_PASSWORD, default}
+      broker_vpn: ${SOLACE_BROKER_VPN, default}
+      temporary_queue: ${USE_TEMPORARY_QUEUES, true}
+
+  - models:
+    planning: &planning_model
+      # This dictionary structure tells ADK to use the LiteLlm wrapper.
+      # 'model' uses the specific model identifier your endpoint expects.
+      model: ${LLM_SERVICE_PLANNING_MODEL_NAME} # Use env var for model name
+      # 'api_base' tells LiteLLM where to send the request.
+      api_base: ${LLM_SERVICE_ENDPOINT} # Use env var for endpoint URL
+      # 'api_key' provides authentication.
+      api_key: ${LLM_SERVICE_API_KEY} # Use env var for API key
+
+    general: &general_model
+      # This dictionary structure tells ADK to use the LiteLlm wrapper.
+      # 'model' uses the specific model identifier your endpoint expects.
+      model: ${LLM_SERVICE_GENERAL_MODEL_NAME} # Use env var for model name
+      # 'api_base' tells LiteLLM where to send the request.
+      api_base: ${LLM_SERVICE_ENDPOINT} # Use env var for endpoint URL
+      # 'api_key' provides authentication.
+      api_key: ${LLM_SERVICE_API_KEY} # Use env var for API key
+
+    image_gen: &image_generation_model
+      # This dictionary structure tells ADK to use the LiteLlm wrapper.
+      # 'model' uses the specific model identifier your endpoint expects.
+      model: ${IMAGE_MODEL_NAME} # Use env var for model name
+      # 'api_base' tells LiteLLM where to send the request.
+      api_base: ${IMAGE_SERVICE_ENDPOINT} # Use env var for endpoint URL
+      # 'api_key' provides authentication.
+      api_key: ${IMAGE_SERVICE_API_KEY} # Use env var for API key
+
+    report_gen: &report_generation_model
+      # This dictionary structure tells ADK to use the LiteLlm wrapper.
+      # 'model' uses the specific model identifier your endpoint expects.
+      model: ${LLM_REPORT_MODEL_NAME} # Use env var for model name
+      # 'api_base' tells LiteLLM where to send the request.
+      api_base: ${LLM_SERVICE_ENDPOINT} # Use env var for endpoint URL
+      # 'api_key' provides authentication.
+      api_key: ${LLM_SERVICE_API_KEY} # Use env var for API key
+
+    multimodal: &multimodal_model  "gemini-2.5-flash-preview-04-17"
+    gemini_pro: &gemini_pro_model "gemini-2.5-pro-exp-03-25"
+
+  - services:
+    # Default session service configuration
+    session_service: &default_session_service
+      type: "__DEFAULT_SESSION_SERVICE_TYPE__"
+      default_behavior: "__DEFAULT_SESSION_SERVICE_BEHAVIOR__"
+    
+    # Default artifact service configuration
+    artifact_service: &default_artifact_service
+      type: "__DEFAULT_ARTIFACT_SERVICE_TYPE__"
+      __DEFAULT_ARTIFACT_SERVICE_BASE_PATH_LINE__
+      artifact_scope: __DEFAULT_ARTIFACT_SERVICE_SCOPE__
+    
+    # Default data tools configuration
+    data_tools_config: &default_data_tools_config
+      sqlite_memory_threshold_mb: 100
+      max_result_preview_rows: 50
+      max_result_preview_bytes: 4096