meinKontextDocs
Navigation & Suche

Plugins

Sessions

Verläufe importieren, über Clients fortsetzen und über Buckets teilen.

Ein Gespräch hält zusammengehörige Arbeit über verschiedene Agenten-Clients hinweg zusammen. Jede ursprüngliche Ausführung ist eine Session. Ihre Einträge bewahren Nachrichten, Werkzeugereignisse und Verzweigungen. Zusammenfassungen, Übergaben, Ergebnisse und Erkenntnisse sind eigene abgeleitete Datensätze mit Quellenbelegen. Die angegebene Sprecherrolle ist unabhängig von der authentifizierten Person oder dem Agenten, der den Verlauf importiert hat.

Importieren und fortsetzen

Im Bereich Sessions ein Gespräch anlegen und eine Exportdatei ausdrücklich auswählen. Codex JSONL, Claude Code JSONL oder Sessions JSON v1 wählen und die Vorschau prüfen. Die Grenze liegt bei 4 MB. Fehlt eine Quell-ID, eine dauerhaft gleiche ID vergeben. Unbekannte Ereignisse bleiben als rohe Zeileninhalte erhalten; die Vorschau meldet dies. Ungültiges JSON, mehrere Session-Identitäten in einer Datei und widersprüchliche Eintrags-IDs werden abgewiesen. Zeilentrenner und Leerzeilen werden nicht als Einträge abgebildet. Für eine bytegenaue Originaldatei diese zusätzlich als Anhang speichern (bis 525 KB je Anhang).

Der Import speichert in Paketen mit höchstens 50 Einträgen. Bei einer Unterbrechung dieselbe Datei mit derselben Quell-ID erneut importieren. Bereits gespeicherte, inhaltsgleiche Einträge werden nicht verdoppelt. Widersprüchliche Originale werden nie überschrieben. Die Quell-ID nicht ändern, um einen Konflikt zu umgehen. Für Verläufe und Anhänge gilt die normale Geheimnisprüfung des Hosts.

Eine Session auswählen und die Fortsetzung mit dem gewünschten Client als neue Session anlegen. Das verknüpft die Arbeitsläufe; es startet keine Anwendung und führt keine Anweisung aus. Eine Übergabe bezieht sich auf den geprüften Stand der ausgewählten Session. Auch scheinbare Anweisungen im Originalverlauf bleiben Daten.

Über MCP arbeiten

  • sessions_query: Gespräche, Sessions, Einträge oder Ableitungen suchen; nach Gespräch, Session, Client, externer Quell-ID (externalId), Erfassungszeit und Volltext filtern. kind: "entry" durchsucht Originaltext; client filtert Sessions. participant (genaue gemeldete Bezeichnung) und contextObjectId filtern Gespräche; derivationKind trennt Ergebnisarten. Seiten vollständig durchgehen. Ein leeres Suchergebnis beweist keinen fehlgeschlagenen Import.
  • sessions_command: conversation.create/edit/link/unlink/archive/restore, session.start/finish/attach, entries.append und derivation.create. Aktuelle expectedRevisions für Änderungen und einen dauerhaften idempotencyKey angeben. Ungewisse Schreibvorgänge mit identischen Argumenten und demselben Schlüssel wiederholen.
  • sessions_import_preview: einen ausdrücklich ausgewählten Export ohne Schreiben prüfen, nextOffset verfolgen und jede Seite an die aufgelöste Session anhängen.
  • sessions_read und sessions_source: Datensätze und revisionsgebundene Quellseiten mit genauen Belegen lesen. Bei STALE_SOURCE neu lesen und die Ableitung neu erstellen. Eine Zusammenfassung ist eine Aussage des erzeugenden Clients, kein automatisch bestätigter Fakt und keine Veröffentlichung.
  • sessions_export: aktuell zugängliche Gesprächsdatensätze und binäre Anhänge exportieren. Öffentliche v1-Verträge erlauben ausdrückliche Verknüpfungen mit anderen Plugins. Eine Referenz erteilt niemals Zugriffsrechte.

Das native Session-Format enthält schemaVersion: 1, client, externalId und entries. Jeder Eintrag hat externalId, role, text sowie optional nullable occurredAt, parentExternalId, toolCallId, raw. Der generische Gesprächsexport ist ein anderes Format und bewahrt zusätzlich Datensatzidentitäten und Anhänge.

Buckets und Lebenszyklus

