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

solace_agent_mesh/gateway/http_sse/shared/exception_handlers.py

@@ -128,9 +128,8 @@ async def http_exception_handler(
     request: Request, exc: HTTPException
 ) -> JSONResponse:
     """Handle FastAPI HTTPExceptions with standardized format."""
-    # Map common HTTP status codes to standard messages
+    # Map common HTTP status codes to standard messages (only used as fallback)
     message_map = {
-        400: "bad request",
         401: "An authentication error occurred. Try logging out and in again.",
         403: "You do not have permissions to perform this operation",
         404: f"Resource not found with path {request.url.path}",
@@ -142,7 +141,7 @@ async def http_exception_handler(
         503: "Service is unavailable.",
     }
 
-    message = message_map.get(exc.status_code, exc.detail)
+    message = exc.detail if exc.detail else message_map.get(exc.status_code, "bad request")
     error_dto = EventErrorDTO.create(message)
     return JSONResponse(status_code=exc.status_code, content=error_dto.model_dump())
 

solace_agent_mesh/gateway/http_sse/shared/shared_llm.txt

@@ -157,7 +157,6 @@ register_exception_handlers(app)
   - `update(session: Session, entity_id: Any, update_data: Dict[str, Any]) -> EntityType` - Update an entity
   - `delete(session: Session, entity_id: Any) -> None` - Delete an entity
 - `PaginatedRepository(model_class: Type[ModelType], entity_class: Type[EntityType])` - Base repository with enhanced pagination support
-  - `get_paginated(session: Session, page_number: int, page_size: int) -> tuple[List[EntityType], int]` - Get paginated results
 - `ValidationMixin` - Mixin for repositories that need validation logic
 
 **Usage Examples:**
@@ -187,6 +186,11 @@ user = repo.create(session, {"name": "John", "email": "john@example.com"})
 - `DataResponse[T](data: T)` - Simple data response wrapper
   - `create(data: T) -> DataResponse[T]` - Create data response
 
+**Constants/Variables:**
+- `DEFAULT_PAGE_NUMBER: int` - Default page number (1)
+- `DEFAULT_PAGE_SIZE: int` - Default page size (20)
+- `MAX_PAGE_SIZE: int` - Maximum allowed page size (100)
+
 **Usage Examples:**
 ```python
 from solace_agent_mesh.gateway.http_sse.shared import PaginationParams, PaginatedResponse
@@ -230,6 +234,8 @@ response = create_paginated_response(users, 100, pagination_params)
 - `DatabaseExceptionHandler` - Centralized handler for converting SQLAlchemy exceptions to domain exceptions
   - `handle_integrity_error(e: IntegrityError, entity_type: str = "Resource") -> ValidationError` - Convert integrity constraint violations
   - `handle_operational_error(e: OperationalError, entity_type: str = "Resource") -> DataIntegrityError` - Handle operational errors
+  - `handle_database_error(e: DatabaseError, entity_type: str = "Resource") -> DataIntegrityError` - Handle general database errors
+  - `handle_sqlalchemy_error(e: SQLAlchemyError, entity_type: str = "Resource") -> DataIntegrityError` - Handle any other SQLAlchemy errors
 
 **Functions:**
 - `handle_database_errors(entity_type: str = "Resource")` - Convenience decorator for database exception handling
@@ -251,6 +257,8 @@ class UserRepository:
 
 **Classes:**
 - `SimpleJSON(TypeDecorator)` - Simple JSON type using Text storage for all databases
+  - `process_bind_param(value, dialect)` - Convert Python object to JSON string for storage
+  - `process_result_value(value, dialect)` - Convert JSON string back to Python object
 
 **Usage Examples:**
 ```python
@@ -262,24 +270,50 @@ class MyModel(Base):
     metadata = Column(SimpleJSON)  # Stores JSON as text
 ```
 
-### utils.py
-**Purpose:** Generic utility functions
-**Import:** `from solace_agent_mesh.gateway.http_sse.shared import generate_uuid, to_snake_case, to_pascal_case`
+### enums.py
+**Purpose:** Enumerations used throughout the application
+**Import:** `from solace_agent_mesh.gateway.http_sse.shared.enums import SenderType, TaskStatus, MessageType`
 
-**Functions:**
-- `generate_uuid() -> str` - Generate a UUID string for database storage
-- `to_snake_case(name: str) -> str` - Convert a string to snake_case
-- `to_pascal_case(name: str) -> str` - Convert a string to PascalCase
+**Classes:**
+- `SenderType(str, Enum)` - Types of message senders (USER, AGENT, SYSTEM)
+- `TaskStatus(str, Enum)` - Task execution status (PENDING, RUNNING, COMPLETED, FAILED, CANCELLED)
+- `MessageType(str, Enum)` - Types of messages (TEXT, FILE, IMAGE, DOCUMENT)
+- `ValidationErrorType(str, Enum)` - Types of validation errors (REQUIRED_FIELD, INVALID_FORMAT, etc.)
 
 **Usage Examples:**
 ```python
-from solace_agent_mesh.gateway.http_sse.shared import generate_uuid, to_snake_case
+from solace_agent_mesh.gateway.http_sse.shared.enums import SenderType, TaskStatus
 
-# Generate unique ID
-user_id = generate_uuid()
+# Use in message handling
+if sender_type == SenderType.USER:
+    process_user_message()
 
-# Convert naming
-snake_name = to_snake_case("User Name")  # "user_name"
+# Use in task management
+task.status = TaskStatus.RUNNING
 ```
 
-# content_hash: 0e33735691fb4637243f4fe61acbba78a388e654834903e34be22e3ce6f3c3bc
+### types.py
+**Purpose:** Custom types and type aliases for better type safety
+**Import:** `from solace_agent_mesh.gateway.http_sse.shared.types import UserId, JsonDict, Timestamp`
+
+**Type Aliases:**
+- `UserId: str` - User identifier type
+- `SessionId: str` - Session identifier type
+- `MessageId: str` - Message identifier type
+- `TaskId: str` - Task identifier type
+- `AgentId: str` - Agent identifier type
+- `JsonDict: dict[str, Any]` - JSON dictionary type
+- `Headers: dict[str, str]` - HTTP headers type
+- `QueryParams: dict[str, str | list[str]]` - Query parameters type
+
+**Classes:**
+- `Timestamp(BaseModel)` - Standardized timestamp representation using epoch milliseconds
+  - `created_time: int` - Creation time in epoch milliseconds
+  - `updated_time: int | None` - Update time in epoch milliseconds
+- `SortInfo(BaseModel)` - Sorting information for list requests
+  - `field: str` - Field to sort by
+  - `direction: str` - Sort direction (asc or desc)
+- `FilterInfo(BaseModel)` - Filtering information for list requests
+  - `field: str` - Field to filter
+
+# content_hash: 646c6eedceab05f3b8573660906cf739cefbc0807c5b28dffe25161746299b67

solace_agent_mesh/solace_agent_mesh_llm.txt

@@ -359,4 +359,4 @@ async def client_integration_example():
         if hasattr(response.result, 'text_delta'):
             print(response.result.text_delta,
 
-# content_hash: ce6554bc70f746507a86e0faa0836fe1b338161b5f72a7923df30de5f23ac84e
+# content_hash: fa4f1849eeec9ff7be5bf627dd4ff9a4441625606ab996e0aaec608fcc8229d9

{solace_agent_mesh-1.6.3.dist-info → solace_agent_mesh-1.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: solace-agent-mesh
-Version: 1.6.3
+Version: 1.7.0
 Summary: Solace Agent Mesh is an open-source framework for building event-driven, multi-agent AI systems where specialized agents collaborate on complex tasks.
 Project-URL: Homepage, https://github.com/SolaceLabs/solace-agent-mesh
 Project-URL: Repository, https://github.com/SolaceLabs/solace-agent-mesh
@@ -218,6 +218,7 @@ Requires-Dist: a2a-sdk[http-server]==0.3.7
 Requires-Dist: alembic==1.16.5
 Requires-Dist: asteval==1.0.6
 Requires-Dist: beautifulsoup4==4.13.5
+Requires-Dist: boto3==1.40.37
 Requires-Dist: click==8.1.8
 Requires-Dist: fastapi==0.117.1
 Requires-Dist: flask-cors==6.0.1
@@ -241,6 +242,7 @@ Requires-Dist: openai==1.99.9
 Requires-Dist: pandas==2.3.2
 Requires-Dist: playwright==1.55.0
 Requires-Dist: plotly==6.3.0
+Requires-Dist: psycopg2-binary==2.9.10
 Requires-Dist: pydantic==2.11.9
 Requires-Dist: pydub==0.25.1
 Requires-Dist: pystache==0.6.8
@@ -258,10 +260,6 @@ Provides-Extra: employee-tools
 Requires-Dist: holidays==0.81.0; extra == 'employee-tools'
 Provides-Extra: gcs
 Requires-Dist: google-cloud-storage==2.19.0; extra == 'gcs'
-Provides-Extra: postgresql
-Requires-Dist: psycopg2-binary==2.9.10; extra == 'postgresql'
-Provides-Extra: s3
-Requires-Dist: boto3==1.40.37; extra == 's3'
 Provides-Extra: vertex
 Requires-Dist: google-cloud-aiplatform==1.120.0; extra == 'vertex'
 Description-Content-Type: text/markdown