assistant-runtime-sdk 1.1.0__tar.gz → 1.2.0__tar.gz

{assistant_runtime_sdk-1.1.0 → assistant_runtime_sdk-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: assistant_runtime_sdk
-Version: 1.1.0
+Version: 1.2.0
 Summary: Python SDK for FAC Cloud - the Assistant Runtime AI assistant backend
 Keywords: frappe,ai,assistant,llm,mcp,anthropic,openai,streaming
 Author: Paul Clinton
@@ -157,9 +157,9 @@ surface. A representative selection:
 `create_message()`, `update_conversation()`, `delete_conversation()`, `delete_message()`
 
 **Billing** — `get_plan_comparison()`, `get_usage_dashboard()`, `get_usage_history()`,
-`get_credit_balance()`, `initiate_checkout()`, `verify_checkout()`, `upgrade_plan()`,
-`cancel_subscription()`, `get_invoices()`, `get_payment_instrument()`,
-`update_payment_method()`
+`get_credit_balance()`, `initiate_checkout()`, `create_hosted_checkout()`,
+`verify_checkout()`, `upgrade_plan()`, `cancel_subscription()`, `get_invoices()`,
+`get_payment_instrument()`, `update_payment_method()`
 
 **Users & seats** — `register_user()`, `get_user()`, `list_users()`, `invite_user()`,
 `add_user_seat()`, `set_user_credit_limit()`, `get_user_auth_status()`

{assistant_runtime_sdk-1.1.0 → assistant_runtime_sdk-1.2.0}/README.md

@@ -124,9 +124,9 @@ surface. A representative selection:
 `create_message()`, `update_conversation()`, `delete_conversation()`, `delete_message()`
 
 **Billing** — `get_plan_comparison()`, `get_usage_dashboard()`, `get_usage_history()`,
-`get_credit_balance()`, `initiate_checkout()`, `verify_checkout()`, `upgrade_plan()`,
-`cancel_subscription()`, `get_invoices()`, `get_payment_instrument()`,
-`update_payment_method()`
+`get_credit_balance()`, `initiate_checkout()`, `create_hosted_checkout()`,
+`verify_checkout()`, `upgrade_plan()`, `cancel_subscription()`, `get_invoices()`,
+`get_payment_instrument()`, `update_payment_method()`
 
 **Users & seats** — `register_user()`, `get_user()`, `list_users()`, `invite_user()`,
 `add_user_seat()`, `set_user_credit_limit()`, `get_user_auth_status()`

{assistant_runtime_sdk-1.1.0 → assistant_runtime_sdk-1.2.0}/assistant_runtime_sdk/__init__.py

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

{assistant_runtime_sdk-1.1.0 → assistant_runtime_sdk-1.2.0}/assistant_runtime_sdk/async_client.py

@@ -872,6 +872,16 @@ class AsyncAssistantRuntimeClient(BaseAssistantRuntimeClient):
         endpoint, payload = self._prepare_initiate_checkout(plan, billing_cycle, gateway, billing_name, billing_email)
         return await self._request_post_json(endpoint, payload, api_base=self.billing_api_base)
 
+    async def create_hosted_checkout(
+        self,
+        purpose: str,
+        params: Optional[Dict[str, Any]] = None,
+        return_url: Optional[str] = None,
+    ) -> Optional[Dict[str, Any]]:
+        """Async version of AssistantRuntimeClient.create_hosted_checkout."""
+        endpoint, payload = self._prepare_create_hosted_checkout(purpose, params, return_url)
+        return await self._request_post_json(endpoint, payload, api_base=self.billing_api_base)
+
     async def verify_checkout(self, session_id: Optional[str] = None) -> Optional[Dict[str, Any]]:
         """Async version of AssistantRuntimeClient.verify_checkout."""
         endpoint, payload = self._prepare_verify_checkout(session_id)

{assistant_runtime_sdk-1.1.0 → assistant_runtime_sdk-1.2.0}/assistant_runtime_sdk/base.py

@@ -906,6 +906,20 @@ class BaseAssistantRuntimeClient:
             payload["billing_email"] = billing_email
         return "initiate_checkout", payload
 
+    def _prepare_create_hosted_checkout(
+        self, purpose: str, params: Optional[Dict[str, Any]] = None,
+        return_url: Optional[str] = None,
+    ) -> tuple:
+        self._require_billing()
+        payload: Dict[str, Any] = {
+            "tenant_id": self.tenant_id,
+            "purpose": purpose,
+            "params": params or {},
+        }
+        if return_url:
+            payload["return_url"] = return_url
+        return "create_hosted_checkout", payload
+
     def _prepare_verify_checkout(self, session_id: Optional[str] = None) -> tuple:
         self._require_billing()
         payload: Dict[str, Any] = {"tenant_id": self.tenant_id}

{assistant_runtime_sdk-1.1.0 → assistant_runtime_sdk-1.2.0}/assistant_runtime_sdk/client.py

@@ -1238,6 +1238,34 @@ class AssistantRuntimeClient(BaseAssistantRuntimeClient):
         endpoint, payload = self._prepare_initiate_checkout(plan, billing_cycle, gateway, billing_name, billing_email)
         return self._request_post_json(endpoint, payload, api_base=self.billing_api_base)
 
+    def create_hosted_checkout(
+        self,
+        purpose: str,
+        params: Optional[Dict[str, Any]] = None,
+        return_url: Optional[str] = None,
+    ) -> Optional[Dict[str, Any]]:
+        """
+        Get a link to the page where a purchase is paid for.
+
+        Payments are collected on the runtime's own public site rather than
+        on this one, so that a payment gateway can be onboarded against a
+        single declared address. Send the user to ``checkout_url``; they are
+        returned to ``return_url`` when they are done.
+
+        Args:
+            purpose: "Subscription", "Payment Method", "Credits", "Pack" or "Seat".
+            params: Purpose-specific arguments — e.g. ``{"plan": "Team",
+                "billing_cycle": "monthly"}`` for a subscription, or
+                ``{"credit_amount": 5000}`` for credits.
+            return_url: Where to send the user afterwards. Must be on this
+                site; defaults to the registered site URL.
+
+        Returns:
+            Dict with checkout_url, session, purpose and expires_at.
+        """
+        endpoint, payload = self._prepare_create_hosted_checkout(purpose, params, return_url)
+        return self._request_post_json(endpoint, payload, api_base=self.billing_api_base)
+
     def verify_checkout(self, session_id: Optional[str] = None) -> Optional[Dict[str, Any]]:
         """Verify payment completion after checkout."""
         endpoint, payload = self._prepare_verify_checkout(session_id)

{assistant_runtime_sdk-1.1.0 → assistant_runtime_sdk-1.2.0}/pyproject.toml

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