PyPI - solace-agent-mesh - Versions diffs - 1.6.3__py3-none-any.whl → 1.7.0__py3-none-any.whl - Mend

solace-agent-mesh 1.6.3py3-none-any.whl → 1.7.0py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of solace-agent-mesh might be problematic. Click here for more details.

Files changed (244) hide show

solace_agent_mesh/client/webui/frontend/static/auth-callback.html CHANGED Viewed

@@ -5,9 +5,9 @@
         <link rel="icon" type="image/svg+xml" href="/assets/favicon-BLgzUch9.ico" />
         <meta name="viewport" content="width=device-width, initial-scale=1.0" />
         <title>Solace Agent Mesh</title>
-      <script type="module" crossorigin src="/assets/authCallback-D4_RMYRh.js"></script>
-      <link rel="modulepreload" crossorigin href="/assets/vendor-DSqhjwq_.js">
-      <link rel="modulepreload" crossorigin href="/assets/client-UZ3qU6Bq.js">
+      <script type="module" crossorigin src="/assets/authCallback-tcIFZLis.js"></script>
+      <link rel="modulepreload" crossorigin href="/assets/vendor-CINwxvwV.js">
+      <link rel="modulepreload" crossorigin href="/assets/client-CRYdKo2Q.js">
     </head>
     <body>
         <div id="root"></div>

solace_agent_mesh/client/webui/frontend/static/index.html CHANGED Viewed

@@ -5,10 +5,10 @@
         <link rel="icon" type="image/svg+xml" href="/assets/favicon-BLgzUch9.ico" />
         <meta name="viewport" content="width=device-width, initial-scale=1.0" />
         <title>Solace Agent Mesh</title>
-      <script type="module" crossorigin src="/assets/main-DojKHS49.js"></script>
-      <link rel="modulepreload" crossorigin href="/assets/vendor-DSqhjwq_.js">
-      <link rel="modulepreload" crossorigin href="/assets/client-UZ3qU6Bq.js">
-      <link rel="stylesheet" crossorigin href="/assets/main--3yJYl7S.css">
+      <script type="module" crossorigin src="/assets/main-ILja9MCG.js"></script>
+      <link rel="modulepreload" crossorigin href="/assets/vendor-CINwxvwV.js">
+      <link rel="modulepreload" crossorigin href="/assets/client-CRYdKo2Q.js">
+      <link rel="stylesheet" crossorigin href="/assets/main-CojeY_1w.css">
     </head>
     <body>
         <div id="root"></div>

solace_agent_mesh/common/a2a/a2a_llm.txt CHANGED Viewed

@@ -34,6 +34,8 @@ This file re-exports all public functions from the other modules, allowing devel
 - `get_artifact_id(artifact: Artifact) -> str` - Safely retrieves the ID from an Artifact
 - `get_artifact_name(artifact: Artifact) -> Optional[str]` - Safely retrieves the name from an Artifact
 - `get_parts_from_artifact(artifact: Artifact) -> List[ContentPart]` - Extracts unwrapped content parts from an Artifact
+- `is_text_only_artifact(artifact: Artifact) -> bool` - Checks if an artifact contains only TextParts
+- `get_text_content_from_artifact(artifact: Artifact) -> List[str]` - Extracts all text content from TextParts in an artifact
 **Usage Examples:**
 ```python
@@ -61,6 +63,8 @@ artifact_id = get_artifact_id(artifact)
 - `get_message_from_status_update(event: TaskStatusUpdateEvent) -> Optional[Message]` - Extracts Message from TaskStatusUpdateEvent
 - `get_data_parts_from_status_update(event: TaskStatusUpdateEvent) -> List[DataPart]` - Extracts DataPart objects from status update
 - `get_artifact_from_artifact_update(event: TaskArtifactUpdateEvent) -> Optional[Artifact]` - Extracts Artifact from TaskArtifactUpdateEvent
+- `is_task_status_update(obj: Any) -> bool` - Checks if an object is a TaskStatusUpdateEvent
+- `is_task_artifact_update(obj: Any) -> bool` - Checks if an object is a TaskArtifactUpdateEvent
 **Usage Examples:**
 ```python
