Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

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.

EigenschaftTypErforderlichBeschreibung
commandstringjaDer 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.
argsstring[]jaDer 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.