blaxel 0.2.34__py3-none-any.whl → 0.2.35__py3-none-any.whl

blaxel/core/client/api/compute/list_sandboxes.py

@@ -1,10 +1,11 @@
 from http import HTTPStatus
-from typing import Any
+from typing import Any, Union
 
 import httpx
 
 from ... import errors
 from ...client import Client
+from ...models.error import Error
 from ...models.sandbox import Sandbox
 from ...types import Response
 
@@ -18,7 +19,9 @@ def _get_kwargs() -> dict[str, Any]:
     return _kwargs
 
 
-def _parse_response(*, client: Client, response: httpx.Response) -> list["Sandbox"] | None:
+def _parse_response(
+    *, client: Client, response: httpx.Response
+) -> Union[Error, list["Sandbox"]] | None:
     if response.status_code == 200:
         response_200 = []
         _response_200 = response.json()
@@ -28,13 +31,27 @@ def _parse_response(*, client: Client, response: httpx.Response) -> list["Sandbo
             response_200.append(response_200_item)
 
         return response_200
+    if response.status_code == 401:
+        response_401 = Error.from_dict(response.json())
+
+        return response_401
+    if response.status_code == 403:
+        response_403 = Error.from_dict(response.json())
+
+        return response_403
+    if response.status_code == 500:
+        response_500 = Error.from_dict(response.json())
+
+        return response_500
     if client.raise_on_unexpected_status:
         raise errors.UnexpectedStatus(response.status_code, response.content)
     else:
         return None
 
 
-def _build_response(*, client: Client, response: httpx.Response) -> Response[list["Sandbox"]]:
+def _build_response(
+    *, client: Client, response: httpx.Response
+) -> Response[Union[Error, list["Sandbox"]]]:
     return Response(
         status_code=HTTPStatus(response.status_code),
         content=response.content,
@@ -46,17 +63,18 @@ def _build_response(*, client: Client, response: httpx.Response) -> Response[lis
 def sync_detailed(
     *,
     client: Client,
-) -> Response[list["Sandbox"]]:
-    """List Sandboxes
+) -> Response[Union[Error, list["Sandbox"]]]:
+    """List sandboxes
 
-     Returns a list of all Sandboxes in the workspace.
+     Returns all sandboxes in the workspace. Each sandbox includes its configuration, status, and
+    endpoint URL.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[list['Sandbox']]
+        Response[Union[Error, list['Sandbox']]]
     """
 
     kwargs = _get_kwargs()
@@ -71,17 +89,18 @@ def sync_detailed(
 def sync(
     *,
     client: Client,
-) -> list["Sandbox"] | None:
-    """List Sandboxes
+) -> Union[Error, list["Sandbox"]] | None:
+    """List sandboxes
 
-     Returns a list of all Sandboxes in the workspace.
+     Returns all sandboxes in the workspace. Each sandbox includes its configuration, status, and
+    endpoint URL.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        list['Sandbox']
+        Union[Error, list['Sandbox']]
     """
 
     return sync_detailed(
@@ -92,17 +111,18 @@ def sync(
 async def asyncio_detailed(
     *,
     client: Client,
-) -> Response[list["Sandbox"]]:
-    """List Sandboxes
+) -> Response[Union[Error, list["Sandbox"]]]:
+    """List sandboxes
 
-     Returns a list of all Sandboxes in the workspace.
+     Returns all sandboxes in the workspace. Each sandbox includes its configuration, status, and
+    endpoint URL.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[list['Sandbox']]
+        Response[Union[Error, list['Sandbox']]]
     """
 
     kwargs = _get_kwargs()
@@ -115,17 +135,18 @@ async def asyncio_detailed(
 async def asyncio(
     *,
     client: Client,
-) -> list["Sandbox"] | None:
-    """List Sandboxes
+) -> Union[Error, list["Sandbox"]] | None:
+    """List sandboxes
 
-     Returns a list of all Sandboxes in the workspace.
+     Returns all sandboxes in the workspace. Each sandbox includes its configuration, status, and
+    endpoint URL.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        list['Sandbox']
+        Union[Error, list['Sandbox']]
     """
 
     return (

blaxel/core/client/api/compute/update_sandbox.py

@@ -1,10 +1,11 @@
 from http import HTTPStatus
-from typing import Any
+from typing import Any, Union
 
 import httpx
 
 from ... import errors
 from ...client import Client
+from ...models.error import Error
 from ...models.sandbox import Sandbox
 from ...types import Response
 
@@ -33,18 +34,38 @@ def _get_kwargs(
     return _kwargs
 
 
-def _parse_response(*, client: Client, response: httpx.Response) -> Sandbox | None:
+def _parse_response(*, client: Client, response: httpx.Response) -> Union[Error, Sandbox] | None:
     if response.status_code == 200:
         response_200 = Sandbox.from_dict(response.json())
 
         return response_200
+    if response.status_code == 400:
+        response_400 = Error.from_dict(response.json())
+
+        return response_400
+    if response.status_code == 401:
+        response_401 = Error.from_dict(response.json())
+
+        return response_401
+    if response.status_code == 403:
+        response_403 = Error.from_dict(response.json())
+
+        return response_403
+    if response.status_code == 404:
+        response_404 = Error.from_dict(response.json())
+
+        return response_404
+    if response.status_code == 500:
+        response_500 = Error.from_dict(response.json())
+
+        return response_500
     if client.raise_on_unexpected_status:
         raise errors.UnexpectedStatus(response.status_code, response.content)
     else:
         return None
 
 
-def _build_response(*, client: Client, response: httpx.Response) -> Response[Sandbox]:
+def _build_response(*, client: Client, response: httpx.Response) -> Response[Union[Error, Sandbox]]:
     return Response(
         status_code=HTTPStatus(response.status_code),
         content=response.content,
@@ -58,21 +79,24 @@ def sync_detailed(
     *,
     client: Client,
     body: Sandbox,
-) -> Response[Sandbox]:
-    """Update Sandbox
+) -> Response[Union[Error, Sandbox]]:
+    """Update sandbox
 
-     Update a Sandbox by name.
+     Updates a sandbox's configuration. Note that certain changes (like image or memory) may reset the
+    sandbox state. Use lifecycle policies to control automatic cleanup.
 
     Args:
         sandbox_name (str):
-        body (Sandbox): Micro VM for running agentic tasks
+        body (Sandbox): Lightweight virtual machine for secure AI code execution. Sandboxes resume
+            from standby in under 25ms and automatically scale to zero after inactivity, preserving
+            memory state including running processes and filesystem.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[Sandbox]
+        Response[Union[Error, Sandbox]]
     """
 
     kwargs = _get_kwargs(
@@ -92,21 +116,24 @@ def sync(
     *,
     client: Client,
     body: Sandbox,
-) -> Sandbox | None:
-    """Update Sandbox
+) -> Union[Error, Sandbox] | None:
+    """Update sandbox
 
-     Update a Sandbox by name.
+     Updates a sandbox's configuration. Note that certain changes (like image or memory) may reset the
+    sandbox state. Use lifecycle policies to control automatic cleanup.
 
     Args:
         sandbox_name (str):
-        body (Sandbox): Micro VM for running agentic tasks
+        body (Sandbox): Lightweight virtual machine for secure AI code execution. Sandboxes resume
+            from standby in under 25ms and automatically scale to zero after inactivity, preserving
+            memory state including running processes and filesystem.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Sandbox
+        Union[Error, Sandbox]
     """
 
     return sync_detailed(
@@ -121,21 +148,24 @@ async def asyncio_detailed(
     *,
     client: Client,
     body: Sandbox,
-) -> Response[Sandbox]:
-    """Update Sandbox
+) -> Response[Union[Error, Sandbox]]:
+    """Update sandbox
 
-     Update a Sandbox by name.
+     Updates a sandbox's configuration. Note that certain changes (like image or memory) may reset the
+    sandbox state. Use lifecycle policies to control automatic cleanup.
 
     Args:
         sandbox_name (str):
-        body (Sandbox): Micro VM for running agentic tasks
+        body (Sandbox): Lightweight virtual machine for secure AI code execution. Sandboxes resume
+            from standby in under 25ms and automatically scale to zero after inactivity, preserving
+            memory state including running processes and filesystem.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[Sandbox]
+        Response[Union[Error, Sandbox]]
     """
 
     kwargs = _get_kwargs(
@@ -153,21 +183,24 @@ async def asyncio(
     *,
     client: Client,
     body: Sandbox,
-) -> Sandbox | None:
-    """Update Sandbox
+) -> Union[Error, Sandbox] | None:
+    """Update sandbox
 
-     Update a Sandbox by name.
+     Updates a sandbox's configuration. Note that certain changes (like image or memory) may reset the
+    sandbox state. Use lifecycle policies to control automatic cleanup.
 
     Args:
         sandbox_name (str):
-        body (Sandbox): Micro VM for running agentic tasks
+        body (Sandbox): Lightweight virtual machine for secure AI code execution. Sandboxes resume
+            from standby in under 25ms and automatically scale to zero after inactivity, preserving
+            memory state including running processes and filesystem.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Sandbox
+        Union[Error, Sandbox]
     """
 
     return (

blaxel/core/client/api/configurations/get_configuration.py

@@ -42,7 +42,10 @@ def sync_detailed(
     *,
     client: Client,
 ) -> Response[Configuration]:
-    """List all configurations
+    """Get platform configuration
+
+     Returns global platform configuration including available regions, countries, continents, and
+    private locations for deployment policies.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -65,7 +68,10 @@ def sync(
     *,
     client: Client,
 ) -> Configuration | None:
-    """List all configurations
+    """Get platform configuration
+
+     Returns global platform configuration including available regions, countries, continents, and
+    private locations for deployment policies.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -84,7 +90,10 @@ async def asyncio_detailed(
     *,
     client: Client,
 ) -> Response[Configuration]:
-    """List all configurations
+    """Get platform configuration
+
+     Returns global platform configuration including available regions, countries, continents, and
+    private locations for deployment policies.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -105,7 +114,10 @@ async def asyncio(
     *,
     client: Client,
 ) -> Configuration | None:
-    """List all configurations
+    """Get platform configuration
+
+     Returns global platform configuration including available regions, countries, continents, and
+    private locations for deployment policies.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

blaxel/core/client/api/customdomains/create_custom_domain.py

@@ -59,6 +59,9 @@ def sync_detailed(
 ) -> Response[CustomDomain]:
     """Create custom domain
 
+     Creates a new custom domain for preview deployments. After creation, you must configure DNS records
+    and verify domain ownership before it becomes active.
+
     Args:
         body (CustomDomain): Custom domain for preview deployments
             The custom domain represents a base domain (e.g., example.com) that will be used
@@ -91,6 +94,9 @@ def sync(
 ) -> CustomDomain | None:
     """Create custom domain
 
+     Creates a new custom domain for preview deployments. After creation, you must configure DNS records
+    and verify domain ownership before it becomes active.
+
     Args:
         body (CustomDomain): Custom domain for preview deployments
             The custom domain represents a base domain (e.g., example.com) that will be used
@@ -118,6 +124,9 @@ async def asyncio_detailed(
 ) -> Response[CustomDomain]:
     """Create custom domain
 
+     Creates a new custom domain for preview deployments. After creation, you must configure DNS records
+    and verify domain ownership before it becomes active.
+
     Args:
         body (CustomDomain): Custom domain for preview deployments
             The custom domain represents a base domain (e.g., example.com) that will be used
@@ -148,6 +157,9 @@ async def asyncio(
 ) -> CustomDomain | None:
     """Create custom domain
 
+     Creates a new custom domain for preview deployments. After creation, you must configure DNS records
+    and verify domain ownership before it becomes active.
+
     Args:
         body (CustomDomain): Custom domain for preview deployments
             The custom domain represents a base domain (e.g., example.com) that will be used

blaxel/core/client/api/customdomains/list_custom_domains.py

@@ -47,7 +47,10 @@ def sync_detailed(
     *,
     client: Client,
 ) -> Response[list["CustomDomain"]]:
-    """List all custom domains
+    """List custom domains
+
+     Returns all custom domains configured in the workspace. Custom domains allow serving preview
+    deployments under your own domain (e.g., preview.yourdomain.com).
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -70,7 +73,10 @@ def sync(
     *,
     client: Client,
 ) -> list["CustomDomain"] | None:
-    """List all custom domains
+    """List custom domains
+
+     Returns all custom domains configured in the workspace. Custom domains allow serving preview
+    deployments under your own domain (e.g., preview.yourdomain.com).
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -89,7 +95,10 @@ async def asyncio_detailed(
     *,
     client: Client,
 ) -> Response[list["CustomDomain"]]:
-    """List all custom domains
+    """List custom domains
+
+     Returns all custom domains configured in the workspace. Custom domains allow serving preview
+    deployments under your own domain (e.g., preview.yourdomain.com).
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -110,7 +119,10 @@ async def asyncio(
     *,
     client: Client,
 ) -> list["CustomDomain"] | None:
-    """List all custom domains
+    """List custom domains
+
+     Returns all custom domains configured in the workspace. Custom domains allow serving preview
+    deployments under your own domain (e.g., preview.yourdomain.com).
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

blaxel/core/client/api/default/get_template.py

@@ -47,7 +47,8 @@ def sync_detailed(
 ) -> Response[Template]:
     """Get template
 
-     Returns a template by name.
+     Returns detailed information about a deployment template including its configuration, source code
+    reference, and available parameters.
 
     Args:
         template_name (str):
@@ -78,7 +79,8 @@ def sync(
 ) -> Template | None:
     """Get template
 
-     Returns a template by name.
+     Returns detailed information about a deployment template including its configuration, source code
+    reference, and available parameters.
 
     Args:
         template_name (str):
@@ -104,7 +106,8 @@ async def asyncio_detailed(
 ) -> Response[Template]:
     """Get template
 
-     Returns a template by name.
+     Returns detailed information about a deployment template including its configuration, source code
+    reference, and available parameters.
 
     Args:
         template_name (str):
@@ -133,7 +136,8 @@ async def asyncio(
 ) -> Template | None:
     """Get template
 
-     Returns a template by name.
+     Returns detailed information about a deployment template including its configuration, source code
+    reference, and available parameters.
 
     Args:
         template_name (str):

blaxel/core/client/api/functions/create_function.py

@@ -1,10 +1,11 @@
 from http import HTTPStatus
-from typing import Any
+from typing import Any, Union
 
 import httpx
 
 from ... import errors
 from ...client import Client
+from ...models.error import Error
 from ...models.function import Function
 from ...types import Response
 
@@ -32,18 +33,40 @@ def _get_kwargs(
     return _kwargs
 
 
-def _parse_response(*, client: Client, response: httpx.Response) -> Function | None:
+def _parse_response(*, client: Client, response: httpx.Response) -> Union[Error, Function] | None:
     if response.status_code == 200:
         response_200 = Function.from_dict(response.json())
 
         return response_200
+    if response.status_code == 400:
+        response_400 = Error.from_dict(response.json())
+
+        return response_400
+    if response.status_code == 401:
+        response_401 = Error.from_dict(response.json())
+
+        return response_401
+    if response.status_code == 403:
+        response_403 = Error.from_dict(response.json())
+
+        return response_403
+    if response.status_code == 409:
+        response_409 = Error.from_dict(response.json())
+
+        return response_409
+    if response.status_code == 500:
+        response_500 = Error.from_dict(response.json())
+
+        return response_500
     if client.raise_on_unexpected_status:
         raise errors.UnexpectedStatus(response.status_code, response.content)
     else:
         return None
 
 
-def _build_response(*, client: Client, response: httpx.Response) -> Response[Function]:
+def _build_response(
+    *, client: Client, response: httpx.Response
+) -> Response[Union[Error, Function]]:
     return Response(
         status_code=HTTPStatus(response.status_code),
         content=response.content,
@@ -56,18 +79,23 @@ def sync_detailed(
     *,
     client: Client,
     body: Function,
-) -> Response[Function]:
-    """Create function
+) -> Response[Union[Error, Function]]:
+    """Create MCP server
+
+     Creates a new MCP server function deployment. The function will expose tools via the Model Context
+    Protocol that can be used by AI agents. Supports streamable HTTP transport.
 
     Args:
-        body (Function): Function
+        body (Function): MCP server deployment that exposes tools for AI agents via the Model
+            Context Protocol (MCP). Deployed as a serverless auto-scaling endpoint using streamable
+            HTTP transport.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[Function]
+        Response[Union[Error, Function]]
     """
 
     kwargs = _get_kwargs(
@@ -85,18 +113,23 @@ def sync(
     *,
     client: Client,
     body: Function,
-) -> Function | None:
-    """Create function
+) -> Union[Error, Function] | None:
+    """Create MCP server
+
+     Creates a new MCP server function deployment. The function will expose tools via the Model Context
+    Protocol that can be used by AI agents. Supports streamable HTTP transport.
 
     Args:
-        body (Function): Function
+        body (Function): MCP server deployment that exposes tools for AI agents via the Model
+            Context Protocol (MCP). Deployed as a serverless auto-scaling endpoint using streamable
+            HTTP transport.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Function
+        Union[Error, Function]
     """
 
     return sync_detailed(
@@ -109,18 +142,23 @@ async def asyncio_detailed(
     *,
     client: Client,
     body: Function,
-) -> Response[Function]:
-    """Create function
+) -> Response[Union[Error, Function]]:
+    """Create MCP server
+
+     Creates a new MCP server function deployment. The function will expose tools via the Model Context
+    Protocol that can be used by AI agents. Supports streamable HTTP transport.
 
     Args:
-        body (Function): Function
+        body (Function): MCP server deployment that exposes tools for AI agents via the Model
+            Context Protocol (MCP). Deployed as a serverless auto-scaling endpoint using streamable
+            HTTP transport.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[Function]
+        Response[Union[Error, Function]]
     """
 
     kwargs = _get_kwargs(
@@ -136,18 +174,23 @@ async def asyncio(
     *,
     client: Client,
     body: Function,
-) -> Function | None:
-    """Create function
+) -> Union[Error, Function] | None:
+    """Create MCP server
+
+     Creates a new MCP server function deployment. The function will expose tools via the Model Context
+    Protocol that can be used by AI agents. Supports streamable HTTP transport.
 
     Args:
-        body (Function): Function
+        body (Function): MCP server deployment that exposes tools for AI agents via the Model
+            Context Protocol (MCP). Deployed as a serverless auto-scaling endpoint using streamable
+            HTTP transport.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Function
+        Union[Error, Function]
     """
 
     return (