solace-agent-mesh 1.6.1__py3-none-any.whl → 1.13.2__py3-none-any.whl

solace_agent_mesh/gateway/http_sse/routers/dto/requests/project_requests.py

@@ -0,0 +1,48 @@
+"""
+Request DTOs for project-related API endpoints.
+"""
+
+from pydantic import BaseModel, Field
+from typing import Optional
+
+
+class CreateProjectRequest(BaseModel):
+    """Request to create a new project."""
+    
+    name: str = Field(..., min_length=1, max_length=255, description="Project name")
+    description: Optional[str] = Field(None, max_length=1000, description="Project description")
+    system_prompt: Optional[str] = Field(None, max_length=4000, description="Instructions for the project")
+    default_agent_id: Optional[str] = Field(None, description="Default agent ID for new chats")
+    file_metadata: Optional[str] = Field(None, description="JSON string containing file metadata")
+    user_id: str
+
+
+class UpdateProjectRequest(BaseModel):
+    """Request to update an existing project."""
+    
+    name: Optional[str] = Field(None, min_length=1, max_length=255, description="Project name")
+    description: Optional[str] = Field(None, max_length=1000, description="Project description")
+    system_prompt: Optional[str] = Field(None, alias="systemPrompt", max_length=4000, description="Instructions for the project")
+    default_agent_id: Optional[str] = Field(None, alias="defaultAgentId", description="Default agent ID for new chats")
+
+
+class GetProjectsRequest(BaseModel):
+    """Request DTO for retrieving projects."""
+    user_id: str
+
+
+class GetProjectRequest(BaseModel):
+    """Request DTO for retrieving a specific project."""
+    project_id: str
+    user_id: str
+
+
+class DeleteProjectRequest(BaseModel):
+    """Request DTO for deleting a project."""
+    project_id: str
+    user_id: str
+
+
+class ProjectFilter(BaseModel):
+    """Filter criteria for retrieving projects."""
+    user_id: Optional[str] = None

solace_agent_mesh/gateway/http_sse/routers/dto/requests/session_requests.py

