Zum Inhalt springen
Ein persönliches Experiment · Alpha · Code noch nicht öffentlich · kein Angebot, kein Support Projektstatus →

Agent-Sessions und Sandboxes

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.

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äuftTreiberWie sich die Session ausweist
ein Pod in kubernetes-sigs/agent-sandbox auf k3sagent_sandboxein projiziertes ServiceAccount-Token, geprüft per TokenReview; gebunden an Namespace, ServiceAccount und Pod
ein Forgejo-Actions-Jobforgejo_actionsdas OIDC-ID-Token des Jobs (ES256), gebunden an Repository und Lauf
dein Rechner, neben dirvaicoa-run pairein 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 der mayPropose-Liste seines Triggers.

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:

ToolWas es tut
actionswas dieser Lauf vorschlagen darf, und für jede Aktion, ob sie sofort läuft oder eine Freigabe braucht, und von wem
explainein Probelauf: was der Kern für genau diese Parameter entscheiden würde, ohne eine Op anzulegen
proposeantwortet done, queued, pending_approval (mit dem, was fehlt) oder refused (mit dem Grund)
status, waiteine Op verfolgen, innerhalb des Budgets des Laufs
reportErgebnisse 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.

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.