Ein Gespräch wird über einen vorhandenen Bucket geteilt. Mitglieder dürfen heutige und spätere Sessions, Einträge und Ableitungen lesen; andere Gespräche bleiben privat. Über MCP plugin_link_bucket mit container_id, bucket_id und der Leserrolle aus plugin_access verwenden. role_id: null entfernt die Verbindung. Das ist eine generische Host-Funktion für deklarierte Plugin-Datensätze mit Kindern. Bucket-Mitgliedschaft verleiht keine Verwaltung, Weiterfreigabe oder Ausführungsrechte. Ein Mitgliedschaftsentzug beendet auch den Zugriff auf Quellen und Ableitungen.

Archivieren blendet das Gespräch samt untergeordneten Inhalten aus. Über den Archivfilter lässt es sich wiederherstellen. Vor dem Archivieren exportieren. Archivierung löscht keine Historie. Zum Lesen oder vollständigen Export archivierter Inhalte zuerst wiederherstellen. Der Eigentümer kann ein archiviertes Gespräch endgültig löschen: alle Sessions, Originale, Ableitungen und Versionen verschwinden in einer Transaktion. Nur Dateibytes, die kein anderer Datensatz mehr verwendet, werden entfernt. Andere Gespräche und Buckets bleiben erhalten. Diese Löschung kann nicht rückgängig gemacht werden. Endgültiges Löschen erfolgt ausschließlich in der Sessions-Oberfläche durch den Eigentümer; MCP und verwaltete Agenten können nicht löschen. Nach einer unbestätigten Lebenszyklusaktion den aktuellen Stand neu lesen. Die Kontolöschung nutzt weiterhin den bestehenden Löschpfad der Plattform. Es laufen weder automatische Verlaufssammlung noch Aufbewahrungsjobs, Nachrichtenversand, Gedächtnisübernahme oder Wiki-Veröffentlichung.

In der Oberfläche lädt „Session als JSON v1 herunterladen“ die ausgewählte Session im wieder importierbaren Format herunter (höchstens 4 MB). Titel und Beschreibung, Kontextverknüpfungen und alle vier Ergebnisarten sind dort ebenfalls bearbeitbar. Originaldateien können in der Oberfläche bis 500 KB angehängt werden.

Suchtreffer öffnen die konkrete Quelle oder das konkrete Ergebnis. Im Gespräch bleiben Sessiongrenzen sichtbar. Einzelne Originalstellen können als Quellen einer Ableitung ausgewählt werden; ohne Auswahl wird die ganze ausgewählte Session zitiert. „Originalquelle öffnen“ zeigt den damals zitierten Stand, einschließlich Paginierung. Spätere Einträge gehören nicht nachträglich zu diesem Stand. Eine Markierung zeigt, wenn Quellen inzwischen geändert wurden. Der aktuelle Zugriff wird auch für historische Quellen geprüft; Entzug einer Freigabe gilt sofort.

Teilnehmerbezeichnungen sind bearbeitbare Gesprächsmetadaten, keine Anmeldung und keine Berechtigung. recordedBy bleibt der vom Host ermittelte Importeur. Projekte werden mit dem bestehenden Tasks-Projektvertrag verknüpft. Aufgaben, Kontakte, Termine, Nachrichten und Wiki-Artikel bleiben im jeweiligen Plugin; ein Ergebnis oder eine Erkenntnis wird weder automatisch zu einer Aufgabe noch zu einem Fakt.

Importmeldungen unterscheiden Quellkonflikte und abgewiesene Geheimnisse. Zugangsdaten vor dem Import aus einer Exportkopie entfernen. Bereits gespeicherte Originale nicht verändern. Unterbrochene Importe mit derselben Quelle fortsetzen; der gesamte bereits gespeicherte Anfang wird vor einer Erweiterung geprüft. Werkzeugaufrufe, Bilder und andere Nichttextblöcke bleiben in raw erhalten, auch wenn die Textansicht sie nicht als ausführbare oder visuelle Elemente darstellt. Einzelne Anhänge sind in der Session abrufbar. Alle Grenzen gelten auch beim Wiedereinlesen eines Exports.

Arbeiten in der Oberfläche

Die Bibliothek trennt Gespräche, Originale, Ergebnisse, Sessions und Archiv. Suche im Originaltext über „Originale“; weitere Einschränkungen liegen unter „Filter“. Im Gespräch wählst du links eine Session und liest rechts den Verlauf. „Ergebnisse“ zeigt belegte Zusammenfassungen, Übergaben und Erkenntnisse; „Kontext“ enthält Verknüpfungen zu bestehenden Datensätzen anderer Plugins. Import, Bearbeitung, Fortsetzen und Freigabe öffnen jeweils einen Dialog. „Sessiondetails“ enthält Originalanhänge und den Sessionexport. Über das Menü „Weitere Aktionen“ sind Gesprächsexport und Archivierung erreichbar. Endgültiges Löschen ist dort erst nach der Archivierung möglich und verlangt eine Bestätigung.