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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shiftaiagenticinfra-sdk-python
-Version: 0.0.6
+Version: 0.0.8
 Summary: Shiftai Agentic Infra Python SDK
 Author: ShiftAI
 Author-email: ShiftAI <s.tadakamalla@theshiftai.in>
@@ -46,6 +46,12 @@ This SDK is the official gateway to the Shift AI Agentic Infra services, enablin
   <a href="https://x.com/shift_ai_first">
     <img src="https://img.shields.io/badge/X(Twitter)-@shift__ai__first-black?style=for-the-badge&logo=x">
   </a>
+  <a href="https://www.reddit.com/user/TheShiftAI/">
+    <img src="https://img.shields.io/badge/Reddit-TheShiftAI-FF4500?style=for-the-badge&logo=reddit">
+  </a>
+  <a href="https://substack.com/@shiftaifirst">
+    <img src="https://img.shields.io/badge/Substack-ShiftAI-orange?style=for-the-badge&logo=substack">
+  </a>
 </p>
 
 **ShiftAI** is an AI infrastructure and consulting company focused on building
@@ -63,6 +69,9 @@ AI-driven systems that move beyond experimentation into real-world production.
 - 🐙 GitHub Organization: https://github.com/shiftaitop  
 - 💼 LinkedIn (Company): https://www.linkedin.com/company/theshiftai-in/  
 - 🐦 Twitter (X): https://x.com/shift_ai_first  
+- 🔗 Reddit: https://www.reddit.com/user/TheShiftAI/  
+- ✍️ Substack: https://substack.com/@shiftaifirst  
+  
 
 ### Founder
 - **Suresh Gokarakonda**
@@ -302,6 +311,14 @@ Get all messages sent by a specific agent.
 
 **Return Type:** `List[PlatformMessage]`
 
+#### `await messages.delete_message(message_id)`
+delete a message turn (bot message and its paired human message). Idempotent if already deleted.
+
+**Parameters:**
+- `message_id` (UUID, required): UUID of the **BOT** message to soft-delete
+
+**Return Type:** `Dict[str, Any]` (success: `success`, `message`, `timestamp`; errors: `error`, `message`, `status`, `timestamp`)
+
 ### Users API
 
 #### `await users.create(username, email, metadata=None)`
@@ -350,20 +367,29 @@ print(f"Created agent: {agent.name}")
 
 ### Analytics API
 
-#### `await analytics.submit_feedback(message_id, like=None, dislike=None, feedback=None, regeneration=None)`
-Submit user feedback on a bot message.
+#### `await analytics.submit_feedback(message_id, feedback_title, feedback, liked=None, disliked=None, regeneration=None)`
+Submit user feedback on a BOT message (multiple feedback per message allowed).
 
 **Parameters:**
-- `message_id` (UUID, **required**): ID of the bot message receiving feedback
-- `like` (bool, **optional**): User liked the response (true/false)
-- `dislike` (bool, **optional**): User disliked the response (true/false)
-- `feedback` (str, **optional**): Text feedback or comments (e.g., "Too verbose", "Perfect answer")
+- `message_id` (UUID, **required**): ID of the BOT message receiving feedback
+- `feedback_title` (str, **required**): Title for the feedback (e.g., "Response Quality Feedback")
+- `feedback` (str, **required**): Feedback content (e.g., "The response was very helpful")
+- `liked` (bool, **optional**): User liked the response (true/false)
+- `disliked` (bool, **optional**): User disliked the response (true/false)
 - `regeneration` (bool, **optional**): User requested regeneration (true/false)
 
-**Return Type:** `FeedbackSubmissionResponse`
+**Return Type:** `FeedbackSubmissionResponse` (includes `feedbackId`, `submittedAt`)
+
+#### `await analytics.get_message_feedback(message_id)`
+Get all feedback submissions for a specific BOT message (most recent first).
+
+**Parameters:**
+- `message_id` (UUID, **required**): UUID of the BOT message
+
+**Return Type:** `List[FeedbackDTO]`
 
 #### `await analytics.get_dashboard()`
