Aggrega-Schema für den Wasm-Socket CLI
Generierte Referenz. Nicht von Hand bearbeiten — aus dem veröffentlichten JSON Schema neu generieren.
Schema-ID: https://aggrega.ai/schemas/wasm-cli-v1beta1.schema.json
Die Übertragungsform, die ein CLI-Plugin verarbeitet (CLIRunInput). Ein CLI-Plugin erweitert die Befehlsoberfläche des Kommandozeilenwerkzeugs aggrega: Der Host löst einen Unterbefehl zu einem Wasm-Guest auf und übergibt ihm den Argumentvektor des Aufrufs; der Guest wird ausgeführt und gibt einen Prozess-Exit-Code als ganzzahligen Rückgabewert zurück. Standardausgabe und Standardfehler fließen über Host-Funktionen statt über eine übertragene Payload, daher deklariert dieser Socket nur eine Eingabeform. Der Payload-Typ für Go, Rust und TypeScript wird aus diesem Schema in die Plugin-ABI-Pakete generiert, sodass die drei Sprachen dasselbe Übertragungsformat lesen und schreiben; ein Guest importiert ihn aus diesen Paketen oder über sein Plugin-Kit, das ihn re-exportiert.
Eine der folgenden Formen
CLIRunInput
Definitionen
CLIRunInput
Die Payload, die der Host einem CLI-Plugin bei jedem Aufruf übergibt: der Argumentvektor, der auf den aufgelösten Unterbefehlsnamen folgt. Der Guest parst diese Tokens als seine eigenen Flags und Positionsargumente, genau wie ein eigenständiges Kommandozeilenprogramm die Argumente nach seinem Namen liest.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
command | string | ja | Der aufgelöste Unterbefehlsname, den der Host an diesen Aufruf weitergeleitet hat. Ein Plugin, das mehrere Befehle beisteuert, verzweigt anhand dieses Namens, um das auszuführende Verhalten zu wählen; ein Plugin mit nur einem Befehl erhält hier seinen eigenen Befehlsnamen. Der Host löst den Namen aus der Kommandozeile auf, bevor er den Guest aufruft, und trägt ihn wörtlich. |
args | string[] | ja | Der Argumentvektor, den der Guest erhält, in Aufrufreihenfolge — die Tokens, die auf der Kommandozeile auf den aufgelösten Unterbefehlsnamen folgen. Die Reihenfolge bleibt erhalten, sodass die Payload über Läufe mit identischer Eingabe hinweg byteidentisch ist. |
Zusätzliche Eigenschaften sind nicht zulässig.