fal 0.15.0__tar.gz → 0.15.2__tar.gz

{fal-0.15.0 → fal-0.15.2}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: fal
-Version: 0.15.0
+Version: 0.15.2
 Summary: fal is an easy-to-use Serverless Python Framework
 Author: Features & Labels <hello@fal.ai>
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Requires-Dist: isolate[build]<1.0,>=0.12.3
-Requires-Dist: isolate-proto==0.3.4
+Requires-Dist: isolate-proto==0.4.0
 Requires-Dist: grpcio<2,>=1.50.0
 Requires-Dist: dill==0.3.7
 Requires-Dist: cloudpickle==3.0.0
@@ -36,9 +36,10 @@ Requires-Dist: pillow<11,>=10.2.0
 Requires-Dist: pyjwt[crypto]<3,>=2.8.0
 Requires-Dist: uvicorn<1,>=0.29.0
 Provides-Extra: test
-Requires-Dist: pytest; extra == "test"
-Requires-Dist: pytest-xdist; extra == "test"
+Requires-Dist: pytest<8; extra == "test"
 Requires-Dist: pytest-asyncio; extra == "test"
+Requires-Dist: pytest-xdist; extra == "test"
+Requires-Dist: flaky; extra == "test"
 Provides-Extra: dev
 Requires-Dist: fal[test]; extra == "dev"
 Requires-Dist: openapi-python-client<1,>=0.14.1; extra == "dev"