@@ -106,6 +110,11 @@ status_event = create_status_update(
 - `get_bytes_from_file_part(part: FilePart) -> Optional[bytes]` - Gets decoded bytes from FilePart
 - `get_filename_from_file_part(part: FilePart) -> Optional[str]` - Gets filename from FilePart
 - `get_mimetype_from_file_part(part: FilePart) -> Optional[str]` - Gets MIME type from FilePart
+- `is_text_part(part: Part) -> bool` - Checks if a Part contains a TextPart
+- `is_file_part(part: Part) -> bool` - Checks if a Part contains a FilePart
+- `is_data_part(part: Part) -> bool` - Checks if a Part contains a DataPart
+- `is_file_part_bytes(part: FilePart) -> bool` - Checks if a FilePart uses FileWithBytes
+- `is_file_part_uri(part: FilePart) -> bool` - Checks if a FilePart uses FileWithUri
 **Usage Examples:**
 ```python
@@ -150,6 +159,8 @@ user_message = create_user_message(
 - `get_client_response_topic(namespace: str, client_id: str) -> str` - Returns topic for publishing response to client
 - `get_client_status_topic(namespace: str, client_id: str, task_id: str) -> str` - Returns topic for publishing status to client
 - `get_client_status_subscription_topic(namespace: str, client_id: str) -> str` - Returns wildcard topic for client to receive status
+- `get_sam_events_topic(namespace: str, category: str, action: str) -> str` - Returns SAM system events topic
+- `get_sam_events_subscription_topic(namespace: str, category: str) -> str` - Returns SAM system events subscription topic
 - `create_send_message_request(message: Message, task_id: str, metadata: Optional[Dict[str, Any]] = None) -> SendMessageRequest` - Creates SendMessageRequest object
 - `create_send_streaming_message_request(message: Message, task_id: str, metadata: Optional[Dict[str, Any]] = None) -> SendStreamingMessageRequest` - Creates SendStreamingMessageRequest object
 - `create_success_response(result: Any, request_id: Optional[Union[str, int]]) -> JSONRPCResponse` - Creates successful JSON-RPC response
@@ -159,24 +170,6 @@ user_message = create_user_message(
 - `get_request_id(request: A2ARequest) -> str | int` - Gets JSON-RPC request ID
 - `get_request_method(request: A2ARequest) -> str` - Gets JSON-RPC method name
 - `get_message_from_send_request(request: A2ARequest) -> Optional[Message]` - Gets Message from send request
-- `get_task_id_from_cancel_request(request: A2ARequest) -> Optional[str]` - Gets task ID from cancel request
-- `get_response_id(response: JSONRPCResponse) -> Optional[Union[str, int]]` - Gets response ID
-- `get_response_result(response: JSONRPCResponse) -> Optional[Any]` - Gets response result
-- `get_response_error(response: JSONRPCResponse) -> Optional[JSONRPCError]` - Gets response error
-- `topic_matches_subscription(topic: str, subscription: str) -> bool` - Checks if topic matches Solace subscription pattern
-- `subscription_to_regex(subscription: str) -> str` - Converts Solace subscription to regex
-- `extract_task_id_from_topic(topic: str, subscription_pattern: str, log_identifier: str) -> Optional[str]` - Extracts task ID from topic
+- `
-**Usage Examples:**
-```python
-from solace_agent_mesh.common.a2a.protocol import get_agent_request_topic, create_send_message_request
-from solace_agent_mesh.common.a2a.message import create_agent_text_message
-# Get topic for sending request to an agent
-topic = get_agent_request_topic("my-namespace", "my-agent")
-# Create a send message request
-message = create_agent_text_message("Hello agent!")
-request = create_sen
-# content_hash: 9b1778648fd65100e79527a9b08867fe94c18b13a52bbe33d86f2e4a6cd62269
+# content_hash: 71c64edf65fe99d8d5cc67d5522436b870fc5b1ead118fc5ef38689b6f26689e

solace_agent_mesh/common/a2a/protocol.py CHANGED Viewed

@@ -188,6 +188,11 @@ def get_sam_events_topic(namespace: str, category: str, action: str) -> str:
     return f"{namespace.rstrip('/')}/sam/events/{category}/{action}"
+def get_feedback_topic(namespace: str) -> str:
+    """Returns the topic for publishing user feedback events."""
+    return f"{namespace.rstrip('/')}/sam/v1/feedback/submit"
 def get_sam_events_subscription_topic(namespace: str, category: str) -> str:
     """Returns SAM system events subscription topic."""
     if not namespace:

solace_agent_mesh/common/a2a/types.py CHANGED Viewed

@@ -35,6 +35,7 @@ class ArtifactInfo(BaseModel):
     uri: Optional[str] = None
     version: Optional[Union[int, str]] = None
     version_count: int
+    source: Optional[str] = None  # Optional: Source of the artifact (e.g., "project")
     model_config = ConfigDict(populate_by_name=True)

solace_agent_mesh/common/a2a_spec/a2a_spec_llm.txt CHANGED Viewed

@@ -7,6 +7,7 @@ The `a2a_spec` directory contains the complete Agent-to-Agent (A2A) communicatio
 - **Direct files:**
   - `a2a.json` - Complete JSON Schema specification for A2A protocol including all data types, requests, responses, and error definitions
   - `a2a_spec_llm.txt` - Developer guide documentation for the A2A specification
+  - `a2a_spec_llm_detail.txt` - Concatenated detailed documentation from all subdirectories
 - **Subdirectories:**
   - `schemas/` - JSON Schema definitions for agent communication signals (progress updates, tool invocations, LLM calls, artifact creation)
@@ -62,6 +63,10 @@ Task {
 **Purpose:** Developer documentation and usage guide for the A2A specification
 **Import:** Documentation file for reference
+#### a2a_spec_llm_detail.txt
+**Purpose:** Comprehensive documentation combining all subdirectory guides
+**Import:** Documentation file for reference
 ### Subdirectory APIs
 #### schemas/
@@ -79,10 +84,10 @@ with open('solace_agent_mesh/common/a2a_spec/schemas/agent_progress_update.json'
 **Available Schemas:**
 - `agent_progress_update.json` - General progress status messages
-- `artifact_creation_progress.json` - File/artifact creation tracking with chunked data
-- `llm_invocation.json` - LLM model invocation signals
+- `artifact_creation_progress.json` - File/artifact creation tracking with chunked data and status
+- `llm_invocation.json` - LLM model invocation signals with usage tracking
 - `tool_invocation_start.json` - Tool execution start notifications
-- `tool_result.json` - Tool execution completion results
+- `tool_result.json` - Tool execution completion results with optional LLM usage
 ## Complete Usage Guide
@@ -215,21 +220,33 @@ agent_card = {
 validate_agent_card(agent_card)
 ```
-### 5. Artifact Creation Progress Tracking
+### 5. Enhanced Artifact Creation Progress Tracking
 ```python
 # Load artifact creation schema
 with open('solace_agent_mesh/common/a2a_spec/schemas/artifact_creation_progress.json') as f:
     artifact_schema = json.load(f)
-# Track artifact creation with chunked data
+# Track artifact creation in progress with chunked data
 artifact_progress = {
     "type": "artifact_creation_progress",
     "filename": "report.pdf",
-    "bytes_saved": 1024,
+    "description": "Monthly sales report",
+    "status": "in-progress",
+    "bytes_transferred": 1024,
     "artifact_chunk": "JVBERi0xLjQKJcOkw7zDtsO..."  # Base64 encoded chunk
 }
 validate(instance=artifact_progress, schema=artifact_schema)
+# Track artifact completion
+artifact_completed = {
+    "type": "artifact_creation_progress",
+    "filename": "report.pdf",
+    "status": "completed",
+    "bytes_transferred": 5120,
+    "mime_type": "application/pdf"
+}
+validate(instance=artifact_completed, schema=artifact_schema)
 ```
 ### 6. LLM Invocation Tracking
@@ -239,13 +256,19 @@ validate(instance=artifact_progress, schema=artifact_schema)
 with open('solace_agent_mesh/common/a2a_spec/schemas/llm_invocation.json') as f:
     llm_schema = json.load(f)
-# Track LLM calls
+# Track LLM calls with usage information
 llm_invocation = {
     "type": "llm_invocation",
     "request": {
         "model": "gpt-4",
         "messages": [{"role": "user", "content": "Analyze this data"}],
         "temperature": 0.7
+    },
+    "usage": {
+        "input_tokens": 150,
+        "output_tokens": 75,
+        "cached_input_tokens": 50,
+        "model": "gpt-4"
     }
 }
 validate(instance=llm_invocation, schema=llm_schema)
@@ -296,14 +319,16 @@ def track_tool_invocation(tool_name, args, call_id):
     validate(instance=invocation, schema=tool_schema)
     return invocation
-# 4. Track tool results
-def track_tool_result(tool_name, result_data, call_id):
+# 4. Track tool results with LLM usage
+def track_tool_result(tool_name, result_data, call_id, llm_usage=None):
     result = {
         "type": "tool_result",
         "tool_name": tool_name,
         "result_data": result_data,
         "function_call_id": call_id
     }
+    if llm_usage:
+        result["llm_usage"] = llm_usage
     validate(instance=result, schema=result_schema)
     return result
 ```
@@ -402,6 +427,19 @@ error_response = {
 validator.validate_definition(error_response, 'JSONRPCErrorResponse')
 ```
-This comprehensive guide shows how to use both the main A2A specification and the specialized signal schemas together to build compliant agent-to-agent communication systems in the Solace Agent Mesh, including progress tracking, tool invocation monitoring, LLM call tracking, and artifact creation progress.
+### 10. Working with Different Transport Protocols
+```python
+# Create agent card with multiple transport interfaces
+agent_card_multi_transport = {
+    "name": "Multi-Transport Agent",
+    "description": "Agent supporting multiple transport protocols",
+    "url": "https://api.example.com/jsonrpc",
+    "preferredTransport": "JSONRPC",
+    "additionalInterfaces": [
+        {
+            "url": "https://api.example.com/jsonrpc",
+            "transport": "JSONRPC"
+        },
-# content_hash: 70d5dd9030447ae14b684049b5e111c72606e637df99d917420a25ac1f718bae
+# content_hash: b8b4bc87e9300c50f2500efdd840bb765e107bfbc1de283800934528e8092614

solace_agent_mesh/common/a2a_spec/schemas/artifact_creation_progress.json CHANGED Viewed

@@ -13,19 +13,36 @@
             "type": "string",
             "description": "The name of the artifact being created."
         },
-        "bytes_saved": {
+        "description": {
+            "type": "string",
+            "description": "An optional description of the artifact being created."
+        },
+        "status": {
+            "type": "string",
+            "enum": ["in-progress", "completed", "failed"],
+            "description": "The status of the artifact creation."
+        },
+        "bytes_transferred": {
             "type": "integer",
-            "description": "The number of bytes saved so far."
+            "description": "The number of bytes transferred so far."
         },
         "artifact_chunk": {
             "type": "string",
-            "description": "The chunk of artifact data that was saved in this progress update."
+            "description": "The chunk of artifact data that was transferred in this progress update. Only present for 'in-progress' status."
+        },
+        "mime_type": {
+            "type": "string",
+            "description": "The MIME type of the artifact. Only present for 'completed' status."
+        },
+        "version": {
+            "type": "integer",
+            "description": "The version number of the artifact being created or updated."
         }
     },
     "required": [
         "type",
         "filename",
-        "bytes_saved",
-        "artifact_chunk"
+        "status",
+        "bytes_transferred"
     ]
-}
+}

solace_agent_mesh/common/a2a_spec/schemas/feedback_event.json ADDED Viewed

@@ -0,0 +1,51 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "FeedbackEvent",
+    "description": "Schema for a user feedback event published by a gateway.",
+    "type": "object",
+    "properties": {
+        "id": {
+            "type": "string",
+            "description": "A unique identifier for this feedback submission."
+        },
+        "session_id": {
+            "type": "string",
+            "description": "The A2A session ID associated with the task."
+        },
+        "task_id": {
+            "type": "string",
+            "description": "The ID of the task this feedback is for."
+        },
+        "user_id": {
+            "type": "string",
+            "description": "The identifier of the user who provided the feedback."
+        },
+        "rating": {
+            "type": "string",
+            "enum": ["up", "down"],
+            "description": "The rating provided by the user."
+        },
+        "comment": {
+            "type": ["string", "null"],
+            "description": "Optional text comment provided by the user."
+        },
+        "created_time": {
+            "type": "string",
+            "format": "date-time",
+            "description": "The ISO 8601 timestamp (UTC) when the feedback was submitted."
+        },
+        "gateway_id": {
+            "type": "string",
+            "description": "The ID of the gateway that collected the feedback."
+        }
+    },
+    "required": [
+        "id",
+        "session_id",
+        "task_id",
+        "user_id",
+        "rating",
+        "created_time",
+        "gateway_id"
+    ]
+}

solace_agent_mesh/common/a2a_spec/schemas/schemas_llm.txt CHANGED Viewed

@@ -9,7 +9,6 @@ This directory contains JSON Schema definitions for various agent-to-agent (A2A)
 - `llm_invocation.json` - Schema for LLM model invocation signals with usage tracking
 - `tool_invocation_start.json` - Schema for tool execution start notifications
 - `tool_result.json` - Schema for tool execution completion results with optional LLM usage
-- `schemas_llm.txt` - Previous developer guide (legacy documentation)
 ## Developer API Reference
@@ -52,7 +51,7 @@ validate(instance=data, schema=schema)
 ```
 ### artifact_creation_progress.json
-**Purpose:** Defines the schema for tracking progress during file or artifact creation operations with chunked data transfer.
+**Purpose:** Defines the schema for tracking progress during file or artifact creation operations with status tracking and chunked data transfer.
 **Import:** Load as JSON schema for validation
 ```python
@@ -65,16 +64,22 @@ from jsonschema import validate
 {
   "type": "artifact_creation_progress",
   "filename": "string",
-  "bytes_saved": "integer",
-  "artifact_chunk": "string"
+  "description": "string",
+  "status": "in-progress|completed|failed",
+  "bytes_transferred": "integer",
+  "artifact_chunk": "string",
+  "mime_type": "string"
 }
 ```
 **Properties:**
 - `type: "artifact_creation_progress"` - Constant identifier for this signal type (required)
 - `filename: string` - Name of the artifact being created (required)
-- `bytes_saved: integer` - Number of bytes saved so far (required)
-- `artifact_chunk: string` - The chunk of artifact data that was saved in this update (required)
+- `description: string` - Optional description of the artifact being created (optional)
+- `status: string` - Status of artifact creation: "in-progress", "completed", or "failed" (required)
+- `bytes_transferred: integer` - Number of bytes transferred so far (required)
+- `artifact_chunk: string` - Chunk of artifact data transferred in this update (optional, only for 'in-progress')
+- `mime_type: string` - MIME type of the artifact (optional, only for 'completed')
 **Usage Examples:**
 ```python
@@ -85,14 +90,26 @@ from jsonschema import validate
 with open('solace_agent_mesh/common/a2a_spec/schemas/artifact_creation_progress.json') as f:
     schema = json.load(f)
-# Valid data example
+# In-progress example
 data = {
     "type": "artifact_creation_progress",
     "filename": "report.pdf",
-    "bytes_saved": 1024,
+    "description": "Monthly sales report",
+    "status": "in-progress",
+    "bytes_transferred": 1024,
     "artifact_chunk": "JVBERi0xLjQKJcOkw7zDtsO..."
 }
 validate(instance=data, schema=schema)
+# Completed example
+completed_data = {
+    "type": "artifact_creation_progress",
+    "filename": "report.pdf",
+    "status": "completed",
+    "bytes_transferred": 5120,
+    "mime_type": "application/pdf"
+}
+validate(instance=completed_data, schema=schema)
 ```
 ### llm_invocation.json
@@ -310,4 +327,4 @@ schemas = {
 }
 ```
-# content_hash: 8d0325636918fd8bdabc0ba61bed79ae2b2be06778893406197aebfb7c3e3a21
+# content_hash: 9b18c2ba0e0aa3d52a27ecd90f45376713fe2738cee386219f988fd84da93a51

solace_agent_mesh/common/common_llm.txt CHANGED Viewed

@@ -68,9 +68,12 @@ Together, these components form a cohesive ecosystem, enabling developers to eit
 **Classes/Functions/Constants:**
 - **`AgentRegistry`**: A thread-safe class for storing and managing agent cards.
-  - `add_or_update_agent(self, agent_card: AgentCard)`: Adds a new agent or updates an existing one.
+  - `add_or_update_agent(self, agent_card: AgentCard) -> bool`: Adds a new agent or updates an existing one, returns True if new.
   - `get_agent(self, agent_name: str) -> Optional[AgentCard]`: Retrieves an agent card by its unique name.
   - `get_agent_names(self) -> List[str]`: Returns a sorted list of all discovered agent names.
+  - `get_last_seen(self, agent_name: str) -> Optional[float]`: Returns the timestamp when the agent was last seen.
+  - `check_ttl_expired(self, agent_name: str, ttl_seconds: int) -> Tuple[bool, int]`: Checks if an agent's TTL has expired.
+  - `remove_agent(self, agent_name: str) -> bool`: Removes an agent from the registry.
   - `clear(self)`: Clears all agents from the registry.
 #### constants.py
@@ -79,6 +82,8 @@ Together, these components form a cohesive ecosystem, enabling developers to eit
 **Classes/Functions/Constants:**
 - `DEFAULT_COMMUNICATION_TIMEOUT: int`: Default timeout for communication operations (600 seconds / 10 minutes).
+- `HEALTH_CHECK_TTL_SECONDS: int`: Time after which a health check is considered stale (60 seconds).
+- `HEALTH_CHECK_INTERVAL_SECONDS: int`: Interval between health checks (10 seconds).
 - `TEXT_ARTIFACT_CONTEXT_MAX_LENGTH_CAPACITY: int`: Maximum number of characters that can be loaded from a text artifact (200,000).
 - `TEXT_ARTIFACT_CONTEXT_DEFAULT_LENGTH: int`: Default number of characters to load from a text artifact (100,000).
@@ -102,8 +107,11 @@ Together, these components form a cohesive ecosystem, enabling developers to eit
 - **`ArtifactCreationProgressData`**: Data model for artifact creation progress signals.
   - `type: Literal["artifact_creation_progress"]`: The constant type identifier.
   - `filename: str`: The name of the artifact being created.
-  - `bytes_saved: int`: The number of bytes saved so far.
-  - `artifact_chunk: str`: The chunk of artifact data that was saved in this progress update.
+  - `status: Literal["in-progress", "completed", "failed"]`: The status of the artifact creation.
+  - `bytes_transferred: int`: The number of bytes transferred so far.
+  - `description: Optional[str]`: An optional description of the artifact being created.
+  - `artifact_chunk: Optional[str]`: The chunk of artifact data that was transferred in this progress update.
+  - `mime_type: Optional[str]`: The MIME type of the artifact (for completed status).
 - **`ToolResultData`**: Data model for tool execution result signals.
   - `type: Literal["tool_result"]`: The constant type identifier.
   - `tool_name: str`: The name of the tool that was called.
@@ -217,35 +225,6 @@ from solace_agent_mesh.common.services.identity_service import create_identity_s
 #### utils/
 **Purpose:** A collection of cross-cutting utilities for caching, logging, MIME type handling, and dynamic content processing.
-**Key Exports:** `InMemoryCache`, `is_text_based_mime_type`, `resolve_embeds_in_string`
-**Import Examples:**
-```python
-from solace_agent_mesh.common.utils.in_memory_cache import InMemoryCache
-from solace_agent_mesh.common.utils import is_text_based_mime_type
-from solace_agent_mesh.common.utils.embeds import resolve_embeds_recursively_in_string
-```
+**Key Exports:** `InMemoryCache`, `is_text_based_mime_type`, `resolve_emb
-## Complete Usage Guide
-### 1. Basic A2A Protocol Usage
-This example shows how to use the core protocol functions and types to build A2A communication.
-```python
-import uuid
-from datetime import datetime, timezone
-from solace_agent_mesh.common.a2a_protocol import (
-    get_agent_request_topic,
-    get_gateway_status_topic,
-    translate_a2a_to_adk_content
-)
-from solace_agent_mesh.common.types import (
-    Message,
-    TextPart,
-    Task,
-    TaskStatus,
-    TaskState,
-    AgentCard
-)
-from solace_
-# content_hash: 4cbf98260b5f5bef314fae44cf680520f4581948d2bfd8b08e7c6455bbcac1bc
+# content_hash: 6fd3be2d2c731f45200e4f3968c7ff82a85f6d57e8269b276fd56cd4444013c9

solace_agent_mesh/common/data_parts.py CHANGED Viewed

@@ -71,10 +71,26 @@ class ArtifactCreationProgressData(BaseModel):
         description="The constant type for this data part.",
     )
     filename: str = Field(..., description="The name of the artifact being created.")
-    bytes_saved: int = Field(..., description="The number of bytes saved so far.")
-    artifact_chunk: str = Field(
-        ...,
-        description="The chunk of artifact data that was saved in this progress update.",
+    status: Literal["in-progress", "completed", "failed"] = Field(
+        ..., description="The status of the artifact creation."
+    )
+    bytes_transferred: int = Field(
+        ..., description="The number of bytes transferred so far."
+    )
+    description: Optional[str] = Field(
+        None, description="An optional description of the artifact being created."
+    )
+    artifact_chunk: Optional[str] = Field(
+        None,
+        description="The chunk of artifact data that was transferred in this progress update. Only present for 'in-progress' status.",
+    )
+    mime_type: Optional[str] = Field(
+        None,
+        description="The MIME type of the artifact. Only present for 'completed' status.",
+    )
+    version: Optional[int] = Field(
+        None,
+        description="The version number of the artifact being created or updated.",
     )

solace_agent_mesh/common/middleware/middleware_llm.txt CHANGED Viewed

@@ -171,4 +171,4 @@ MiddlewareRegistry.reset_bindings()
 print(f"Registry Status after reset: {MiddlewareRegistry.get_registry_status()}")
 ```
-# content_hash: 9f505d5203463aeca42959c92c78fe35212f34e4ea0288b67c1c6a6450117d6c
+# content_hash: eb6f60d7fdc4a0fb198bf8cc5644c3d372a72ebf46870c79282f230b07637095

solace_agent_mesh/common/sac/sac_llm.txt CHANGED Viewed

@@ -68,4 +68,4 @@ agent.run()
 agent.cleanup()
 ```
-# content_hash: 8ba90bbcaab8684e6611224e74cb0bb86a9cf87d6dccd25352d70ee3d851a06b
+# content_hash: 3a67b8df1c1af409e52645a3674864418b00017b58519d84736eb4d1da56ea11

solace_agent_mesh/common/sam_events/sam_events_llm.txt CHANGED Viewed

@@ -101,4 +101,4 @@ topic = SamEventService.get_event_topic("my_namespace", "session.deleted")
 print(topic)  # Returns the proper SAM events topic
 ```
-# content_hash: e2f1353fe6841458c68f294efc03e1fdbac3632f78507e6e58044bb0c59919af
+# content_hash: 2a249adbac594bbf8a551a6b4f606218b7b8fce41753efe31954b8acc50cc126

solace_agent_mesh/common/services/employee_service.py CHANGED Viewed

@@ -66,7 +66,7 @@ class BaseEmployeeService(ABC):
         pass
     @abstractmethod
-    async def get_time_off_data(self, employee_id: str) -> List[Dict[str, Any]]:
+    async def get_time_off_data(self, employee_id: str, start_date: Optional[str] = None, end_date: Optional[str] = None) -> List[Dict[str, Any]]:
         """
         Retrieves a list of raw time-off entries for an employee.

solace_agent_mesh/common/services/providers/providers_llm.txt CHANGED Viewed

@@ -18,7 +18,7 @@ This file contains no public classes or functions - it serves only as package do
 **Import:** `from solace_agent_mesh.common.services.providers.local_file_identity_service import LocalFileIdentityService`
 **Classes:**
-- `LocalFileIdentityService(config: Dict[str, Any])` - Identity service that sources user data from a local JSON file
+- `LocalFileIdentityService(config: Dict[str, Any], component: Optional[SamComponentBase] = None)` - Identity service that sources user data from a local JSON file
   - `async get_user_profile(auth_claims: Dict[str, Any]) -> Optional[Dict[str, Any]]` - Looks up a user profile using the lookup key from auth claims
   - `async search_users(query: str, limit: int = 10) -> List[Dict[str, Any]]` - Performs case-insensitive search on user names and emails
   - `file_path: str` - Path to the JSON file containing user data
@@ -30,6 +30,7 @@ This file contains no public classes or functions - it serves only as package do
 ```python
 import asyncio
 import json
+from typing import Dict, Any
 from solace_agent_mesh.common.services.providers.local_file_identity_service import LocalFileIdentityService
 # Create sample users.json file
@@ -77,4 +78,4 @@ async def main():
 asyncio.run(main())
 ```
-# content_hash: 3661ffe07466b1391797c2feb90e2c97544b1a9c6c8cd15fc448cf95f4be6015
+# content_hash: 26b677e947bf60f1e211b6e119bf6382f0a269d46c0f102751bae9faab3c8435

solace_agent_mesh/common/services/services_llm.txt CHANGED Viewed

@@ -36,10 +36,10 @@ The core architecture revolves around factory functions (`create_identity_servic
 **Classes/Functions/Constants:**
 - **`class BaseIdentityService(ABC)`**: The abstract base class for identity service providers.
-    - **`__init__(self, config: Dict[str, Any])`**: Initializes the service, setting up configuration and an optional in-memory cache.
+    - **`__init__(self, config: Dict[str, Any], component: Optional[SamComponentBase] = None)`**: Initializes the service, setting up configuration and an optional in-memory cache.
     - **`async def get_user_profile(self, auth_claims: Dict[str, Any]) -> Optional[Dict[str, Any]]`**: (Abstract) Fetches additional profile details for an authenticated user based on claims.
     - **`async def search_users(self, query: str, limit: int = 10) -> List[Dict[str, Any]]`**: (Abstract) Searches for users based on a query string (e.g., for autocomplete).
-- **`def create_identity_service(config: Optional[Dict[str, Any]]) -> Optional[BaseIdentityService]`**: A factory function that instantiates an identity service provider. It has special handling for the built-in `local_file` provider and uses Python entry points for all other provider types.
+- **`def create_identity_service(config: Optional[Dict[str, Any]], component: Optional[SamComponentBase] = None) -> Optional[BaseIdentityService]`**: A factory function that instantiates an identity service provider. It has special handling for the built-in `local_file` provider and uses Python entry points for all other provider types.
 ### Subdirectory APIs
@@ -358,6 +358,11 @@ async def setup_file_based_identity():
 asyncio.run(setup_file_based_identity())
 ```
-This comprehensive guide shows how the services framework provides a clean, extensible way to integrate various data sources while maintaining consistent interfaces and supporting both built-in providers and external plugins through the factory pattern and plugin system.
+### 6. Advanced Usage: Custom Identity Service with Component Integration
+```python
+import asyncio
+from typing import Any, Dict, List, Optional
+from solace_agent
-# content_hash: 879562926a7d3b7c6782ae395159d6c1f8a55663ce052a93eea8966e69b04444
+# content_hash: 4532aa73f5067694fc253bc1875f79148f7b8778d1d46680c423d2b3da8456e6

solace_agent_mesh/common/utils/embeds/constants.py CHANGED Viewed

@@ -38,6 +38,7 @@ EARLY_EMBED_TYPES: Set[str] = {
 }
 LATE_EMBED_TYPES: Set[str] = {
     "artifact_content",
+    "artifact_return",
 }
 TEXT_CONTAINER_MIME_TYPES: Set[str] = {

solace_agent_mesh/common/utils/embeds/embeds_llm.txt CHANGED Viewed

@@ -217,4 +217,4 @@ result, error, size = await evaluate_embed(
 ### types.py
-# content_hash: 2f31c6289fe46fe2ebb4c490574d6d030547346221337f730f315f7b3cac572f
+# content_hash: b2c6bea4995d4d68f8cad84016e236560d091897ba1b8502f1532bf84eb813f7

solace_agent_mesh/common/utils/embeds/modifiers.py CHANGED Viewed

@@ -26,7 +26,7 @@ except ImportError:
 from google.adk.artifacts import BaseArtifactService
-from .types import DataFormat
+from .types import DataFormat, ResolutionMode
 def _apply_jsonpath(
@@ -661,6 +661,7 @@ async def _apply_template(
             context=context,
             resolver_func=evaluate_embed,
             types_to_resolve=EARLY_EMBED_TYPES.union(LATE_EMBED_TYPES),
+            resolution_mode=ResolutionMode.RECURSIVE_ARTIFACT_CONTENT,
             log_identifier=f"{log_id}[TemplateEmbeds]",
             config=resolver_config,
             max_depth=resolver_config.get("gateway_recursive_embed_depth", 12),

solace-agent-mesh 1.6.3__py3-none-any.whl → 1.7.0__py3-none-any.whl

Potentially problematic release.

solace-agent-mesh 1.6.3py3-none-any.whl → 1.7.0py3-none-any.whl