DIALOGSTORE

Der DIALOGSTORE-Service bietet Funktionen zur Speicherung, zum Abruf und zur Wiederherstellung von Chatverläufen. Du kannst den aktuellen Dialog auslesen, im LocalStorage sichern und später wiederherstellen – z. B. um eine Konversation nach einem Seitenneuladen fortzusetzen oder einen bestimmten Dialogzustand zu replizieren.

---

.getCurrentDialog()

Gibt den kompletten Chatverlauf des aktuellen Chats als Array von HistoryItemResponse-Objekten zurück.

Rückgabe: Promise<HistoryItemResponse[]>

const dialog = await RAGAI.DIALOGSTORE.getCurrentDialog();
console.log('Nachrichten im Dialog:', dialog.length);

---

.storeDialogToLocalStorage(key)

Speichert den aktuellen Chatverlauf im LocalStorage unter dem angegebenen Schlüssel. Gibt eine ID zurück, mit der du den Dialog später wiederherstellen kannst.

Parameter	Typ	Beschreibung
key	string	Ein eindeutiger Schlüssel, unter dem der Dialog gespeichert wird.

Rückgabe: Promise<string> – Die generierte Dialog-ID.

const dialogId = await RAGAI.DIALOGSTORE.storeDialogToLocalStorage('mein-dialog');
console.log('Dialog gespeichert unter:', dialogId);

---

.restoreDialogFromLocalStorage(dialogId, removeExisting?, ignoreExisting?)

Stellt einen zuvor gespeicherten Dialog aus dem LocalStorage wieder her.

Parameter	Typ	Pflicht	Beschreibung
dialogId	string	ja	Die ID des gespeicherten Dialogs.
removeExisting	boolean	nein	Wenn true, werden bestehende Nachrichten im Chat vor der Wiederherstellung entfernt.
ignoreExisting	boolean	nein	Wenn true, werden bereits vorhandene Nachrichten beim Wiederherstellen übersprungen.

Rückgabe: Promise<HistoryItemResponse[] | null> – Der wiederhergestellte Dialog oder null, wenn kein Dialog gefunden wurde.

const dialog = await RAGAI.DIALOGSTORE.restoreDialogFromLocalStorage('mein-dialog-id', true);
if (dialog) {
  console.log('Dialog wiederhergestellt:', dialog.length, 'Nachrichten');
}

---

.createDialogMessageFromHistoryItem(item)

Erzeugt aus einem HistoryItemResponse-Objekt eine DialogMessage, die im Chat angezeigt werden kann.

Parameter	Typ	Beschreibung
item	HistoryItemResponse	Ein Element aus dem Chatverlauf.

Rückgabe: DialogMessage

const dialog = await RAGAI.DIALOGSTORE.getCurrentDialog();
const message = RAGAI.DIALOGSTORE.createDialogMessageFromHistoryItem(dialog[0]);
console.log('Erstellte Nachricht:', message);

---

.addDialogMessagesFromHistoryItems(historyItems, ignoreExisting)

Fügt mehrere Nachrichten aus einem Array von HistoryItemResponse-Objekten dem aktuellen Chat hinzu.

Parameter	Typ	Beschreibung
historyItems	HistoryItemResponse[]	Array der hinzuzufügenden Chatverlauf-Elemente.
ignoreExisting	boolean	Wenn true, werden bereits vorhandene Nachrichten übersprungen.

const dialog = await RAGAI.DIALOGSTORE.getCurrentDialog();
RAGAI.DIALOGSTORE.addDialogMessagesFromHistoryItems(dialog, true);

---

.overrideDialogFromLocalStorage(dialogId)

Ersetzt den kompletten aktuellen Chat durch den gespeicherten Dialog. Bestehende Nachrichten werden entfernt.

Parameter	Typ	Beschreibung
dialogId	string	Die ID des gespeicherten Dialogs.

await RAGAI.DIALOGSTORE.overrideDialogFromLocalStorage('mein-dialog-id');

---

.appendDialogFromLocalStorage(dialogId)

Hängt die Nachrichten eines gespeicherten Dialogs an den aktuellen Chat an. Bereits vorhandene Nachrichten werden nicht übersprungen.

Parameter	Typ	Beschreibung
dialogId	string	Die ID des gespeicherten Dialogs.

await RAGAI.DIALOGSTORE.appendDialogFromLocalStorage('mein-dialog-id');

---

.appendDialogFromLocalStorageIgnoreExisting(dialogId)

Hängt die Nachrichten eines gespeicherten Dialogs an den aktuellen Chat an. Bereits vorhandene Nachrichten werden dabei übersprungen.

Parameter	Typ	Beschreibung
dialogId	string	Die ID des gespeicherten Dialogs.

await RAGAI.DIALOGSTORE.appendDialogFromLocalStorageIgnoreExisting('mein-dialog-id');