@@ -2,14 +2,16 @@
 Session-related request DTOs.
 """
 
+from typing import Optional
 from pydantic import BaseModel, Field
 
-from ....shared.types import SessionId, UserId
+from solace_agent_mesh.shared.utils.types import SessionId, UserId
 
 
 class GetSessionRequest(BaseModel):
     """Request DTO for retrieving a specific session."""
     session_id: SessionId
+    project_id: Optional[str] = None
     user_id: UserId
 
 
@@ -18,3 +20,14 @@ class UpdateSessionRequest(BaseModel):
     session_id: SessionId
     user_id: UserId
     name: str = Field(..., min_length=1, max_length=255, description="New session name")
+
+
+class MoveSessionRequest(BaseModel):
+    """Request DTO for moving a session to a different project."""
+    project_id: Optional[str] = Field(None, alias="projectId", description="New project ID (null to remove from project)")
+
+
+class SearchSessionsRequest(BaseModel):
+    """Request DTO for searching sessions."""
+    query: str = Field(..., min_length=1, description="Search query string")
+    project_id: Optional[str] = Field(None, alias="projectId", description="Optional project ID to filter results")

solace_agent_mesh/gateway/http_sse/routers/dto/responses/base_responses.py

@@ -6,7 +6,7 @@ from typing import Any
 
 from pydantic import BaseModel, ConfigDict
 
-from ....shared import epoch_ms_to_iso8601
+from solace_agent_mesh.shared.utils.timestamp_utils import epoch_ms_to_iso8601
 
 
 class BaseTimestampResponse(BaseModel):

solace_agent_mesh/gateway/http_sse/routers/dto/responses/project_responses.py

@@ -0,0 +1,31 @@
+"""
+Project-related response DTOs.
+"""
+
+from pydantic import BaseModel, ConfigDict, Field
+from typing import Optional
+
+from .base_responses import BaseTimestampResponse
+
+
+class ProjectResponse(BaseTimestampResponse):
+    """Response DTO for a project."""
+
+    id: str
+    name: str
+    user_id: str = Field(alias="userId")
+    description: Optional[str] = None
+    system_prompt: Optional[str] = Field(default=None, alias="systemPrompt")
+    default_agent_id: Optional[str] = Field(default=None, alias="defaultAgentId")
+    artifact_count: Optional[int] = Field(default=None, alias="artifactCount")
+    created_at: int = Field(alias="createdAt")
+    updated_at: Optional[int] = Field(default=None, alias="updatedAt")
+
+
+class ProjectListResponse(BaseModel):
+    """Response DTO for a list of projects."""
+
+    model_config = ConfigDict(populate_by_name=True)
+
+    projects: list[ProjectResponse]
+    total: int

solace_agent_mesh/gateway/http_sse/routers/dto/responses/session_responses.py

@@ -4,8 +4,8 @@ Session-related response DTOs.
 
 from pydantic import BaseModel, ConfigDict, Field
 
-from ....shared.pagination import PaginationMeta
-from ....shared.types import SessionId, UserId
+from solace_agent_mesh.shared.api.pagination import PaginationMeta
+from solace_agent_mesh.shared.utils.types import SessionId, UserId
 from .base_responses import BaseTimestampResponse
 
 
@@ -16,6 +16,9 @@ class SessionResponse(BaseTimestampResponse):
     user_id: UserId = Field(alias="userId")
     name: str | None = None
     agent_id: str | None = Field(default=None, alias="agentId")
+    project_id: str | None = Field(default=None, alias="projectId")
+    project_name: str | None = Field(default=None, alias="projectName")
+    has_running_background_task: bool = Field(default=False, alias="hasRunningBackgroundTask")
     created_time: int = Field(alias="createdTime")
     updated_time: int | None = Field(default=None, alias="updatedTime")
 

solace_agent_mesh/gateway/http_sse/routers/dto/responses/version_responses.py

@@ -0,0 +1,31 @@
+"""
+Version-related response DTOs.
+"""
+
+from typing import Optional
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ProductInfo(BaseModel):
+    """Information about a single installed product."""
+
+    model_config = ConfigDict(populate_by_name=True)
+
+    id: str = Field(..., description="Product identifier")
+    name: str = Field(..., description="Human-readable product name")
+    description: str = Field(..., description="Product description")
+    version: str = Field(..., description="Product version")
+    dependencies: Optional[dict[str, str]] = Field(
+        default=None, description="Optional map of dependency names to versions"
+    )
+
+
+class VersionResponse(BaseModel):
+    """Response containing version information for all installed products."""
+
+    model_config = ConfigDict(populate_by_name=True)
+
+    products: list[ProductInfo] = Field(
+        ..., description="List of installed product information"
+    )

solace_agent_mesh/gateway/http_sse/routers/feedback.py

@@ -2,16 +2,31 @@
 API Router for receiving and processing user feedback on chat messages.
 """
 
+import logging
+from datetime import datetime
 from typing import Literal, Optional
 
-from fastapi import APIRouter, Depends
+from fastapi import APIRouter, Depends, HTTPException, status
 from fastapi import Request as FastAPIRequest
 from pydantic import BaseModel, Field
+from sqlalchemy.orm import Session as DBSession
 
-from ..dependencies import get_feedback_service, get_user_id
+from ..dependencies import (
+    get_db,
+    get_feedback_service,
+    get_task_repository,
+    get_user_config,
+    get_user_id,
+)
+from ..repository.entities import Feedback
+from ..repository.feedback_repository import FeedbackRepository
+from ..repository.interfaces import ITaskRepository
 from ..services.feedback_service import FeedbackService
+from solace_agent_mesh.shared.api.pagination import PaginationParams
+from solace_agent_mesh.shared.utils.types import UserId
 
 router = APIRouter()
+log = logging.getLogger(__name__)
 
 
 class FeedbackPayload(BaseModel):
@@ -23,6 +38,122 @@ class FeedbackPayload(BaseModel):
     feedback_text: Optional[str] = Field(None, alias="feedbackText")
 
 