-Get project dashboard metrics.
+Get project dashboard metrics (includes cache analytics: `cacheServed`, `estimatedTokensSaved`, `estimatedCostSaved` when available).
 
 **Return Type:** `DashboardMetricsDTO`
 
@@ -384,12 +410,12 @@ Get most active users.
 **Return Type:** `List[TopUserDTO]`
 
 #### `await analytics.get_user_analytics()`
-Get analytics for all users.
+Get analytics for all users (per-user cache metrics: `cacheServed`, `estimatedTokensSaved`, `estimatedCostSaved` when available).
 
 **Return Type:** `List[UserAnalyticsDTO]`
 
 #### `await analytics.get_project_data(top_limit=10)`
-Get project-level analytics data.
+Get project-level analytics data (includes `cacheServed`, `estimatedTokensSaved`, `estimatedCostSaved` when available).
 
 **Parameters:**
 - `top_limit` (int, **optional**): Limit for top results (default: 10, max: 100)

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

@@ -17,6 +17,12 @@ This SDK is the official gateway to the Shift AI Agentic Infra services, enablin
   <a href="https://x.com/shift_ai_first">
     <img src="https://img.shields.io/badge/X(Twitter)-@shift__ai__first-black?style=for-the-badge&logo=x">
   </a>
+  <a href="https://www.reddit.com/user/TheShiftAI/">
+    <img src="https://img.shields.io/badge/Reddit-TheShiftAI-FF4500?style=for-the-badge&logo=reddit">
+  </a>
+  <a href="https://substack.com/@shiftaifirst">
+    <img src="https://img.shields.io/badge/Substack-ShiftAI-orange?style=for-the-badge&logo=substack">
+  </a>
 </p>
 
 **ShiftAI** is an AI infrastructure and consulting company focused on building
@@ -34,6 +40,9 @@ AI-driven systems that move beyond experimentation into real-world production.
 - 🐙 GitHub Organization: https://github.com/shiftaitop  
 - 💼 LinkedIn (Company): https://www.linkedin.com/company/theshiftai-in/  
 - 🐦 Twitter (X): https://x.com/shift_ai_first  
+- 🔗 Reddit: https://www.reddit.com/user/TheShiftAI/  
+- ✍️ Substack: https://substack.com/@shiftaifirst  
+  
 
 ### Founder
 - **Suresh Gokarakonda**
@@ -273,6 +282,14 @@ Get all messages sent by a specific agent.
 
 **Return Type:** `List[PlatformMessage]`
 
+#### `await messages.delete_message(message_id)`
+delete a message turn (bot message and its paired human message). Idempotent if already deleted.
+
+**Parameters:**
+- `message_id` (UUID, required): UUID of the **BOT** message to soft-delete
+
+**Return Type:** `Dict[str, Any]` (success: `success`, `message`, `timestamp`; errors: `error`, `message`, `status`, `timestamp`)
+
 ### Users API
 
 #### `await users.create(username, email, metadata=None)`
@@ -321,20 +338,29 @@ print(f"Created agent: {agent.name}")
 
 ### Analytics API
 
-#### `await analytics.submit_feedback(message_id, like=None, dislike=None, feedback=None, regeneration=None)`
-Submit user feedback on a bot message.
+#### `await analytics.submit_feedback(message_id, feedback_title, feedback, liked=None, disliked=None, regeneration=None)`
+Submit user feedback on a BOT message (multiple feedback per message allowed).
 
 **Parameters:**
