@schlenkr/ragents 0.1.9 → 0.1.11

package/plugins/ragents.reference/walkthroughs.ts

@@ -1,219 +1,219 @@
 export const referenceWalkthroughs = [
   {
     id: "mini-app-owner-inspector",
-    title: "Den Helfer hinter einer Mini-App öffnen",
-    description: "Die Mini-App bleibt als Kachel sichtbar; ihr Besitzer ist auch ohne eigene Kachel erreichbar.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Fläche"],
+    title: "Open the helper behind a mini-app",
+    description: "The mini-app stays visible as a tile; its owner is reachable even without a tile of its own.",
+    tags: ["Use case", "Concept demo", "Surface"],
     steps: [
-      "Im Profil showcase Sammelboard einrichten öffnen und den Leitfaden abschließen. Erwartung: Die Liste steht als Kachel auf der Fläche; ihr Besitzer hat keine eigene Kachel.",
-      "In der Kopfzeile Actors öffnen und den Namen des Listenbesitzers wählen. Erwartung: Rechts öffnen sich dessen Chat und Details, ohne die Kachelaufteilung zu ändern.",
-      "Den Besitzer aus der Kopfzeile auf die Kachel der Liste ziehen und rechts andocken. Erwartung: Seine Kachel erscheint neben der Liste; die Mini-App bleibt bedienbar und behält ihre Einträge.",
-      "Die neue Kachel über das Kreuz in ihrer Kopfzeile wieder entfernen und die App erneut bedienen. Erwartung: Actor und Funktionen arbeiten weiter; sein Name bleibt in der Kopfzeile erreichbar.",
+      "In the showcase profile, open Set up collection board and complete the guide. Expected: The list is a tile on the surface; its owner has no tile of its own.",
+      "Open Actors in the header and choose the name of the list owner. Expected: Its chat and details open on the right without changing the tile layout.",
+      "Drag the owner from the header onto the list tile and dock it on the right. Expected: Its tile appears next to the list; the mini-app stays usable and keeps its entries.",
+      "Remove the new tile again with the cross in its title bar and use the app again. Expected: The actor and its functions keep working; its name stays reachable in the header.",
     ],
   },
   {
     id: "personal-tile-arrangement",
-    title: "Eine Gesprächsrunde anders aufteilen",
-    description: "Kacheln lassen sich persönlich umstellen und wieder auf die Programmvorgabe zurücksetzen.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Fläche"],
+    title: "Split a conversation circle differently",
+    description: "Tiles can be rearranged personally and reset to the program default.",
+    tags: ["Use case", "Concept demo", "Surface"],
     steps: [
-      "Im Profil showcase die Vorlage Gesprächsrunde einrichten ausführen und den Aufbau abwarten. Die vom Run gesetzte Aufteilung ansehen.",
-      "Eine Kachel an ihrer Kopfzeile fassen und am oberen Rand einer anderen Kachel andocken. Erwartung: Die Aufteilung ändert sich sofort; alle Gesprächspartner arbeiten weiter.",
-      "Die Trennlinie zwischen zwei Kacheln verschieben und denselben Run im selben Browser neu laden. Erwartung: Die persönliche Aufteilung bleibt erhalten; die Actors und die Programmanordnung sind unverändert.",
-      "In der Statusleiste Programmvorgabe übernehmen wählen. Erwartung: Die Fläche zeigt wieder die Aufteilung des Runs; der Knopf verschwindet, bis wieder eine eigene Änderung vorliegt.",
+      "In the showcase profile, run the template Set up conversation circle and wait for the setup. Look at the layout set by the run.",
+      "Grab a tile by its title bar and dock it at the top edge of another tile. Expected: The layout changes immediately; all conversation partners keep working.",
+      "Move the divider between two tiles and reload the same run in the same browser. Expected: The personal layout is kept; the actors and the program arrangement are unchanged.",
+      "Choose Apply program default in the status bar. Expected: The surface shows the run's layout again; the button disappears until there is another change of your own.",
     ],
   },
   {
     id: "global-run-overview",
-    title: "Zwei Runs im Blick behalten",
-    description: "Der globale Koordinator liest vorhandene Runs, während die aktuelle Fläche geöffnet bleibt.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Globaler Koordinator"],
+    title: "Keep an eye on two runs",
+    description: "The global coordinator reads existing runs while the current surface stays open.",
+    tags: ["Use case", "Concept demo", "Global coordinator"],
     steps: [
-      "Im Profil showcase zwei kurze Runs zu einer Leseliste und einem Wochenplan anlegen und ihre Antworten abwarten.",
-      "In die Eingabe Globaler Koordinator in der Kopfzeile klicken und damit seinen Verlauf öffnen. Um eine knappe Übersicht der beiden Runs mit ihrem jeweiligen Arbeitsstand bitten.",
-      "Die Run-Liste über die Übersichtsecke oder Cmd+I auf macOS beziehungsweise Ctrl+I öffnen, beide Runs auswählen und die Antwort mit ihren tatsächlichen Gesprächen vergleichen. Erwartung: Der globale Chat kann beide Journale berücksichtigen; ein Run-Wechsel erhält seinen eigenen Verlauf.",
-      "Einen ungesendeten Entwurf oben eingeben, Escape drücken und den Verlauf wieder öffnen. Erwartung: Das Dropdown schließt ohne Stopp; Entwurf, aktueller Run und globales Gespräch bleiben erhalten.",
+      "In the showcase profile, create two short runs about a reading list and a weekly plan and wait for their answers.",
+      "Click the Global coordinator input in the header to open its history. Ask for a brief overview of both runs with their current progress.",
+      "Open the run list via the overview corner or Cmd+I on macOS or Ctrl+I, select both runs, and compare the answer with their actual conversations. Expected: The global chat can take both journals into account; switching runs keeps its own history.",
+      "Type an unsent draft at the top, press Escape, and open the history again. Expected: The dropdown closes without stopping anything; the draft, the current run, and the global conversation are kept.",
     ],
   },
   {
     id: "global-prepared-run",
-    title: "Eine vorbereitete Runde global starten",
-    description: "Der globale Koordinator wählt aus dem vorhandenen Katalog ein Run-Script und erstellt damit einen neuen Run.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Globaler Koordinator"],
+    title: "Start a prepared circle globally",
+    description: "The global coordinator picks a run script from the existing catalog and creates a new run with it.",
+    tags: ["Use case", "Concept demo", "Global coordinator"],
     steps: [
-      "In die Eingabe Globaler Koordinator in der Kopfzeile klicken und bitten: Zeige die verfügbaren vorbereiteten Run-Scripts und starte Gesprächsrunde einrichten zum Thema gemeinsames Lernen mit zwei Runden.",
-      "Nach dem Senden die Kurzantwort direkt unter der Kopfzeile abwarten. Den Hinweis anklicken und die vollständige Antwort im Verlauf lesen. Falls der Startwert unklar ist, die Rückfrage anhand des angezeigten Katalogs beantworten; keine Modellkennung oder Run-ID abschreiben.",
-      "Den neuen Run über die Run-Liste öffnen. Erwartung: Ein eigener Run mit dem angeforderten Thema und dem vorbereiteten Aufbau entsteht. Die Annahme des Starts allein beweist noch keinen abgeschlossenen Gesprächsbeitrag.",
-      "Nach dem ersten tatsächlichen Beitrag unten Actors öffnen und einen Gesprächspartner im Inspector auswählen. Oben im globalen Chat fragen: Was macht dieser Actor? Erwartung: Die Frage erhält den Run und den ausgewählten Actor als getrennte Orientierung; der sichtbare Fragetext bleibt unverändert.",
-      "Nach dem Absenden einen anderen Run öffnen. Erwartung: Die bereits gesendete Frage bleibt an ihre ursprüngliche Auswahl gebunden, auch wenn sie erst später bearbeitet wird. Der globale Verlauf und beide Runs bleiben getrennt erreichbar.",
+      "Click the Global coordinator input in the header and ask: Show the available prepared run scripts and start Set up conversation circle on the topic of learning together with two rounds.",
+      "After sending, wait for the short answer directly below the header. Click the notice and read the full answer in the history. If the start value is unclear, answer the question based on the catalog shown; do not copy a model id or run id.",
+      "Open the new run from the run list. Expected: A separate run with the requested topic and the prepared setup is created. Acceptance of the start alone does not prove a completed conversation contribution.",
+      "After the first actual contribution, open Actors at the bottom and select a conversation partner in the inspector. At the top of the global chat, ask: What does this actor do? Expected: The question receives the run and the selected actor as separate orientation; the visible question text stays unchanged.",
+      "After sending, open another run. Expected: The question already sent stays bound to its original selection, even if it is processed only later. The global history and both runs stay reachable separately.",
     ],
   },
   {
     id: "reset-completed-global-chat",
-    title: "Nach einer Planung neu beginnen",
-    description: "Ein bestätigter Reset leert das globale Gespräch und lässt bestehende Runs und die Modellauswahl erhalten.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Gesprächsreset"],
+    title: "Start over after planning",
+    description: "A confirmed reset clears the global conversation and keeps existing runs and the model selection.",
+    tags: ["Use case", "Concept demo", "Conversation reset"],
     steps: [
-      "Im globalen Chat eine kurze Planung abschließen. Einen normalen Run geöffnet lassen und die aktuelle globale Modell- und Reasoningwahl merken.",
-      "Gespräch zurücksetzen wählen und die angezeigte Bestätigung ausdrücklich bestätigen. Die erfolgreiche Rückmeldung abwarten.",
-      "Erwartung: Verlauf, Eingabeentwurf und Anhänge des globalen Chats sind leer; der geöffnete normale Run sowie die Modell- und Reasoningwahl bestehen weiter.",
-      "Eine neue kurze Nachricht senden. Erwartung: Sie beginnt ein frisches globales Gespräch. Der Reset selbst hat keinen neuen Modellauftrag gestartet.",
+      "Complete a short planning session in the global chat. Keep a normal run open and note the current global model and reasoning selection.",
+      "Choose Reset conversation and explicitly confirm the confirmation shown. Wait for the success message.",
+      "Expected: The history, input draft, and attachments of the global chat are empty; the open normal run and the model and reasoning selection remain.",
+      "Send a new short message. Expected: It starts a fresh global conversation. The reset itself did not start a new model task.",
     ],
   },
   {
     id: "reset-without-losing-draft",
-    title: "Einen Reset zunächst abbrechen",
-    description: "Die Bestätigung schützt einen noch benötigten Gesprächsentwurf; erst der bestätigte zweite Versuch leert ihn.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Gesprächsreset"],
+    title: "Cancel a reset at first",
+    description: "The confirmation protects a conversation draft you still need; only the confirmed second attempt clears it.",
+    tags: ["Use case", "Concept demo", "Conversation reset"],
     steps: [
-      "Im globalen Chat einen kurzen Entwurf eingeben, ohne ihn zu senden. Gespräch zurücksetzen öffnen und die Bestätigung abbrechen.",
-      "Erwartung: Entwurf und bestehender Verlauf bleiben erhalten. Die bloße Anzeige der Bestätigung setzt nichts zurück.",
-      "Gespräch zurücksetzen erneut öffnen und diesmal bestätigen. Während des Resets keine weitere Nachricht senden.",
-      "Erwartung: Nach Erfolg sind Entwurf und Verlauf leer. Bei einem Fehler bleibt dessen Meldung sichtbar und erlaubt einen erneuten Versuch; ein Fehler darf nicht als erfolgreicher Reset gelten.",
+      "Type a short draft in the global chat without sending it. Open Reset conversation and cancel the confirmation.",
+      "Expected: The draft and the existing history are kept. Merely showing the confirmation resets nothing.",
+      "Open Reset conversation again and confirm this time. Do not send another message during the reset.",
+      "Expected: After success, the draft and history are empty. On an error, its message stays visible and allows a retry; an error must not count as a successful reset.",
     ],
   },
   {
     id: "coordinator-model-settings",
-    title: "Den Koordinator für kurze Antworten einstellen",
-    description: "Modell und Reasoning werden direkt im globalen Chat gewählt und in den Einstellungen wiedergefunden.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Einstellungen und Modellwahl"],
+    title: "Set up the coordinator for short answers",
+    description: "Model and reasoning are chosen directly in the global chat and can be found again in the settings.",
+    tags: ["Use case", "Concept demo", "Settings and model selection"],
     steps: [
-      "Den globalen Verlauf über die Toolbar-Eingabe öffnen und im Dropdown oberhalb des Verlaufs ein angebotenes Modell und eine dort verfügbare Reasoning-Stufe wählen. Keine nicht angebotene Stufe voraussetzen.",
-      "Die bestätigte Speicherung abwarten und danach eine kurze Frage stellen. Erwartung: Neue Arbeit verwendet die gespeicherte Auswahl; ein schon laufender Turn wird dadurch nicht rückwirkend verändert.",
-      "Das Zahnrad öffnen und unter Modelle die Einstellung Globaler Koordinator ansehen. Erwartung: Beide Ansichten zeigen dieselbe bestätigte Auswahl.",
-      "Falls ein Modellwechsel wegen bereits vorhandener Medien abgelehnt wird, die sichtbare Fehlermeldung beachten. Erwartung: Die bisherige gültige Auswahl bleibt erhalten.",
+      "Open the global history via the toolbar input and, in the dropdown above the history, choose an offered model and a reasoning level available there. Do not assume a level that is not offered.",
+      "Wait for the confirmed save and then ask a short question. Expected: New work uses the saved selection; a turn that is already running is not changed retroactively.",
+      "Open the gear and look at the Global coordinator setting under Models. Expected: Both views show the same confirmed selection.",
+      "If a model change is rejected because of media that already exists, note the visible error message. Expected: The previous valid selection is kept.",
     ],
   },
   {
     id: "title-model-selection",
-    title: "Das Modell für kurze Überschriften wählen",
-    description: "Ein eigenes Modell verdichtet den Auftrag in der Run-Liste, ohne die Modelle der Agenten zu ändern.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Einstellungen und Modellwahl"],
+    title: "Choose the model for short titles",
+    description: "A separate model condenses the task in the run list without changing the agents' models.",
+    tags: ["Use case", "Concept demo", "Settings and model selection"],
     steps: [
-      "Über das Zahnrad Einstellungen, Modelle und Überschriften öffnen. Bei einer großen Liste mit der Suche ein angebotenes Modell finden, auswählen und Speichern wählen.",
-      "Die bestätigte Speicherung abwarten. Erwartung: Die Auswahl bleibt im Formular erhalten; Globaler Koordinator sowie Neue Runs und Agenten behalten ihre eigenen Einstellungen.",
-      "Einen neuen Run mit einem ausführlicheren Auftrag beginnen und die Run-Liste öffnen. Erwartung: Der ursprüngliche Auftrag ist bereits sichtbar. Sobald ein automatischer Titel erfolgreich erzeugt und gespeichert ist, erscheint die kurze Überschrift ohne zusätzlichen manuellen Listenabruf. Eine feste Antwortzeit wird nicht vorausgesetzt.",
-      "Eine andere Modellwahl als Entwurf einstellen und Änderungen verwerfen wählen. Erwartung: Die bestätigte Auswahl kehrt zurück; ein schon erzeugter Titel wird nicht ersetzt.",
+      "Open Settings, Models, and Titles via the gear. With a large list, use the search to find an offered model, select it, and choose Save.",
+      "Wait for the confirmed save. Expected: The selection stays in the form; Global coordinator as well as New runs and agents keep their own settings.",
+      "Start a new run with a more detailed task and open the run list. Expected: The original task is already visible. As soon as an automatic title has been generated and saved successfully, the short title appears without an additional manual list refresh. No fixed response time is assumed.",
+      "Set a different model selection as a draft and choose Discard changes. Expected: The confirmed selection returns; a title that was already generated is not replaced.",
     ],
   },
   {
     id: "disable-generated-titles",
-    title: "Automatische Überschriften ausschalten",
-    description: "Neue Erzeugungen lassen sich deaktivieren; vorhandene und ausdrücklich gesetzte Titel bleiben erhalten.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Einstellungen und Modellwahl"],
+    title: "Turn off automatic titles",
+    description: "New generation can be disabled; existing and explicitly set titles are kept.",
+    tags: ["Use case", "Concept demo", "Settings and model selection"],
     steps: [
-      "Einen Run mit bereits erzeugtem Kurztitel in der Run-Liste ansehen. Unter Einstellungen, Modelle, Überschriften Keine automatischen Überschriften auswählen und speichern.",
-      "Die Anwendung neu laden und die Einstellung erneut ansehen. Erwartung: Die Deaktivierung ist gespeichert; der bestehende Kurztitel bleibt unverändert.",
-      "Einen weiteren Run mit einem normalen Auftrag beginnen. Erwartung: Die Run-Liste zeigt den Auftrag, ohne dafür einen automatischen Kurztitel anzufordern.",
-      "Optional Sammelboard einrichten starten und im Leitfaden einen Namen vorgeben. Erwartung: Der vorbereitete Ablauf setzt weiterhin seinen eigenen Run-Titel. Ein später wieder aktiviertes Titelmodell überschreibt diesen Namen nicht.",
+      "Look at a run with an already generated short title in the run list. Under Settings, Models, Titles, select No automatic titles and save.",
+      "Reload the application and look at the setting again. Expected: The deactivation is saved; the existing short title stays unchanged.",
+      "Start another run with a normal task. Expected: The run list shows the task without requesting an automatic short title for it.",
+      "Optionally start Set up collection board and enter a name in the guide. Expected: The prepared flow still sets its own run title. A title model that is enabled again later does not overwrite this name.",
     ],
   },
   {
     id: "extension-capability-settings",
-    title: "Eine Fähigkeit ihrem Plugin zuordnen",
-    description: "Die beiden Ansichten der Einstellungen erschließen denselben Bestand aus unterschiedlichen Richtungen.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Einstellungen und Modellwahl"],
+    title: "Map a capability to its plugin",
+    description: "The two views of the settings open up the same inventory from different directions.",
+    tags: ["Use case", "Concept demo", "Settings and model selection"],
     steps: [
-      "Über das Zahnrad die Einstellungen öffnen und zu Plugins wechseln. In Nach Plugin das Actor-Programm-Plugin auswählen und ihre Werkzeuge und Web-Beiträge ansehen.",
-      "Zu Nach Fähigkeit wechseln, Werkzeuge auswählen und nach actor_program suchen. Erwartung: Die passenden Beiträge erscheinen mit ihrem jeweiligen Plugin als Eigentümer.",
-      "Den Link zum Actor-Programm-Plugin öffnen. Erwartung: Sein vollständiges Inventar ist wieder sichtbar; ein vorheriger Suchfilter verdeckt die Detailseite nicht.",
-      "Zu Modelle wechseln und die Koordinator-Modellwahl öffnen. Nur tatsächlich angebotene Werte sind wählbar; eine ungültige Kombination wird nicht still ersetzt.",
+      "Open the settings via the gear and switch to Plugins. In By plugin, select the actor program plugin and look at its tools and web contributions.",
+      "Switch to By capability, select Tools, and search for actor_program. Expected: The matching contributions appear with their respective plugin as owner.",
+      "Open the link to the actor program plugin. Expected: Its complete inventory is visible again; a previous search filter does not hide the detail page.",
+      "Switch to Models and open the coordinator model selection. Only values that are actually offered can be selected; an invalid combination is not silently replaced.",
     ],
   },
   {
     id: "language-server-process",
-    title: "Den Sprachserver als Run-Prozess sehen",
-    description: "Eine TypeScript-Prüfung macht den zugehörigen Sprachserver in der Prozessanzeige sichtbar.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Prozessanzeige"],
+    title: "See the language server as a run process",
+    description: "A TypeScript check makes the associated language server visible in the process display.",
+    tags: ["Use case", "Concept demo", "Process display"],
     steps: [
-      "Im Profil showcase die Skill-Vorlage Fehler in einer Terminliste finden ausführen. Voraussetzung ist ein verfügbarer TypeScript-Sprachserver; eine fehlende Voraussetzung muss als Fehler gemeldet werden.",
-      "Nach dem Öffnen des Sprachservers die gemeinsame Kopfzeile des Runs ansehen. Erwartung: Der verwaltete Sprachserver erscheint als zu diesem Run gehörender Prozess.",
-      "Einen anderen Run öffnen und zurückwechseln. Erwartung: Die Prozessanzeige folgt dem ausgewählten Run und ist kein gemeinsames Verzeichnis aller Rechnerprozesse.",
-      "Die Prozessanzeige dient der Beobachtung. Sie bietet keinen Beenden-Knopf; fehlende Betriebssystemrechte oder Werkzeuge werden als sichtbarer Fehler gemeldet.",
+      "In the showcase profile, run the skill template Find errors in an appointment list. It requires an available TypeScript language server; a missing prerequisite must be reported as an error.",
+      "After the language server has been opened, look at the run's shared header. Expected: The managed language server appears as a process belonging to this run.",
+      "Open another run and switch back. Expected: The process display follows the selected run and is not a shared list of all processes on the machine.",
+      "The process display is for observation. It offers no stop button; missing operating system permissions or tools are reported as a visible error.",
     ],
   },
   {
     id: "local-preview-process",
-    title: "Eine kurzlebige lokale Vorschau öffnen",
-    description: "Ein zeitlich begrenzter Demo-Webprozess erscheint mit seinem erkannten Port in der Kopfzeile.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Prozessanzeige"],
+    title: "Open a short-lived local preview",
+    description: "A time-limited demo web process appears in the header with its detected port.",
+    tags: ["Use case", "Concept demo", "Process display"],
     steps: [
-      "In einem eigenen showcase-Run den Koordinator bitten, einen kleinen Node-Demoprozess im Run-Arbeitsverzeichnis vorzubereiten: Er liefert nur einen neutralen Begrüßungstext, bindet ausschließlich 127.0.0.1 auf einem freien Port und beendet sich nach zwei Minuten selbst. Keine zusätzlichen Pakete installieren und keinen Produktserver ersetzen.",
-      "Den vorbereiteten Demoprozess starten lassen und bei laufender Ausführung die Kopfzeile ansehen. Erwartung: Der Prozess erscheint mit einem Link auf seinen erkannten offenen Port.",
-      "Den Port-Link nur auf demselben Rechner öffnen. Erwartung: Die lokale Demoantwort erscheint; bei einem entfernten Server ist dessen Loopback-Adresse nicht die Adresse des Browsers.",
-      "Das vorgesehene automatische Ende abwarten. Erwartung: Der Eintrag verschwindet nach der nächsten Prozessaktualisierung. Run-Stopp oder das Schließen eines Tabs werden hier nicht als Beenden eines abgesetzten Dienstes versprochen.",
+      "In a separate showcase run, ask the coordinator to prepare a small Node demo process in the run workspace: It only serves a neutral greeting text, binds exclusively to 127.0.0.1 on a free port, and exits by itself after two minutes. Do not install additional packages and do not replace a product server.",
+      "Have the prepared demo process started and look at the header while it runs. Expected: The process appears with a link to its detected open port.",
+      "Open the port link only on the same machine. Expected: The local demo response appears; with a remote server, its loopback address is not the browser's address.",
+      "Wait for the intended automatic end. Expected: The entry disappears after the next process refresh. Stopping the run or closing a tab is not promised here to end a detached service.",
     ],
   },
   {
     id: "workspace-draft-preview",
-    title: "Einen Entwurf im Dateibaum lesen",
-    description: "Ein Run schreibt einen kleinen Text; der Dateireiter zeigt Inhalt und spätere Änderung ohne eigenen Editor.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Dateien und Arbeitsverzeichnis"],
+    title: "Read a draft in the file tree",
+    description: "A run writes a small text; the files tab shows its content and a later change without an editor of its own.",
+    tags: ["Use case", "Concept demo", "Files and workspace"],
     steps: [
-      "In einem neuen showcase-Run den Koordinator bitten, im Run-Arbeitsverzeichnis die Datei reading-list.md mit drei neutralen Lesethemen anzulegen.",
-      "Den Reiter Dateien öffnen, das Arbeitsverzeichnis aufklappen und reading-list.md auswählen. Erwartung: Der geschriebene Text erscheint als Vorschau.",
-      "Im Chat ein viertes Thema ergänzen lassen und zur weiterhin geöffneten Vorschau zurückkehren. Erwartung: Die Dateiänderung wird im Dateibrowser sichtbar.",
-      "Erwartung: Der Dateireiter bleibt eine Leseansicht. Änderungen erfolgen durch den beauftragten Actor und dessen Dateiwerkzeuge, nicht durch einen eingebauten Editor oder Löschknopf.",
+      "In a new showcase run, ask the coordinator to create the file reading-list.md with three neutral reading topics in the run workspace.",
+      "Open the Files tab, expand the workspace, and select reading-list.md. Expected: The written text appears as a preview.",
+      "Have a fourth topic added in the chat and return to the preview that is still open. Expected: The file change becomes visible in the file browser.",
+      "Expected: The files tab stays a read-only view. Changes are made by the assigned actor and its file tools, not by a built-in editor or delete button.",
     ],
   },
   {
     id: "separate-run-files",
-    title: "Gleichnamige Dateien in zwei Runs vergleichen",
-    description: "Zwei unabhängige Arbeitsverzeichnisse enthalten eigene Dateien mit demselben Namen.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Dateien und Arbeitsverzeichnis"],
+    title: "Compare files with the same name in two runs",
+    description: "Two independent workspaces contain their own files with the same name.",
+    tags: ["Use case", "Concept demo", "Files and workspace"],
     steps: [
-      "Einen showcase-Run Leseliste anlegen und darin notes.md mit dem Inhalt Lesen vorbereiten schreiben lassen.",
-      "Einen zweiten showcase-Run Wochenplan anlegen und dort ebenfalls notes.md schreiben lassen, diesmal mit dem Inhalt Woche planen. Keine Datei zwischen Runs kopieren.",
-      "In beiden Runs nacheinander den Reiter Dateien öffnen und notes.md lesen. Erwartung: Der gleiche Dateiname zeigt den jeweils eigenen Inhalt des Run-Arbeitsverzeichnisses.",
-      "Nur im Wochenplan eine Zeile ergänzen lassen und beide Vorschauen erneut prüfen. Erwartung: Die Datei des Leselisten-Runs ist unverändert.",
+      "Create a showcase run Reading list and have it write notes.md with the content Prepare reading.",
+      "Create a second showcase run Weekly plan and have it also write notes.md, this time with the content Plan the week. Do not copy any file between runs.",
+      "Open the Files tab in both runs one after the other and read notes.md. Expected: The same file name shows the respective content of each run workspace.",
+      "Have a line added only in the weekly plan and check both previews again. Expected: The file of the reading list run is unchanged.",
     ],
   },
   {
     id: "restore-shared-list",
-    title: "Eine gemeinsame Liste nach Neustart wiederfinden",
-    description: "Eine abgeschlossene Actor-Funktion bleibt beim regulären Neustart desselben Profils erhalten.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Wiederherstellung nach Neustart"],
+    title: "Find a shared list again after a restart",
+    description: "A completed actor function is kept when the same profile is restarted normally.",
+    tags: ["Use case", "Concept demo", "Recovery after restart"],
     steps: [
-      "Im Profil showcase Sammelboard einrichten öffnen und den Leitfaden abschließen. Einen eindeutig erkennbaren Eintrag hinzufügen und die bestätigte Aktualisierung der Liste abwarten.",
-      "Alle laufenden Arbeiten abschließen lassen. Den lokalen Server selbst über den für diese Installation verwendeten Startweg beenden und mit demselben Profil und Datenverzeichnis neu starten. Keine Daten löschen und keine zweite Serverinstanz parallel starten.",
-      "Die Anwendung erneut öffnen und denselben Run auswählen. Erwartung: Gespräch, Mini-App und bestätigter Listeneintrag sind wieder vorhanden.",
-      "Die Liste auf doppelte Einträge prüfen. Erwartung: Der Neustart stellt gespeicherten Zustand wieder her, führt die bereits abgeschlossene Hinzufügeaktion aber nicht erneut aus. Das Journal allein ersetzt keine vollständige Sicherung der übrigen Run-Dateien.",
+      "In the showcase profile, open Set up collection board and complete the guide. Add a clearly recognizable entry and wait for the confirmed update of the list.",
+      "Let all running work finish. Stop the local server yourself using the start method used for this installation and restart it with the same profile and data directory. Do not delete any data and do not start a second server instance in parallel.",
+      "Open the application again and select the same run. Expected: The conversation, the mini-app, and the confirmed list entry are present again.",
+      "Check the list for duplicate entries. Expected: The restart restores the saved state but does not run the already completed add action again. The journal alone does not replace a complete backup of the other run files.",
     ],
   },
   {
     id: "restore-conversation-context",
-    title: "Zwei Gesprächsverläufe nach Neustart fortsetzen",
-    description: "Normaler Run und globaler Koordinator behalten ihre jeweils eigene Geschichte.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Wiederherstellung nach Neustart"],
+    title: "Continue two conversation histories after a restart",
+    description: "A normal run and the global coordinator each keep their own history.",
+    tags: ["Use case", "Concept demo", "Recovery after restart"],
     steps: [
-      "In einem normalen showcase-Run drei Lernziele besprechen und im globalen Chat eine knappe Übersicht dieses Runs anfordern. Beide Antworten vollständig abwarten und die globale Modellwahl merken.",
-      "Den lokalen Server selbst über den vorhandenen Startweg neu starten, mit demselben Profil und Datenverzeichnis. Keine Dateien entfernen oder zwischen Installationen übertragen.",
-      "Den normalen Run und anschließend den globalen Chat öffnen. Erwartung: Beide bisherigen Verläufe und die globale Modellwahl sind erhalten.",
-      "Im normalen Run um den nächsten Schritt zu den Lernzielen bitten. Die neue Antwort als neue Arbeit behandeln; der Neustart hat alte Modellaufrufe nicht wiederholt. Ein beim Neustart noch offener Turn wäre unterbrochen abgeschlossen worden und wird nicht automatisch erneut ausgeführt.",
+      "In a normal showcase run, discuss three learning goals and request a brief overview of this run in the global chat. Wait for both answers to complete and note the global model selection.",
+      "Restart the local server yourself using the existing start method, with the same profile and data directory. Do not remove any files or transfer them between installations.",
+      "Open the normal run and then the global chat. Expected: Both previous histories and the global model selection are kept.",
+      "In the normal run, ask for the next step on the learning goals. Treat the new answer as new work; the restart did not repeat old model calls. A turn that was still open during the restart would have been completed as interrupted and is not run again automatically.",
     ],
   },
   {
     id: "image-paste-conversation",
-    title: "Eine eigene Skizze im Chat besprechen",
-    description: "Ein Bild aus der Zwischenablage wird vor dem Senden geprüft und danach als Anhang im Verlauf gezeigt.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Multimodale Eingaben"],
+    title: "Discuss your own sketch in the chat",
+    description: "An image from the clipboard is checked before sending and then shown as an attachment in the history.",
+    tags: ["Use case", "Concept demo", "Multimodal input"],
     steps: [
-      "Eine eigene unkritische Skizze in die Zwischenablage kopieren. Einen neuen Run öffnen und ein angebotenes Modell wählen, das Bildeingaben unterstützt.",
-      "Das Bild mit Cmd+V oder Ctrl+V in die Chat-Eingabe einfügen. Erwartung: Eine Bildvorschau erscheint, lässt sich vor dem Senden wieder entfernen und wurde noch nicht allein durch das Einfügen gesendet.",
-      "Mit der Frage Welche drei Formen erkennst du? senden. Erwartung: Nach erfolgreicher Annahme stehen Nachricht und dauerhafter Bildanhang im Verlauf; die Antwort wird gegen die tatsächliche Skizze geprüft.",
-      "Falls das Zielmodell keine Bildeingaben unterstützt, muss der Composer das Senden mit einer verständlichen Meldung blockieren. Kein passendes Modell im Katalog ist eine fehlende Voraussetzung, kein Anlass für einen behaupteten Bildbefund.",
+      "Copy a harmless sketch of your own to the clipboard. Open a new run and choose an offered model that supports image input.",
+      "Paste the image into the chat input with Cmd+V or Ctrl+V. Expected: An image preview appears, can be removed again before sending, and has not been sent merely by pasting.",
+      "Send with the question Which three shapes do you recognize? Expected: After successful acceptance, the message and a persistent image attachment are in the history; the answer is checked against the actual sketch.",
+      "If the target model does not support image input, the composer must block sending with an understandable message. No matching model in the catalog is a missing prerequisite, not a reason for a claimed image finding.",
     ],
   },
   {
     id: "video-and-document-drop",
-    title: "Einen kurzen Clip mit seinem Ablaufplan vergleichen",
-    description: "Video und PDF werden per Drag-and-drop ausdrücklich an ein geeignetes Modell gesendet.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Multimodale Eingaben"],
-    steps: [
-      "Einen eigenen kurzen, unkritischen Videoclip und einen kleinen PDF-Ablaufplan bereitlegen. Einen Chat mit einem angebotenen Modell öffnen, dessen veröffentlichte Eingabefähigkeiten sowohl Video als auch native PDFs erlauben. Gibt es kein solches Modell, ist dieser Ablauf nicht ausführbar.",
-      "Beide Dateien in die Chat-Eingabe ziehen. Erwartung: Der Clip erhält eine Vorschau und das PDF eine Dateiangabe; Anhänge lassen sich einzeln entfernen. Sichtbare Größen- oder Fähigkeitsfehler vor dem Senden beheben.",
-      "Mit der Frage Welche geplanten Schritte sind im Clip sichtbar? senden und die tatsächliche Antwort mit Clip und Ablaufplan vergleichen. Erwartung: Die Anhänge bleiben im Verlauf erneut erreichbar.",
-      "Bei fehlender Video- oder PDF-Unterstützung bleibt das Senden blockiert. Es gibt hier keine stille OCR-Ausweichverarbeitung und keine Zusage, dass jedes angebotene Modell die Dateien versteht.",
+    title: "Compare a short clip with its schedule",
+    description: "Video and PDF are explicitly sent to a suitable model via drag and drop.",
+    tags: ["Use case", "Concept demo", "Multimodal input"],
+    steps: [
+      "Prepare a short, harmless video clip of your own and a small PDF schedule. Open a chat with an offered model whose published input capabilities allow both video and native PDFs. If there is no such model, this flow cannot be run.",
+      "Drag both files into the chat input. Expected: The clip gets a preview and the PDF a file label; attachments can be removed individually. Fix visible size or capability errors before sending.",
+      "Send with the question Which planned steps are visible in the clip? and compare the actual answer with the clip and the schedule. Expected: The attachments stay reachable again in the history.",
+      "Without video or PDF support, sending stays blocked. There is no silent OCR fallback here and no promise that every offered model understands the files.",
     ],
   },
 ];

