Method _wait_for_instance

relay/server.py:527–557

Wait for a Unity instance to become ready.

(
        self,
        request_id: str,
        instance_id: str | None,
    )

        return instance.status in (InstanceStatus.RELOADING, InstanceStatus.DISCONNECTED) or not instance.is_connected

    async def _wait_for_instance(
        self,
        request_id: str,
        instance_id: str | None,
    ) -> UnityInstance | dict[str, Any]:
        """Wait for a Unity instance to become ready."""
        max_wait_ms = 15000
        poll_interval_ms = 250
        waited_ms = 0

        while waited_ms < max_wait_ms:
            result = self._get_instance_or_error(request_id, instance_id)
            if isinstance(result, dict):
                return result

            if result is None:
                if not self._should_wait_for_missing(request_id, instance_id, waited_ms):
                    return ErrorMessage.from_code(
                        request_id,
                        ErrorCode.INSTANCE_NOT_FOUND,
                        f"Instance not found: {instance_id}. Check available instances with 'u instances'.",
                    ).to_dict()
            elif not self._instance_needs_wait(result):
                break
            elif waited_ms == 0:
                logger.info(f"[{request_id}] Instance not ready ({result.status}), waiting...")

            await asyncio.sleep(poll_interval_ms / 1000)
            waited_ms += poll_interval_ms

        return self._validate_waited_instance(request_id, instance_id, waited_ms)

    def _validate_waited_instance(
        self,