В Vercel Sandbox добавили ввод в уже работающую команду. Как связаны stdin, чтение результата и завершение процесса при работе с CLI и stdio-серверами.
Vercel Sandbox теперь позволяет передавать данные в стандартный ввод уже работающей команды. Обновление от 26 октября расширяет сценарии с обычными CLI и серверами, которые обмениваются сообщениями через stdio. Для разработчика важна не только возможность записать строку: нужно правильно определить окончание ввода, прочитать результат и дождаться завершения процесса.
Официальная карточка анонса поддержки стандартного ввода в командах Vercel Sandbox.
Запущенная команда может ждать продолжения
Многие консольные программы читают входной поток до его окончания. Если отправить данные и оставить stdin открытым, процесс может продолжить ждать, даже когда приложение уже считает работу выполненной. Это не обязательно зависание: программа просто не получила сигнал, что новых данных больше не будет.
В TypeScript SDK для такого режима у runCommand() включаются stdin и detached. Далее writeStdin() передаёт данные, closeStdin() завершает вход, а ожидание команды позволяет получить её результат. Этот порядок стоит понимать как протокол обмена, а не набор независимых вспомогательных вызовов.
В Python SDK можно открыть канал через subprocess.PIPE. Метод communicate() завершает передачу ввода, собирает оставшийся вывод и ожидает окончания процесса. Для задачи, где все входные данные известны заранее, предусмотрен и более простой вариант передачи input при запуске.
Разделять данные и служебные сообщения
У процесса есть stdout и stderr. Если stdout используется как машинный протокол, случайная диагностическая строка может нарушить обмен. Поэтому полезно заранее определить, какой поток содержит результат, куда уходят сообщения об ошибках и что означает успешный код завершения. Наличие текста в stdout ещё не доказывает успешность всей операции.
Особенно важно это для долгоживущих stdio-сервисов. Там конец одной порции данных не равен окончанию процесса. Сообщениям нужны границы, предусмотренные используемым протоколом, а приложению — понимание, какое сообщение относится к какому запросу. Закрывать stdin после каждой строки в таком сценарии было бы неправильным обобщением простого примера.
Ограничить ожидание и объём результата
Перед запуском полезно определить тайм-аут, допустимый объём вывода и реакцию на преждевременное завершение. Потоки нельзя бесконечно накапливать в памяти только потому, что процесс изолирован. Если команда генерирует большой результат, нужен способ читать его постепенно или сохранять в подходящее хранилище.
Проверка интеграции должна включать пустой ввод, несколько порций, ошибочную строку и остановку процесса раньше ожидаемого. Отдельно стоит проверить сценарий, где команда ждёт EOF: он быстро обнаруживает забытое закрытие входа. Полезно также убедиться, что после ошибки не остаётся ненужная работа.
Поддержка stdin делает песочницу удобнее для существующих инструментов, которым не нужен HTTP-сервер. Но надёжность обмена возникает из ясного жизненного цикла: запустить, передать данные по правилам, завершить нужный поток, прочитать результат и корректно обработать окончание работы.