package/plugins/ragents.reference/web/StartGuides.tsx

@@ -9,7 +9,7 @@ const hintClass = "leading-[1.5] text-muted-foreground";
 const actionsClass = "flex flex-wrap justify-end gap-2.5 pt-2";
 
 export function ConversationGuide({ onCancel, onComplete }: EntryGuideContext) {
-  const [topic, setTopic] = useState("Sollten Innenstädte autofrei werden?");
+  const [topic, setTopic] = useState("Should city centers become car-free?");
   const [rounds, setRounds] = useState("2");
   const count = Number(rounds);
   const valid = topic.trim().length > 0 && Number.isInteger(count) && count >= 1 && count <= 5;
@@ -19,16 +19,16 @@ export function ConversationGuide({ onCancel, onComplete }: EntryGuideContext) {
       event.preventDefault();
       if (valid) onComplete({ topic: topic.trim(), rounds: count });
     }}>
-      <p className={introClass}>Drei Perspektiven auf eine Frage. Der Koordinator führt durch die Runde und fasst die Ergebnisse zusammen.</p>
+      <p className={introClass}>Three perspectives on one question. The coordinator leads the round and summarizes the results.</p>
       <label className={fieldClass}>
-        <span>Worüber soll die Runde sprechen?</span>
+        <span>What should the round talk about?</span>
         <Textarea autoFocus maxLength={160} onChange={(event) => setTopic(event.target.value)} required rows={3} value={topic} />
       </label>
