Esquema del socket Wasm CLI de Aggrega
Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.
ID del esquema: https://aggrega.ai/schemas/wasm-cli-v1beta1.schema.json
La forma de transmisión que consume un plugin CLI (CLIRunInput). Un plugin CLI amplía la superficie de comandos de la herramienta de línea de comandos aggrega: el host resuelve un subcomando a un guest Wasm y le entrega el vector de argumentos de la invocación; el guest se ejecuta y devuelve un código de salida del proceso como su valor de retorno entero. La salida estándar y el error estándar fluyen a través de funciones del host en lugar de un payload transmitido, de modo que este socket declara solo una forma de entrada. El tipo de payload de Go, Rust y TypeScript se genera a partir de este esquema en los paquetes de la ABI de plugins, de modo que los tres lenguajes leen y escriben el mismo formato de transmisión; un guest lo importa desde esos paquetes, o a través de su kit de plugins, que lo reexporta.
Una de las siguientes formas
CLIRunInput
Definiciones
CLIRunInput
El payload que el host entrega a un plugin CLI en cada invocación: el vector de argumentos que sigue al nombre del subcomando resuelto. El guest analiza estos tokens como sus propios flags y argumentos posicionales, exactamente como un programa de línea de comandos independiente lee los argumentos que siguen a su nombre.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
command | string | sí | El nombre del subcomando resuelto que el host despachó a esta invocación. Un plugin que aporta varios comandos se encamina según este nombre para seleccionar el comportamiento que se ejecuta; un plugin de un solo comando recibe aquí su propio nombre de comando. El host resuelve el nombre a partir de la línea de comandos antes de invocar al guest y lo lleva literalmente. |
args | string[] | sí | El vector de argumentos que recibe el guest, en el orden de invocación — los tokens que siguen al nombre del subcomando resuelto en la línea de comandos. El orden se conserva para que el payload sea idéntico byte a byte entre ejecuciones con una entrada idéntica. |
No se permiten propiedades adicionales.