Transform tree inspection
=========================

:meth:`~olo.spatial.Spatial.tree` returns a one-shot snapshot of topology and
edge poses. :meth:`~olo.spatial.Spatial.subscribe_tree` streams updates as
poses or topology changes.

By default each yield is a full :class:`~olo.spatial.FrameTree`; call
:meth:`~olo.spatial.TreeSubscription.changes` on the same subscription for raw
:class:`~olo.spatial.TreeDelta` batches (``added`` / ``updated``). The first
delta is always a snapshot, so skip it to see incremental changes. Scoped trees
omit external ancestor edges by default, so root nodes are pose-less unless
``include_ancestors=True``.

.. tab-set::
    :sync-group: sdk-language

    .. tab-item:: Python
        :sync: python

        .. literalinclude:: scripts/spatial-tree.py
           :language: python

    .. tab-item:: TypeScript
        :sync: typescript

        .. literalinclude:: scripts/spatial-tree.ts
           :language: typescript