@@ -89,3 +90,30 @@ A new virtual environment will be created by fal in the cloud and the set of req
 ## Next steps
 
 If you would like to find out more about the capabilities of fal, check out to the [docs](https://fal.ai/docs). You can learn more about persistent storage, function caches and deploying your functions as API endpoints.
+
+## Contributing
+
+### Installing in editable mode with dev dependencies
+
+```py
+pip install -e 'projects/fal[dev]'
+pip install -e 'projects/fal_client[dev]'
+pip install -e 'projects/isolate_proto[dev]'
+```
+
+### Running tests
+
+```py
+pytest
+```
+
+### Pre-commit
+
+```
+cd projects/fal
+pre-commit install
+```
+
+### Commit format
+
+Please follow [conventional commits specification](https://www.conventionalcommits.org/) for descriptions/messages.

{fal-0.15.0 → fal-0.15.2}/README.md

@@ -44,3 +44,30 @@ A new virtual environment will be created by fal in the cloud and the set of req
 ## Next steps
 
 If you would like to find out more about the capabilities of fal, check out to the [docs](https://fal.ai/docs). You can learn more about persistent storage, function caches and deploying your functions as API endpoints.
+
+## Contributing
+
+### Installing in editable mode with dev dependencies
+
+```py
+pip install -e 'projects/fal[dev]'
+pip install -e 'projects/fal_client[dev]'
+pip install -e 'projects/isolate_proto[dev]'
+```
+
+### Running tests
+
+```py
+pytest
+```
+
+### Pre-commit
+
+```
+cd projects/fal
+pre-commit install
+```
+
+### Commit format
+
+Please follow [conventional commits specification](https://www.conventionalcommits.org/) for descriptions/messages.

{fal-0.15.0 → fal-0.15.2}/fal.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: fal
-Version: 0.15.0
+Version: 0.15.2
 Summary: fal is an easy-to-use Serverless Python Framework
 Author: Features & Labels <hello@fal.ai>
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Requires-Dist: isolate[build]<1.0,>=0.12.3
-Requires-Dist: isolate-proto==0.3.4
+Requires-Dist: isolate-proto==0.4.0
 Requires-Dist: grpcio<2,>=1.50.0
 Requires-Dist: dill==0.3.7
 Requires-Dist: cloudpickle==3.0.0
@@ -36,9 +36,10 @@ Requires-Dist: pillow<11,>=10.2.0
 Requires-Dist: pyjwt[crypto]<3,>=2.8.0
 Requires-Dist: uvicorn<1,>=0.29.0
 Provides-Extra: test
-Requires-Dist: pytest; extra == "test"
-Requires-Dist: pytest-xdist; extra == "test"
+Requires-Dist: pytest<8; extra == "test"
 Requires-Dist: pytest-asyncio; extra == "test"
+Requires-Dist: pytest-xdist; extra == "test"
+Requires-Dist: flaky; extra == "test"
 Provides-Extra: dev
 Requires-Dist: fal[test]; extra == "dev"
 Requires-Dist: openapi-python-client<1,>=0.14.1; extra == "dev"
@@ -89,3 +90,30 @@ A new virtual environment will be created by fal in the cloud and the set of req
 ## Next steps
 
 If you would like to find out more about the capabilities of fal, check out to the [docs](https://fal.ai/docs). You can learn more about persistent storage, function caches and deploying your functions as API endpoints.
+
+## Contributing
+
+### Installing in editable mode with dev dependencies
+
+```py
+pip install -e 'projects/fal[dev]'
+pip install -e 'projects/fal_client[dev]'
+pip install -e 'projects/isolate_proto[dev]'
+```
+
+### Running tests
+
+```py
+pytest
+```
+
+### Pre-commit
+
+```
+cd projects/fal
+pre-commit install
+```
+
+### Commit format
+
+Please follow [conventional commits specification](https://www.conventionalcommits.org/) for descriptions/messages.

{fal-0.15.0 → fal-0.15.2}/fal.egg-info/requires.txt

@@ -1,5 +1,5 @@
 isolate[build]<1.0,>=0.12.3
-isolate-proto==0.3.4
+isolate-proto==0.4.0
 grpcio<2,>=1.50.0
 dill==0.3.7
 cloudpickle==3.0.0
@@ -36,6 +36,7 @@ fal[test]
 openapi-python-client<1,>=0.14.1
 
 [test]
-pytest
-pytest-xdist
+pytest<8
 pytest-asyncio
+pytest-xdist
+flaky

{fal-0.15.0 → fal-0.15.2}/pyproject.toml

@@ -22,7 +22,7 @@ readme = "README.md"
 requires-python = ">=3.8"
 dependencies = [
     "isolate[build]>=0.12.3,<1.0",
-    "isolate-proto==0.3.4",
+    "isolate-proto==0.4.0",
     "grpcio>=1.50.0,<2",
     "dill==0.3.7",
     "cloudpickle==3.0.0",
@@ -58,9 +58,10 @@ dependencies = [
 
 [project.optional-dependencies]
 test = [
-    "pytest",
-    "pytest-xdist",
+    "pytest<8",
     "pytest-asyncio",
+    "pytest-xdist",
+    "flaky",
 ]
 dev = [
     "fal[test]",
@@ -69,3 +70,12 @@ dev = [
 
 [project.scripts]
 fal = "fal.cli:cli"
+
+[tool.ruff]
+target-version = "py38"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "PLC", "PLE", "PLW", "I", "UP"]
+
+[tool.ruff.lint.pyupgrade]
+keep-runtime-typing = true

fal-0.15.2/src/fal/__init__.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+from fal import apps  # noqa: F401
+from fal.api import FalServerlessHost, LocalHost, cached, function
+from fal.api import function as isolated  # noqa: F401
+from fal.app import App, endpoint, realtime, wrap_app  # noqa: F401
+from fal.sdk import FalServerlessKeyCredentials
+from fal.sync import sync_dir
+
+local = LocalHost()
+serverless = FalServerlessHost()
+
+# DEPRECATED - use serverless instead
+cloud = FalServerlessHost()
+
+__all__ = [
+    "function",
+    "cached",
+    "App",
+    "endpoint",
+    "realtime",
+    # "wrap_app",
+    "FalServerlessKeyCredentials",
+    "sync_dir",
+]

{fal-0.15.0 → fal-0.15.2}/src/fal/_serialization.py

@@ -1,8 +1,8 @@
 from __future__ import annotations
 
+import pickle
 from typing import Any, Callable
 
-import pickle
 import cloudpickle
 
 
@@ -98,11 +98,12 @@ def _patch_pydantic_field_serialization() -> None:
 
 
 def _patch_pydantic_model_serialization() -> None:
-    # If user has created new pydantic models in his namespace, we will try to pickle those
-    # by value, which means recreating class skeleton, which will stumble upon
-    # __pydantic_parent_namespace__ in its __dict__ and it may contain modules that happened
-    # to be imported in the namespace but are not actually used, resulting in pickling errors.
-    # Unfortunately this also means that `model_rebuid()` might not work.
+    # If user has created new pydantic models in his namespace, we will try to pickle
+    # those by value, which means recreating class skeleton, which will stumble upon
+    # __pydantic_parent_namespace__ in its __dict__ and it may contain modules that
+    # happened to be imported in the namespace but are not actually used, resulting
+    # in pickling errors. Unfortunately this also means that `model_rebuid()` might
+    # not work.
     try:
         import pydantic
     except ImportError:
@@ -133,7 +134,8 @@ def _patch_lru_cache() -> None:
     # https://github.com/cloudpipe/cloudpickle/issues/178
     # https://github.com/uqfoundation/dill/blob/70f569b0dd268d2b1e85c0f300951b11f53c5d53/dill/_dill.py#L1429
 
-    from functools import lru_cache, _lru_cache_wrapper as LRUCacheType
+    from functools import _lru_cache_wrapper as LRUCacheType
+    from functools import lru_cache
 
     def create_lru_cache(func: Callable, kwargs: dict) -> LRUCacheType:
         return lru_cache(**kwargs)(func)
@@ -155,8 +157,8 @@ def _patch_lru_cache() -> None:
 
 def _patch_lock() -> None:
     # https://github.com/uqfoundation/dill/blob/70f569b0dd268d2b1e85c0f300951b11f53c5d53/dill/_dill.py#L1310
-    from threading import Lock
     from _thread import LockType
+    from threading import Lock
 
     def create_lock(locked: bool) -> Lock:
         lock = Lock()
@@ -199,7 +201,11 @@ def _patch_console_thread_locals() -> None:
         return ConsoleThreadLocals(**kwargs)
 
     def pickle_locals(obj: ConsoleThreadLocals) -> tuple[Callable, tuple]:
-        kwargs = {"theme_stack": obj.theme_stack, "buffer": obj.buffer, "buffer_index": obj.buffer_index}
+        kwargs = {
+            "theme_stack": obj.theme_stack,
+            "buffer": obj.buffer,
+            "buffer_index": obj.buffer_index,
+        }
         return create_locals, (kwargs, )
 
     _register(ConsoleThreadLocals, pickle_locals)

{fal-0.15.0 → fal-0.15.2}/src/fal/api.py

@@ -40,8 +40,8 @@ from pydantic import __version__ as pydantic_version
 from typing_extensions import Concatenate, ParamSpec
 
 import fal.flags as flags
-from fal.exceptions import FalServerlessException
 from fal._serialization import include_modules_from, patch_pickle
+from fal.exceptions import FalServerlessException
 from fal.logging.isolate import IsolateLogPrinter
 from fal.sdk import (
     FAL_SERVERLESS_DEFAULT_KEEP_ALIVE,
@@ -57,7 +57,7 @@ from fal.sdk import (
 )
 
 ArgsT = ParamSpec("ArgsT")
-ReturnT = TypeVar("ReturnT", covariant=True)
+ReturnT = TypeVar("ReturnT", covariant=True)  # noqa: PLC0105
 
 BasicConfig = Dict[str, Any]
 _UNSET = object()
@@ -113,8 +113,8 @@ class Host(Generic[ArgsT, ReturnT]):
         environment options."""
 
         options = Options()
-        for key, value in config.items():
-            key, value = cls.parse_key(key, value)
+        for item in config.items():
+            key, value = cls.parse_key(*item)
             if key in cls._SUPPORTED_KEYS:
                 options.host[key] = value
             elif key in cls._GATEWAY_KEYS:
@@ -545,7 +545,8 @@ _DEFAULT_HOST = FalServerlessHost()
 _SERVE_PORT = 8080
 
 # Overload @function to help users identify the correct signature.
-# NOTE: This is both in sync with host options and with environment configs from `isolate` package.
+# NOTE: This is both in sync with host options and with environment configs from
+# `isolate` package.
 
 
 ## virtualenv
@@ -785,7 +786,8 @@ class FalFastAPI(FastAPI):
         """
         Add x-fal-order-* keys to the OpenAPI specification to help the rendering of UI.
 
-        NOTE: We rely on the fact that fastapi and Python dicts keep the order of properties.
+        NOTE: We rely on the fact that fastapi and Python dicts keep the order of
+        properties.
         """
 
         def mark_order(obj: dict[str, Any], key: str):
@@ -918,7 +920,9 @@ class BaseServable:
                 asyncio.create_task(metrics_server.serve()): metrics_server,
             }
 
-            _, pending = await asyncio.wait(tasks.keys(), return_when=asyncio.FIRST_COMPLETED)
+            _, pending = await asyncio.wait(
+                tasks.keys(), return_when=asyncio.FIRST_COMPLETED,
+            )
             if not pending:
                 return
 
@@ -1007,13 +1011,15 @@ class IsolatedFunction(Generic[ArgsT, ReturnT]):
                 lines = []
                 for used_modules, references in pairs:
                     lines.append(
-                        f"\t- {used_modules!r} (accessed through {', '.join(map(repr, references))})"
+                        f"\t- {used_modules!r} "
+                        f"(accessed through {', '.join(map(repr, references))})"
                     )
 
                 function_name = self.func.__name__
                 raise FalServerlessError(
-                    f"Couldn't deserialize your function on the remote server. \n\n[Hint] {function_name!r} "
-                    f"function uses the following modules which weren't present in the environment definition:\n"
+                    f"Couldn't deserialize your function on the remote server. \n\n"
+                    f"[Hint] {function_name!r} function uses the following modules "
+                    "which weren't present in the environment definition:\n"
                     + "\n".join(lines)
                 ) from None
         except Exception as exc:
@@ -1065,7 +1071,8 @@ class IsolatedFunction(Generic[ArgsT, ReturnT]):
     def func(self) -> Callable[ArgsT, ReturnT]:
         serve_mode = self.options.gateway.get("serve")
         if serve_mode:
-            # This type can be safely ignored because this case only happens when it is a ServedIsolatedFunction
+            # This type can be safely ignored because this case only happens when it
+            # is a ServedIsolatedFunction
             serve_func: Callable[[], None] = ServeWrapper(self.raw_func)
             return serve_func  # type: ignore
         else:
@@ -1098,8 +1105,10 @@ class ServedIsolatedFunction(
 
 class Server(uvicorn.Server):
     """Server is a uvicorn.Server that actually plays nicely with signals.
-    By default, uvicorn's Server class overwrites the signal handler for SIGINT, swallowing the signal and preventing other tasks from cancelling.
-    This class allows the task to be gracefully cancelled using asyncio's built-in task cancellation or with an event, like aiohttp.
+    By default, uvicorn's Server class overwrites the signal handler for SIGINT,
+    swallowing the signal and preventing other tasks from cancelling.
+    This class allows the task to be gracefully cancelled using asyncio's built-in task
+    cancellation or with an event, like aiohttp.
     """
 
     def install_signal_handlers(self) -> None:

{fal-0.15.0 → fal-0.15.2}/src/fal/app.py

@@ -10,9 +10,11 @@ from typing import Any, Callable, ClassVar, TypeVar
 from fastapi import FastAPI
 
 import fal.api
+from fal._serialization import include_modules_from
 from fal.api import RouteSignature
 from fal.logging import get_logger
-from fal._serialization import include_modules_from
+from fal.toolkit.file.providers import fal as fal_provider_module
+
 REALTIME_APP_REQUIREMENTS = ["websockets", "msgpack"]
 
 EndpointT = TypeVar("EndpointT", bound=Callable[..., Any])
@@ -123,6 +125,22 @@ class App(fal.api.BaseServable):
                 )
             return response
 
+        @app.middleware("http")
+        async def set_global_object_preference(request, call_next):
+            response = await call_next(request)
+            try:
+                fal_provider_module.GLOBAL_LIFECYCLE_PREFERENCE = request.headers.get(
+                    "X-Fal-Object-Lifecycle-Preference"
+                )
+            except Exception:
+                from fastapi.logger import logger
+
+                logger.exception(
+                    "Failed set a global lifecycle preference %s",
+                    self.__class__.__name__,
+                )
+            return response
+
     def provide_hints(self) -> list[str]:
         """Provide hints for routing the application."""
         raise NotImplementedError
@@ -237,14 +255,16 @@ def _fal_websocket_template(
                     output = output.dict()
                 else:
                     raise TypeError(
-                        f"Expected a dict or pydantic model as output, got {type(output)}"
+                        "Expected a dict or pydantic model as output, got "
+                        f"{type(output)}"
                     )
 
             messages = [
                 msgpack.packb(output, use_bin_type=True),
             ]
             if route_signature.emit_timings:
-                # We emit x-fal messages in JSON, no matter what the input/output format is.
+                # We emit x-fal messages in JSON, no matter what the
+                # input/output format is.
                 timings = {
                     "type": "x-fal-message",
                     "action": "timings",
@@ -354,7 +374,8 @@ def realtime(
 
         if hasattr(original_func, "route_signature"):
             raise ValueError(
-                f"Can't set multiple routes for the same function: {original_func.__name__}"
+                "Can't set multiple routes for the same function: "
+                f"{original_func.__name__}"
             )
 
         if input_modal is _SENTINEL:

{fal-0.15.0 → fal-0.15.2}/src/fal/auth/__init__.py

@@ -51,7 +51,8 @@ def _fetch_access_token() -> str:
     Load the refresh token, request a new access_token (refreshing the refresh token)
     and return the access_token.
     """
-    # We need to lock both read and write access because we could be reading a soon invalid refresh_token
+    # We need to lock both read and write access because we could be reading a soon
+    # invalid refresh_token
     with local.lock_token():
         refresh_token, access_token = local.load_token()
 

{fal-0.15.0 → fal-0.15.2}/src/fal/auth/auth0.py

@@ -30,7 +30,8 @@ def _open_browser(url: str, code: str | None) -> None:
     maybe_open_browser_tab(url)
 
     console.print(
-        "If browser didn't open automatically, on your computer or mobile device navigate to"
+        "If browser didn't open automatically, "
+        "on your computer or mobile device navigate to"
     )
     console.print(url)
 
@@ -155,7 +156,8 @@ def build_jwk_client():
 
 def validate_id_token(token: str):
     """
-    id_token is intended for the client (this sdk) only. Never send one to another service.
+    id_token is intended for the client (this sdk) only.
+    Never send one to another service.
     """
     from jwt import decode
 

{fal-0.15.0 → fal-0.15.2}/src/fal/auth/local.py

@@ -62,7 +62,8 @@ def delete_token() -> None:
 @contextmanager
 def lock_token():
     """
-    Lock the access to the token file to avoid race conditions when running multiple scripts at the same time.
+    Lock the access to the token file to avoid race conditions when running multiple
+    scripts at the same time.
     """
     lock_file = _check_dir_exist() / _LOCK_FILE
     with portalocker.utils.TemporaryFileLock(

{fal-0.15.0 → fal-0.15.2}/src/fal/cli.py

@@ -89,12 +89,13 @@ class MainGroup(RichGroup):
             except Exception as exception:
                 logger.error(exception)
                 if state.debug:
-                    # Here we supress detailed errors on click lines because
-                    # they're mostly decorator calls, irrelevant to the dev's error tracing
+                    # Here we supress detailed errors on click lines because they're
+                    # mostly decorator calls, irrelevant to the dev's error tracing
                     console.print_exception(suppress=[click])
                     console.print()
                     console.print(
-                        f"The [markdown.code]invocation_id[/] for this operation is: [white]{state.invocation_id}[/]"
+                        "The [markdown.code]invocation_id[/] for this operation is: "
+                        f"[white]{state.invocation_id}[/]"
                     )
                 else:
                     self._exception_handler.handle(exception)
@@ -207,7 +208,8 @@ def key_generate(client: sdk.FalServerlessClient, scope: str, alias: str | None)
         print(
             f"Generated key id and key secret, with the scope `{scope}`.\n"
             "This is the only time the secret will be visible.\n"
-            "You will need to generate a new key pair if you lose access to this secret."
+            "You will need to generate a new key pair if you lose access to this "
+            "secret."
         )
         print(f"FAL_KEY='{result[1]}:{result[0]}'")
 
@@ -306,7 +308,8 @@ def register_application(
     gateway_options = isolated_function.options.gateway
     if "serve" not in gateway_options and "exposed_port" not in gateway_options:
         raise api.FalServerlessError(
-            "One of `serve` or `exposed_port` options needs to be specified in the isolated annotation to register a function"
+            "One of `serve` or `exposed_port` options needs to be specified "
+            "in the isolated annotation to register a function"
         )
     elif (
         "exposed_port" in gateway_options

{fal-0.15.0 → fal-0.15.2}/src/fal/exceptions/__init__.py

@@ -13,7 +13,8 @@ class ApplicationExceptionHandler:
 
     This exception handler is capable of handling, i.e. customize the output
     and add behavior, of any type of exception. Click handles all `ClickException`
-    types by default, but prints the stack for other exception not wrapped in ClickException.
+    types by default, but prints the stack for other exception not wrapped in
+    ClickException.
 
     The handler also allows for central metrics and logging collection.
     """

{fal-0.15.0 → fal-0.15.2}/src/fal/flags.py

@@ -18,8 +18,6 @@ GRPC_HOST = os.getenv("FAL_HOST", "api.alpha.fal.ai")
 if not TEST_MODE:
     assert GRPC_HOST.startswith("api"), "FAL_HOST must start with 'api'"
 
-GATEWAY_HOST = GRPC_HOST.replace("api", "gateway", 1)
-
 REST_HOST = GRPC_HOST.replace("api", "rest", 1)
 REST_SCHEME = "http" if TEST_MODE or AUTH_DISABLED else "https"
 REST_URL = f"{REST_SCHEME}://{REST_HOST}"

{fal-0.15.0 → fal-0.15.2}/src/fal/logging/isolate.py

@@ -34,10 +34,10 @@ class IsolateLogPrinter:
             timestamp = log.timestamp
         else:
             # Default value for timestamp if user has old `isolate` version.
-            # Even if the controller version is controller by us, which means that the timestamp
-            # is being sent in the gRPC message.
-            # The `isolate` version users interpret that message with is out of our control.
-            # So we need to handle this case.
+            # Even if the controller version is controller by us, which means that
+            # the timestamp is being sent in the gRPC message.
+            # The `isolate` version users interpret that message with is out of our
+            # control. So we need to handle this case.
             timestamp = datetime.now(timezone.utc)
 
         event: EventDict = {

{fal-0.15.0 → fal-0.15.2}/src/fal/sdk.py

@@ -8,17 +8,17 @@ from enum import Enum
 from typing import Any, Callable, Generic, Iterator, Literal, TypeVar
 
 import grpc
+import isolate_proto
 from isolate.connections.common import is_agent
 from isolate.logs import Log
 from isolate.server.interface import from_grpc, to_serialized_object, to_struct
+from isolate_proto.configuration import GRPC_OPTIONS
 
-import isolate_proto
 from fal import flags
 from fal._serialization import patch_pickle
 from fal.auth import USER, key_credentials
 from fal.logging import get_logger
 from fal.logging.trace import TraceContextInterceptor
-from isolate_proto.configuration import GRPC_OPTIONS
 
 ResultT = TypeVar("ResultT")
 InputT = TypeVar("InputT")
@@ -187,6 +187,16 @@ class HostedRunStatus:
     state: HostedRunState
 
 
+@dataclass
+class ApplicationInfo:
+    application_id: str
+    keep_alive: int
+    max_concurrency: int
+    max_multiplexing: int
+    active_runners: int
+    min_concurrency: int
+
+
 @dataclass
 class AliasInfo:
     alias: str
@@ -263,6 +273,20 @@ class KeyScope(enum.Enum):
             raise ValueError(f"Unknown KeyScope: {proto}")
 
 
+@from_grpc.register(isolate_proto.ApplicationInfo)
+def _from_grpc_application_info(
+    message: isolate_proto.ApplicationInfo
+) -> ApplicationInfo:
+    return ApplicationInfo(
+        application_id=message.application_id,
+        keep_alive=message.keep_alive,
+        max_concurrency=message.max_concurrency,
+        max_multiplexing=message.max_multiplexing,
+        active_runners=message.active_runners,
+        min_concurrency=message.min_concurrency,
+    )
+
+
 @from_grpc.register(isolate_proto.AliasInfo)
 def _from_grpc_alias_info(message: isolate_proto.AliasInfo) -> AliasInfo:
     if message.auth_mode is isolate_proto.ApplicationAuthMode.PUBLIC:
@@ -496,6 +520,18 @@ class FalServerlessConnection:
         )
         return from_grpc(res.alias_info)
 
+    def list_applications(self) -> list[ApplicationInfo]:
+        request = isolate_proto.ListApplicationsRequest()
+        res: isolate_proto.ListApplicationsResult = self.stub.ListApplications(request)
+        return [from_grpc(app) for app in res.applications]
+
+    def delete_application(
+        self,
+        application_id: str,
+    ) -> None:
+        request = isolate_proto.DeleteApplicationRequest(application_id=application_id)
+        self.stub.DeleteApplication(request)
+
     def run(
         self,
         function: Callable[..., ResultT],