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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shiftaiagenticinfra-sdk-python
-Version: 0.0.5
+Version: 0.0.6
 Summary: Shiftai Agentic Infra Python SDK
 Author: ShiftAI
 Author-email: ShiftAI <s.tadakamalla@theshiftai.in>
@@ -154,6 +154,7 @@ async def main():
         message="Hello, how can I help you?",
         agent_name="SupportBot",
         agent_platform="OpenAI",
+        user_email="john@example.com",
         agent_version="1.0.0"  # Required: Agent version 
     )
 
@@ -167,7 +168,8 @@ async def main():
         agent_platform="OpenAI",
         agent_version="1.0.0",  # Required: Agent version 
         reply_message_id=human_response.messageId,
-        rag_context="Retrieved context from knowledge base..."
+        rag_context="Retrieved context from knowledge base...",
+        user_email="john@example.com"
     )
 
     # 4. Get analytics
@@ -223,6 +225,7 @@ Send a human message with automatic user/agent creation.
 - `agent_version` (str, **optional**): Agent version/model (e.g., "gpt-4", "claude-2") - **Required in database**
 - `agent_metadata` (dict, **optional**): Agent configuration data (e.g., `{"temperature": 0.7, "max_tokens": 1000}`)
 - `mode` (str, **optional**): Mode identifier for the message. Allowed values: `"SIMPLE"` or `"EXPAND"`
+- `conversation_id` (UUID, **optional**): Conversation ID to store the HUMAN message in. If omitted, backend creates a new conversation automatically.
 
 **Return Type:** `PlatformMessageSubmissionResponse`
 
@@ -248,6 +251,28 @@ Send a bot response to a human message.
 
 **Return Type:** `PlatformMessageSubmissionResponse`
 
+**Response Notes (Cache):**
+- `cacheHit` / `cacheResponse` may be present when the backend cache API was checked (typically for HUMAN messages).
+
+### Platform Session API
+
+#### `await platform_session.initiate_session(request=None)`
+Initiate a new conversation session.
+
+POST `/api/platformsession/initiate`
+
+**Return Type:** `Dict[str, Any]` (raw response body as returned by the server)
+
+#### `await platform_session.end_conversation(conversation_id)`
+End an active conversation session explicitly.
+
+POST `/api/platformsession/endconversation`
+
+**Parameters:**
+- `conversation_id` (UUID, **required**): Conversation identifier to end
+
+**Return Type:** `EndConversationResponse`
+
 #### `await messages.submit(request)`
 Low-level message submission with full control.
 

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

@@ -125,6 +125,7 @@ async def main():
         message="Hello, how can I help you?",
         agent_name="SupportBot",
         agent_platform="OpenAI",
+        user_email="john@example.com",
         agent_version="1.0.0"  # Required: Agent version 
     )
 
@@ -138,7 +139,8 @@ async def main():
         agent_platform="OpenAI",
         agent_version="1.0.0",  # Required: Agent version 
         reply_message_id=human_response.messageId,
-        rag_context="Retrieved context from knowledge base..."
+        rag_context="Retrieved context from knowledge base...",
+        user_email="john@example.com"
     )
 
     # 4. Get analytics
@@ -194,6 +196,7 @@ Send a human message with automatic user/agent creation.
 - `agent_version` (str, **optional**): Agent version/model (e.g., "gpt-4", "claude-2") - **Required in database**
 - `agent_metadata` (dict, **optional**): Agent configuration data (e.g., `{"temperature": 0.7, "max_tokens": 1000}`)
 - `mode` (str, **optional**): Mode identifier for the message. Allowed values: `"SIMPLE"` or `"EXPAND"`
+- `conversation_id` (UUID, **optional**): Conversation ID to store the HUMAN message in. If omitted, backend creates a new conversation automatically.
 
 **Return Type:** `PlatformMessageSubmissionResponse`
 
@@ -219,6 +222,28 @@ Send a bot response to a human message.
 
 **Return Type:** `PlatformMessageSubmissionResponse`
 
