Agent Sidecars

Agent Sidecars verbinden Nova mit externen Agentenlaufzeiten wie Claude, Codex oder Gemini. Sidecar bedeutet hier Begleitlaufzeit: Der Provider-Agent läuft neben Nova, während Nova Browser-Oberfläche, sichtbaren Dialog, Freigaben, Arbeitskontext und gespeicherte Sitzung zusammenhält.

Nutzer arbeiten über das Agenten-Panel. Sie wählen einen Provider, geben ein Ziel ein, sehen den Verlauf, beantworten Freigaben, stoppen einen Lauf bei Bedarf und können gespeicherte Gespräche später wieder öffnen oder fortsetzen.

Ein Sidecar macht Agentenarbeit nicht unsichtbar oder unkontrolliert. Nova bindet Agentenarbeit an Tabs, Berechtigungen, Aufgabenbezug, Arbeitsbereiche, Agent Awareness Gates und sichtbare Nutzerentscheidungen.

Kurz gesagt

Agent Sidecars lassen Nova Provider-Agenten nutzen, ohne die Arbeit vor dem Nutzer zu verstecken.
Das Agenten-Panel zeigt Provider-Zustand, Verlauf, Werkzeugkarten, Freigaben, Stop-Steuerung und Archiv.
Provider-Einrichtung bleibt ausdrücklich: Die nötige CLI oder das nötige Konto muss verfügbar sein, bevor Nova einen Provider starten kann.
Sensible oder verändernde Arbeit kann Freigabe, Tab-Bindung, AAG-Prüfung oder strengere Berechtigungen verlangen.
Arbeitsbereiche, Logs und Archive machen Sitzungen prüfbarer und leichter fortsetzbar.

Was Sidecars verbinden

Ein Sidecar verbindet eine externe Provider-Laufzeit mit Novas browserbewusster Arbeitsfläche.

Provider-Laufzeit Nova kann einen unterstützten Provider-Agenten starten, wenn die nötige lokale Einrichtung vorhanden ist. Fehlt der Provider, ist er veraltet, nicht angemeldet oder eingeschränkt, zeigt Nova diesen Zustand vor Arbeitsbeginn.
Agenten-Panel Das Panel ist der sichtbare Ort für Aufgaben, Provider-Zustand, Antworten, Werkzeugkarten, Freigaben, Stop-Steuerung, Archiv und Diagnose.
Browser-Werkzeuge und Kontext Sidecars nutzen Novas Browser- und MCP-Werkzeuge zum Lesen, Navigieren, Klicken, Eingeben und Melden von Fortschritt. Seitenwahrnehmung, Tab-Zustand, Berechtigungen und Nutzerkontrolle bleiben in derselben Produktoberfläche.
Freigaben und Sicherheit Sensible Handlungen können ausdrückliche Freigabe verlangen. Domain-Regeln, Autonomie-Einstellungen, AAG, Notstop und Tab-Reservierungen verhindern, dass ein Agent so handelt, als sei jede Aktion bereits erlaubt.
Arbeitsbereich und Aufgabenkontext Nova bereitet Arbeitsbereiche, Anweisungen und relevanten Kontext vor, damit ein Provider-Agent mit der richtigen lokalen Orientierung startet.
Archiv und Logs Gespräche, Ereignisse, Exporte und begrenzte Diagnosen zeigen, was passiert ist, und erlauben es, eine Sitzung später fortzusetzen.

Wann brauche ich Agent Sidecars?

Agent Sidecars passen zu Aufgaben, bei denen ein KI-Agent im Browser handelt, statt nur über eine Seite zu sprechen. Typisch sind Website-Prüfungen, mehrstufige Formulare, Plattform-Mapping, QM-Runden, fortgesetzte Aufgaben oder Läufe, in denen ein Agent Novas Lern-, Aufgaben- und Sicherheitskontext nutzt, während der Nutzer die Kontrolle behält.

Wichtige Begriffe

Diese Begriffe trennen die Agentenschicht von der Webseite selbst.

Agent Sidecar: Eine lokale Provider-Laufzeit, die Nova startet oder koordiniert, damit ein KI-Agent mit Nova-Werkzeugen arbeiten kann.
Provider: Die externe Agentenlaufzeit oder das zugehörige Konto, etwa Claude, Codex oder Gemini.
Agenten-Panel: Novas sichtbare Steuerfläche für Provider, Verlauf, Freigaben, Stop-Steuerung, Archiv und Diagnose.
Verlauf: Der sichtbare Dialog- und Ereignisstrom der aktuellen Agentensitzung.
Freigabe: Eine Nutzerentscheidung, bevor eine sensible, weitreichende oder verändernde Handlung fortgesetzt wird.
Arbeitsbereich: Der vorbereitete Arbeits- und Anweisungskontext, mit dem der Provider-Agent die aktuelle Nova-Aufgabe versteht.
Tab-Reservierung: Eine Bindung, die Agentenarbeit einem bestimmten Tab oder Arbeitskontext zuordnet.

So funktioniert es

