Speichereigentum

Trennen Sie die Speicher nach Inhaber #

Jeder Agent speichert seine Unterhaltungen selbst. HB Code speichert die Verknüpfung von einer Session zur Unterhaltung des Agenten, die Outbox und den Live-Zustand. Eine Unterhaltung liest HB Code nur über die Schnittstelle des Agenten: das Protokoll des Codex-App-Servers oder das Claude Agent SDK im Agent-Host.

Die Abbildung zeigt nur den Desktop-Computer. Zwei Speicher liegen außerhalb des Desktops: die Serverdatenbank und das Telefon. Die letzten zwei Zeilen der folgenden Tabelle nennen, was jeder enthält. Keiner enthält ein Transkript.

Jeder Lesevorgang eines Claude-Transkripts läuft mit dem Hauptordner, egal welches Konto aktiv ist. Ein gespeichertes Transkript braucht keine Anmeldung, und jedes Konto speichert in denselben Ordner projects. HB Code legt diesen Ordner im Hauptordner an, bevor es ein Konto verknüpft. Schlägt die Verknüpfung projects fehl, schlägt die Einrichtung des Kontos mit einem Fehler fehl. Eine fehlgeschlagene Verknüpfung für einen anderen Eintrag schreibt nur eine Warnung ins Protokoll.

Der Agent-Host öffnet drei Arten von Claude-Dateien direkt, weil das SDK sie nicht liefert: die Datei meta.json neben einem Subagenten-Transkript, den Run-Datensatz eines Workflows und das Feld effort im ersten gespeicherten Assistenten-Turn eines Subagenten. Er liest sie und schreibt sie nie.

Das Asset-Protokoll der WebView ist auf Medienvorschauen unter dem App-Cache beschränkt, sodass keine private Laufzeitdatei von der Seite erreichbar ist.

Speicheridentität und Ausführungsidentität unterscheiden sich #

Die Spalte sessions.chat_agent enthält codex oder claude. Sie wird beim Anlegen der Session gesetzt, und eine Session-Aktualisierung behält sie bei. Sie entscheidet, welche Identitätstabellen eine Session nutzt.

Ein App-eigenes Codex-Profil hat eine stabile, opake UUID in kanonischer Kleinschreibung. Eine E-Mail-Adresse und ein Dateisystempfad sind keine Profilidentität. Die Tabelle codex_profiles enthält eine Zeile je Profil mit dem Status signed_out, authenticated oder unavailable und den Kontospalten, die der App-Server gemeldet hat.

Indexed und Exact sind Entwurfsnamen für die zwei Leserouten von Codex. Im Code entscheidet ein Prädikat: Eine Verknüpfung, deren Rollout-Pfad außerhalb des Laufzeit-Homes liegt, ist eine externe exakte Quelle. Beide Routen rufen thread/items/list auf dem Codex-App-Server auf. Ein exakter Lesevorgang fügt path und historySources hinzu. Das übertragene storageFormat einer Codex-Session bleibt auf beiden Routen indexed. Eine Operation löst ihre Route einmal auf und behält sie.

Eine Claude-Session hat keine Profilverknüpfung, weil jedes Claude-Konto dieselben Transkripte liest. HB Code speichert nicht, ob ein Transkript existiert. Der Host antwortet mit missing, wenn Claude die Unterhaltung noch nicht gespeichert hat, und der Desktop zeigt dann eine leere Timeline. Die UUID in claude_operations ist die UUID der Benutzernachricht, die der Desktop sendet. Über sie findet der Desktop diese Nachricht im Transkript. Die Zeile enthält auch den Nachrichtentext und die Anhänge.

Der exakte Quellzugriff hat bewusste Grenzen #

Vor einem Versand oder Anhängen gibt der Desktop den Thread von jedem anderen Profilserver frei, den er betreibt. Das koordiniert die mitgelieferten Sidecars dieses Prozesses. Es hindert keinen fremden externen Codex-Prozess daran, dieselbe Quelle zu schreiben. Stoppen Sie einen externen Schreiber, bevor Sie diese Unterhaltung in HB Code fortsetzen.

Die Outbox verwendet einen atomaren Identitätsanspruch #

workspace_chat_outbox
  session_id → entries_json, updated_at

workspace_chat_outbox_operation_identity
  (session_id, operation_id) → request_fingerprint