+@router.get("/feedback", response_model=list[Feedback], tags=["Feedback"])
+async def get_feedback(
+    request: FastAPIRequest,
+    start_date: str | None = None,
+    end_date: str | None = None,
+    task_id: str | None = None,
+    session_id: str | None = None,
+    rating: Literal["up", "down"] | None = None,
+    page: int = 1,
+    page_size: int = 20,
+    query_user_id: str | None = None,
+    db: DBSession = Depends(get_db),
+    user_id: UserId = Depends(get_user_id),
+    user_config: dict = Depends(get_user_config),
+    task_repo: ITaskRepository = Depends(get_task_repository),
+):
+    """
+    Retrieves feedback with flexible filtering and security controls.
+
+    Regular users can only view their own feedback.
+    Users with the 'feedback:read:all' scope can view any user's feedback.
+
+    Query Parameters:
+    - start_date: Filter feedback created after this date (ISO 8601 format)
+    - end_date: Filter feedback created before this date (ISO 8601 format)
+    - task_id: Filter by specific task ID
+    - session_id: Filter by specific session ID
+    - rating: Filter by rating type ("up" or "down")
+    - page: Page number (default: 1)
+    - page_size: Results per page (default: 20)
+    - query_user_id: (Admin only) Query feedback for a specific user
+    """
+    log_prefix = "[GET /api/v1/feedback] "
+    log.info("%sRequest from user %s", log_prefix, user_id)
+
+    # Determine target user and permissions
+    target_user_id = user_id
+    can_query_all = user_config.get("scopes", {}).get("feedback:read:all", False)
+
+    if query_user_id:
+        if can_query_all:
+            target_user_id = query_user_id
+            log.info(
+                "%sAdmin user %s is querying feedback for user %s",
+                log_prefix,
+                user_id,
+                target_user_id,
+            )
+        else:
+            raise HTTPException(
+                status_code=status.HTTP_403_FORBIDDEN,
+                detail="You do not have permission to query other users' feedback.",
+            )
+    elif can_query_all:
+        target_user_id = "*"
+        log.info("%sAdmin user %s is querying feedback for all users.", log_prefix, user_id)
+
+    # Verify task ownership if task_id filter is provided
+    if task_id:
+        task = task_repo.find_by_id(db, task_id)
+        if not task:
+            raise HTTPException(
+                status_code=status.HTTP_404_NOT_FOUND,
+                detail=f"Task with ID '{task_id}' not found.",
+            )
+        if task.user_id != user_id and not can_query_all:
+            raise HTTPException(
+                status_code=status.HTTP_403_FORBIDDEN,
+                detail="You do not have permission to view feedback for this task.",
+            )
+
+    # Parse date filters
+    start_time_ms = None
+    if start_date:
+        try:
+            start_time_ms = int(datetime.fromisoformat(start_date).timestamp() * 1000)
+        except ValueError:
+            raise HTTPException(
+                status_code=status.HTTP_400_BAD_REQUEST,
+                detail="Invalid start_date format. Use ISO 8601 format.",
+            )
+
+    end_time_ms = None
+    if end_date:
+        try:
+            end_time_ms = int(datetime.fromisoformat(end_date).timestamp() * 1000)
+        except ValueError:
+            raise HTTPException(
+                status_code=status.HTTP_400_BAD_REQUEST,
+                detail="Invalid end_date format. Use ISO 8601 format.",
+            )
+
+    pagination = PaginationParams(page_number=page, page_size=page_size)
+
+    try:
+        repo = FeedbackRepository()
+        feedback_list = repo.search(
+            db,
+            user_id=target_user_id,
+            start_date=start_time_ms,
+            end_date=end_time_ms,
+            task_id=task_id,
+            session_id=session_id,
+            rating=rating,
+            pagination=pagination,
+        )
+        log.info("%sReturning %d feedback entries", log_prefix, len(feedback_list))
+        return feedback_list
+    except Exception as e:
+        log.exception("%sError searching for feedback: %s", log_prefix, e)
+        raise HTTPException(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
+            detail="An error occurred while searching for feedback.",
+        )
+
+
 @router.post("/feedback", status_code=202, tags=["Feedback"])
 async def submit_feedback(
     payload: FeedbackPayload,

solace_agent_mesh/gateway/http_sse/routers/people.py

@@ -9,8 +9,8 @@ from fastapi import APIRouter, Depends, Query
 
 from ..dependencies import get_people_service
 from ..services.people_service import PeopleService
-from ..shared.pagination import DataResponse
-from ..shared.response_utils import create_data_response
+from solace_agent_mesh.shared.api.pagination import DataResponse
+from solace_agent_mesh.shared.api.response_utils import create_data_response
 
 log = logging.getLogger(__name__)