-      <div aria-label="Gesprächspartner" className="grid grid-cols-3 gap-3.5 max-sm:grid-cols-1 max-sm:gap-2">
+      <div aria-label="Conversation partners" className="grid grid-cols-3 gap-3.5 max-sm:grid-cols-1 max-sm:gap-2">
         {[
-          { name: "Mira", role: "Fragt neugierig nach" },
-          { name: "Jon", role: "Widerspricht höflich" },
-          { name: "Ada", role: "Sucht Gemeinsamkeiten" },
+          { name: "Mira", role: "Asks curious questions" },
+          { name: "Jon", role: "Politely disagrees" },
+          { name: "Ada", role: "Looks for common ground" },
         ].map((partner) => (
           <div className="grid gap-[7px] rounded-lg bg-secondary p-3.5" key={partner.name}>
             <strong>{partner.name}</strong>
@@ -37,21 +37,21 @@ export function ConversationGuide({ onCancel, onComplete }: EntryGuideContext) {
         ))}
       </div>
       <label className={fieldClass}>
-        <span>Runden</span>
+        <span>Rounds</span>
         <Input className="max-w-25" max={5} min={1} onChange={(event) => setRounds(event.target.value)} required step={1} type="number" value={rounds} />
-        <small className={hintClass}>1 bis 5 Runden, mit einem Beitrag pro Person und Runde.</small>
+        <small className={hintClass}>1 to 5 rounds, with one contribution per person and round.</small>
       </label>
       <div className={actionsClass}>
-        <Button onClick={onCancel} variant="outline">Abbrechen</Button>
-        <Button disabled={!valid} type="submit">Gespräch starten</Button>
+        <Button onClick={onCancel} variant="outline">Cancel</Button>
+        <Button disabled={!valid} type="submit">Start conversation</Button>
       </div>
     </form>
   );
 }
 
 export function SharedBoardGuide({ onCancel, onComplete }: EntryGuideContext) {
-  const [title, setTitle] = useState("Ideen für unser Teamfrühstück");
-  const [firstEntry, setFirstEntry] = useState("Jeder bringt etwas aus seiner Lieblingsküche mit.");
+  const [title, setTitle] = useState("Ideas for our team breakfast");
+  const [firstEntry, setFirstEntry] = useState("Everyone brings something from their favorite cuisine.");
   const valid = title.trim().length > 0 && firstEntry.trim().length > 0;
 
   return (
@@ -59,30 +59,30 @@ export function SharedBoardGuide({ onCancel, onComplete }: EntryGuideContext) {
       event.preventDefault();
       if (valid) onComplete({ title: title.trim(), firstEntry: firstEntry.trim() });
     }}>
-      <p className={introClass}>Sammelt Ideen, Fragen oder Aufgaben an einem Ort. Du ergänzt die Liste in seiner View, der Listenhelfer über sein Werkzeug.</p>
+      <p className={introClass}>Collects ideas, questions, or tasks in one place. You add to the list in its view, the list helper through its tool.</p>
       <div className="grid grid-cols-2 gap-6 max-sm:grid-cols-1">
         <div className="grid min-w-0 gap-5.5">
           <label className={fieldClass}>
-            <span>Was wollt ihr sammeln?</span>
+            <span>What do you want to collect?</span>
             <Input autoFocus maxLength={160} onChange={(event) => setTitle(event.target.value)} required value={title} />
           </label>
           <label className={fieldClass}>
-            <span>Erster Eintrag</span>
+            <span>First entry</span>
             <Textarea maxLength={2000} onChange={(event) => setFirstEntry(event.target.value)} required rows={5} value={firstEntry} />
           </label>
         </div>
-        <aside aria-label="Vorschau des Sammelboards">
+        <aside aria-label="Collection board preview">
           <Card className="h-full gap-0 bg-secondary p-5 [overflow-wrap:anywhere]">
-            <small className={hintClass}>So beginnt eure Sammlung</small>
-            <h3 className="mt-3 mb-4.5 text-[1.05rem]">{title.trim() || "Titel der Sammlung"}</h3>
-            <ol className="list-decimal pl-5.5 leading-[1.6] whitespace-pre-wrap"><li>{firstEntry.trim() || "Dein erster Eintrag"}</li></ol>
-            <p className="mt-5.5 text-[0.85rem] leading-[1.5] text-muted-foreground">Der Listenhelfer trägt diesen Eintrag nach dem Start ein. Danach könnt ihr beide ergänzen.</p>
+            <small className={hintClass}>This is how your collection starts</small>
+            <h3 className="mt-3 mb-4.5 text-[1.05rem]">{title.trim() || "Collection title"}</h3>
+            <ol className="list-decimal pl-5.5 leading-[1.6] whitespace-pre-wrap"><li>{firstEntry.trim() || "Your first entry"}</li></ol>
+            <p className="mt-5.5 text-[0.85rem] leading-[1.5] text-muted-foreground">The list helper adds this entry after the start. After that, both of you can add more.</p>
           </Card>
         </aside>
       </div>
       <div className={actionsClass}>
-        <Button onClick={onCancel} variant="outline">Abbrechen</Button>
-        <Button disabled={!valid} type="submit">Sammelboard starten</Button>
+        <Button onClick={onCancel} variant="outline">Cancel</Button>
+        <Button disabled={!valid} type="submit">Start collection board</Button>
       </div>
     </form>
   );