examples(teleop_session_manager): package under isaacteleop_examples

teleop_controls_simple_example.py imported its helper as a top-level module,
which resolved only because the invoked script's own directory landed on
sys.path -- so it broke under `python -m`, broke when copied into another
project, and claimed the bare name `teleop_controls_simple_helper`. Move the
tree to the layout in examples/README.md.

The four demos here are co-equal, so there is no __main__.py to pick: each is
its own submodule and the README lists them. Inventing a default would have
made one of the four look privileged.

The README moves up beside the pyproject and now documents all four, rather
than only teleop_session_example.

Part of #985.

Signed-off-by: Jiwen Cai <jiwenc@nvidia.com>

Author: jiwenc-nv

docs/source/getting_started/teleop_control_state_machine.rst

@@ -69,7 +69,7 @@ Connecting Inputs
 -----------------
 
 Use one debounced selector per signal (simple wiring, no multi-input lambdas):
-see :code-file:`teleop_controls_simple_example.py <examples/teleop_session_manager/python/teleop_controls_simple_example.py>`
+see :code-file:`teleop_controls_simple_example.py <examples/teleop_session_manager/python/isaacteleop_examples/teleop_session_manager/teleop_controls_simple_example.py>`
 for the full runnable setup.
 
 .. code-block:: python

examples/teleop_session_manager/CMakeLists.txt

@@ -1,7 +1,7 @@
-# SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
 cmake_minimum_required(VERSION 3.20)
 
 include(${CMAKE_SOURCE_DIR}/cmake/InstallPythonExample.cmake)
-install_python_example(DESTINATION examples/teleop_session_manager/python)
+install_python_example(DESTINATION examples/teleop_session_manager)

examples/teleop_session_manager/README.md

@@ -0,0 +1,26 @@
+<!--
+SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+SPDX-License-Identifier: Apache-2.0
+-->
+
+# TeleopSessionManager examples
+
+Four standalone demos of the `TeleopSession` API. Install once, then run
+whichever one you want:
+
+```bash
+uv pip install -e ./examples/teleop_session_manager
+python -m isaacteleop_examples.teleop_session_manager.teleop_session_example
+```
+
+| Module | What it shows |
+| --- | --- |
+| `teleop_session_example` | Velocity from hand-wrist and controller motion, driven by `session.step()` with the synthetic hands plugin |
+| `teleop_controls_simple_example` | The simplified controls helper, with the state machine in `teleop_controls_simple_helper` |
+| `external_inputs_example` | Feeding a session from an input source outside DeviceIO |
+| `message_channel_example` | Sending and receiving on a session message channel |
+
+## See also
+
+- Module docs: `docs/source/references/teleop_session.rst`
+- Retargeting engine: `src/core/retargeting_engine/`

examples/teleop_session_manager/pyproject.toml

@@ -0,0 +1,26 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+# The dist name mirrors the import path, so an installed example claims no bare
+# top-level name in site-packages.
+name = "isaacteleop-examples-teleop-session-manager"
+version = "0.0.0"  # Internal examples - not versioned
+description = "TeleopUtils Python Examples"
+requires-python = ">=3.11,<3.14"
+dependencies = [
+    "isaacteleop[ui]",
+    "numpy>=1.23.0",
+]
+
+# `isaacteleop_examples` is a PEP 420 namespace shared by every example dist and
+# must stay without an __init__.py. `only-include` + `sources`, not `packages`:
+# the latter keeps only the last path component and would root the wheel at a
+# bare top-level `teleop_session_manager/`.
+[tool.hatch.build.targets.wheel]
+only-include = ["python/isaacteleop_examples/teleop_session_manager"]
+sources = ["python"]

examples/teleop_session_manager/python/README.md

@@ -0,0 +1,2 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0

examples/teleop_session_manager/python/isaacteleop_examples/teleop_session_manager/__init__.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
 """

…anager/python/external_inputs_example.py …ssion_manager/external_inputs_example.pyexamples/teleop_session_manager/python/external_inputs_example.py renamed to examples/teleop_session_manager/python/isaacteleop_examples/teleop_session_manager/external_inputs_example.py examples/teleop_session_manager/python/external_inputs_example.py renamed to examples/teleop_session_manager/python/isaacteleop_examples/teleop_session_manager/external_inputs_example.py

@@ -38,7 +38,7 @@
     DefaultTeleopStateManager,
 )
 
-from teleop_controls_simple_helper import (
+from .teleop_controls_simple_helper import (
     build_observation_pipeline,
     print_frame,
     print_header,