Start command and readiness

The start command runs while AgentBox builds the template. After the readiness check succeeds, AgentBox saves the process with the rest of the state. Creating a sandbox does not execute the command again: the process is already running.

setStartCmd(command, readyCommand) configures both actions. The SDK includes helpers for common checks:

• waitForURL waits for an HTTP status;
• waitForPort waits for an open port;
• waitForProcess waits for a process;
• waitForFile waits for a file;
• waitForTimeout waits for a fixed duration.

Python provides wait_for_url, wait_for_port, wait_for_process, wait_for_file, and wait_for_timeout.

If a build instruction already started the process, use setReadyCmd or set_ready_cmd without a start command.

Variables passed later to Sandbox.create do not change the saved process. Configure everything it needs during the build. Use commands.run after Sandbox.create for work that must happen once per sandbox.