Aktionskataloge
Vaicoa kennt Aktionen nur als Einträge in einem signierten Katalog. Niemand, weder Mensch noch Agent, kann etwas ausführen, das nicht darin steht. Jeder Eintrag legt fest:
- die Parameter, als JSON Schema, das der Kern validiert;
- die Risikoklasse:
safe,routine,risky(undneverin der Policy); - die Einschränkungen, CEL-Ausdrücke über die Parameter und den Zustand, den ein Modul liefert;
- das verlangte Level dessen, der vorschlägt, und die Freigaberegel (das Quorum: wie viele Personen, welche Rollen, welches Level, welche Kanäle, wie lange die Freigabe gilt);
- das Modul, das Zustand und Plan liefert, und den Executor, der sie ausführt (auf dem Node oder am Kern);
- die Anzeige-Vorlage: wie die Freigabe auf jedem Gerät aussieht;
- ob sie zerstörend ist (wer freigibt, wählt oder tippt dann zusätzlich das Ziel).
Das Format steht in der Referenz.
Der eingebaute Katalog
Abschnitt betitelt „Der eingebaute Katalog“Version 2026.11.9 hat 74 Aktionen: 15 safe, 36 routine, 23 risky. Sie decken Podman-Umgebungen ab, Hosts
(OS-Updates, Reboots, Isolation), k3s, Kubernetes-Workloads und -Volumes, Flux, Backups und Restores mit CloudNativePG,
Cluster API, Server und Firewalls bei Hetzner Cloud, Forgejo (git.change, git.tag), Incidents und Alerts, Zugangsfreigaben,
Zertifikate und Secrets, Restore-Übungen und Game Days. Dazu kommen fünf Playbooks: patch.window,
release.rollout, incident.first_response, restore.drill und gameday.run
(Betriebsprozesse).
Der Katalog ist mit dem Release-Schlüssel signiert und vom Kern und jedem Node gepinnt. Ein Node lehnt eine Op ab, deren Aktion nicht in seinem gepinnten Katalog steht.
Lese-Aktionen
Abschnitt betitelt „Lese-Aktionen“Fünf Aktionen lesen nur: metrics.query, logs.query, traces.get, kube.get, kube.logs. Sie brauchen keine Freigabe
und laufen sofort, sind aber eng gefasst: ein Lese-Budget pro Lauf, Schwärzung von Secrets, bevor die Antwort hinausgeht, und in einer
Produktionsumgebung gar nichts, solange du Lese-Aktionen dort nicht einschaltest (agent-read). Das Audit hält fest, dass gelesen wurde und wie viel,
nicht den Inhalt.
Wie Agenten den Katalog sehen
Abschnitt betitelt „Wie Agenten den Katalog sehen“Eine Agent-Session sieht nur die Aktionen, die ihr Trigger erlaubt (mayPropose), als Tools von vaicoa-run. Name, Beschreibung
und Eingabe-Schema kommen nur aus dem geprüften signierten Katalog, nie aus Text, den ein Agent oder ein Dritter beeinflussen kann;
verifiziert die Signatur des Katalogs nicht, startet der MCP-Server nicht.
Eigene Aktionen: Layer
Abschnitt betitelt „Eigene Aktionen: Layer“Eigene Aktionen liegen in einem internen Layer org.<name> neben dem eingebauten Katalog, signiert von den Ownern deines Teams
und im Roster gepinnt. Ein Layer kann Aktionen und Playbooks hinzufügen; eine eingebaute kann er nicht ändern. Eine Layer-Aktion
erscheint in der Freigabe als „aus Katalog org.…“. Kapitel 18 des Handbuchs führt eine durch (notify.send), von
Hand und mit einem Coding-Agenten.
Einen Layer aus einem MCP-Server entwerfen
Abschnitt betitelt „Einen Layer aus einem MCP-Server entwerfen“Bietet ein Provider einen MCP-Server an, entwirft vcx catalog import-mcp daraus einen Layer. Übernommen werden nur lesende Tools,
als safe-Lese-Aktionen mit Budget und Schwärzung; Tools für beliebige Befehle oder SQL bleiben immer draußen. Der Entwurf ist ein
Vorschlag: Verbindlich wird er erst mit den Signaturen deiner Owner. Ändert der Provider später ein Tool, markiert der Kern
die Aktion als nicht verfügbar (MCP DRIFT) und lehnt sie ab, bis du einen neuen Layer signierst.