skypilot-nightly 1.0.0.dev20250502__py3-none-any.whl → 1.0.0.dev20251203__py3-none-any.whl

sky/client/sdk_async.py

@@ -0,0 +1,827 @@
+"""Async client-side Python SDK for SkyPilot.
+
+All functions will return a future that can be awaited on.
+
+Usage example:
+
+.. code-block:: python
+
+    request_id = await sky.status()
+    statuses = await sky.get(request_id)
+
+"""
+import dataclasses
+import logging
+import typing
+from typing import Any, Dict, List, Optional, Tuple, Union
+
+import aiohttp
+import colorama
+
+from sky import admin_policy
+from sky import catalog
+from sky import exceptions
+from sky import sky_logging
+from sky.client import common as client_common
+from sky.client import sdk
+from sky.schemas.api import responses
+from sky.server import common as server_common
+from sky.server import rest
+from sky.server.requests import payloads
+from sky.server.requests import requests as requests_lib
+from sky.usage import usage_lib
+from sky.utils import annotations
+from sky.utils import common
+from sky.utils import context_utils
+from sky.utils import env_options
+from sky.utils import rich_utils
+from sky.utils import ux_utils
+
+if typing.TYPE_CHECKING:
+    import io
+
+    import sky
+    from sky import backends
+    from sky import models
+    from sky.provision.kubernetes import utils as kubernetes_utils
+    from sky.skylet import autostop_lib
+    from sky.skylet import job_lib
+
+logger = sky_logging.init_logger(__name__)
+logging.getLogger('httpx').setLevel(logging.CRITICAL)
+
+
+@dataclasses.dataclass
+class StreamConfig:
+    """Configuration class for stream_and_get behavior.
+
+    Attributes:
+        log_path: The path to the log file to stream.
+        tail: The number of lines to show from the end of the logs.
+            If None, show all logs.
+        follow: Whether to follow the logs.
+        output_stream: The output stream to write to. If None, print to the
+            console.
+    """
+    log_path: Optional[str] = None
+    tail: Optional[int] = None
+    follow: bool = True
+    output_stream: Optional['io.TextIOBase'] = None
+
+
+DEFAULT_STREAM_CONFIG = StreamConfig()
+
+
+@usage_lib.entrypoint
+@server_common.check_server_healthy_or_start
+@annotations.client_api
+async def get(request_id: str) -> Any:
+    """Async version of get() that waits for and gets the result of a request.
+
+    Args:
+        request_id: The request ID of the request to get.
+
+    Returns:
+        The ``Request Returns`` of the specified request. See the documentation
+        of the specific requests above for more details.
+
+    Raises:
+        Exception: It raises the same exceptions as the specific requests,
+            see ``Request Raises`` in the documentation of the specific requests
+            above.
+    """
+    async with aiohttp.ClientSession() as session:
+        response = await server_common.make_authenticated_request_async(
+            session,
+            'GET',
+            f'/api/get?request_id={request_id}',
+            retry=False,
+            timeout=aiohttp.ClientTimeout(
+                total=None,
+                connect=client_common.
+                API_SERVER_REQUEST_CONNECTION_TIMEOUT_SECONDS))
+
+        try:
+            request_task = None
+            if response.status == 200:
+                request_task = requests_lib.Request.decode(
+                    payloads.RequestPayload(**await response.json()))
+            elif response.status == 500:
+                try:
+                    request_task = requests_lib.Request.decode(
+                        payloads.RequestPayload(**await response.json()))
+                    logger.debug(f'Got request with error: {request_task.name}')
+                except Exception:  # pylint: disable=broad-except
+                    request_task = None
+            if request_task is None:
+                with ux_utils.print_exception_no_traceback():
+                    raise RuntimeError(
+                        f'Failed to get request {request_id}: '
+                        f'{response.status} {await response.text()}')
+            error = request_task.get_error()
+            if error is not None:
+                error_obj = error['object']
+                if env_options.Options.SHOW_DEBUG_INFO.get():
+                    stacktrace = getattr(error_obj, 'stacktrace',
+                                         str(error_obj))
+                    logger.error('=== Traceback on SkyPilot API Server ===\n'
+                                 f'{stacktrace}')
+                with ux_utils.print_exception_no_traceback():
+                    raise error_obj
+            if request_task.status == requests_lib.RequestStatus.CANCELLED:
+                with ux_utils.print_exception_no_traceback():
+                    raise exceptions.RequestCancelled(
+                        f'{colorama.Fore.YELLOW}Current {request_task.name!r} '
+                        f'request ({request_task.request_id}) is cancelled by '
+                        f'another process. {colorama.Style.RESET_ALL}')
+            return request_task.get_return_value()
+        finally:
+            response.close()
+
+
+@usage_lib.entrypoint
+@server_common.check_server_healthy_or_start
+@annotations.client_api
+async def stream_response_async(request_id: Optional[str],
+                                response: 'aiohttp.ClientResponse',
+                                output_stream: Optional['io.TextIOBase'] = None,
+                                resumable: bool = False,
+                                get_result: bool = True) -> Any:
+    """Async version of stream_response that streams the response to the
+    console.
+
+    Args:
+        request_id: The request ID.
+        response: The aiohttp response.
+        output_stream: The output stream to write to. If None, print to the
+            console.
+        resumable: Whether the response is resumable on retry. If True, the
+            streaming will start from the previous failure point on retry.
+
+    Returns:
+        Result of request_id if given. Will only return if get_result is True.
+    """
+
+    retry_context: Optional[rest.RetryContext] = None
+    if resumable:
+        retry_context = rest.get_retry_context()
+    try:
+        line_count = 0
+        async for line in rich_utils.decode_rich_status_async(response):
+            if line is not None:
+                line_count += 1
+                if retry_context is None:
+                    print(line, flush=True, end='', file=output_stream)
+                elif line_count > retry_context.line_processed:
+                    print(line, flush=True, end='', file=output_stream)
+                    retry_context.line_processed = line_count
+        if request_id is not None and get_result:
+            return await get(request_id)
+    except Exception:  # pylint: disable=broad-except
+        logger.debug(f'To stream request logs: sky api logs {request_id}')
+        raise
+
+
+async def _stream_and_get(
+    request_id: Optional[str] = None,
+    config: StreamConfig = DEFAULT_STREAM_CONFIG,
+) -> Any:
+    """Streams the logs of a request or a log file and gets the final result.
+    """
+    return await stream_and_get(
+        request_id,
+        config.log_path,
+        config.tail,
+        config.follow,
+        config.output_stream,
+    )
+
+
+async def stream_and_get(
+    request_id: Optional[str] = None,
+    log_path: Optional[str] = None,
+    tail: Optional[int] = None,
+    follow: bool = True,
+    output_stream: Optional['io.TextIOBase'] = None,
+) -> Any:
+    """Streams the logs of a request or a log file and gets the final result.
+
+    This will block until the request is finished. The request id can be a
+    prefix of the full request id.
+
+    Args:
+        request_id: The prefix of the request ID of the request to stream.
+        config: Configuration for streaming behavior.
+
+    Returns:
+        The ``Request Returns`` of the specified request. See the documentation
+        of the specific requests above for more details.
+
+    Raises:
+        Exception: It raises the same exceptions as the specific requests,
+            see ``Request Raises`` in the documentation of the specific requests
+            above.
+    """
+    params = {
+        'request_id': request_id,
+        'log_path': log_path,
+        'tail': str(tail) if tail is not None else None,
+        'follow': str(follow).lower(),  # Convert boolean to string for aiohttp
+        'format': 'console',
+    }
+    # Filter out None values
+    params = {k: v for k, v in params.items() if v is not None}
+
+    async with aiohttp.ClientSession() as session:
+        response = await server_common.make_authenticated_request_async(
+            session,
+            'GET',
+            '/api/stream',
+            params=params,
+            retry=False,
+            timeout=aiohttp.ClientTimeout(
+                total=None,
+                connect=client_common.
+                API_SERVER_REQUEST_CONNECTION_TIMEOUT_SECONDS))
+
+        try:
+            if response.status in [404, 400]:
+                detail = (await response.json()).get('detail')
+                with ux_utils.print_exception_no_traceback():
+                    raise RuntimeError(f'Failed to stream logs: {detail}')
+            elif response.status != 200:
+                # TODO(syang): handle the case where the requestID is not
+                # provided. https://github.com/skypilot-org/skypilot/issues/6549
+                if request_id is None:
+                    return None
+                return await get(request_id)
+
+            return await stream_response_async(request_id, response,
+                                               output_stream)
+        finally:
+            response.close()
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def check(
+    infra_list: Optional[Tuple[str, ...]],
+    verbose: bool,
+    workspace: Optional[str] = None,
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> Dict[str, List[str]]:
+    """Async version of check() that checks the credentials to enable clouds."""
+    request_id = await context_utils.to_thread(sdk.check, infra_list, verbose,
+                                               workspace)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def enabled_clouds(
+        workspace: Optional[str] = None,
+        expand: bool = False,
+        stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> List[str]:
+    """Async version of enabled_clouds() that gets the enabled clouds."""
+    request_id = await context_utils.to_thread(sdk.enabled_clouds, workspace,
+                                               expand)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def list_accelerators(
+    gpus_only: bool = True,
+    name_filter: Optional[str] = None,
+    region_filter: Optional[str] = None,
+    quantity_filter: Optional[int] = None,
+    clouds: Optional[Union[List[str], str]] = None,
+    all_regions: bool = False,
+    require_price: bool = True,
+    case_sensitive: bool = True,
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> Dict[str, List[catalog.common.InstanceTypeInfo]]:
+    """Async version of list_accelerators() that lists the names of all
+    accelerators offered by Sky."""
+    request_id = await context_utils.to_thread(sdk.list_accelerators, gpus_only,
+                                               name_filter, region_filter,
+                                               quantity_filter, clouds,
+                                               all_regions, require_price,
+                                               case_sensitive)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def list_accelerator_counts(
+    gpus_only: bool = True,
+    name_filter: Optional[str] = None,
+    region_filter: Optional[str] = None,
+    quantity_filter: Optional[int] = None,
+    clouds: Optional[Union[List[str], str]] = None,
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> Dict[str, List[int]]:
+    """Async version of list_accelerator_counts() that lists all accelerators
+      offered by Sky and available counts."""
+    request_id = await context_utils.to_thread(sdk.list_accelerator_counts,
+                                               gpus_only, name_filter,
+                                               region_filter, quantity_filter,
+                                               clouds)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def optimize(
+        dag: 'sky.Dag',
+        minimize: common.OptimizeTarget = common.OptimizeTarget.COST,
+        admin_policy_request_options: Optional[
+            admin_policy.RequestOptions] = None,
+        stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> 'sky.Dag':
+    """Async version of optimize() that finds the best execution plan for the
+      given DAG."""
+    request_id = await context_utils.to_thread(sdk.optimize, dag, minimize,
+                                               admin_policy_request_options)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def workspaces(
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> Dict[str, Any]:
+    """Async version of workspaces() that gets the workspaces."""
+    request_id = await context_utils.to_thread(sdk.workspaces)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def launch(
+    task: Union['sky.Task', 'sky.Dag'],
+    cluster_name: Optional[str] = None,
+    retry_until_up: bool = False,
+    idle_minutes_to_autostop: Optional[int] = None,
+    wait_for: Optional['autostop_lib.AutostopWaitFor'] = None,
+    dryrun: bool = False,
+    down: bool = False,  # pylint: disable=redefined-outer-name
+    backend: Optional['backends.Backend'] = None,
+    optimize_target: common.OptimizeTarget = common.OptimizeTarget.COST,
+    no_setup: bool = False,
+    clone_disk_from: Optional[str] = None,
+    fast: bool = False,
+    # Internal only:
+    # pylint: disable=invalid-name
+    _need_confirmation: bool = False,
+    _is_launched_by_jobs_controller: bool = False,
+    _is_launched_by_sky_serve_controller: bool = False,
+    _disable_controller_check: bool = False,
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG,
+) -> Tuple[Optional[int], Optional['backends.ResourceHandle']]:
+    """Async version of launch() that launches a cluster or task."""
+    request_id = await context_utils.to_thread(
+        sdk.launch, task, cluster_name, retry_until_up,
+        idle_minutes_to_autostop, wait_for, dryrun, down, backend,
+        optimize_target, no_setup, clone_disk_from, fast, _need_confirmation,
+        _is_launched_by_jobs_controller, _is_launched_by_sky_serve_controller,
+        _disable_controller_check)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def exec(  # pylint: disable=redefined-builtin
+    task: Union['sky.Task', 'sky.Dag'],
+    cluster_name: Optional[str] = None,
+    dryrun: bool = False,
+    down: bool = False,  # pylint: disable=redefined-outer-name
+    backend: Optional['backends.Backend'] = None,
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG,
+) -> Tuple[Optional[int], Optional['backends.ResourceHandle']]:
+    """Async version of exec() that executes a task on an existing cluster."""
+    request_id = await context_utils.to_thread(sdk.exec, task, cluster_name,
+                                               dryrun, down, backend)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def tail_logs(cluster_name: str,
+                    job_id: Optional[int],
+                    follow: bool,
+                    tail: int = 0,
+                    output_stream: Optional['io.TextIOBase'] = None) -> int:
+    """Async version of tail_logs() that tails the logs of a job."""
+    return await context_utils.to_thread(sdk.tail_logs, cluster_name, job_id,
+                                         follow, tail, output_stream)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def download_logs(cluster_name: str,
+                        job_ids: Optional[List[str]]) -> Dict[str, str]:
+    """Async version of download_logs() that downloads the logs of jobs."""
+    return await context_utils.to_thread(sdk.download_logs, cluster_name,
+                                         job_ids)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def start(
+    cluster_name: str,
+    idle_minutes_to_autostop: Optional[int] = None,
+    wait_for: Optional['autostop_lib.AutostopWaitFor'] = None,
+    retry_until_up: bool = False,
+    down: bool = False,  # pylint: disable=redefined-outer-name
+    force: bool = False,
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG,
+) -> 'backends.CloudVmRayResourceHandle':
+    """Async version of start() that restarts a cluster."""
+    request_id = await context_utils.to_thread(sdk.start, cluster_name,
+                                               idle_minutes_to_autostop,
+                                               wait_for, retry_until_up, down,
+                                               force)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def down(
+        cluster_name: str,
+        purge: bool = False,
+        stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG) -> None:
+    """Async version of down() that tears down a cluster."""
+    request_id = await context_utils.to_thread(sdk.down, cluster_name, purge)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def stop(
+        cluster_name: str,
+        purge: bool = False,
+        stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG) -> None:
+    """Async version of stop() that stops a cluster."""
+    request_id = await context_utils.to_thread(sdk.stop, cluster_name, purge)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def autostop(
+    cluster_name: str,
+    idle_minutes: int,
+    wait_for: Optional['autostop_lib.AutostopWaitFor'] = None,
+    down: bool = False,  # pylint: disable=redefined-outer-name
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> None:
+    """Async version of autostop() that schedules an autostop/autodown for a
+      cluster."""
+    request_id = await context_utils.to_thread(sdk.autostop, cluster_name,
+                                               idle_minutes, wait_for, down)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def queue(
+    cluster_name: str,
+    skip_finished: bool = False,
+    all_users: bool = False,
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> List[responses.ClusterJobRecord]:
+    """Async version of queue() that gets the job queue of a cluster."""
+    request_id = await context_utils.to_thread(sdk.queue, cluster_name,
+                                               skip_finished, all_users)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def job_status(
+    cluster_name: str,
+    job_ids: Optional[List[int]] = None,
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> Dict[Optional[int], Optional['job_lib.JobStatus']]:
+    """Async version of job_status() that gets the status of jobs on a
+      cluster."""
+    request_id = await context_utils.to_thread(sdk.job_status, cluster_name,
+                                               job_ids)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def cancel(
+        cluster_name: str,
+        all: bool = False,  # pylint: disable=redefined-builtin
+        all_users: bool = False,
+        job_ids: Optional[List[int]] = None,
+        # pylint: disable=invalid-name
+        _try_cancel_if_cluster_is_init: bool = False,
+        stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG) -> None:
+    """Async version of cancel() that cancels jobs on a cluster."""
+    request_id = await context_utils.to_thread(sdk.cancel, cluster_name, all,
+                                               all_users, job_ids,
+                                               _try_cancel_if_cluster_is_init)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def status(
+    cluster_names: Optional[List[str]] = None,
+    refresh: common.StatusRefreshMode = common.StatusRefreshMode.NONE,
+    all_users: bool = False,
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG,
+    *,
+    _include_credentials: bool = False,
+) -> List[Dict[str, Any]]:
+    """Async version of status() that gets cluster statuses."""
+    request_id = await context_utils.to_thread(
+        sdk.status,
+        cluster_names,
+        refresh,
+        all_users,
+        _include_credentials=_include_credentials)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def endpoints(
+    cluster: str,
+    port: Optional[Union[int, str]] = None,
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> Dict[int, str]:
+    """Async version of endpoints() that gets the endpoint for a given cluster
+      and port number."""
+    request_id = await context_utils.to_thread(sdk.endpoints, cluster, port)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def cost_report(
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> List[Dict[str, Any]]:
+    """Async version of cost_report() that gets all cluster cost reports."""
+    request_id = await context_utils.to_thread(sdk.cost_report)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def storage_ls(
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> List[Dict[str, Any]]:
+    """Async version of storage_ls() that gets the storages."""
+    request_id = await context_utils.to_thread(sdk.storage_ls)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def storage_delete(
+        name: str,
+        stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG) -> None:
+    """Async version of storage_delete() that deletes a storage."""
+    request_id = await context_utils.to_thread(sdk.storage_delete, name)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def local_up(
+        gpus: bool,
+        name: Optional[str] = None,
+        port_start: Optional[int] = None,
+        stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG) -> None:
+    """Async version of local_up() that launches a Kubernetes cluster on
+    local machines."""
+    request_id = await context_utils.to_thread(sdk.local_up, gpus, name,
+                                               port_start)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def local_down(
+        name: Optional[str] = None,
+        stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG) -> None:
+    """Async version of local_down() that tears down the Kubernetes cluster
+    started by local_up."""
+    request_id = await context_utils.to_thread(sdk.local_down, name)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def ssh_up(
+        infra: Optional[str] = None,
+        stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG) -> None:
+    """Async version of ssh_up() that deploys the SSH Node Pools defined in
+      ~/.sky/ssh_targets.yaml."""
+    request_id = await context_utils.to_thread(sdk.ssh_up, infra)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def ssh_down(
+        infra: Optional[str] = None,
+        stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG) -> None:
+    """Async version of ssh_down() that tears down a Kubernetes cluster on SSH
+    targets."""
+    request_id = await context_utils.to_thread(sdk.ssh_down, infra)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def realtime_kubernetes_gpu_availability(
+    context: Optional[str] = None,
+    name_filter: Optional[str] = None,
+    quantity_filter: Optional[int] = None,
+    is_ssh: Optional[bool] = None,
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> List[Tuple[str, List['models.RealtimeGpuAvailability']]]:
+    """Async version of realtime_kubernetes_gpu_availability() that gets the
+      real-time Kubernetes GPU availability."""
+    request_id = await context_utils.to_thread(
+        sdk.realtime_kubernetes_gpu_availability, context, name_filter,
+        quantity_filter, is_ssh)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def kubernetes_node_info(
+    context: Optional[str] = None,
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> 'models.KubernetesNodesInfo':
+    """Async version of kubernetes_node_info() that gets the resource
+    information for all the nodes in the cluster."""
+    request_id = await context_utils.to_thread(sdk.kubernetes_node_info,
+                                               context)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def status_kubernetes(
+    stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> Tuple[List['kubernetes_utils.KubernetesSkyPilotClusterInfoPayload'],
+           List['kubernetes_utils.KubernetesSkyPilotClusterInfoPayload'],
+           List[Dict[str, Any]], Optional[str]]:
+    """Async version of status_kubernetes() that gets all SkyPilot clusters
+      and jobs in the Kubernetes cluster."""
+    request_id = await context_utils.to_thread(sdk.status_kubernetes)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def api_cancel(
+        request_ids: Optional[Union[str, List[str]]] = None,
+        all_users: bool = False,
+        silent: bool = False,
+        stream_logs: Optional[StreamConfig] = DEFAULT_STREAM_CONFIG
+) -> List[str]:
+    """Async version of api_cancel() that aborts a request or all requests."""
+    request_id = await context_utils.to_thread(sdk.api_cancel, request_ids,
+                                               all_users, silent)
+    if stream_logs is not None:
+        return await _stream_and_get(request_id, stream_logs)
+    else:
+        return await get(request_id)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def api_status(request_ids: Optional[List[str]] = None,
+                     all_status: bool = False) -> List[payloads.RequestPayload]:
+    """Async version of api_status() that lists all requests."""
+    return await context_utils.to_thread(sdk.api_status, request_ids,
+                                         all_status)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def dashboard(starting_page: Optional[str] = None) -> None:
+    """Async version of dashboard() that starts the dashboard for SkyPilot."""
+    return await context_utils.to_thread(sdk.dashboard, starting_page)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def api_info() -> responses.APIHealthResponse:
+    """Async version of api_info() that gets the server's status, commit and
+      version."""
+    return await context_utils.to_thread(sdk.api_info)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def api_stop() -> None:
+    """Async version of api_stop() that stops the API server."""
+    return await context_utils.to_thread(sdk.api_stop)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def api_server_logs(follow: bool = True,
+                          tail: Optional[int] = None) -> None:
+    """Async version of api_server_logs() that streams the API server logs."""
+    return await context_utils.to_thread(sdk.api_server_logs, follow, tail)
+
+
+@usage_lib.entrypoint
+@annotations.client_api
+async def api_login(endpoint: Optional[str] = None,
+                    get_token: bool = False) -> None:
+    """Async version of api_login() that logs into a SkyPilot API server."""
+    return await context_utils.to_thread(sdk.api_login, endpoint, get_token)