Ein Sidecar-Lauf ist ein sichtbarer Kreislauf aus Nutzerziel, Provider-Agent, Nova-Werkzeugen und Nutzerkontrolle.

Provider vorbereiten Nova prüft, ob der gewählte Provider verfügbar, angemeldet, kompatibel und startbereit genug ist.
Im Agenten-Panel starten Der Nutzer wählt einen Provider, beschreibt das Ziel und startet den Lauf aus dem gemeinsamen Panel, statt die Seite an einen unsichtbaren Arbeiter abzugeben.
Nova ergänzt Kontext Nova kann Anweisungen, Arbeitsbereich, Tab-Zustand, Berechtigungen und Werkzeug-Bundles wie nova.tools_bundle bereitstellen, damit der Agent die verfügbare Arbeitsfläche kennt.
Der Agent nutzt Nova-Werkzeuge Ein Sidecar kann Seitenzustand lesen, navigieren, klicken, tippen, Kontext prüfen oder Fortschritt melden, soweit Werkzeuge und Richtlinien es erlauben.
Der Nutzer bleibt in Kontrolle Wenn ein Schritt Freigabe braucht, zeigt das Panel eine Freigabekarte. Der Nutzer kann erlauben, ablehnen, stoppen oder unterbrechen.
Arbeit bleibt prüfbar Gesprächsereignisse, Archiv, Exporte und Arbeitsbereiche machen wichtige Sitzungen nachvollziehbar und später fortsetzbar.

Provider-Bereitschaft

Provider-Einrichtung ist sichtbar, weil ein Sidecar nur arbeiten kann, wenn seine Laufzeit sicher startet.

Bereich	Was Nova zeigt	Warum das wichtig ist
Provider-Zustand	Bereit, fehlt, nicht unterstützt, eingeschränkt, nicht angemeldet oder anderweitig blockiert.	Der Nutzer sieht vor dem Start, warum ein Provider verfügbar oder blockiert ist.
Version und Pfad	Erkannte Version, ausführbarer Pfad und letzter Scan-Zeitpunkt, wenn verfügbar.	Lokale Provider-Clients ändern sich; Nova macht Setup-Drift sichtbar, statt still zu scheitern.
Diagnose	Kopierbare Diagnose und gezielte Reparaturschritte, wenn Nova den nächsten Schritt kennt.	Einrichtungsprobleme lassen sich leichter lösen, wenn die sichtbare Meldung die nächste Handlung nennt.
Berechtigungen	Freigabeoptionen, Autonomie-Modus, Domain-Regeln und dauerhafte Freigaben, wo sie erlaubt sind.	Browserändernde Arbeit läuft mit bewusst gesetzten und begrenzten Agentenrechten.

Grenzen und Sicherheit

Agent Sidecars umgehen Novas Sicherheitsmodell nicht. Sie machen Provider-Konten, Passwörter, destruktive Handlungen oder Browserzustand nicht automatisch sicher. Ein Provider kann fehlen, eine Sitzung kann gestoppt werden, eine Freigabe kann abgelehnt werden, und veralteter oder unsicherer Seitenkontext kann den nächsten Schritt blockieren oder verlangsamen.

Beispiel

Ein Nutzer bittet Codex, eine Einstellungsseite zu prüfen. Nova öffnet das Agenten-Panel, stellt Browser-Werkzeuge und aktuellen Tab-Kontext bereit und zeigt den Verlauf während der Arbeit. Wenn der Agent in ein sensibles Feld schreiben oder vom reservierten Tab weg navigieren will, kann Nova vorher eine Freigabe verlangen oder die Handlung stoppen.

Agenten-Werkzeuge

MCP-Tools für Agenten. Diese Variablen und Werkzeugnamen sind für Agenten und Integratoren gedacht. Sie sind keine normalen Bedienbefehle für Menschen in der Oberfläche.