-- `message_id` (UUID, **required**): ID of the bot message receiving feedback
-- `like` (bool, **optional**): User liked the response (true/false)
-- `dislike` (bool, **optional**): User disliked the response (true/false)
-- `feedback` (str, **optional**): Text feedback or comments (e.g., "Too verbose", "Perfect answer")
+- `message_id` (UUID, **required**): ID of the BOT message receiving feedback
+- `feedback_title` (str, **required**): Title for the feedback (e.g., "Response Quality Feedback")
+- `feedback` (str, **required**): Feedback content (e.g., "The response was very helpful")
+- `liked` (bool, **optional**): User liked the response (true/false)
+- `disliked` (bool, **optional**): User disliked the response (true/false)
 - `regeneration` (bool, **optional**): User requested regeneration (true/false)
 
-**Return Type:** `FeedbackSubmissionResponse`
+**Return Type:** `FeedbackSubmissionResponse` (includes `feedbackId`, `submittedAt`)
+
+#### `await analytics.get_message_feedback(message_id)`
+Get all feedback submissions for a specific BOT message (most recent first).
+
+**Parameters:**
+- `message_id` (UUID, **required**): UUID of the BOT message
+
+**Return Type:** `List[FeedbackDTO]`
 
 #### `await analytics.get_dashboard()`
-Get project dashboard metrics.
+Get project dashboard metrics (includes cache analytics: `cacheServed`, `estimatedTokensSaved`, `estimatedCostSaved` when available).
 
 **Return Type:** `DashboardMetricsDTO`
 
@@ -355,12 +381,12 @@ Get most active users.
 **Return Type:** `List[TopUserDTO]`
 
 #### `await analytics.get_user_analytics()`
-Get analytics for all users.
+Get analytics for all users (per-user cache metrics: `cacheServed`, `estimatedTokensSaved`, `estimatedCostSaved` when available).
 
 **Return Type:** `List[UserAnalyticsDTO]`
 
 #### `await analytics.get_project_data(top_limit=10)`
-Get project-level analytics data.
+Get project-level analytics data (includes `cacheServed`, `estimatedTokensSaved`, `estimatedCostSaved` when available).
 
 **Parameters:**
 - `top_limit` (int, **optional**): Limit for top results (default: 10, max: 100)

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

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

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