remote_rpc_idempotency
  scope_key → request_fingerprint, state, response_json, lease, expiry

chat_operation_ledger
  (app_session_id, operation_id) → status, result_json

chat_session_messages
  operation_id → recipient, sender, sender_call_id, sender_run_id, sender_thread_id, chain_id, hop, delivery

chat_live_timeline_overlays
  (app_session_id, timeline_target_id) → revision, snapshot_json

chat_live_timeline_overlay_revisions
  singleton → one global revision sequence

chat_pending_terminal_overlay_cleanups
  (app_session_id, run_id)

agent_usage_samples
  agent, account_key, window_kind → used_percent, resets_at, sampled_at

Fünf Tabellen tragen das Präfix chat_ und dienen Codex- und Claude-Sessions gleichermaßen. Vier davon hatten bis zu einer Umbenennungsmigration das Präfix codex_. chat_session_messages ist neuer. Tabellen, die nur Codex nutzt, behalten das Präfix codex_, zum Beispiel codex_session_links und codex_command_outputs.

save_workspace_chat_outbox_with_operation_identity öffnet eine Transaktion. Ihr INSERT … ON CONFLICT aktualisiert die Identitätszeile nur, wenn der vorhandene Fingerabdruck dem übermittelten gleicht. Betrifft diese Anweisung nicht genau eine Zeile, wird die Transaktion zurückgerollt. Danach schreibt sie das JSON der Outbox-Einträge per Upsert. Für eine Nachricht aus einer anderen Session fügt sie außerdem die Zeile in chat_session_messages ein, und eine Zeile mit derselben Operations-ID bleibt unverändert. Dann folgt der Commit. Eine Session-Nachricht wird nie ohne ihren Datensatz eingereiht und nie ohne ihren Warteschlangeneintrag aufgezeichnet. Die Identitätszeile hat die Basis-Session als Schlüssel, während das Outbox-JSON unter der Alias-Session gespeichert wird. So lässt sich dieselbe Operation von jedem Alias im Geltungsbereich finden.

Die Tabelle remote_rpc_idempotency ist das zweite Register. Sie behält das Ergebnis jeder gelisteten Remote-Mutation 48 Stunden lang über Desktop-Neustarts hinweg, sodass ein Telefon, das nach der Rückkehr des Desktops erneut versucht, weiterhin die gespeicherte Antwort erhält.

agent_usage_samples enthält Messwerte der Tariflimits für beide Agenten. Der Kontoschlüssel ist die ID des aktiven Codex-Profils oder die Claude-Konto-ID, also default oder eine UUID. Ein Messwert wird übersprungen, wenn der neueste Messwert desselben Fensters jünger als 10 Minuten ist, dieselbe Rücksetzzeit hat und um weniger als 0,5 Prozent abweicht. Messwerte, die älter als 35 Tage sind, werden gelöscht.

Was das Löschen einer Session entfernt #

delete_session_with_scoped_references entfernt die HB-Code-Zeilen einer Session in einer SQLite-Transaktion. Das Löschen sendet keine Anfrage an Codex und keine an Claude. Das Transkript des Agenten bleibt dort, wo der Agent es gespeichert hat.

Der Zugriff auf Projektdateien bildet eine eigene Grenze #

Entfernte Dateizugriffe laufen mit dem Dateisystemzugriff des Desktop-Benutzers. resolve_desktop_file_read_path expandiert eine Home-Abkürzung, hängt einen relativen Pfad an das kanonische Projektverzeichnis und kanonisiert das Ergebnis. Die Funktion erzwingt keine Projekteinschließung, und die Entwurfsnotiz sagt das mit Absicht. allowExternalFile und allowExternalMedia entscheiden nur, welcher Auflöser zuerst versucht wird, sodass ein authentifizierter Companion so oder so Pfade außerhalb des gewählten Projekts öffnen kann. ensure_path_within_project, das Elternkomponenten zurückweist und die kanonische Wurzel prüft, existiert für desktop-lokale Operationen.

App-verwaltete Chat-Anhänge liegen in pasted-images unter dem App-Datenverzeichnis, und ein externer Medienlesezugriff für einen Anhang muss als Bild, Video, Audio oder Dokument klassifiziert sein. Das Telefon verwendet nie sein eigenes Home-Verzeichnis.