fal 1.50.2__tar.gz → 1.59.0__tar.gz

{fal-1.50.2/fal.egg-info → fal-1.59.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: fal
-Version: 1.50.2
+Version: 1.59.0
 Summary: fal is an easy-to-use Serverless Python Framework
 Author: Features & Labels <support@fal.ai>
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
-Requires-Dist: isolate[build]<0.21.0,>=0.18.0
-Requires-Dist: isolate-proto<0.23.0,>=0.22.0
+Requires-Dist: isolate[build]<0.22.0,>=0.18.0
+Requires-Dist: isolate-proto>=0.29.2
 Requires-Dist: grpcio<2,>=1.64.0
 Requires-Dist: dill==0.3.7
 Requires-Dist: cloudpickle==3.0.0
@@ -21,8 +21,8 @@ Requires-Dist: rich<15,>=13.3.2
 Requires-Dist: rich_argparse
 Requires-Dist: packaging>=21.3
 Requires-Dist: pathspec<1,>=0.11.1
-Requires-Dist: pydantic!=2.0.*,!=2.1.*,!=2.2.*,!=2.3.*,!=2.4.*,<2.11
-Requires-Dist: fastapi<1,>=0.99.1
+Requires-Dist: pydantic!=2.0.*,!=2.1.*,!=2.2.*,!=2.3.*,!=2.4.*
+Requires-Dist: fastapi<0.119,>=0.99.1
 Requires-Dist: starlette-exporter>=0.21.0
 Requires-Dist: httpx>=0.15.4
 Requires-Dist: httpx-sse
@@ -60,7 +60,7 @@ Requires-Dist: fal[docs,test]; extra == "dev"
 Requires-Dist: openapi-python-client<1,>=0.14.1; extra == "dev"
 
 [![PyPI](https://img.shields.io/pypi/v/fal.svg?logo=PyPI)](https://pypi.org/project/fal)
-[![Tests](https://img.shields.io/github/actions/workflow/status/fal-ai/fal/integration_tests.yaml?label=Tests)](https://github.com/fal-ai/fal/actions)
+[![Tests](https://img.shields.io/github/actions/workflow/status/fal-ai/fal/fal-unit-tests.yml?label=Tests)](https://github.com/fal-ai/fal/actions)
 
 # fal
 

{fal-1.50.2 → fal-1.59.0}/README.md

@@ -1,5 +1,5 @@
 [![PyPI](https://img.shields.io/pypi/v/fal.svg?logo=PyPI)](https://pypi.org/project/fal)
-[![Tests](https://img.shields.io/github/actions/workflow/status/fal-ai/fal/integration_tests.yaml?label=Tests)](https://github.com/fal-ai/fal/actions)
+[![Tests](https://img.shields.io/github/actions/workflow/status/fal-ai/fal/fal-unit-tests.yml?label=Tests)](https://github.com/fal-ai/fal/actions)
 
 # fal
 

{fal-1.50.2 → fal-1.59.0/fal.egg-info}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: fal
-Version: 1.50.2
+Version: 1.59.0
 Summary: fal is an easy-to-use Serverless Python Framework
 Author: Features & Labels <support@fal.ai>
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
-Requires-Dist: isolate[build]<0.21.0,>=0.18.0
-Requires-Dist: isolate-proto<0.23.0,>=0.22.0
+Requires-Dist: isolate[build]<0.22.0,>=0.18.0
+Requires-Dist: isolate-proto>=0.29.2
 Requires-Dist: grpcio<2,>=1.64.0
 Requires-Dist: dill==0.3.7
 Requires-Dist: cloudpickle==3.0.0
@@ -21,8 +21,8 @@ Requires-Dist: rich<15,>=13.3.2
 Requires-Dist: rich_argparse
 Requires-Dist: packaging>=21.3
 Requires-Dist: pathspec<1,>=0.11.1
-Requires-Dist: pydantic!=2.0.*,!=2.1.*,!=2.2.*,!=2.3.*,!=2.4.*,<2.11
-Requires-Dist: fastapi<1,>=0.99.1
+Requires-Dist: pydantic!=2.0.*,!=2.1.*,!=2.2.*,!=2.3.*,!=2.4.*
+Requires-Dist: fastapi<0.119,>=0.99.1
 Requires-Dist: starlette-exporter>=0.21.0
 Requires-Dist: httpx>=0.15.4
 Requires-Dist: httpx-sse
@@ -60,7 +60,7 @@ Requires-Dist: fal[docs,test]; extra == "dev"
 Requires-Dist: openapi-python-client<1,>=0.14.1; extra == "dev"
 
 [![PyPI](https://img.shields.io/pypi/v/fal.svg?logo=PyPI)](https://pypi.org/project/fal)
-[![Tests](https://img.shields.io/github/actions/workflow/status/fal-ai/fal/integration_tests.yaml?label=Tests)](https://github.com/fal-ai/fal/actions)
+[![Tests](https://img.shields.io/github/actions/workflow/status/fal-ai/fal/fal-unit-tests.yml?label=Tests)](https://github.com/fal-ai/fal/actions)
 
 # fal
 

{fal-1.50.2 → fal-1.59.0}/fal.egg-info/SOURCES.txt

@@ -90,7 +90,6 @@ src/fal/files.py
 src/fal/flags.py
 src/fal/project.py
 src/fal/py.typed
-src/fal/rest_client.py
 src/fal/sdk.py
 src/fal/sync.py
 src/fal/utils.py
@@ -100,7 +99,9 @@ src/fal/api/api.py
 src/fal/api/apps.py
 src/fal/api/client.py
 src/fal/api/deploy.py
+src/fal/api/keys.py
 src/fal/api/runners.py
+src/fal/api/secrets.py
 src/fal/auth/__init__.py
 src/fal/auth/auth0.py
 src/fal/auth/local.py
@@ -139,6 +140,7 @@ src/fal/logging/isolate.py
 src/fal/logging/style.py
 src/fal/logging/trace.py
 src/fal/toolkit/__init__.py
+src/fal/toolkit/compilation.py
 src/fal/toolkit/exceptions.py
 src/fal/toolkit/kv.py
 src/fal/toolkit/optimize.py
@@ -169,31 +171,29 @@ src/fal/toolkit/video/__init__.py
 src/fal/toolkit/video/video.py
 tests/__init__.py
 tests/conftest.py
-tests/integration_test.py
-tests/mainify_target.py
-tests/test_apps.py
-tests/test_file_sync.py
-tests/test_files.py
-tests/test_kv.py
-tests/test_stability.py
 tests/assets/cat.png
-tests/cli/__init__.py
-tests/cli/test_apps.py
-tests/cli/test_auth.py
-tests/cli/test_deploy.py
-tests/cli/test_keys.py
-tests/cli/test_run.py
-tests/cli/test_secrets.py
-tests/mainify_package/__init__.py
-tests/mainify_package/impl.py
-tests/mainify_package/utils.py
-tests/toolkit/file_test.py
-tests/toolkit/image_test.py
-tests/toolkit/test_types.py
-tests/toolkit/file/providers/test_fal_retry.py
-tests/toolkit/utils/retry.py
+tests/e2e/test_apps.py
+tests/integration/test.py
+tests/integration/test_files.py
+tests/integration/test_stability.py
+tests/integration/toolkit/test_image.py
+tests/integration/toolkit/test_kv.py
 tests/unit/test_app.py
+tests/unit/test_file_sync.py
+tests/unit/test_utils.py
+tests/unit/cli/__init__.py
+tests/unit/cli/test_apps.py
+tests/unit/cli/test_auth.py
+tests/unit/cli/test_deploy.py
+tests/unit/cli/test_keys.py
+tests/unit/cli/test_run.py
+tests/unit/cli/test_secrets.py
+tests/unit/distributed/__init__.py
 tests/unit/distributed/test_integration.py
 tests/unit/distributed/test_utils.py
 tests/unit/distributed/test_worker.py
+tests/unit/toolkit/test_file.py
+tests/unit/toolkit/test_types.py
+tests/unit/toolkit/file/providers/test_fal_retry.py
+tests/unit/toolkit/utils/test_retry.py
 tools/demo_script.py

{fal-1.50.2 → fal-1.59.0}/fal.egg-info/requires.txt

@@ -1,5 +1,5 @@
-isolate[build]<0.21.0,>=0.18.0
-isolate-proto<0.23.0,>=0.22.0
+isolate[build]<0.22.0,>=0.18.0
+isolate-proto>=0.29.2
 grpcio<2,>=1.64.0
 dill==0.3.7
 cloudpickle==3.0.0
@@ -14,8 +14,8 @@ rich<15,>=13.3.2
 rich_argparse
 packaging>=21.3
 pathspec<1,>=0.11.1
-pydantic!=2.0.*,!=2.1.*,!=2.2.*,!=2.3.*,!=2.4.*,<2.11
-fastapi<1,>=0.99.1
+pydantic!=2.0.*,!=2.1.*,!=2.2.*,!=2.3.*,!=2.4.*
+fastapi<0.119,>=0.99.1
 starlette-exporter>=0.21.0
 httpx>=0.15.4
 httpx-sse

{fal-1.50.2 → fal-1.59.0}/pyproject.toml

@@ -22,8 +22,8 @@ authors = [{ name = "Features & Labels <support@fal.ai>"}]
 readme = "README.md"
 requires-python = ">=3.8"
 dependencies = [
-    "isolate[build]>=0.18.0,<0.21.0",
-    "isolate-proto>=0.22.0,<0.23.0",
+    "isolate[build]>=0.18.0,<0.22.0",
+    "isolate-proto>=0.29.2",
     "grpcio>=1.64.0,<2",
     "dill==0.3.7",
     "cloudpickle==3.0.0",
@@ -38,9 +38,10 @@ dependencies = [
     "rich_argparse",
     "packaging>=21.3",
     "pathspec>=0.11.1,<1",
-    "pydantic!=2.0.*,!=2.1.*,!=2.2.*,!=2.3.*,!=2.4.*,<2.11",
+    "pydantic!=2.0.*,!=2.1.*,!=2.2.*,!=2.3.*,!=2.4.*",
     # serve=True dependencies
-    "fastapi>=0.99.1,<1",
+    # https://github.com/fastapi/fastapi/issues/14221
+    "fastapi>=0.99.1,<0.119",
     "starlette-exporter>=0.21.0",
     # rest-api-client dependencies
     "httpx>=0.15.4",

{fal-1.50.2 → fal-1.59.0}/src/fal/__init__.py

@@ -5,7 +5,7 @@ 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.container import ContainerImage
-from fal.sdk import FalServerlessKeyCredentials
+from fal.sdk import FalServerlessKeyCredentials, HealthCheck
 from fal.sync import sync_dir
 
 from ._version import __version__, version_tuple  # noqa: F401
@@ -23,6 +23,7 @@ __all__ = [
     "endpoint",
     "realtime",
     # "wrap_app",
+    "HealthCheck",
     "FalServerlessKeyCredentials",
     "sync_dir",
     "__version__",

{fal-1.50.2 → fal-1.59.0}/src/fal/_fal_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '1.50.2'
-__version_tuple__ = version_tuple = (1, 50, 2)
+__version__ = version = '1.59.0'
+__version_tuple__ = version_tuple = (1, 59, 0)
 
 __commit_id__ = commit_id = None

{fal-1.50.2 → fal-1.59.0}/src/fal/api/api.py

@@ -66,8 +66,10 @@ from fal.sdk import (
     FalServerlessClient,
     FalServerlessConnection,
     File,
+    HealthCheck,
     HostedRunState,
     MachineRequirements,
+    RegisterApplicationResult,
     get_agent_credentials,
     get_default_credentials,
 )
@@ -84,6 +86,7 @@ _UNSET = object()
 SERVE_REQUIREMENTS = [
     f"fastapi=={fastapi_version}",
     f"pydantic=={pydantic_version}",
+    f"tblib=={tblib.__version__}",
     "uvicorn",
     "starlette_exporter",
     # workaround for prometheus_client 0.23.0
@@ -426,12 +429,14 @@ class FalServerlessHost(Host):
         {
             "machine_type",
             "machine_types",
+            "regions",
             "num_gpus",
             "keep_alive",
             "max_concurrency",
             "min_concurrency",
             "concurrency_buffer",
             "concurrency_buffer_perc",
+            "scaling_delay",
             "max_multiplexing",
             "setup_function",
             "metadata",
@@ -444,6 +449,7 @@ class FalServerlessHost(Host):
             "app_files",
             "app_files_ignore",
             "app_files_context_dir",
+            "health_check_config",
         }
     )
 
@@ -518,7 +524,7 @@ class FalServerlessHost(Host):
         metadata: Optional[dict[str, Any]] = None,
         deployment_strategy: DeploymentStrategyLiteral,
         scale: bool = True,
-    ) -> Optional[str]:
+    ) -> Optional[RegisterApplicationResult]:
         from isolate.backends.common import active_python
 
         environment_options = options.environment.copy()
@@ -536,10 +542,12 @@ class FalServerlessHost(Host):
         min_concurrency = options.host.get("min_concurrency")
         concurrency_buffer = options.host.get("concurrency_buffer")
         concurrency_buffer_perc = options.host.get("concurrency_buffer_perc")
+        scaling_delay = options.host.get("scaling_delay")
         max_multiplexing = options.host.get("max_multiplexing")
         exposed_port = options.get_exposed_port()
         request_timeout = options.host.get("request_timeout")
         startup_timeout = options.host.get("startup_timeout")
+        regions = options.host.get("regions")
         machine_requirements = MachineRequirements(
             machine_types=machine_type,  # type: ignore
             num_gpus=options.host.get("num_gpus"),
@@ -553,10 +561,14 @@ class FalServerlessHost(Host):
             min_concurrency=min_concurrency,
             concurrency_buffer=concurrency_buffer,
             concurrency_buffer_perc=concurrency_buffer_perc,
+            scaling_delay=scaling_delay,
             request_timeout=request_timeout,
             startup_timeout=startup_timeout,
+            valid_regions=regions,
         )
 
+        health_check_config = options.host.get("health_check_config")
+
         app_files = self._app_files_sync(options)
 
         partial_func = _prepare_partial_func(func)
@@ -580,6 +592,7 @@ class FalServerlessHost(Host):
             metadata=metadata,
             deployment_strategy=deployment_strategy,
             scale=scale,
+            health_check_config=health_check_config,
             # By default, logs are public
             private_logs=options.host.get("private_logs", False),
             files=app_files,
@@ -588,7 +601,7 @@ class FalServerlessHost(Host):
                 self._log_printer.print(log)
 
             if partial_result.result:
-                return partial_result.result.application_id
+                return partial_result
 
         return None
 
@@ -615,6 +628,7 @@ class FalServerlessHost(Host):
         min_concurrency = options.host.get("min_concurrency")
         concurrency_buffer = options.host.get("concurrency_buffer")
         concurrency_buffer_perc = options.host.get("concurrency_buffer_perc")
+        scaling_delay = options.host.get("scaling_delay")
         max_multiplexing = options.host.get("max_multiplexing")
         base_image = options.host.get("_base_image", None)
         scheduler = options.host.get("_scheduler", None)
@@ -636,6 +650,7 @@ class FalServerlessHost(Host):
             min_concurrency=min_concurrency,
             concurrency_buffer=concurrency_buffer,
             concurrency_buffer_perc=concurrency_buffer_perc,
+            scaling_delay=scaling_delay,
             request_timeout=request_timeout,
             startup_timeout=startup_timeout,
         )
@@ -824,12 +839,14 @@ def function(
     # FalServerlessHost options
     metadata: dict[str, Any] | None = None,
     machine_type: str | list[str] = FAL_SERVERLESS_DEFAULT_MACHINE_TYPE,
+    regions: list[str] | None = None,
     num_gpus: int | None = None,
     keep_alive: int = FAL_SERVERLESS_DEFAULT_KEEP_ALIVE,
     max_multiplexing: int = FAL_SERVERLESS_DEFAULT_MAX_MULTIPLEXING,
     min_concurrency: int = FAL_SERVERLESS_DEFAULT_MIN_CONCURRENCY,
     concurrency_buffer: int = FAL_SERVERLESS_DEFAULT_CONCURRENCY_BUFFER,
     concurrency_buffer_perc: int = FAL_SERVERLESS_DEFAULT_CONCURRENCY_BUFFER_PERC,
+    scaling_delay: int | None = None,
     request_timeout: int | None = None,
     startup_timeout: int | None = None,
     setup_function: Callable[..., None] | None = None,
@@ -855,12 +872,14 @@ def function(
     # FalServerlessHost options
     metadata: dict[str, Any] | None = None,
     machine_type: str | list[str] = FAL_SERVERLESS_DEFAULT_MACHINE_TYPE,
+    regions: list[str] | None = None,
     num_gpus: int | None = None,
     keep_alive: int = FAL_SERVERLESS_DEFAULT_KEEP_ALIVE,
     max_multiplexing: int = FAL_SERVERLESS_DEFAULT_MAX_MULTIPLEXING,
     min_concurrency: int = FAL_SERVERLESS_DEFAULT_MIN_CONCURRENCY,
     concurrency_buffer: int = FAL_SERVERLESS_DEFAULT_CONCURRENCY_BUFFER,
     concurrency_buffer_perc: int = FAL_SERVERLESS_DEFAULT_CONCURRENCY_BUFFER_PERC,
+    scaling_delay: int | None = None,
     request_timeout: int | None = None,
     startup_timeout: int | None = None,
     setup_function: Callable[..., None] | None = None,
@@ -938,12 +957,14 @@ def function(
     # FalServerlessHost options
     metadata: dict[str, Any] | None = None,
     machine_type: str | list[str] = FAL_SERVERLESS_DEFAULT_MACHINE_TYPE,
+    regions: list[str] | None = None,
     num_gpus: int | None = None,
     keep_alive: int = FAL_SERVERLESS_DEFAULT_KEEP_ALIVE,
     max_multiplexing: int = FAL_SERVERLESS_DEFAULT_MAX_MULTIPLEXING,
     min_concurrency: int = FAL_SERVERLESS_DEFAULT_MIN_CONCURRENCY,
     concurrency_buffer: int = FAL_SERVERLESS_DEFAULT_CONCURRENCY_BUFFER,
     concurrency_buffer_perc: int = FAL_SERVERLESS_DEFAULT_CONCURRENCY_BUFFER_PERC,
+    scaling_delay: int | None = None,
     request_timeout: int | None = None,
     startup_timeout: int | None = None,
     setup_function: Callable[..., None] | None = None,
@@ -974,12 +995,14 @@ def function(
     # FalServerlessHost options
     metadata: dict[str, Any] | None = None,
     machine_type: str | list[str] = FAL_SERVERLESS_DEFAULT_MACHINE_TYPE,
+    regions: list[str] | None = None,
     num_gpus: int | None = None,
     keep_alive: int = FAL_SERVERLESS_DEFAULT_KEEP_ALIVE,
     max_multiplexing: int = FAL_SERVERLESS_DEFAULT_MAX_MULTIPLEXING,
     min_concurrency: int = FAL_SERVERLESS_DEFAULT_MIN_CONCURRENCY,
     concurrency_buffer: int = FAL_SERVERLESS_DEFAULT_CONCURRENCY_BUFFER,
     concurrency_buffer_perc: int = FAL_SERVERLESS_DEFAULT_CONCURRENCY_BUFFER_PERC,
+    scaling_delay: int | None = None,
     request_timeout: int | None = None,
     startup_timeout: int | None = None,
     setup_function: Callable[..., None] | None = None,
@@ -1004,12 +1027,14 @@ def function(
     # FalServerlessHost options
     metadata: dict[str, Any] | None = None,
     machine_type: str | list[str] = FAL_SERVERLESS_DEFAULT_MACHINE_TYPE,
+    regions: list[str] | None = None,
     num_gpus: int | None = None,
     keep_alive: int = FAL_SERVERLESS_DEFAULT_KEEP_ALIVE,
     max_multiplexing: int = FAL_SERVERLESS_DEFAULT_MAX_MULTIPLEXING,
     min_concurrency: int = FAL_SERVERLESS_DEFAULT_MIN_CONCURRENCY,
     concurrency_buffer: int = FAL_SERVERLESS_DEFAULT_CONCURRENCY_BUFFER,
     concurrency_buffer_perc: int = FAL_SERVERLESS_DEFAULT_CONCURRENCY_BUFFER_PERC,
+    scaling_delay: int | None = None,
     request_timeout: int | None = None,
     startup_timeout: int | None = None,
     setup_function: Callable[..., None] | None = None,
@@ -1034,12 +1059,14 @@ def function(
     # FalServerlessHost options
     metadata: dict[str, Any] | None = None,
     machine_type: str | list[str] = FAL_SERVERLESS_DEFAULT_MACHINE_TYPE,
+    regions: list[str] | None = None,
     num_gpus: int | None = None,
     keep_alive: int = FAL_SERVERLESS_DEFAULT_KEEP_ALIVE,
     max_multiplexing: int = FAL_SERVERLESS_DEFAULT_MAX_MULTIPLEXING,
     min_concurrency: int = FAL_SERVERLESS_DEFAULT_MIN_CONCURRENCY,
     concurrency_buffer: int = FAL_SERVERLESS_DEFAULT_CONCURRENCY_BUFFER,
     concurrency_buffer_perc: int = FAL_SERVERLESS_DEFAULT_CONCURRENCY_BUFFER_PERC,
+    scaling_delay: int | None = None,
     request_timeout: int | None = None,
     startup_timeout: int | None = None,
     setup_function: Callable[..., None] | None = None,
@@ -1065,6 +1092,9 @@ def function(  # type: ignore
     if config.get("image"):
         kind = "container"
 
+    if kind == "container" and config.get("app_files"):
+        raise ValueError("app_files is not supported for container apps.")
+
     options = host.parse_options(kind=kind, **config)
 
     def wrapper(func: Callable[ArgsT, ReturnT]):
@@ -1141,6 +1171,7 @@ class FalFastAPI(FastAPI):
 class RouteSignature(NamedTuple):
     path: str
     is_websocket: bool = False
+    health_check: HealthCheck | None = None
     input_modal: type | None = None
     buffering: int | None = None
     session_timeout: float | None = None

{fal-1.50.2 → fal-1.59.0}/src/fal/api/apps.py

@@ -34,7 +34,14 @@ def apps_runners(
 
     if state and "all" not in set(state):
         states = set(state)
-        alias_runners = [r for r in alias_runners if r.state.value in states]
+        alias_runners = [
+            r
+            for r in alias_runners
+            if r.state.value.lower() in states
+            or (
+                "terminated" in states and r.state.value.lower() == "dead"
+            )  # TODO for backwards compatibility. remove later
+        ]
     return alias_runners
 
 
@@ -48,6 +55,7 @@ def scale_app(
     min_concurrency: int | None = None,
     concurrency_buffer: int | None = None,
     concurrency_buffer_perc: int | None = None,
+    scaling_delay: int | None = None,
     request_timeout: int | None = None,
     startup_timeout: int | None = None,
     machine_types: list[str] | None = None,
@@ -62,8 +70,22 @@ def scale_app(
             min_concurrency=min_concurrency,
             concurrency_buffer=concurrency_buffer,
             concurrency_buffer_perc=concurrency_buffer_perc,
+            scaling_delay=scaling_delay,
             request_timeout=request_timeout,
             startup_timeout=startup_timeout,
             machine_types=machine_types,
             valid_regions=regions,
         )
+
+
+def rollout_app(
+    client: SyncServerlessClient,
+    app_name: str,
+    *,
+    force: bool = False,
+) -> None:
+    with FalServerlessClient(client._grpc_host, client._credentials).connect() as conn:
+        conn.rollout_application(
+            application_name=app_name,
+            force=force,
+        )

{fal-1.50.2 → fal-1.59.0}/src/fal/api/client.py

@@ -2,18 +2,26 @@ from __future__ import annotations
 
 import os
 from dataclasses import dataclass
-from typing import List, Optional
+from typing import TYPE_CHECKING, List, Optional
 
 from fal.api import FAL_SERVERLESS_DEFAULT_URL, FalServerlessHost
 from fal.sdk import (
     AliasInfo,
     Credentials,
+    KeyScope,
     RunnerInfo,
+    ServerlessSecret,
+    UserKeyInfo,
 )
 
+if TYPE_CHECKING:
+    from openapi_fal_rest.client import Client
+
 from . import apps as apps_api
 from . import deploy as deploy_api
+from . import keys as keys_api
 from . import runners as runners_api
+from . import secrets as secrets_api
 
 
 class _AppsNamespace:
@@ -38,6 +46,7 @@ class _AppsNamespace:
         min_concurrency: int | None = None,
         concurrency_buffer: int | None = None,
         concurrency_buffer_perc: int | None = None,
+        scaling_delay: int | None = None,
         request_timeout: int | None = None,
         startup_timeout: int | None = None,
         machine_types: List[str] | None = None,
@@ -52,12 +61,16 @@ class _AppsNamespace:
             min_concurrency=min_concurrency,
             concurrency_buffer=concurrency_buffer,
             concurrency_buffer_perc=concurrency_buffer_perc,
+            scaling_delay=scaling_delay,
             request_timeout=request_timeout,
             startup_timeout=startup_timeout,
             machine_types=machine_types,
             regions=regions,
         )
 
+    def rollout(self, app_name: str, *, force: bool = False) -> None:
+        return apps_api.rollout_app(self.client, app_name, force=force)
+
 
 class _RunnersNamespace:
     def __init__(self, client: SyncServerlessClient):
@@ -73,6 +86,36 @@ class _RunnersNamespace:
         return runners_api.kill_runner(self.client, runner_id)
 
 
+class _KeysNamespace:
+    def __init__(self, client: SyncServerlessClient):
+        self.client = client
+
+    def create(
+        self, *, scope: KeyScope, description: str | None = None
+    ) -> tuple[str, str]:
+        return keys_api.create_key(self.client, scope=scope, description=description)
+
+    def list(self) -> List[UserKeyInfo]:
+        return keys_api.list_keys(self.client)
+
+    def revoke(self, key_id: str) -> None:
+        return keys_api.revoke_key(self.client, key_id)
+
+
+class _SecretsNamespace:
+    def __init__(self, client: SyncServerlessClient):
+        self.client = client
+
+    def set(self, name: str, value: str) -> None:
+        return secrets_api.set_secret(self.client, name, value)
+
+    def list(self) -> List[ServerlessSecret]:
+        return secrets_api.list_secrets(self.client)
+
+    def unset(self, name: str) -> None:
+        return secrets_api.unset_secret(self.client, name)
+
+
 @dataclass
 class SyncServerlessClient:
     host: Optional[str] = None
@@ -83,6 +126,8 @@ class SyncServerlessClient:
     def __post_init__(self) -> None:
         self.apps = _AppsNamespace(self)
         self.runners = _RunnersNamespace(self)
+        self.keys = _KeysNamespace(self)
+        self.secrets = _SecretsNamespace(self)
 
     # Top-level verbs
     def deploy(self, *args, **kwargs):
@@ -93,6 +138,12 @@ class SyncServerlessClient:
     def _grpc_host(self) -> str:
         return self.host or FAL_SERVERLESS_DEFAULT_URL
 
+    @property
+    def _rest_url(self) -> str:
+        from fal.flags import REST_SCHEME
+
+        return f"{REST_SCHEME}://{self._grpc_host.replace('api', 'rest', 1)}"
+
     @property
     def _credentials(self) -> Credentials:
         from fal.sdk import FalServerlessKeyCredentials, get_default_credentials
@@ -127,3 +178,17 @@ class SyncServerlessClient:
             local_file_path=local_file_path,
             credentials=self._credentials,
         )
+
+    def _create_rest_client(self) -> Client:
+        from openapi_fal_rest.client import Client
+
+        import fal.flags as flags
+
+        return Client(
+            self._rest_url,
+            headers=self._credentials.to_headers(),
+            timeout=30,
+            verify_ssl=not flags.TEST_MODE,
+            raise_on_unexpected_status=False,
+            follow_redirects=True,
+        )