@@ -9,6 +9,7 @@ from ..http import HttpClient
 from ..models import (
     FeedbackSubmissionRequest,
     FeedbackSubmissionResponse,
+    FeedbackDTO,
     DashboardMetricsDTO,
     TopAgentDTO,
     TopUserDTO,
@@ -26,49 +27,82 @@ class AnalyticsApi:
     async def submit_feedback(
         self,
         message_id: UUID,
-        like: Optional[bool] = None,
-        dislike: Optional[bool] = None,
-        feedback: Optional[str] = None,
+        feedback_title: str,
+        feedback: str,
+        liked: Optional[bool] = None,
+        disliked: Optional[bool] = None,
         regeneration: Optional[bool] = None,
     ) -> FeedbackSubmissionResponse:
         """
-        Submit feedback for a BOT message.
-        
+        Submit feedback for a BOT message (multiple feedback per message allowed).
+
         POST /api/analytics/data
-        
+
         Args:
             message_id: The ID of the BOT message that received feedback (required)
-            like: Like feedback indicator (optional)
-            dislike: Dislike feedback indicator (optional)
-            feedback: Optional text feedback or comments (optional)
-            regeneration: Indicates if user requested to regenerate (optional)
-            
+            feedback_title: Title for the feedback (required)
+            feedback: Feedback content (required)
+            liked: Like rating (optional)
+            disliked: Dislike rating (optional)
+            regeneration: User requested regeneration (optional)
+
         Returns:
-            FeedbackSubmissionResponse
-            
+            FeedbackSubmissionResponse with feedbackId and submittedAt
+
         Raises:
-            ValueError: If message_id is missing or API key is not configured
+            ValueError: If message_id, feedback_title or feedback is missing
             ApiException: If the API request fails
         """
         self._http_client.ensure_authenticated()
 
         if message_id is None:
             raise ValueError("message_id is required")
-        
+        if not feedback_title or not feedback_title.strip():
+            raise ValueError("feedback_title is required")
+        if not feedback or not feedback.strip():
+            raise ValueError("feedback is required")
+
         request = FeedbackSubmissionRequest(
             messageId=message_id,
-            like=like,
-            dislike=dislike,
-            feedback=feedback,
-            regeneration=regeneration
+            feedbackTitle=feedback_title.strip(),
+            feedback=feedback.strip(),
+            liked=liked,
+            disliked=disliked,
+            regeneration=regeneration,
         )
-        
+
         return await self._http_client.post(
             "/api/analytics/data",
             request,
-            FeedbackSubmissionResponse
+            FeedbackSubmissionResponse,
         )
-    
+
+    async def get_message_feedback(self, message_id: UUID) -> List[FeedbackDTO]:
+        """
+        Get all feedback submissions for a specific BOT message (most recent first).
+
+        GET /api/analytics/messages/{messageId}/feedback
+
+        Args:
+            message_id: UUID of the BOT message (required)
+
+        Returns:
+            List of FeedbackDTO, ordered by submittedAt descending
+
+        Raises:
+            ValueError: If message_id is missing
+            ApiException: If the API request fails
+        """
+        self._http_client.ensure_authenticated()
+
+        if message_id is None:
+            raise ValueError("message_id is required")
+
+        return await self._http_client.get_list(
+            f"/api/analytics/messages/{message_id}/feedback",
+            FeedbackDTO,
+        )
+
     async def get_dashboard(self) -> DashboardMetricsDTO:
         """
         Get dashboard metrics.

{shiftaiagenticinfra_sdk_python-0.0.6 → shiftaiagenticinfra_sdk_python-0.0.8}/shiftai/api/messages_api.py

@@ -11,6 +11,7 @@ from ..models import (
     PlatformMessageSubmissionResponse,
     PlatformMessage,
     AgentData,
+    DeleteMessageRequest,
 )
 
 
@@ -291,3 +292,23 @@ class MessagesApi:
             PlatformMessage
         )
 
+    async def delete_message(self, message_id: UUID) -> Dict[str, Any]:
+        """
+        Soft-delete a message turn (bot message and its paired human message).
+
+        POST /api/platform/messages/delete
+
+        Idempotent if the message is already deleted. Returns a map with
+        success, message, timestamp (or error fields on failure).
+
+        Args:
+            message_id: UUID of the BOT message to soft-delete (required)
+
+        Returns:
+            Dict with success, message, timestamp (or error, message, status, timestamp on error)
+        """
+        self._http_client.ensure_authenticated()
+        if message_id is None:
+            raise ValueError("message_id is required")
+        request = DeleteMessageRequest(messageId=message_id)
+        return await self._http_client.post_map("/api/platform/messages/delete", request)

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

@@ -152,20 +152,40 @@ class Agent:
 
 @dataclass
 class FeedbackSubmissionRequest:
-    """Request for submitting feedback."""
-    messageId: UUID
-    like: Optional[bool] = None
-    dislike: Optional[bool] = None
-    feedback: Optional[str] = None
-    regeneration: Optional[bool] = None
+    """Request for submitting feedback (multiple feedback per BOT message)."""
+    messageId: UUID  # required - BOT message ID
+    feedbackTitle: str  # required - Feedback title
+    feedback: str  # required - Feedback content
+    liked: Optional[bool] = None  # optional - Like rating (renamed from like)
+    disliked: Optional[bool] = None  # optional - Dislike rating (renamed from dislike)
+    regeneration: Optional[bool] = None  # optional - Regeneration request
 
 
 @dataclass
 class FeedbackSubmissionResponse:
     """Response from feedback submission."""
     success: Optional[bool] = None
+    feedbackId: Optional[UUID] = None  # Feedback entry ID (was botMessageId)
     message: Optional[str] = None
-    botMessageId: Optional[UUID] = None
+    submittedAt: Optional[str] = None  # ISO 8601 datetime string
+
+
+@dataclass
+class FeedbackDTO:
+    """Single feedback entry for a BOT message (GET feedback list)."""
+    id: Optional[UUID] = None  # Feedback entry ID
+    feedbackTitle: Optional[str] = None
+    feedback: Optional[str] = None
+    liked: Optional[bool] = None
+    disliked: Optional[bool] = None
+    regeneration: Optional[bool] = None
+    submittedAt: Optional[str] = None  # ISO 8601 datetime string
+
+
+@dataclass
+class DeleteMessageRequest:
+    """Request for soft-deleting a message turn (bot message and its paired human)."""
+    messageId: UUID  # required – bot message ID
 
 
 @dataclass(init=False)
@@ -240,6 +260,9 @@ class DashboardMetricsDTO:
     likes: Optional[int] = None
     dislikes: Optional[int] = None
     regenerates: Optional[int] = None
+    cacheServed: Optional[int] = None
+    estimatedTokensSaved: Optional[int] = None
+    estimatedCostSaved: Optional[float] = None
 
 
 @dataclass
@@ -275,6 +298,9 @@ class UserAnalyticsDTO:
     likes: Optional[int] = None
     dislikes: Optional[int] = None
     regenerates: Optional[int] = None
+    cacheServed: Optional[int] = None
+    estimatedTokensSaved: Optional[int] = None
+    estimatedCostSaved: Optional[float] = None
 
 
 @dataclass
@@ -289,6 +315,9 @@ class ProjectAnalyticsResponseDTO:
     likes: Optional[int] = None
     dislikes: Optional[int] = None
     regenerates: Optional[int] = None
+    cacheServed: Optional[int] = None
+    estimatedTokensSaved: Optional[int] = None
+    estimatedCostSaved: Optional[float] = None
     topUserActivity: Optional[List[Any]] = None
     topDevicesByUsage: Optional[List[Any]] = None
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shiftaiagenticinfra-sdk-python
-Version: 0.0.6
+Version: 0.0.8
 Summary: Shiftai Agentic Infra Python SDK
 Author: ShiftAI
 Author-email: ShiftAI <s.tadakamalla@theshiftai.in>
@@ -46,6 +46,12 @@ This SDK is the official gateway to the Shift AI Agentic Infra services, enablin
   <a href="https://x.com/shift_ai_first">
     <img src="https://img.shields.io/badge/X(Twitter)-@shift__ai__first-black?style=for-the-badge&logo=x">
   </a>
+  <a href="https://www.reddit.com/user/TheShiftAI/">
+    <img src="https://img.shields.io/badge/Reddit-TheShiftAI-FF4500?style=for-the-badge&logo=reddit">
+  </a>
+  <a href="https://substack.com/@shiftaifirst">
+    <img src="https://img.shields.io/badge/Substack-ShiftAI-orange?style=for-the-badge&logo=substack">
+  </a>
 </p>
 
 **ShiftAI** is an AI infrastructure and consulting company focused on building
@@ -63,6 +69,9 @@ AI-driven systems that move beyond experimentation into real-world production.
 - 🐙 GitHub Organization: https://github.com/shiftaitop  
 - 💼 LinkedIn (Company): https://www.linkedin.com/company/theshiftai-in/  
 - 🐦 Twitter (X): https://x.com/shift_ai_first  
+- 🔗 Reddit: https://www.reddit.com/user/TheShiftAI/  
+- ✍️ Substack: https://substack.com/@shiftaifirst  
+  
 
 ### Founder
 - **Suresh Gokarakonda**
@@ -302,6 +311,14 @@ Get all messages sent by a specific agent.
 
 **Return Type:** `List[PlatformMessage]`
 
+#### `await messages.delete_message(message_id)`
+delete a message turn (bot message and its paired human message). Idempotent if already deleted.
+
+**Parameters:**
+- `message_id` (UUID, required): UUID of the **BOT** message to soft-delete
+
+**Return Type:** `Dict[str, Any]` (success: `success`, `message`, `timestamp`; errors: `error`, `message`, `status`, `timestamp`)
+
 ### Users API
 
 #### `await users.create(username, email, metadata=None)`
@@ -350,20 +367,29 @@ print(f"Created agent: {agent.name}")
 
 ### Analytics API
 
-#### `await analytics.submit_feedback(message_id, like=None, dislike=None, feedback=None, regeneration=None)`
-Submit user feedback on a bot message.
+#### `await analytics.submit_feedback(message_id, feedback_title, feedback, liked=None, disliked=None, regeneration=None)`
+Submit user feedback on a BOT message (multiple feedback per message allowed).
 
 **Parameters:**
-- `message_id` (UUID, **required**): ID of the bot message receiving feedback
-- `like` (bool, **optional**): User liked the response (true/false)
-- `dislike` (bool, **optional**): User disliked the response (true/false)
-- `feedback` (str, **optional**): Text feedback or comments (e.g., "Too verbose", "Perfect answer")
+- `message_id` (UUID, **required**): ID of the BOT message receiving feedback
+- `feedback_title` (str, **required**): Title for the feedback (e.g., "Response Quality Feedback")
+- `feedback` (str, **required**): Feedback content (e.g., "The response was very helpful")
+- `liked` (bool, **optional**): User liked the response (true/false)
+- `disliked` (bool, **optional**): User disliked the response (true/false)
 - `regeneration` (bool, **optional**): User requested regeneration (true/false)
 
-**Return Type:** `FeedbackSubmissionResponse`
+**Return Type:** `FeedbackSubmissionResponse` (includes `feedbackId`, `submittedAt`)
+
+#### `await analytics.get_message_feedback(message_id)`
+Get all feedback submissions for a specific BOT message (most recent first).
+
+**Parameters:**
+- `message_id` (UUID, **required**): UUID of the BOT message
+
+**Return Type:** `List[FeedbackDTO]`
 
 #### `await analytics.get_dashboard()`
-Get project dashboard metrics.
+Get project dashboard metrics (includes cache analytics: `cacheServed`, `estimatedTokensSaved`, `estimatedCostSaved` when available).
 
 **Return Type:** `DashboardMetricsDTO`
 
@@ -384,12 +410,12 @@ Get most active users.
 **Return Type:** `List[TopUserDTO]`
 
 #### `await analytics.get_user_analytics()`
-Get analytics for all users.
+Get analytics for all users (per-user cache metrics: `cacheServed`, `estimatedTokensSaved`, `estimatedCostSaved` when available).
 
 **Return Type:** `List[UserAnalyticsDTO]`
 
 #### `await analytics.get_project_data(top_limit=10)`
-Get project-level analytics data.
+Get project-level analytics data (includes `cacheServed`, `estimatedTokensSaved`, `estimatedCostSaved` when available).
 
 **Parameters:**
 - `top_limit` (int, **optional**): Limit for top results (default: 10, max: 100)

{shiftaiagenticinfra_sdk_python-0.0.6 → shiftaiagenticinfra_sdk_python-0.0.8}/tests/test_integration.py

@@ -156,12 +156,14 @@ async def test_complete_sdk_flow():
         print("Step 7: Submitting feedback...")
         feedback_response = await client.analytics.submit_feedback(
             message_id=bot_message_id,
-            like=True,
-            feedback="Great response, very helpful!"
+            feedback_title="Response Quality Feedback",
+            feedback="Great response, very helpful!",
+            liked=True,
         )
         
         assert feedback_response is not None, "Feedback response should not be null"
         assert feedback_response.success is True, "Feedback submission should be successful"
+        assert feedback_response.feedbackId is not None, "Feedback ID should be returned"
         print("✓ Feedback submitted\n")
         
         # Step 8: Get dashboard metrics