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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shiftaiagenticinfra-sdk-python
-Version: 0.0.5
+Version: 0.0.7
 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**
@@ -154,6 +163,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 +177,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 +234,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 +260,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.
 
@@ -325,17 +359,26 @@ 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.