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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shiftaiagenticinfra-sdk-python
-Version: 0.0.7
+Version: 0.0.9
 Summary: Shiftai Agentic Infra Python SDK
 Author: ShiftAI
 Author-email: ShiftAI <s.tadakamalla@theshiftai.in>
@@ -311,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)`
@@ -381,7 +389,7 @@ Get all feedback submissions for a specific BOT message (most recent first).
 **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`
 
@@ -402,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)
@@ -450,6 +458,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.7 → shiftaiagenticinfra_sdk_python-0.0.9}/README.md

@@ -282,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)`
@@ -352,7 +360,7 @@ Get all feedback submissions for a specific BOT message (most recent first).
 **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`
 
@@ -373,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)
@@ -421,6 +429,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.7 → shiftaiagenticinfra_sdk_python-0.0.9}/pyproject.toml

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

{shiftaiagenticinfra_sdk_python-0.0.7 → shiftaiagenticinfra_sdk_python-0.0.9}/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.7 → shiftaiagenticinfra_sdk_python-0.0.9}/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.7 → shiftaiagenticinfra_sdk_python-0.0.9}/shiftai/models/__init__.py

@@ -182,6 +182,12 @@ class FeedbackDTO:
     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)
 class PlatformMessage:
     """Platform message model - matches backend JPA entity."""
@@ -254,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
@@ -289,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
@@ -303,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
 
@@ -320,6 +335,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.7 → shiftaiagenticinfra_sdk_python-0.0.9}/shiftaiagenticinfra_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shiftaiagenticinfra-sdk-python
-Version: 0.0.7
+Version: 0.0.9
 Summary: Shiftai Agentic Infra Python SDK
 Author: ShiftAI
 Author-email: ShiftAI <s.tadakamalla@theshiftai.in>
@@ -311,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)`
@@ -381,7 +389,7 @@ Get all feedback submissions for a specific BOT message (most recent first).
 **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`
 
@@ -402,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)
@@ -450,6 +458,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: