Интеграция в приложение

Как встроить F1 в собственное приложение: границы, порядок вызовов и рекомендуемый контур.

Desktop

Рекомендуемый вариант — дочерний процесс на окно или контролируемую группу книг. Держите stdin/stdout открытыми, сопоставляйте один запрос одному ответу, логируйте operation и code без содержимого ячеек.

Server

Оборачивайте CLI внутренним service host. На запрос загрузки создавайте изолированный рабочий каталог, запускайте процесс с лимитами памяти/времени, выдавайте собственный внешний session token и никогда не раскрывайте клиенту локальный subsetId как долгоживущий идентификатор.

Web

Браузер напрямую не запускает compute_contract_cli. Web UI вызывает ваш backend API или отдельный утверждённый WASM adapter. В проверенной desktop-сборке документирован и реально испытан native CLI; наличие публичного browser SDK этим руководством не заявляется.

Mobile

На iOS/Android используйте сервисный вариант либо платформенный native adapter. Не кладите desktop CLI в мобильный bundle и не запускайте его как произвольный процесс: мобильные sandbox-модели этого не предполагают.

Рекомендуемый внешний API

POST /workbooks              -> externalSessionId
POST /workbooks/{id}/commands -> typed response
GET  /workbooks/{id}/cells    -> bounded projection
POST /workbooks/{id}/save     -> file/download token
DELETE /workbooks/{id}        -> teardown