+**Response Notes (Cache):**
+- `cacheHit` / `cacheResponse` may be present when the backend cache API was checked (typically for HUMAN messages).
+
+### Platform Session API
+
+#### `await platform_session.initiate_session(request=None)`
+Initiate a new conversation session.
+
+POST `/api/platformsession/initiate`
+
+**Return Type:** `Dict[str, Any]` (raw response body as returned by the server)
+
+#### `await platform_session.end_conversation(conversation_id)`
+End an active conversation session explicitly.
+
+POST `/api/platformsession/endconversation`
+
+**Parameters:**
+- `conversation_id` (UUID, **required**): Conversation identifier to end
+
+**Return Type:** `EndConversationResponse`
+
 #### `await messages.submit(request)`
 Low-level message submission with full control.
 

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

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

{shiftaiagenticinfra_sdk_python-0.0.5 → shiftaiagenticinfra_sdk_python-0.0.6}/setup.py

@@ -13,7 +13,7 @@ def read_readme():
 
 setup(
     name="shiftaiagenticinfra-sdk-python",
-    version="0.0.1",
+    version="0.0.6",
     description="Shiftai Agentic Infra Python SDK",
     long_description=read_readme(),
     long_description_content_type="text/markdown",

{shiftaiagenticinfra_sdk_python-0.0.5 → shiftaiagenticinfra_sdk_python-0.0.6}/shiftai/__init__.py

@@ -6,6 +6,6 @@ A Python client library for the Shiftai Agentic Infra REST API.
 
 from .client import ShiftaiagenticinfraClient
 
-__version__ = "0.0.1"
+__version__ = "0.0.6"
 __all__ = ["ShiftaiagenticinfraClient"]
 

{shiftaiagenticinfra_sdk_python-0.0.5 → shiftaiagenticinfra_sdk_python-0.0.6}/shiftai/api/__init__.py

@@ -6,6 +6,7 @@ from .users_api import UsersApi
 from .agents_api import AgentsApi
 from .analytics_api import AnalyticsApi
 from .conversations_api import ConversationsApi
+from .platform_session_api import PlatformSessionApi
 
 __all__ = [
     "PlatformApi",
@@ -14,5 +15,6 @@ __all__ = [
     "AgentsApi",
     "AnalyticsApi",
     "ConversationsApi",
+    "PlatformSessionApi",
 ]
 

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

@@ -35,6 +35,7 @@ class MessagesApi:
         agent_version: Optional[str] = None,
         agent_metadata: Optional[Dict[str, Any]] = None,
         mode: Optional[str] = None,
+        conversation_id: Optional[UUID] = None,
     ) -> PlatformMessageSubmissionResponse:
         """
         Send a human message.
@@ -56,6 +57,7 @@ class MessagesApi:
             agent_version: Optional agent version or model identifier
             agent_metadata: Optional additional agent configuration metadata
             mode: Optional mode identifier for the message
+            conversation_id: Optional conversation ID for HUMAN messages. If not provided, backend creates a new conversation.
             
         Returns:
             PlatformMessageSubmissionResponse with message ID and contextual prompt
@@ -101,6 +103,7 @@ class MessagesApi:
             agentData=agent_data,
             senderType="HUMAN",  # Auto-set
             messageType="TEXT",  # Auto-set
+            conversationId=conversation_id,
             mode=mode
         )
         

shiftaiagenticinfra_sdk_python-0.0.6/shiftai/api/platform_session_api.py

@@ -0,0 +1,66 @@
+"""
+API for platform session (conversation session) operations.
+
+Provides methods for initiating new conversation sessions and explicitly ending them.
+"""
+
+from typing import Any, Dict, Optional
+from uuid import UUID
+
+from ..http import HttpClient
+from ..models import EndConversationRequest, EndConversationResponse
+
+
+class PlatformSessionApi:
+    """API for platform session operations."""
+
+    def __init__(self, http_client: HttpClient):
+        self._http_client = http_client
+
+    async def initiate_session(
+        self,
+        request: Optional[Dict[str, Any]] = None,
+    ) -> Dict[str, Any]:
+        """
+        Initiate a new conversation session.
+
+        POST /api/platformsession/initiate
+
+        Notes:
+            - Requires API key authentication.
+            - This SDK method returns the response body "as-is" (raw map) because
+              the exact response DTO may evolve server-side.
+
+        Args:
+            request: Optional raw request body to pass through (dict). If omitted, sends an empty body.
+
+        Returns:
+            Dict[str, Any]: Raw response map returned by the endpoint.
+        """
+        self._http_client.ensure_authenticated()
+        return await self._http_client.post_map("/api/platformsession/initiate", request or {})
+
+    async def end_conversation(self, conversation_id: UUID) -> EndConversationResponse:
+        """
+        End an active conversation session.
+
+        POST /api/platformsession/endconversation
+
+        Args:
+            conversation_id: UUID of the conversation to end (required)
+
+        Returns:
+            EndConversationResponse containing success, message and timestamps.
+        """
+        self._http_client.ensure_authenticated()
+
+        if conversation_id is None:
+            raise ValueError("conversation_id is required")
+
+        request = EndConversationRequest(conversationId=conversation_id)
+        return await self._http_client.post(
+            "/api/platformsession/endconversation",
+            request,
+            EndConversationResponse,
+        )
+

{shiftaiagenticinfra_sdk_python-0.0.5 → shiftaiagenticinfra_sdk_python-0.0.6}/shiftai/client.py

@@ -12,6 +12,7 @@ from .api import (
     AgentsApi,
     AnalyticsApi,
     ConversationsApi,
+    PlatformSessionApi,
 )
 from .api.internal.trulens_api import EvalApi
 
@@ -68,6 +69,7 @@ class ShiftaiagenticinfraClient:
         self.agents = AgentsApi(self._http_client)
         self.analytics = AnalyticsApi(self._http_client)
         self.conversations = ConversationsApi(self._http_client)
+        self.platform_session = PlatformSessionApi(self._http_client)
         self.internal = InternalApi(self._http_client)
 
     def _ensure_api_key(self) -> None:

{shiftaiagenticinfra_sdk_python-0.0.5 → shiftaiagenticinfra_sdk_python-0.0.6}/shiftai/http/http_client.py

@@ -239,7 +239,9 @@ class HttpClient:
             
             # Convert dict to response_type object
             if isinstance(data, dict):
-                return response_type(**data)
+                # Filter to known fields to prevent TypeError on unknown fields
+                filtered_data = self._filter_known_fields(data, response_type)
+                return response_type(**filtered_data)
             return data
             
         except (UnauthorizedException, BadRequestException, NotFoundException, ServerException, ApiException):
@@ -291,7 +293,15 @@ class HttpClient:
                 raise ApiException(0, f"Expected list, got {type(data)}")
             
             # Convert list of dicts to list of objects
-            return [element_type(**item) if isinstance(item, dict) else item for item in data]
+            result: List[T] = []
+            for item in data:
+                if isinstance(item, dict):
+                    # Filter to known fields to prevent TypeError on unknown fields
+                    filtered_item = self._filter_known_fields(item, element_type)
+                    result.append(element_type(**filtered_item))
+                else:
+                    result.append(item)
+            return result
             
         except (UnauthorizedException, BadRequestException, NotFoundException, ServerException, ApiException):
             raise
@@ -338,7 +348,9 @@ class HttpClient:
             
             # Convert dict to response_type object
             if isinstance(data, dict):
-                return response_type(**data)
+                # Filter to known fields to prevent TypeError on unknown fields
+                filtered_data = self._filter_known_fields(data, response_type)
+                return response_type(**filtered_data)
             return data
             
         except (UnauthorizedException, BadRequestException, NotFoundException, ServerException, ApiException):

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

@@ -49,6 +49,9 @@ class PlatformMessageSubmissionRequest:
     sourceEvent: Optional[Dict[str, Any]] = None
     ragContext: Optional[str] = None
     replyMessageId: Optional[UUID] = None
+    # Optional conversation ID for HUMAN messages. If omitted, backend creates a new conversation.
+    # For BOT messages, backend determines conversation from replyMessageId and ignores this field.
+    conversationId: Optional[UUID] = None
     mode: Optional[str] = None
 
 
@@ -88,6 +91,25 @@ class PlatformMessageSubmissionResponse:
     similarConversations: Optional[List[WeaviateVector]] = None  # Similar conversations (senderType=HUMAN only)
     operationStatus: Optional[Dict[str, bool]] = None  # Operation status flags (senderType=BOT only)
     conversationTitle: Optional[str] = None  # LLM-generated conversation title
+    # Cache metadata (only present when cache was checked)
+    cacheResponse: Optional[str] = None
+    cacheHit: Optional[bool] = None
+
+
+@dataclass
+class EndConversationRequest:
+    """Request DTO for ending a conversation session."""
+    conversationId: UUID
+
+
+@dataclass
+class EndConversationResponse:
+    """Response DTO for ending a conversation session."""
+    success: Optional[bool] = None
+    message: Optional[str] = None
+    conversationId: Optional[UUID] = None
+    conversationExternalId: Optional[str] = None
+    endedAt: Optional[str] = None  # ISO 8601 datetime string
 
 
 @dataclass
@@ -175,6 +197,8 @@ class PlatformMessage:
     messageEmbedding: Optional[str] = None
     generatedContext: Optional[str] = None
     ragContext: Optional[str] = None
+    cacheHit: Optional[bool] = None
+    cacheResponse: Optional[str] = None
     evalRecordId: Optional[str] = None
     evalSyncStatus: Optional[str] = None
     evalSyncError: Optional[str] = None

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shiftaiagenticinfra-sdk-python
-Version: 0.0.5
+Version: 0.0.6
 Summary: Shiftai Agentic Infra Python SDK
 Author: ShiftAI
 Author-email: ShiftAI <s.tadakamalla@theshiftai.in>
@@ -154,6 +154,7 @@ async def main():
         message="Hello, how can I help you?",
         agent_name="SupportBot",
         agent_platform="OpenAI",
+        user_email="john@example.com",
         agent_version="1.0.0"  # Required: Agent version 
     )
 
@@ -167,7 +168,8 @@ async def main():
         agent_platform="OpenAI",
         agent_version="1.0.0",  # Required: Agent version 
         reply_message_id=human_response.messageId,
-        rag_context="Retrieved context from knowledge base..."
+        rag_context="Retrieved context from knowledge base...",
+        user_email="john@example.com"
     )
 
     # 4. Get analytics
@@ -223,6 +225,7 @@ Send a human message with automatic user/agent creation.
 - `agent_version` (str, **optional**): Agent version/model (e.g., "gpt-4", "claude-2") - **Required in database**
 - `agent_metadata` (dict, **optional**): Agent configuration data (e.g., `{"temperature": 0.7, "max_tokens": 1000}`)
 - `mode` (str, **optional**): Mode identifier for the message. Allowed values: `"SIMPLE"` or `"EXPAND"`
+- `conversation_id` (UUID, **optional**): Conversation ID to store the HUMAN message in. If omitted, backend creates a new conversation automatically.
 
 **Return Type:** `PlatformMessageSubmissionResponse`
 
@@ -248,6 +251,28 @@ Send a bot response to a human message.
 
 **Return Type:** `PlatformMessageSubmissionResponse`
 
+**Response Notes (Cache):**
+- `cacheHit` / `cacheResponse` may be present when the backend cache API was checked (typically for HUMAN messages).
+
+### Platform Session API
+
+#### `await platform_session.initiate_session(request=None)`
+Initiate a new conversation session.
+
+POST `/api/platformsession/initiate`
+
+**Return Type:** `Dict[str, Any]` (raw response body as returned by the server)
+
+#### `await platform_session.end_conversation(conversation_id)`
+End an active conversation session explicitly.
+
+POST `/api/platformsession/endconversation`
+
+**Parameters:**
+- `conversation_id` (UUID, **required**): Conversation identifier to end
+
+**Return Type:** `EndConversationResponse`
+
 #### `await messages.submit(request)`
 Low-level message submission with full control.
 

{shiftaiagenticinfra_sdk_python-0.0.5 → shiftaiagenticinfra_sdk_python-0.0.6}/shiftaiagenticinfra_sdk_python.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ shiftai/api/analytics_api.py
 shiftai/api/conversations_api.py
 shiftai/api/messages_api.py
 shiftai/api/platform_api.py
+shiftai/api/platform_session_api.py
 shiftai/api/users_api.py
 shiftai/api/internal/__init__.py
 shiftai/api/internal/trulens_api.py