Variable	Bedeutung
`nova.get_instructions`	Gibt agentenlesbare Anweisungen für aktuellen Modus, Aufgabe und Werkzeugkontext zurück.
`nova.tools_bundle`	Lädt die passende Nova-Werkzeuggruppe, bevor aktive Browser- oder Aufgabenarbeit beginnt.
`nova.permission_prompt`	Erlaubt einem Agenten, für einen sensiblen oder verändernden Schritt ausdrücklich nach Nutzerfreigabe zu fragen.
`nova.tab_claim`	Reserviert einen Tab für eine begrenzte Agentenaufgabe, damit kein anderer Agent ihn still übernimmt.
`nova.tab_release`	Gibt einen reservierten Tab wieder frei, wenn die begrenzte Arbeit erledigt oder abgebrochen ist.
`nova.tabs`	Listet sichtbare Tabs, damit ein Agent sich vor einer Handlung orientieren kann.
`nova.set_active_tab`	Wechselt das aktive Browser-Ziel bewusst, statt auf veraltete Tab-Annahmen zu bauen.
`nova.get_onboarding`	Bereitet agentenlesbare Einrichtungsinformationen für lokale Tool- oder Client-Konfiguration vor.
`nova.install_onboarding`	Installiert Agenten-Referenzdateien, wenn der Nutzer diese Einrichtung über Nova anstößt.
`targetId`	Kanonische Browser-Zielkennung für tabgebundene Werkzeuge und Claim-Prüfungen.
`agentId`	Agentenkennung zum Reservieren, Freigeben und Autorisieren begrenzter Tab-Arbeit.
`ownerAgentId`	Agent, der aktuell einen Claim, ein Goal oder einen begrenzten Arbeitsdatensatz besitzt.
`sidecarSessionId`	Sitzungsbindung für Embedded-Sidecar-Requests und gespeicherte Claim-Ownership.
`sourceKind`	Herkunftsklasse des Requests, etwa embedded oder external.
`role`	Agentenrolle, die an Claim oder Arbeitsbesitz gespeichert wird.
`claim`	Auto-Claim-Ergebnisobjekt aus Tab-Erstellung oder begrenzten Claim-Flows.
`claim.state`	Dreistufiges Claim-Ergebnis: claimed, failed oder unknown.
`leaseMs`	Claim- oder Goal-Lease-Dauer in Millisekunden.
`leaseRemainingMs`	Verbleibende Claim-Lease-Zeit in direkten Roundtrips.
`leaseExpiresAtUtc`	Absoluter UTC-Ablaufzeitpunkt der aktuellen Claim- oder Goal-Lease.
`heartbeatAtUtc`	Zuletzt beobachteter Heartbeat der besitzenden Sidecar-Sitzung.
`claimedAtUtc`	UTC-Zeitpunkt, zu dem das Ziel reserviert wurde.
`claimHint`	Maschinenlesbare Konfliktführung, wenn ein Claim eine Handlung blockiert.
`claimHint.suggestedAction`	Empfohlener nächster Schritt zur Lösung des Claim-Konflikts.
`claimHint.retryAgentId`	Agentenkennung, die für einen sauberen Retry genutzt werden sollte, wenn vorhanden.
`claimHint.overrideAvailable`	Zeigt, ob ein kontrollierter Reclaim- oder Override-Weg existiert.
`claimHint.tokenRequired`	Zeigt, ob der Konflikt ein Finalization Token verlangt.
`claimHint.requiresLocalTakeover`	Zeigt, dass lokale Nutzer- oder Sidecar-Übernahme vor einem Retry nötig ist.
`claimHint.nextStep`	Kurzer maschinenlesbarer nächster Schritt für den blockierten Agenten.
`resolution.tool`	Vorgeschlagenes Behebungswerkzeug für einen Owner-Mismatch-Reclaim.
`resolution.args.targetId`	Vorausgefülltes Zielargument für den vorgeschlagenen Reclaim-Aufruf.
`resolution.args.agentId`	Vorausgefülltes Agentenargument für den vorgeschlagenen Reclaim-Aufruf.
`resolution.args.reclaimReason`	Grundvorlage für eine kontrollierte Tab-Rückholung.
`finalizationToken`	Token, das eine kontrollierte Freigabe aus einer anderen gebundenen Sitzung autorisieren kann.
`releaseState`	Stabiler Freigabezustand wie released, expired_cleanup oder not_claimed_noop.
`releaseAuthorization`	Erklärt, ob die Freigabe über owner_session, token_override oder not_applicable lief.
`hadActiveClaim`	Zeigt, ob der Release-Pfad einen aktiven Claim gesehen hat.
`released`	Boolesches Freigabeergebnis, das für bestehende Clients sichtbar bleibt.
`finalized`	Boolesches Finalisierungsergebnis neben den Release-Metadaten.
`claim.owner_mismatch`	Reason Code für eine falsche Agentenkennung auf einem reservierten Ziel.
`claim.session_mismatch`	Reason Code für dieselbe Agentenkennung aus einer anderen gebundenen Sitzung.
`claim.reclaim_required_after_resume`	Resume-Modus-Grund, der vor Veränderungen einen erneuten Claim des Ziels verlangt.
`projectRoot`	Absoluter Worktree-Pfad, der für die Onboarding-Installation gewählt wurde.
`bootstrapNow.steps`	Sofortige Einrichtungsschritte aus der Onboarding-Führung.
`bootstrapNow.note`	Kurzer Setup-Hinweis aus der Onboarding-Führung.
`files[]`	Onboarding-Referenzdateien für Prüfung oder Installation.
`files[].sha256`	Prüfsumme einer Onboarding-Datei, damit Clients Drift erkennen.
`edits[]`	Aktionsförmiger Edit-Plan für die Installation von Onboarding-Referenzen.
`preserveOtherContent`	Vorgabe, dass Onboarding-Edits fremde Nutzerinhalte nicht überschreiben sollen.
`verify[]`	Prüfschritte zur Bestätigung der Onboarding-Einrichtung.
`bundles[]`	Von der Onboarding-Führung empfohlene Bundles.
`risk_level`	Optionale Risikostufe für Freigabeaufforderungen mit Nutzerkontext.
`retryAfterMs`	Empfohlene Wartezeit vor Retry bei transienter Tab-Aktivierung oder Claim-Zustand.