Local archive
=============

Appliance-local archive control lives on ``client.archive`` and
``client.robot(...).archive``. Cloud catalog reads use
``client.platform.archive.listBags()``, ``listVideos()``, and ``listImages()``
(see :doc:`../examples/archive-catalog`).

``core.getImage`` returns the next frame in memory for processing.
``archive.captureImage`` saves a JPEG to appliance disk.
``archive.captureVideo`` records an MP4 session with ``stop()``.
``archive.recordBag`` / ``playBag`` control local rosbag recording and playback
(see :doc:`../examples/archive-bags`).

Image and video capture example:

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

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

      .. literalinclude:: ../examples/scripts/archive-recording.py
         :language: python

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

      .. literalinclude:: ../examples/scripts/archive-recording.ts
         :language: typescript

Python API
----------

.. automodule:: olo.archive
   :members:
   :show-inheritance:

TypeScript API
--------------

- :doc:`Archive </typescript/api/generated/olo/archive/classes/Archive>`
- :doc:`ArchiveHandle </typescript/api/generated/olo/archive/classes/ArchiveHandle>`
- :doc:`VideoSession </typescript/api/generated/olo/archive/classes/VideoSession>`
- :doc:`BagSession </typescript/api/generated/olo/archive/classes/BagSession>`
- :doc:`PlaybackSession </typescript/api/generated/olo/archive/classes/PlaybackSession>`

Migration from SDK v1
---------------------

- ``oloClient.videoRecording.startRecording(topic, opts)`` → ``robot.archive.captureVideo({ topic, ... })``
- ``oloClient.videoRecording.stopRecording(id)`` → ``session.stop()``
- Local rosbag recording → ``robot.archive.recordBag`` / ``playBag``