assistant-runtime-sdk 1.6.0__tar.gz → 1.7.1__tar.gz

{assistant_runtime_sdk-1.6.0 → assistant_runtime_sdk-1.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: assistant_runtime_sdk
-Version: 1.6.0
+Version: 1.7.1
 Summary: Python SDK for FAC Cloud - the Assistant Runtime AI assistant backend
 Keywords: frappe,ai,assistant,llm,mcp,anthropic,openai,streaming
 Author: Paul Clinton

{assistant_runtime_sdk-1.6.0 → assistant_runtime_sdk-1.7.1}/assistant_runtime_sdk/__init__.py

@@ -53,7 +53,7 @@ Standalone Functions:
 
 """
 
-__version__ = "1.6.0"
+__version__ = "1.7.1"
 __author__ = "Paul Clinton"
 __license__ = "AGPL-3.0"
 

{assistant_runtime_sdk-1.6.0 → assistant_runtime_sdk-1.7.1}/assistant_runtime_sdk/async_client.py

@@ -826,6 +826,14 @@ class AsyncAssistantRuntimeClient(BaseAssistantRuntimeClient):
             user_id, preference_id, status)
         return await self._request_post_json(endpoint, payload)
 
+    async def set_routing_preference_mode(
+        self, user_id: str, preference_id: str, rule_mode: str,
+    ) -> Optional[Dict[str, Any]]:
+        """Async version of AssistantRuntimeClient.set_routing_preference_mode."""
+        endpoint, payload = self._prepare_set_routing_preference_mode(
+            user_id, preference_id, rule_mode)
+        return await self._request_post_json(endpoint, payload)
+
     async def delete_routing_preference(
         self, user_id: str, preference_id: str,
     ) -> Optional[Dict[str, Any]]:
@@ -1737,6 +1745,18 @@ class AsyncAssistantRuntimeClient(BaseAssistantRuntimeClient):
             user_id, rating, comment, category, conversation_id, environment)
         return await self._request_post_json(endpoint, payload)
 
+    async def download_ticket_attachment(self, user_id: str, ticket_id: str,
+                                         file_url: str) -> tuple:
+        """Download one attachment from a ticket the user owns.
+
+        Returns:
+            (content_bytes, content_type, filename) tuple.
+        """
+        endpoint, params = self._prepare_download_ticket_attachment(
+            user_id, ticket_id, file_url
+        )
+        return await self._request_get_raw(endpoint, params)
+
     async def list_tickets(self, user_id: str, status: Optional[str] = None) -> Optional[Dict[str, Any]]:
         """List the user's support tickets. Returns {tickets: [...]}."""
         endpoint, payload = self._prepare_list_tickets(user_id, status)

{assistant_runtime_sdk-1.6.0 → assistant_runtime_sdk-1.7.1}/assistant_runtime_sdk/base.py

@@ -883,6 +883,16 @@ class BaseAssistantRuntimeClient:
             "status": status,
         }
 
+    def _prepare_set_routing_preference_mode(
+        self, user_id: str, preference_id: str, rule_mode: str,
+    ) -> tuple:
+        return "routing_preferences.set_routing_preference_mode", {
+            "tenant_id": self.tenant_id,
+            "user_id": user_id,
+            "preference_id": preference_id,
+            "rule_mode": rule_mode,
+        }
+
     def _prepare_delete_routing_preference(
         self, user_id: str, preference_id: str,
     ) -> tuple:
@@ -1924,6 +1934,16 @@ class BaseAssistantRuntimeClient:
             "ticket_id": ticket_id,
         }
 
+    def _prepare_download_ticket_attachment(self, user_id: str, ticket_id: str,
+                                            file_url: str) -> tuple:
+        """Returns (endpoint, params)."""
+        return "support.download_ticket_attachment", {
+            "tenant_id": self.tenant_id,
+            "user_id": user_id,
+            "ticket_id": ticket_id,
+            "file_url": file_url,
+        }
+
     def _prepare_reply_to_ticket(self, user_id: str, ticket_id: str, message: str,
                                  attachment_ids: Optional[List[str]] = None) -> tuple:
         """Returns (endpoint, payload)."""

{assistant_runtime_sdk-1.6.0 → assistant_runtime_sdk-1.7.1}/assistant_runtime_sdk/client.py

@@ -1189,6 +1189,28 @@ class AssistantRuntimeClient(BaseAssistantRuntimeClient):
             user_id, preference_id, status)
         return self._request_post_json(endpoint, payload)
 
+    def set_routing_preference_mode(
+        self, user_id: str, preference_id: str, rule_mode: str,
+    ) -> Optional[Dict[str, Any]]:
+        """Finish a rule's trial, or send it back to one.
+
+        Every rule carries its own mode, so this changes nothing about any
+        other rule. Platform defaults are not reachable here — they are
+        managed in AR Admin.
+
+        Args:
+            user_id: User identifier
+            preference_id: the rule
+            rule_mode: "shadow" (matched and recorded, never applied) or
+                "on" (applied)
+
+        Returns:
+            {"preference_id": ..., "rule_mode": ...}
+        """
+        endpoint, payload = self._prepare_set_routing_preference_mode(
+            user_id, preference_id, rule_mode)
+        return self._request_post_json(endpoint, payload)
+
     def delete_routing_preference(
         self, user_id: str, preference_id: str,
     ) -> Optional[Dict[str, Any]]:
@@ -2593,6 +2615,21 @@ class AssistantRuntimeClient(BaseAssistantRuntimeClient):
             user_id, rating, comment, category, conversation_id, environment)
         return self._request_post_json(endpoint, payload)
 
+    def download_ticket_attachment(self, user_id: str, ticket_id: str,
+                                   file_url: str) -> tuple:
+        """Download one attachment from a ticket the user owns.
+
+        Raw bytes rather than JSON, so a 10 MB screenshot doesn't get
+        base64-inflated through two hops.
+
+        Returns:
+            (content_bytes, content_type, filename) tuple.
+        """
+        endpoint, params = self._prepare_download_ticket_attachment(
+            user_id, ticket_id, file_url
+        )
+        return self._request_get_raw(endpoint, params)
+
     def list_tickets(self, user_id: str, status: Optional[str] = None) -> Optional[Dict[str, Any]]:
         """List the user's support tickets. Returns {tickets: [...]}."""
         endpoint, payload = self._prepare_list_tickets(user_id, status)

{assistant_runtime_sdk-1.6.0 → assistant_runtime_sdk-1.7.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "assistant_runtime_sdk"
-version = "1.6.0"
+version = "1.7.1"
 description = "Python SDK for FAC Cloud - the Assistant Runtime AI assistant backend"
 readme = "README.md"
 license = {text = "AGPL-3.0"}