shiftaiagenticinfra-sdk-python 0.0.8__tar.gz → 0.0.10__tar.gz

{shiftaiagenticinfra_sdk_python-0.0.8 → shiftaiagenticinfra_sdk_python-0.0.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shiftaiagenticinfra-sdk-python
-Version: 0.0.8
+Version: 0.0.10
 Summary: Shiftai Agentic Infra Python SDK
 Author: ShiftAI
 Author-email: ShiftAI <s.tadakamalla@theshiftai.in>
@@ -388,6 +388,14 @@ Get all feedback submissions for a specific BOT message (most recent first).
 
 **Return Type:** `List[FeedbackDTO]`
 
+#### `await analytics.get_latest_feedbacks(timeperiod=None)`
+Get latest feedback submissions for the project, most recent first.
+
+**Parameters:**
+- `timeperiod` (int, **optional**): None or omitted = all feedbacks; N (e.g. 24) = only feedbacks from the last N hours
+
+**Return Type:** `LatestFeedbacksResponse` (`.feedbacks` list of `LatestFeedbackItemResponse`; optional `.message` when time window is used and there are no feedbacks)
+
 #### `await analytics.get_dashboard()`
 Get project dashboard metrics (includes cache analytics: `cacheServed`, `estimatedTokensSaved`, `estimatedCostSaved` when available).
 
@@ -458,6 +466,22 @@ Get all conversations for a specific user.
 
 **Return Type:** `List[ConversationSummaryResponse]`
 
+#### `await conversations.get_conversations_by_email(email)`
+Get all conversations for a specific user by email.
+
+**Parameters:**
+- `email` (str, required): User's email address
+
+**Return Type:** `List[ConversationSummaryResponse]`
+
+#### `await conversations.delete_conversation(conversation_id)`
+Delete a conversation.
+
+**Parameters:**
+- `conversation_id` (UUID, required): Conversation identifier
+
+**Return Type:** `Dict[str, Any]`
+
 ## Error Handling
 
 The SDK surfaces HTTP errors as typed exceptions:

{shiftaiagenticinfra_sdk_python-0.0.8 → shiftaiagenticinfra_sdk_python-0.0.10}/README.md

@@ -359,6 +359,14 @@ Get all feedback submissions for a specific BOT message (most recent first).
 
 **Return Type:** `List[FeedbackDTO]`
 
+#### `await analytics.get_latest_feedbacks(timeperiod=None)`
+Get latest feedback submissions for the project, most recent first.
+
+**Parameters:**
+- `timeperiod` (int, **optional**): None or omitted = all feedbacks; N (e.g. 24) = only feedbacks from the last N hours
+
+**Return Type:** `LatestFeedbacksResponse` (`.feedbacks` list of `LatestFeedbackItemResponse`; optional `.message` when time window is used and there are no feedbacks)
+
 #### `await analytics.get_dashboard()`
 Get project dashboard metrics (includes cache analytics: `cacheServed`, `estimatedTokensSaved`, `estimatedCostSaved` when available).
 
@@ -429,6 +437,22 @@ Get all conversations for a specific user.
 
 **Return Type:** `List[ConversationSummaryResponse]`
 
+#### `await conversations.get_conversations_by_email(email)`
+Get all conversations for a specific user by email.
+
+**Parameters:**
+- `email` (str, required): User's email address
+
+**Return Type:** `List[ConversationSummaryResponse]`
+
+#### `await conversations.delete_conversation(conversation_id)`
+Delete a conversation.
+
+**Parameters:**
+- `conversation_id` (UUID, required): Conversation identifier
+
+**Return Type:** `Dict[str, Any]`
+
 ## Error Handling
 
 The SDK surfaces HTTP errors as typed exceptions:

{shiftaiagenticinfra_sdk_python-0.0.8 → shiftaiagenticinfra_sdk_python-0.0.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "shiftaiagenticinfra-sdk-python"
-version = "0.0.8"
+version = "0.0.10"
 description = "Shiftai Agentic Infra Python SDK"
 readme = "README.md"
 requires-python = ">=3.8"

{shiftaiagenticinfra_sdk_python-0.0.8 → shiftaiagenticinfra_sdk_python-0.0.10}/shiftai/api/analytics_api.py

@@ -10,6 +10,9 @@ from ..models import (
     FeedbackSubmissionRequest,
     FeedbackSubmissionResponse,
     FeedbackDTO,
+    LatestFeedbacksRequest,
+    LatestFeedbackItemResponse,
+    LatestFeedbacksResponse,
     DashboardMetricsDTO,
     TopAgentDTO,
     TopUserDTO,
@@ -103,6 +106,48 @@ class AnalyticsApi:
             FeedbackDTO,
         )
 
+    async def get_latest_feedbacks(
+        self,
+        timeperiod: Optional[int] = None,
+    ) -> LatestFeedbacksResponse:
+        """
+        Get latest feedback submissions for the project, most recent first.
+
+        POST /api/platform/feedbacks/latest
+
+        Args:
+            timeperiod: Optional. None or omitted = all feedbacks.
+                        N (e.g. 24) = only feedbacks from the last N hours.
+
+        Returns:
+            LatestFeedbacksResponse with .feedbacks (list) and optional .message
+            (e.g. when timeperiod is set and there are no feedbacks in that window).
+        """
+        self._http_client.ensure_authenticated()
+
+        body: Dict[str, Any] = {} if timeperiod is None else {"timeperiod": timeperiod}
+        data = await self._http_client.post_map("/api/platform/feedbacks/latest", body)
+
+        if isinstance(data, list):
+            items = [
+                LatestFeedbackItemResponse(
+                    **self._http_client._filter_known_fields(item, LatestFeedbackItemResponse)
+                )
+                for item in data
+            ]
+            return LatestFeedbacksResponse(feedbacks=items)
+        if isinstance(data, dict):
+            msg = data.get("message")
+            raw_list = data.get("feedbacks", [])
+            items = [
+                LatestFeedbackItemResponse(
+                    **self._http_client._filter_known_fields(item, LatestFeedbackItemResponse)
+                )
+                for item in raw_list
+            ]
+            return LatestFeedbacksResponse(message=msg, feedbacks=items)
+        return LatestFeedbacksResponse(feedbacks=[])
+
     async def get_dashboard(self) -> DashboardMetricsDTO:
         """
         Get dashboard metrics.

{shiftaiagenticinfra_sdk_python-0.0.8 → shiftaiagenticinfra_sdk_python-0.0.10}/shiftai/api/conversations_api.py

@@ -1,12 +1,17 @@
 """
 API for platform conversation operations.
-Provides methods for retrieving conversation messages and listing conversations.
+Provides methods for retrieving and managing conversations.
 """
 
-from typing import List
+from typing import List, Dict, Any
 from uuid import UUID
 from ..http import HttpClient
-from ..models import ConversationMessageResponse, ConversationSummaryResponse
+from ..models import (
+    ConversationMessageResponse,
+    ConversationSummaryResponse,
+    GetConversationsByEmailRequest,
+    DeleteConversationRequest,
+)
 
 
 class ConversationsApi:
@@ -106,4 +111,65 @@ class ConversationsApi:
             request,
             ConversationSummaryResponse
         )
+    
+    async def get_conversations_by_email(
+        self,
+        email: str,
+    ) -> List[ConversationSummaryResponse]:
+        """
+        Get all conversations for a specific user by email within the authenticated project.
+
+        POST /api/platform/conversations/email
+
+        Args:
+            email: User's email address (required)
+
+        Returns:
+            List of conversation summaries for the user
+
+        Raises:
+            ValueError: If email is missing or API key is not configured
+            ApiException: If the API request fails
+        """
+        self._http_client.ensure_authenticated()
+
+        if not email or not email.strip():
+            raise ValueError("email is required")
+
+        request = GetConversationsByEmailRequest(email=email.strip())
+
+        return await self._http_client.post_list(
+            "/api/platform/conversations/email",
+            request,
+            ConversationSummaryResponse,
+        )
+
+    async def delete_conversation(
+        self,
+        conversation_id: UUID,
+    ) -> Dict[str, Any]:
+        """
+        Delete a conversation.
+
+        POST /api/platform/conversation/delete
+
+        Args:
+            conversation_id: UUID of the conversation to delete (required)
+
+        Returns:
+            Dict with:
+              - On success (200): success, message, timestamp
+              - On errors (4xx/5xx): error, message, status, timestamp
+        """
+        self._http_client.ensure_authenticated()
+
+        if conversation_id is None:
+            raise ValueError("conversation_id is required")
+
+        request = DeleteConversationRequest(conversationId=conversation_id)
+
+        return await self._http_client.post_map(
+            "/api/platform/conversation/delete",
+            request,
+        )
 

{shiftaiagenticinfra_sdk_python-0.0.8 → shiftaiagenticinfra_sdk_python-0.0.10}/shiftai/models/__init__.py

@@ -182,6 +182,34 @@ class FeedbackDTO:
     submittedAt: Optional[str] = None  # ISO 8601 datetime string
 
 
+@dataclass
+class LatestFeedbacksRequest:
+    """Request for latest feedbacks; optional time window in hours."""
+    timeperiod: Optional[int] = None  # None or omitted = all; N = last N hours
+
+
+@dataclass
+class LatestFeedbackItemResponse:
+    """Single item in the latest-feedbacks list (POST /api/platform/feedbacks/latest)."""
+    messageId: Optional[UUID] = None
+    username: Optional[str] = None
+    agentName: Optional[str] = None
+    conversationId: Optional[UUID] = None
+    sender: Optional[str] = None
+    message: Optional[str] = None  # Human query the bot was replying to
+    feedbackTitle: Optional[str] = None
+    feedback: Optional[str] = None
+    context: Optional[str] = None
+    time: Optional[str] = None  # ISO-8601 when feedback was submitted
+
+
+@dataclass
+class LatestFeedbacksResponse:
+    """Response from latest feedbacks: list of items and optional message (e.g. empty timeline)."""
+    message: Optional[str] = None  # Set when timeperiod used and no feedbacks in window
+    feedbacks: List[LatestFeedbackItemResponse] = field(default_factory=list)
+
+
 @dataclass
 class DeleteMessageRequest:
     """Request for soft-deleting a message turn (bot message and its paired human)."""
@@ -335,6 +363,18 @@ class ConversationSummaryResponse:
     conversationTitle: Optional[str] = None  # LLM-generated conversation title
 
 
+@dataclass
+class GetConversationsByEmailRequest:
+    """Request object for retrieving conversations by user email."""
+    email: str
+
+
+@dataclass
+class DeleteConversationRequest:
+    """Request object for deleting a conversation."""
+    conversationId: UUID
+
+
 @dataclass
 class ConversationMessageResponse:
     """Simplified message response for conversation messages.

{shiftaiagenticinfra_sdk_python-0.0.8 → shiftaiagenticinfra_sdk_python-0.0.10}/shiftaiagenticinfra_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shiftaiagenticinfra-sdk-python
-Version: 0.0.8
+Version: 0.0.10
 Summary: Shiftai Agentic Infra Python SDK
 Author: ShiftAI
 Author-email: ShiftAI <s.tadakamalla@theshiftai.in>
@@ -388,6 +388,14 @@ Get all feedback submissions for a specific BOT message (most recent first).
 
 **Return Type:** `List[FeedbackDTO]`
 
+#### `await analytics.get_latest_feedbacks(timeperiod=None)`
+Get latest feedback submissions for the project, most recent first.
+
+**Parameters:**
+- `timeperiod` (int, **optional**): None or omitted = all feedbacks; N (e.g. 24) = only feedbacks from the last N hours
+
+**Return Type:** `LatestFeedbacksResponse` (`.feedbacks` list of `LatestFeedbackItemResponse`; optional `.message` when time window is used and there are no feedbacks)
+
 #### `await analytics.get_dashboard()`
 Get project dashboard metrics (includes cache analytics: `cacheServed`, `estimatedTokensSaved`, `estimatedCostSaved` when available).
 
@@ -458,6 +466,22 @@ Get all conversations for a specific user.
 
 **Return Type:** `List[ConversationSummaryResponse]`
 
+#### `await conversations.get_conversations_by_email(email)`
+Get all conversations for a specific user by email.
+
+**Parameters:**
+- `email` (str, required): User's email address
+
+**Return Type:** `List[ConversationSummaryResponse]`
+
+#### `await conversations.delete_conversation(conversation_id)`
+Delete a conversation.
+
+**Parameters:**
+- `conversation_id` (UUID, required): Conversation identifier
+
+**Return Type:** `Dict[str, Any]`
+
 ## Error Handling
 
 The SDK surfaces HTTP errors as typed exceptions: