Tell Apollo to prepare documentation before the user sends a message

Summary

Add a call to Apollo to prepare adaptor documentation when the user opens the job code assistant.

The issue

Apollo can now fetch adaptor version-specific documentation efficiently during a conversation. However, we will not process documentation for all old versions of adaptors by default into the Apollo database. To avoid repeated checks and triggers for the upload process, we would like to trigger the upload process before the user sends their first message.

Implementation

When the user opens the chat, Lightning should call Apollo's upload_adaptor_docs service, with a payload like this:

{
  "adaptor": "@openfn/language-kobotoolbox",
  "version": "4.2.7"
}

This will check if the documentation is already in the Apollo database. If it is not, it will check if it is available for download and then process it into the database.

UI

When the chat opens, the user will see a status message like "Preparing documentation databases..." before they can start a conversation.

Start by locating the chat-open flow and the existing Apollo integration in Lightning. Trace how the adaptor name and version are available, then verify that opening chat triggers upload_adaptor_docs with the specified payload and shows the preparation status before messaging is enabled.