Instanzmanager Stufe 4: eine Adresse, ein Zugang, alle Instanzen (#528, E-M5)

Der Managerprozess. ClawdDotNet.Instanzmanager ist eine Konsolenanwendung:
Lizenz pruefen, uebernehmen was laeuft, Weboberflaeche aufhaengen, warten.
Beim Herunterfahren beendet er keine Instanz.

Zwei neue Projekte. ClawdDotNet.Manager.Web traegt die Weboberflaeche -
ohne jeden Verweis auf ClawdDotNet.Web, denn dort haengt App und daran
sechzehn Werkzeugprojekte. ClawdDotNet.ManagerApp ist der Einstiegspunkt.
wwwroot ist aus der Instanz in den Manager gezogen.

DER SCHNITT DER HTTP-FLAECHE: Unter /api/verwaltung steht, was den Manager
angeht - auflisten, anlegen, starten, anhalten. Alles andere unter /api
geht unveraendert an eine Instanz. Er leitet weiter, er implementiert
nicht. Welche Instanz gemeint ist, sagt die Kopfzeile X-Instanz; laeuft
genau eine, ist sie gemeint, und laufen mehrere, wird nachgefragt statt
geraten - eine Anfrage an die falsche Instanz ist schlimmer als eine
abgelehnte.

Der zusammengefuehrte Ereignisstrom haelt je laufender Instanz eine
Zuleitung und schreibt an jedes Ereignis, von wem es kommt. Ergaenzt statt
verpackt: Ein Umschlag waere einfacher gewesen, haette aber jede Ansicht
der Weboberflaeche zum Umschreiben gezwungen.

ABNAHME gegen laufende Prozesse: 401 ohne Token, Oberflaeche ohne Token
200, Instanz ueber den Manager gestartet und angehalten, /api/info und
/api/status unverfaelscht durchgereicht, /events/logs mit
"instanz":"Instance-Test" an jeder Zeile. Manager abgeschossen: Instanz
laeuft weiter. Manager neu gestartet: "1 Instanzen bekannt, 1 laufen
bereits" - uebernommen. E-M6 damit in beide Richtungen belegt.

DREI DEFEKTE, die erst der Lauf gezeigt hat:

1. Der Manager hing an einer Konsolenabfrage nach dem Lizenzschluessel. Ein
   Test auf Console.IsInputRedirected reicht dafuer NICHT: Er beantwortet
   "ist die Eingabe umgeleitet", nicht "kann jemand antworten" - ein
   Prozess ganz ohne Konsole, der gefaehrlichste Fall, ist nicht
   umgeleitet. Der Manager fragt jetzt gar nicht.
2. Eine unlesbare manager.json wurde stillschweigend durch Vorgaben
   ersetzt: falsches Instanzverzeichnis, anderer Port, Lizenzfrage - und
   nichts sagte, woran es lag. LoadProblem meldet den Grund jetzt.
3. Der Instanzprozess erbte CLAWD_CONFIG_DIR vom Manager und legte sich in
   dessen Konfigurationsverzeichnis eine eigene Settings.json an. Eine
   Umgebungsvariable vererbt sich, ein Argument nicht - der Manager nimmt
   sein Verzeichnis jetzt ueber --config.

SharedLoggerProvider ist nach Core gezogen: Es gibt jetzt zwei Webhosts,
die dasselbe brauchen, und sie duerfen einander nicht kennen.

NOCH OFFEN in dieser Stufe: Die Weboberflaeche kennt noch keine Instanzen -
Instanzauswahl, X-Instanz und die Verwaltungsansicht sind Arbeit an
wwwroot. Und webServerPort steht noch in der Instanz.

Build ohne Warnungen, 775 Tests gruen, 8 uebersprungen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

src/ClawdDotNet.Manager.Web/wwwroot/modules/api.js

@@ -0,0 +1,115 @@
+// ClawdDotNet — API-Zugriffsschicht
+//
+// Verwaltet das Zugangstoken im sessionStorage und kapselt fetch-Aufrufe.
+
+export const TOKEN_SCHLUESSEL = "clawd.token";
+
+let token = sessionStorage.getItem(TOKEN_SCHLUESSEL) ?? "";
+const unberechtigtCallbacks = new Set();
+
+/**
+ * Gibt das aktuell gespeicherte Token zurück.
+ * @returns {string}
+ */
+export function holeToken() {
+  return token;
+}
+
+/**
+ * Speichert ein neues Token im Speicher und sessionStorage.
+ * @param {string} neuesToken
+ */
+export function setzeToken(neuesToken) {
+  token = (neuesToken || "").trim();
+  if (token) {
+    sessionStorage.setItem(TOKEN_SCHLUESSEL, token);
+  } else {
+    sessionStorage.removeItem(TOKEN_SCHLUESSEL);
+  }
+}
+
+/**
+ * Löscht das Token (Abmeldung).
+ */
+export function loescheToken() {
+  token = "";
+  sessionStorage.removeItem(TOKEN_SCHLUESSEL);
+}
+
+/**
+ * Prüft, ob ein Token im Speicher liegt.
+ * @returns {boolean}
+ */
+export function hatToken() {
+  return Boolean(token && token.length > 0);
+}
+
+/**
+ * Registriert einen Rückruf für den Fall einer 401-Ablehnung (sofortiger Login-Sprung).
+ * @param {() => void} callback
+ */
+export function beiUnberechtigt(callback) {
+  unberechtigtCallbacks.add(callback);
+  return () => unberechtigtCallbacks.delete(callback);
+}
+
+function meldeUnberechtigt() {
+  loescheToken();
+  for (const cb of unberechtigtCallbacks) {
+    try {
+      cb();
+    } catch (err) {
+      console.error("Fehler im Unberechtigt-Callback:", err);
+    }
+  }
+}
+
+/**
+ * Führt einen Aufruf gegen die API aus.
+ * @param {string} pfad Pfad relativ zu /api, z.B. "/info" oder "/agents"
+ * @param {RequestInit} [optionen={}]
+ * @returns {Promise<any>}
+ */
+export async function api(pfad, optionen = {}) {
+  const kopfzeilen = {
+    ...(optionen.headers ?? {}),
+    Authorization: `Bearer ${token}`
+  };
+
+  if (optionen.body && typeof optionen.body === "object" && !(optionen.body instanceof FormData)) {
+    kopfzeilen["Content-Type"] = "application/json";
+    optionen.body = JSON.stringify(optionen.body);
+  }
+
+  const antwort = await fetch(`/api${pfad}`, {
+    ...optionen,
+    headers: kopfzeilen
+  });
+
+  if (antwort.status === 401) {
+    meldeUnberechtigt();
+    const fehler = new Error("Kein gültiges Token. Bitte neu anmelden.");
+    fehler.abgelehnt = true;
+    fehler.status = 401;
+    throw fehler;
+  }
+
+  if (!antwort.ok) {
+    let meldung = `HTTP ${antwort.status}`;
+    try {
+      const rumpf = await antwort.json();
+      meldung = rumpf?.message ?? rumpf?.fehler ?? rumpf?.detail ?? meldung;
+    } catch {
+      // Wenn kein JSON geliefert wird, bleibt es beim HTTP-Code
+    }
+    const fehler = new Error(meldung);
+    fehler.status = antwort.status;
+    throw fehler;
+  }
+
+  if (antwort.status === 204) {
+    return null;
+  }
+
+  return antwort.json();
+}