@schlenkr/ragents 0.1.4 → 0.1.5

package/README.md

@@ -22,7 +22,8 @@ npm install -g @schlenkr/ragents
   RAGENTS_TOKEN=<token> ragents connect https://ragents.example.com
   ```
 
-- `start <profile|path>` - start a profile shipped with the package (`core`, `developer`), your
+- `start <profile|path>` - start a profile shipped with the package (`core`, `developer`,
+  `showcase`), your
   own `ragents.config.<name>.ts` anywhere on disk, or a stand that `connect` already fetched,
   without asking the server. The web interface is built for that set of plugins when it is
   missing or was last built for another profile or host version; the result goes to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schlenkr/ragents",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "RAgents-Host: Server, Engine, Plugins und Werkzeuge ohne Quell-Checkout",
   "keywords": [
     "agents",
@@ -11,7 +11,7 @@
     "fsharp",
     "vscode"
   ],
-  "homepage": "https://github.com/SchlenkR/RAgents#readme",
+  "homepage": "https://schlenkr.github.io/RAgents/",
   "bugs": {
     "url": "https://github.com/SchlenkR/RAgents/issues"
   },

package/plugins/ragents.reference/walkthroughs.ts

@@ -5,7 +5,7 @@ export const referenceWalkthroughs = [
     description: "Die Mini-App bleibt als Kachel sichtbar; ihr Besitzer ist auch ohne eigene Kachel erreichbar.",
     tags: ["Anwendungsfall", "Konzeptdemo", "Kachelfläche"],
     steps: [
-      "Im Profil core Sammelboard einrichten öffnen und den Leitfaden abschließen. Erwartung: Die Liste steht als Kachel auf der Fläche; ihr Besitzer hat keine eigene Kachel.",
+      "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.",
@@ -17,7 +17,7 @@ export const referenceWalkthroughs = [
     description: "Kacheln lassen sich persönlich umstellen und wieder auf die Programmvorgabe zurücksetzen.",
     tags: ["Anwendungsfall", "Konzeptdemo", "Kachelfläche"],
     steps: [
-      "Im Profil core den Einstieg Gesprächsrunde einrichten ausführen und den Aufbau abwarten. Die vom Run gesetzte Aufteilung ansehen.",
+      "Im Profil showcase den Einstieg 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.",
@@ -29,7 +29,7 @@ export const referenceWalkthroughs = [
     description: "Der übergeordnete Koordinator liest vorhandene Runs, während die aktuelle Arbeitsfläche geöffnet bleibt.",
     tags: ["Anwendungsfall", "Konzeptdemo", "Globaler Koordinator"],
     steps: [
-      "Im Profil core zwei kurze Unterhaltungen zu einer Leseliste und einem Wochenplan anlegen und ihre Antworten abwarten.",
+      "Im Profil showcase zwei kurze Unterhaltungen 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 Unterhaltungen 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 Unterhaltungen 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.",
@@ -126,7 +126,7 @@ export const referenceWalkthroughs = [
     description: "Eine TypeScript-Prüfung macht den zugehörigen Sprachserver in der Prozessanzeige sichtbar.",
     tags: ["Anwendungsfall", "Konzeptdemo", "Prozessanzeige"],
     steps: [
-      "Im Profil core den Skill-Einstieg Fehler in einer Terminliste finden ausführen. Voraussetzung ist ein verfügbarer TypeScript-Sprachserver; eine fehlende Voraussetzung muss als Fehler gemeldet werden.",
+      "Im Profil showcase den Skill-Einstieg 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.",
@@ -138,7 +138,7 @@ export const referenceWalkthroughs = [
     description: "Ein zeitlich begrenzter Demo-Webprozess erscheint mit seinem erkannten Port in der Kopfzeile.",
     tags: ["Anwendungsfall", "Konzeptdemo", "Prozessanzeige"],
     steps: [
-      "In einem eigenen core-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.",
+      "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.",
@@ -150,7 +150,7 @@ export const referenceWalkthroughs = [
     description: "Ein Run schreibt einen kleinen Text; der Dateireiter zeigt Inhalt und spätere Änderung ohne eigenen Editor.",
     tags: ["Anwendungsfall", "Konzeptdemo", "Dateien und Arbeitsverzeichnis"],
     steps: [
-      "In einem neuen core-Run den Koordinator bitten, im Run-Arbeitsverzeichnis die Datei reading-list.md mit drei neutralen Lesethemen anzulegen.",
+      "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.",
@@ -162,8 +162,8 @@ export const referenceWalkthroughs = [
     description: "Zwei unabhängige Arbeitsverzeichnisse enthalten eigene Dateien mit demselben Namen.",
     tags: ["Anwendungsfall", "Konzeptdemo", "Dateien und Arbeitsverzeichnis"],
     steps: [
-      "Einen core-Run Leseliste anlegen und darin notes.md mit dem Inhalt Lesen vorbereiten schreiben lassen.",
-      "Einen zweiten core-Run Wochenplan anlegen und dort ebenfalls notes.md schreiben lassen, diesmal mit dem Inhalt Woche planen. Keine Datei zwischen Runs kopieren.",
+      "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.",
     ],
@@ -174,7 +174,7 @@ export const referenceWalkthroughs = [
     description: "Eine abgeschlossene Actor-Funktion bleibt beim regulären Neustart desselben Profils erhalten.",
     tags: ["Anwendungsfall", "Konzeptdemo", "Wiederherstellung nach Neustart"],
     steps: [
-      "Im Profil core Sammelboard einrichten öffnen und den Leitfaden abschließen. Einen eindeutig erkennbaren Eintrag hinzufügen und die bestätigte Aktualisierung der Liste abwarten.",
+      "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.",
@@ -186,7 +186,7 @@ export const referenceWalkthroughs = [
     description: "Normale Unterhaltung und globaler Koordinator behalten ihre jeweils eigene Geschichte.",
     tags: ["Anwendungsfall", "Konzeptdemo", "Wiederherstellung nach Neustart"],
     steps: [
-      "In einem normalen core-Run drei Lernziele besprechen und im globalen Chat eine knappe Übersicht dieses Runs anfordern. Beide Antworten vollständig abwarten und die globale Modellwahl merken.",
+      "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.",

package/ragents.config.core.ts

@@ -21,7 +21,6 @@ export const config = {
       "ragents.watch",
       "ragents.transcript",
       "ragents.actor-programs",
-      "ragents.reference",
       "ragents.lsp-roslyn",
       "ragents.lsp-fsharp",
       "ragents.lsp-typescript",

package/ragents.config.showcase.ts

@@ -0,0 +1,64 @@
+// Schaufenster: das Profil core und zusätzlich die mitgelieferten Beispiele aus ragents.reference.
+import { env, provisioned, type RAgentsConfig } from "./apps/server/src/config-definition.js";
+
+export const config = {
+  host: {
+    PORT: 4713,
+    PRODUCT_PROFILE: "showcase",
+    COMPACTION_MODEL: "google/gemma-4-26b-a4b-it",
+    PRODUCT_ID: "ragents-showcase",
+    PRODUCT_TITLE: "RAgents Showcase",
+    PLUGINS: [
+      "ragents.orchestration",
+      "ragents.workspace",
+      "ragents.product",
+      "ragents.overseer",
+      "ragents.activity",
+      "ragents.processes",
+      "ragents.documents",
+      "ragents.browser",
+      "ragents.ask",
+      "ragents.todo",
+      "ragents.watch",
+      "ragents.transcript",
+      "ragents.actor-programs",
+      "ragents.reference",
+      "ragents.lsp-roslyn",
+      "ragents.lsp-fsharp",
+      "ragents.lsp-typescript",
+      "ragents.model-relay",
+      "ragents.profile-distribution",
+    ],
+  },
+
+  "ragents.product": {
+    OPENROUTER_API_KEY: env("OPENROUTER_API_KEY"),
+    AGENT_MODEL: "z-ai/glm-5.3-flash",
+    AGENT_MODELS: [
+      "deepseek/deepseek-v4-flash-0731",
+      "deepseek/deepseek-v4-pro-0813",
+      "qwen/qwen3.8-max",
+      "z-ai/glm-5.3",
+      "z-ai/glm-5.3-flash",
+      "qwen/qwen3.8-flash",
+      "moonshotai/kimi-k3",
+      "minimax/minimax-m3",
+      "qwen/qwen3.8-27b",
+      "moonshotai/kimi-k2.7-code",
+    ],
+    AGENT_COORDINATOR_MODEL: "z-ai/glm-5.3-flash",
+    AGENT_COORDINATOR_THINKING: "high",
+  },
+
+  // Modell-Relay: Aliasse für andere RAgents-Server, die ihre Modelle von hier beziehen.
+  "ragents.model-relay": {
+    RELAY_MODELS: ["showcase-standard=openrouter/z-ai/glm-5.3-flash", "showcase-coordinator=openrouter/deepseek/deepseek-v4-flash-0731"],
+  },
+
+  "ragents.lsp-roslyn": {
+    ROSLYN_LANGUAGE_SERVER: provisioned("ragents.lsp-roslyn", "roslyn/Microsoft.CodeAnalysis.LanguageServer.dll"),
+  },
+  "ragents.lsp-fsharp": {
+    FSHARP_LANGUAGE_SERVER: provisioned("ragents.lsp-fsharp", "fsautocomplete/fsautocomplete.dll"),
+  },
+} as const satisfies RAgentsConfig;

package/scripts/package/build-package.ts

@@ -22,7 +22,7 @@ const SKIPPED_IN_PACKAGE = /^scripts\/.*\.test\.tsx?$/;
 const packagePath = (packageRoot: string, file: string): string => path.relative(packageRoot, file).split(path.sep).join("/");
 
 /** Die neutralen Profile des Repositories; ragents start fährt sie aus dem Paket wie aus dem Checkout. */
-export const PACKAGED_PROFILES = ["core", "developer"] as const;
+export const PACKAGED_PROFILES = ["core", "developer", "showcase"] as const;
 
 export const PACKAGE_LICENSE = "PolyForm-Shield-1.0.0";
 export const PACKAGE_AUTHOR = "Ronald Schlenker";
@@ -217,7 +217,7 @@ export const buildPackage = async (target: string, root = repositoryRoot): Promi
     version: readPackageVersion(root),
     description: "RAgents-Host: Server, Engine, Plugins und Werkzeuge ohne Quell-Checkout",
     keywords: [...PACKAGE_KEYWORDS],
-    homepage: `${REPOSITORY_URL}#readme`,
+    homepage: "https://schlenkr.github.io/RAgents/",
     bugs: { url: `${REPOSITORY_URL}/issues` },
     license: PACKAGE_LICENSE,
     author: PACKAGE_AUTHOR,

package/scripts/remote/start.ts

@@ -8,7 +8,7 @@ import { localProfile } from "../../apps/server/src/profile-target.ts";
 import { startCached, startProfile, type CachedProfile } from "./connect.ts";
 
 const usage = (): string => `Verwendung: ragents start <profil|pfad> [--port <n>]
-Startet ein Profil dieses Hosts (core, developer), eine eigene ragents.config.<profil>.ts an
+Startet ein Profil dieses Hosts (core, developer, showcase), eine eigene ragents.config.<profil>.ts an
 beliebiger Stelle oder einen Stand, den ragents connect schon geholt hat, ohne den Server zu
 fragen. Ein eigenes Profil bekommt sein Web beim Start gebaut, ein geholter Stand bringt es aus
 demselben Cache mit. Ohne Argument nennt der Befehl die Profile im Cache.`;