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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shiftaiagenticinfra-sdk-python
-Version: 0.0.9
+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).
 

{shiftaiagenticinfra_sdk_python-0.0.9 → 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).
 

{shiftaiagenticinfra_sdk_python-0.0.9 → 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.9"
+version = "0.0.10"
 description = "Shiftai Agentic Infra Python SDK"
 readme = "README.md"
 requires-python = ">=3.8"

{shiftaiagenticinfra_sdk_python-0.0.9 → 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.9 → 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)."""

{shiftaiagenticinfra_sdk_python-0.0.9 → 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.9
+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).