Method _get_instance_or_error

relay/server.py:508–522

Resolve instance; returns instance, None (not found), or error dict (ambiguous).

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

        )

    def _get_instance_or_error(
        self,
        request_id: str,
        instance_id: str | None,
    ) -> UnityInstance | None | dict[str, Any]:
        """Resolve instance; returns instance, None (not found), or error dict (ambiguous)."""
        try:
            instance = self.registry.get_instance_for_request(instance_id)
        except AmbiguousInstanceError as e:
            return ErrorMessage.from_code(
                request_id,
                ErrorCode.AMBIGUOUS_INSTANCE,
                str(e),
            ).to_dict()
        return instance

    def _instance_needs_wait(self, instance: UnityInstance) -> bool:
        return instance.status in (InstanceStatus.RELOADING, InstanceStatus.DISCONNECTED) or not instance.is_connected