Agent-Sessions und Sandboxes
Das Muster
Abschnitt betitelt „Das Muster“Ein Coding-Agent arbeitet frei an einem getrennten Ort, und der eine Schritt, der die Produktion ändert, geht durch eine Freigabe. Damit das hält, muss der getrennte Ort wirklich getrennt sein: eigene Credentials, keine Produktions-Secrets, kein Netzwerkweg zur Produktion, und wegwerfbar.
Sessions
Abschnitt betitelt „Sessions“Ein Trigger (ein Webhook, ein Node-Signal, ein Zeitplan) oder ein Mensch startet eine Agent-Session. Der Kern entscheidet wann, ob und mit welchen Rechten; der Treiber startet, überwacht und stoppt sie nur.
| Wo die Session läuft | Treiber | Wie sich die Session ausweist |
|---|---|---|
| ein Pod in kubernetes-sigs/agent-sandbox auf k3s | agent_sandbox | ein projiziertes ServiceAccount-Token, geprüft per TokenReview; gebunden an Namespace, ServiceAccount und Pod |
| ein Forgejo-Actions-Job | forgejo_actions | das OIDC-ID-Token des Jobs (ES256), gebunden an Repository und Lauf |
| dein Rechner, neben dir | vaicoa-run pair | ein Vergleichscode, den du auf deinem Telefon bestätigst |
- Die Session bekommt kein Token, sondern ein Run-Ticket: einmal verwendbar, höchstens zehn Minuten gültig. Wer es einlöst, bekommt ein Lauf-Zertifikat, das mit dem Budget des Laufs endet.
- Die Sandbox darf nur die Tür des Kerns und das Modell erreichen (eine NetworkPolicy). Auf Forgejo-Runnern kann der Treiber ausgehenden Verkehr nicht einschränken (Grenzen).
- Jeder Lauf hat ein Budget: Tokens, Läufe pro Tag, Vorschläge pro Lauf, ein Timeout.
- Ein Lauf trägt höchstens die Rechte des Benutzers, für den er handelt, begrenzt auf Level
device, und nur die Aktionen in dermayPropose-Liste seines Triggers.
vaicoa-run
Abschnitt betitelt „vaicoa-run“Der Agent spricht nie direkt mit dem Kern. vaicoa-run sitzt in der Session und hat zwei Gesichter: eine CLI und einen lokalen MCP-Server
über stdio, für Claude Code, OpenCode oder jeden MCP-Client. Seine Tools sind die erlaubten Aktionen aus dem geprüften
signierten Katalog, dazu:
| Tool | Was es tut |
|---|---|
actions | was dieser Lauf vorschlagen darf, und für jede Aktion, ob sie sofort läuft oder eine Freigabe braucht, und von wem |
explain | ein Probelauf: was der Kern für genau diese Parameter entscheiden würde, ohne eine Op anzulegen |
propose | antwortet done, queued, pending_approval (mit dem, was fehlt) oder refused (mit dem Grund) |
status, wait | eine Op verfolgen, innerhalb des Budgets des Laufs |
report | Ergebnisse oder Fragen an den Menschen zurückschicken |
Eine Skill-Datei sagt dem Agenten, wie er sich verhalten soll: zuerst erklären, einmal vorschlagen, weiterarbeiten, während eine Freigabe aussteht,
einen Vorschlag nicht wiederholen. Reviewer-Sessions bekommen stattdessen review-next und review-decide und sehen die Behauptungen
des Vorschlagenden nie. Ein Lauf hat nie beide Rollen.
Twins: eine Idee, nicht gebaut
Abschnitt betitelt „Twins: eine Idee, nicht gebaut“Die Idee hinter dem Namen: Ein Agent bekommt eine Kopie einer Umgebung (mit Seed-Daten oder einer maskierten Kopie), probiert dort eine Änderung aus und legt das Ergebnis zum Review vor. Das ist in Vaicoa Core nicht gebaut. Was es gibt, ist die Session in einer Sandbox oder einem CI-Job, Änderungen als Pull Request (GitOps-Ablauf) und Pläne, die vorher und nachher zeigen.