Схема сокета Aggrega Wasm CLI
Сгенерированный справочник. Не редактируйте вручную — сгенерируйте заново из опубликованной JSON Schema.
Идентификатор схемы: https://aggrega.ai/schemas/wasm-cli-v1beta1.schema.json
Формат передачи данных, который принимает CLI-плагин (CLIRunInput). CLI-плагин расширяет набор команд инструмента командной строки aggrega: хост сопоставляет подкоманду с гостевым модулем Wasm и передаёт ему вектор аргументов вызова; гостевой модуль выполняется и возвращает код завершения процесса в качестве своего целочисленного возвращаемого значения. Стандартный вывод и стандартный поток ошибок передаются через функции хоста, а не через полезную нагрузку, поэтому этот сокет объявляет только формат входных данных. Тип полезной нагрузки для Go, Rust и TypeScript генерируется из этой схемы в пакеты plugin-ABI, поэтому все три языка читают и записывают одни и те же передаваемые данные; гостевой модуль импортирует его из этих пакетов или через свой набор для разработки плагинов, который его реэкспортирует.
Одна из следующих форм
CLIRunInput
Определения
CLIRunInput
Полезная нагрузка, которую хост передаёт CLI-плагину при каждом вызове: вектор аргументов, следующих за именем найденной подкоманды. Гостевой модуль разбирает эти токены как собственные флаги и позиционные аргументы — точно так же, как отдельная программа командной строки читает аргументы, следующие за её именем.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
command | string | да | Имя найденной подкоманды, которой хост передал этот вызов. Плагин, добавляющий несколько команд, выбирает по этому имени нужное поведение; плагин с одной командой получает здесь имя своей команды. Хост определяет имя по командной строке до вызова гостевого модуля и передаёт его без изменений. |
args | string[] | да | Вектор аргументов, который получает гостевой модуль, в порядке вызова — токены, следующие в командной строке за именем найденной подкоманды. Порядок сохраняется, поэтому полезная нагрузка побайтно идентична между запусками с одинаковыми входными данными. |
Дополнительные свойства не допускаются.