Skip to content

The all-in-one local AI studio for your desktop: chat, image and video generation and a coding agent in one free, open source app. Windows and Linux. No Docker, no terminal, no cloud required.

5.1 KB
Raw Blame
import { useEffect, useRef } from 'react'
import { useAgentTaskStore } from '../stores/agentTaskStore'
import { useGenerationStore } from '../stores/generationStore'
import { useModelStore } from '../stores/modelStore'
import { useChatStore } from '../stores/chatStore'
import { createWakeWatcher } from '../lib/agent-wake'
import { isRunStopped } from '../lib/run-stop'

/**
 * Holt den Hauptagenten zurueck, wenn ein Hintergrundagent fertig ist.
 *
 * ── WARUM ES DAS GIBT ──────────────────────────────────────────────────────
 *
 * Das Ergebnis erreicht das Modell ueber `appendTaskReport`, und der steht
 * oben in der ReAct-Schleife. Endet eine Hintergrundaufgabe nach dem Zug — der
 * Normalfall, sie laeuft ja laenger —, gibt es keine Schleife, die sie abholt.
 * Wer drei Recherchen bestellt und dann wartet, wartet fuer immer.
 *
 * ── WAS HIER STEHT UND WAS NICHT ───────────────────────────────────────────
 *
 * Nur die Verdrahtung: Stores hinein, Sendeweg hinein, Abonnement auf und
 * wieder zu. Die Regeln — Sammelfrist, "laeuft schon", "ein Weckzug zur Zeit" —
 * stehen in lib/agent-wake.ts, weil vitest hier nur `.test.ts` einsammelt und
 * die Regeln genau die Art sind, die beim naechsten Umbau still verlorengeht.
 *
 * ── WARUM ALS ABONNEMENT UND NICHT IM STORE ────────────────────────────────
 *
 * Der Aufgaben-Store weiss nichts von Zuegen, und das soll so bleiben: er ist
 * die Buchhaltung, nicht der Antrieb. Einen Zug aus einem Zustand-Setter
 * heraus zu starten waere ausserdem ein Seiteneffekt mitten in einer
 * Store-Aktualisierung.
 */
export function useBackgroundAgentWake(
  conversationId: string | null | undefined,
  senden: (text: string, images?: undefined, opts?: { hiddenUser?: boolean }) => Promise<unknown>,
): void {
  // In Refs, damit das Abonnement NICHT bei jedem Render neu aufgebaut wird:
  // `senden` ist in beiden Hooks ein useCallback, dessen Identitaet sich mit
  // jedem Zustandswechsel aendern kann, und ein Abonnement, das dabei
  // abreisst, verpasst genau den Abschluss, auf den es wartet.
  //
  // Nachgefuehrt in einem Effekt und NICHT im Render: React 19 verbietet das
  // Schreiben eines Refs waehrend des Renders (`react-hooks/refs`), weil ein
  // verworfener Render sonst einen Wert hinterliesse, den es nie gab.
  const sendenRef = useRef(senden)
  const convRef = useRef(conversationId)
  useEffect(() => {
    sendenRef.current = senden
    convRef.current = conversationId
  })

  useEffect(() => {
    const watcher = createWakeWatcher({
      conversationId: () => convRef.current,
      tasks: (id) => useAgentTaskStore.getState().forConv(id),
      isRunning: (id) => !!useGenerationStore.getState().generating[id],
      // Stop heisst Stop, auch fuer einen Zug, den nicht der Mensch, sondern
      // ein fertiger Hintergrundagent ausloest. `lib/run-stop.ts` fuehrt die
      // Tatsache je Gespraech und ueberlebt das Ab- und Anmelden dieser
      // Ansicht; geloescht wird sie von `beginRun`, also von der naechsten
      // selbst getippten Anweisung.
      isStopped: (id) => isRunStopped(id),
      activeModel: () => useModelStore.getState().activeModel,
      // `hiddenUser`: der Satz erreicht das Modell, nicht das Auge. Sichtbar
      // stuende im Verlauf eine Nutzernachricht, die der Mensch nie
      // geschrieben hat. Was er sieht, ist die Notiz des fertigen Agenten und
      // danach die Antwort darauf.
      send: (text) => sendenRef.current(text, undefined, { hiddenUser: true }),
      lastUserTurn: (id) => {
        const msgs = useChatStore.getState().conversations.find((c) => c.id === id)?.messages ?? []
        for (let i = msgs.length - 1; i >= 0; i--) {
          const m = msgs[i]
          if (m.role === 'user' && !m.hidden) return m.id
        }
        return null
      },
    })

    // ZWEI Quellen, und die zweite ist die, an der die erste Fassung scheiterte.
    //
    // Am 02.09.2026 im laufenden Fenster nachgemessen: der Sub-Agent scheiterte
    // sofort (falsche Modellkennung), war also fertig, WAEHREND der Elternzug
    // noch lief. `check` sah "laeuft schon" und stieg aus — richtig. Dann
    // endete der Zug, und der Aufgaben-Store aenderte sich nie wieder. Es sah
    // also nie wieder jemand hin, und das Ergebnis blieb liegen, bis der
    // Mensch von sich aus etwas schrieb: genau das Loch, das dieser Hook
    // schliessen sollte.
    //
    // Der Generierungs-Store ist die fehlende Kante: sein Umschalten auf
    // "fertig" ist der Moment, in dem aus "darf nicht" ein "darf" wird.
    const abAufgaben = useAgentTaskStore.subscribe(watcher.check)
    const abLauf = useGenerationStore.subscribe(watcher.check)
    // Einmal beim Aufsetzen: eine Aufgabe kann fertig geworden sein, waehrend
    // dieser Hook nicht montiert war — beim Wechsel in ein anderes Gespraech
    // und wieder zurueck etwa.
    watcher.check()
    return () => {
      abAufgaben()
      abLauf()
      watcher.dispose()
    }
  }, [])
}