refactor!: Remove wait argument from Actor.start

Actor.start only starts the run without waiting for it to finish, so a wait argument contradicts its purpose, and the JS SDK does not expose it either. To wait for a run to finish, use Actor.call.

Author: vdusek

docs/04_upgrading/upgrading_to_v4.md

@@ -69,9 +69,9 @@ The deprecated `latest_sdk_version`, `log_format`, and `standby_port` fields hav
 - In place of `standby_port`, use `web_server_port`.
 - `latest_sdk_version` and `log_format` don't have replacement. SDK version checking isn't supported for the Python SDK and the log format should be adjusted in code instead.
 
-## `Actor.start` — `wait_for_finish` is now `wait`
+### `wait_for_finish` argument of `Actor.start`
 
-The `wait_for_finish: int` argument of `Actor.start()` has been renamed to `wait: timedelta`, matching `Actor.call()` and `Actor.call_task()`. The behavior is unchanged: the server still waits at most the given time (capped at 300 seconds) before returning the run info.
+The `wait_for_finish` argument of `Actor.start()` has been removed. It contradicted the purpose of `Actor.start()`, which only starts the run without waiting for it to finish. The JS SDK does not expose it on `Actor.start()` either. To wait for a run to finish, use `Actor.call()`.
 
 ```python
 from datetime import timedelta
@@ -80,7 +80,7 @@ from datetime import timedelta
 run = await Actor.start('my-actor-id', wait_for_finish=60)
 
 # After (v4)
-run = await Actor.start('my-actor-id', wait=timedelta(seconds=60))
+run = await Actor.call('my-actor-id', wait=timedelta(seconds=60))
 ```
 
 ## Built on `apify-client` v3

src/apify/_actor.py

@@ -890,11 +890,11 @@ async def start(
         timeout: timedelta | None | Literal['inherit'] = None,
         force_permission_level: ActorPermissionLevel | None = None,
         webhooks: list[Webhook] | None = None,
-        wait: timedelta | None = None,
     ) -> Run:
         """Run an Actor on the Apify platform.
 
-        Unlike `Actor.call`, this method just starts the run without waiting for finish.
+        Unlike `Actor.call`, this method just starts the run without waiting for finish. To wait for the run to
+        finish, use `Actor.call` instead.
 
         Args:
             actor_id: The ID of the Actor to be run.
@@ -916,8 +916,6 @@ async def start(
             webhooks: Optional ad-hoc webhooks (https://docs.apify.com/webhooks/ad-hoc-webhooks) associated with
                 the Actor run which can be used to receive a notification, e.g. when the Actor finished or failed.
                 If you already have a webhook set up for the Actor or task, you do not have to add it again here.
-            wait: The maximum time the server waits for the run to finish. By default, it does not wait at all.
-                The maximum value is 300 seconds.
 
         Returns:
             Info about the started Actor run
@@ -943,7 +941,6 @@ async def start(
             memory_mbytes=memory_mbytes,
             run_timeout=actor_start_timeout,
             force_permission_level=force_permission_level,
-            wait_for_finish=int(wait.total_seconds()) if wait is not None else None,
             webhooks=to_client_representations(webhooks),
         )