@schlenkr/ragents 0.1.5 → 0.1.7

package/plugins/ragents.reference/run-scripts/word-game/RUN.md

@@ -6,7 +6,7 @@ coordinator: false
 tags: Run-Scripts, Anwendungsfall, Konzeptdemo, Mini-Apps, TypeScript-Actors, Agententeams, Subscriptions
 ---
 
-Rot, Gelb, Blau und Grün sind vier LLM-Actors ohne Werkzeuge mit dem Modellprofil `standard`.
+Rot, Gelb, Blau und Grün sind vier LLM-Actors ohne Werkzeuge mit der Rolle `standard`.
 Der TypeScript-Actor besitzt die Mini-App, legt die Teilnehmer an und wird Primary-Actor.
 Erst "Wortspiel starten" in der App beauftragt das erste Modell. Das Ausgangswort ist "Sonne".
 

package/plugins/ragents.reference/run-scripts/word-game/src/client.tsx

@@ -23,5 +23,5 @@ function App() {
 }
 
 const root = document.getElementById("root");
-if (!root) throw new Error("Das Wurzelelement #root fehlt.");
+if (!root) throw new Error("The #root element is missing.");
 createRoot(root).render(<App />);

package/plugins/ragents.reference/run-scripts/word-game/src/server.ts

@@ -45,7 +45,7 @@ export default defineActor(contract, {
         }
         const catalog = await context.functions.model_list({});
         const profile = catalog.profiles.find((entry) => entry.driver === "agent" && entry.name === "standard");
-        if (!profile) throw new Error("Das Modellprofil standard fehlt.");
+        if (!profile) throw new Error("Die Rolle standard fehlt.");
         const actors = [];
         for (const participant of participants) {
           const actor = await context.functions.agent_spawn({ handle: participant.handle, displayName: participant.name, prompt, profile: profile.name, tools: [] });
@@ -60,7 +60,6 @@ export default defineActor(contract, {
           eventTypes: ["turn.finished", "turn.interrupted", "actor.stopped"],
           sourceActorIds: state.participants!.map((participant) => participant.id),
         });
-        if (subscription.status !== "active") throw new Error("Das Ereignisabo ist nicht aktiv.");
         context.state.replace(await dispatch({ ...state, subscriptionId: subscription.subscriptionId }, context));
         return;
       }

package/plugins/ragents.reference/run-scripts/word-game/src/state.ts

@@ -1,12 +1,12 @@
 export const participants = [
-  { handle: "red", name: "Rot" },
-  { handle: "yellow", name: "Gelb" },
-  { handle: "blue", name: "Blau" },
-  { handle: "green", name: "Grün" },
+  { handle: "red", name: "Red" },
+  { handle: "yellow", name: "Yellow" },
+  { handle: "blue", name: "Blue" },
+  { handle: "green", name: "Green" },
 ] as const;
 
 export const targetCount = 12;
-export const initialWord = "Sonne";
+export const initialWord = "sun";
 
 export type WordGameState = {
   status?: "setup" | "ready" | "running" | "completed" | "error";
@@ -19,4 +19,4 @@ export type WordGameState = {
 };
 
 export const documentFrom = (entries: NonNullable<WordGameState["entries"]>): string =>
-  `# Wortspiel\n\nAusgangswort: ${initialWord}\n\n${entries.map((entry, index) => `${index + 1}. ${participants[entry.participant]!.name}: ${entry.word}`).join("\n")}\n`;
+  `# Word game\n\nStarting word: ${initialWord}\n\n${entries.map((entry, index) => `${index + 1}. ${participants[entry.participant]!.name}: ${entry.word}`).join("\n")}\n`;

package/plugins/ragents.reference/run-scripts/word-game/src/view.tsx

@@ -22,30 +22,30 @@ export function WordGameView({ state, onStart, busy = false, actionError, previe
   const entries = state.entries ?? [];
   const active = entries.length % participants.length;
   const status = state.status ?? "setup";
-  const step = status === "running" ? `${participants[active]!.name} wählt Wort ${entries.length + 1}.`
-    : status === "completed" ? "Fertig. Alle zwölf Wörter sind im Dokument."
-      : status === "error" ? "Das Spiel wurde angehalten."
-        : status === "ready" ? (preview ? "Bereit für den nächsten Beispielschritt." : "Bereit. Der Start beauftragt das erste Modell.") : "Die Teilnehmer werden eingerichtet.";
+  const step = status === "running" ? `${participants[active]!.name} chooses word ${entries.length + 1}.`
+    : status === "completed" ? "Done. All twelve words are in the document."
+      : status === "error" ? "The game was stopped."
+        : status === "ready" ? (preview ? "Ready for the next example step." : "Ready. Start sends the first model task.") : "Setting up participants.";
 
   return <main className="mx-auto max-w-[760px] text-base">
     <header className="flex items-center justify-between gap-4">
-      <div><p className="mb-1.5 text-xs text-muted-foreground">TypeScript steuert, LLMs wählen Wörter</p><h1 className="text-[1.75rem] leading-[1.2] font-semibold">Wortspiel</h1></div>
-      <strong className="text-[1.7rem] tabular-nums" aria-label={`${entries.length} von ${targetCount} Beiträgen`}>{entries.length}/{targetCount}</strong>
+      <div><p className="mb-1.5 text-xs text-muted-foreground">TypeScript controls the flow, LLMs choose words</p><h1 className="text-[1.75rem] leading-[1.2] font-semibold">Word game</h1></div>
+      <strong className="text-[1.7rem] tabular-nums" aria-label={`${entries.length} of ${targetCount} entries`}>{entries.length}/{targetCount}</strong>
     </header>
-    <p className="my-5">Rot, Gelb, Blau und Grün sind nacheinander dran. Drei Runden, zwölf neue Wörter. Ausgangswort: <strong>{initialWord}</strong>.</p>
-    <ol className="my-5 grid grid-cols-4 gap-2" aria-label="Reihenfolge der Teilnehmer">
+    <p className="my-5">Red, Yellow, Blue, and Green take turns. Three rounds, twelve new words. Starting word: <strong>{initialWord}</strong>.</p>
+    <ol className="my-5 grid grid-cols-4 gap-2" aria-label="Participant order">
       {participants.map((participant, index) => <li key={participant.handle} aria-current={status === "running" && active === index ? "step" : undefined}
         className={`flex flex-wrap items-center justify-center gap-1.5 rounded-lg border border-border px-1.5 py-3 max-[420px]:text-[0.75rem] aria-[current=step]:border-(--word-game-color) aria-[current=step]:bg-muted aria-[current=step]:ring-1 aria-[current=step]:ring-(--word-game-color) ${participantColor[participant.handle]}`}>
         <span className={dot} aria-hidden="true" /><strong>{participant.name}</strong><small className="w-full text-center text-muted-foreground">LLM</small>
       </li>)}
     </ol>
-    <progress className="block h-1.5 w-full [accent-color:#408561]" value={entries.length} max={targetCount} aria-label="Abgeschlossene Beiträge" />
+    <progress className="block h-1.5 w-full [accent-color:#408561]" value={entries.length} max={targetCount} aria-label="Completed entries" />
     <p className="my-3" role="status">{step}</p>
-    {status === "ready" && <Button disabled={busy || !onStart} onClick={() => void onStart?.()}>{busy ? "Start wird gesendet..." : preview ? "Beispiel zeigen" : "Wortspiel starten"}</Button>}
-    {(state.error || actionError) && <p className="border-l-[3px] border-destructive bg-destructive-soft p-3" role="alert">{state.error || actionError}{status === "error" ? " Bitte einen neuen Wortspiel-Run starten. Der bisherige Stand bleibt erhalten." : ""}</p>}
-    <section className="mt-6 border-t border-border pt-4" aria-label="Gesammelte Wörter">
-      <h2 className="mb-3 text-lg font-semibold">{status === "completed" ? "Das fertige Dokument" : "Die Wortfolge"}</h2>
-      {state.document && status === "completed" ? <DocumentViewer content={state.document} format="markdown" filename="word-game.md" /> : entries.length === 0 ? <p className="text-muted-foreground">{preview ? "Hier wächst die Wortfolge aus beschrifteten Beispieldaten." : "Noch keine Modellantwort. Hier wächst die gemeinsame Wortfolge."}</p> : <ol className="mb-5 grid grid-cols-2 gap-x-5 max-[420px]:grid-cols-1">
+    {status === "ready" && <Button disabled={busy || !onStart} onClick={() => void onStart?.()}>{busy ? "Sending start..." : preview ? "Show example" : "Start word game"}</Button>}
+    {(state.error || actionError) && <p className="border-l-[3px] border-destructive bg-destructive-soft p-3" role="alert">{state.error || actionError}{status === "error" ? " Start a new word-game run. The current state remains available." : ""}</p>}
+    <section className="mt-6 border-t border-border pt-4" aria-label="Collected words">
+      <h2 className="mb-3 text-lg font-semibold">{status === "completed" ? "Completed document" : "Word sequence"}</h2>
+      {state.document && status === "completed" ? <DocumentViewer content={state.document} format="markdown" filename="word-game.md" /> : entries.length === 0 ? <p className="text-muted-foreground">{preview ? "The word sequence grows here from labeled example data." : "No model response yet. The shared word sequence grows here."}</p> : <ol className="mb-5 grid grid-cols-2 gap-x-5 max-[420px]:grid-cols-1">
         {entries.map((entry, index) => <li key={index} className={`flex min-h-9 items-center gap-2 border-b border-border ${participantColor[participants[entry.participant]!.handle]}`}>
           <span className="w-[22px] text-muted-foreground tabular-nums">{index + 1}.</span><span className={dot} aria-hidden="true" /><strong className="[overflow-wrap:anywhere]">{entry.word}</strong><small className="ml-auto text-muted-foreground">{participants[entry.participant]!.name}</small></li>)}
       </ol>}

package/plugins/ragents.reference/run-scripts/word-game/tests/program.test.ts

@@ -25,12 +25,11 @@ function fixture(initialState: WordGameState = {}) {
         calls.push({ name: "agent_spawn", input });
         return { id: `actor-${input.handle}`, handle: input.handle };
       },
-      run_configure: async (input) => { calls.push({ name: "run_configure", input }); return []; },
-      canvas_layout_replace: async (input) => { calls.push({ name: "canvas_layout_replace", input }); return []; },
+      run_configure: async (input) => { calls.push({ name: "run_configure", input }); return null; },
+      canvas_layout_replace: async (input) => { calls.push({ name: "canvas_layout_replace", input }); return null; },
       event_subscribe: async (input) => {
         calls.push({ name: "event_subscribe", input });
-        return { ...input, includeSelf: false, sourceActorIds: input.sourceActorIds ?? null, sourceActorKinds: null, sources: null,
-          status: "active", subscriptionId: "subscription", subscriberId: "test-actor", createdAt: "2026-09-13T12:00:00Z", createdBy: "test-actor", createdSequence: 1 };
+        return { subscriptionId: "subscription", sources: input.sourceActorIds ?? null };
       },
       actor_input: async (input) => {
         calls.push({ name: "actor_input", input });
@@ -97,7 +96,7 @@ test("wartet auf spätere Ereignisse, zählt zwölf Beiträge und beendet die We
   assert.deepEqual(inputs.map((call) => (call.input as { actor: string }).actor), words.map((_word, index) => `actor-${participants[index % 4]!.handle}`));
   assert.equal(context.state.read().status, "completed");
   assert.equal(context.state.read().entries?.length, 12);
-  assert.match(context.state.read().document!, /12\. Grün: Blume/);
+  assert.match(context.state.read().document!, /12\. Green: Blume/);
   assert.equal(context.state.read().pendingInputId, undefined);
   assert.deepEqual(await program.functions.start({}, context), { accepted: false });
 });
@@ -123,7 +122,7 @@ for (const scenario of [
   { name: "Modellfehler", word: "Strand", options: { outcome: "failed" } },
   { name: "Unterbrechung", word: "Strand", options: { type: "turn.interrupted" } },
   { name: "Mehrwortantwort", word: "Schöner Strand", options: {} },
-  { name: "wiederholtes Ausgangswort", word: "sonne", options: {} },
+  { name: "wiederholtes Ausgangswort", word: "sun", options: {} },
 ]) {
   test(`${scenario.name} bleibt als Fehler sichtbar und startet nicht erneut`, async () => {
     const { context, calls, response, start } = fixture();
@@ -190,7 +189,7 @@ test("fehlendes Standardprofil zeigt einen Fehler ohne Teilnehmer anzulegen", as
   settings.missingProfile = true;
   await program.onInput(firstInput, context);
   assert.equal(context.state.read().status, "error");
-  assert.match(context.state.read().error!, /Modellprofil standard fehlt/);
+  assert.match(context.state.read().error!, /Rolle standard fehlt/);
   assert.deepEqual(calls.map((call) => call.name), ["run_configure", "canvas_layout_replace", "model_list"]);
 });
 
@@ -248,6 +247,6 @@ test("ein gestoppter aktueller Teilnehmer hält das Spiel an", async () => {
   await start();
   await program.onInput(response("Strand", { type: "actor.stopped" }), context);
   assert.equal(context.state.read().status, "error");
-  assert.match(context.state.read().error!, /Rot wurde gestoppt/);
+  assert.match(context.state.read().error!, /Red wurde gestoppt/);
   assert.equal(context.state.read().entries?.length, 0);
 });

package/plugins/ragents.reference/server/index.ts

@@ -1,5 +1,5 @@
-import type { RAgentsPlugin } from "@aicontainer/ragents";
-import type { PluginModule } from "@aicontainer/server/plugin-support/plugin-module.js";
+import type { RAgentsPlugin } from "@ragents/engine";
+import type { PluginModule } from "@ragents/host/plugin-support/plugin-module.js";
 
 const referencePlugin: RAgentsPlugin = {
   manifest: { id: "ragents.reference" },

package/plugins/ragents.reference/skills/160-learning-companion/SKILL.md

@@ -9,4 +9,4 @@ order: 160
 tags: "Anwendungsfall, Konzeptdemo, Agententeams, Mini-Apps, LLM-Actor mit View, Actor-Chat"
 ---
 
-Ich hätte gern einen KI-Tutor mit eigener Oberfläche auf der Arbeitsfläche: Textunterlagen öffnen und lesen, daneben mit genau diesem Tutor sprechen. Ich möchte zwischen Erklären, Beispiel und Verständnisprüfung wählen. Die ausgewählte Datei soll erst nach meinem Klick im Gespräch verwendet werden. Fragen ohne Datei sollen auch gehen. Nutze die vorhandenen Chat-, Datei- und Auswahlbausteine.
+Ich hätte gern einen KI-Tutor mit eigener Oberfläche auf der Fläche: Textunterlagen öffnen und lesen, daneben mit genau diesem Tutor sprechen. Ich möchte zwischen Erklären, Beispiel und Verständnisprüfung wählen. Die ausgewählte Datei soll erst nach meinem Klick im Gespräch verwendet werden. Fragen ohne Datei sollen auch gehen. Nutze die vorhandenen Chat-, Datei- und Auswahlbausteine.

package/plugins/ragents.reference/skills/240-live-result-list/SKILL.md

@@ -9,4 +9,4 @@ order: 240
 tags: "Anwendungsfall, Konzeptdemo, TypeScript-Actors, Subscriptions, Actor-Zustand, Mini-Apps"
 ---
 
-Ich hätte gern zwei KI-Helfer, die je eine kurze Idee für einen gemeinsamen Lernnachmittag vorschlagen. Ihre fertigen Antworten sollen automatisch in einer kleinen Ergebnisliste auf der Arbeitsfläche erscheinen. Ein programmierter Sammler merkt sich die Beiträge; dafür soll keine weitere KI die Texte kopieren. Lass danach einen Helfer eine zweite Idee ergänzen. Die Liste soll von selbst wachsen, auch wenn Du im Chat gerade nichts schreibst.
+Ich hätte gern zwei KI-Helfer, die je eine kurze Idee für einen gemeinsamen Lernnachmittag vorschlagen. Ihre fertigen Antworten sollen automatisch in einer kleinen Ergebnisliste auf der Fläche erscheinen. Ein programmierter Sammler merkt sich die Beiträge; dafür soll keine weitere KI die Texte kopieren. Lass danach einen Helfer eine zweite Idee ergänzen. Die Liste soll von selbst wachsen, auch wenn Du im Chat gerade nichts schreibst.

package/plugins/ragents.reference/skills/250-balcony-wizard/SKILL.md

@@ -9,4 +9,4 @@ order: 250
 tags: "Anwendungsfall, Konzeptdemo, Mini-Apps, Actor-Funktionen, Actor-Zustand"
 ---
 
-Ich hätte gern einen Balkon-Wizard als eigenständige App auf dem Canvas. Sie vermittelt ein begrenztes Gespräch mit einem KI-Berater im Hintergrund. Nach jeder Antwort wählt das LLM die nächste passende Frage, keine feste Fragenliste. Nach fünf Antworten gibt es Gestaltungstipps. Ich antworte nur in der App; sie zeigt Frage, Fortschritt, Lade- und Fehlerzustände. Nutze gemeinsame Layouts und Formulare. Keine App in einer LLM-Chatkarte.
+Ich hätte gern einen Balkon-Wizard als eigenständige App auf der Fläche. Sie vermittelt ein begrenztes Gespräch mit einem KI-Berater im Hintergrund. Nach jeder Antwort wählt das LLM die nächste passende Frage, keine feste Fragenliste. Nach fünf Antworten gibt es Gestaltungstipps. Ich antworte nur in der App; sie zeigt Frage, Fortschritt, Lade- und Fehlerzustände. Nutze gemeinsame Layouts und Formulare. Keine App in einer LLM-Chatkarte.

package/plugins/ragents.reference/skills/90-actor-notes/SKILL.md

@@ -9,4 +9,4 @@ order: 90
 tags: "Anwendungsfall, Konzeptdemo, TypeScript-Actors, Actor-Funktionen, Actor-Zustand, Mini-Apps, Automatische View-Platzierung, View-Sichtbarkeit"
 ---
 
-Ich hätte gern einen TypeScript-Actor für meine Notizen. Seine Oberfläche mit Eingabe und Zähler soll von selbst auf der Arbeitsfläche erscheinen: links eine durchsuchbare Titelliste, rechts die ausgewählte Notiz. Ergänze eine erste Notiz über seine Funktion. Blende die Oberfläche kurz aus und wieder ein, ohne den Actor zu löschen oder Notizen zurückzusetzen. Lass sie zum Eintragen meiner nächsten Idee offen.
+Ich hätte gern einen TypeScript-Actor für meine Notizen. Seine Oberfläche mit Eingabe und Zähler soll von selbst auf der Fläche erscheinen: links eine durchsuchbare Titelliste, rechts die ausgewählte Notiz. Ergänze eine erste Notiz über seine Funktion. Blende die Oberfläche kurz aus und wieder ein, ohne den Actor zu löschen oder Notizen zurückzusetzen. Lass sie zum Eintragen meiner nächsten Idee offen.

package/plugins/ragents.reference/skills/95-hello-world/SKILL.md

@@ -2,11 +2,11 @@
 name: 95-hello-world
 start: true
 disable-model-invocation: true
-title: "Hallo Welt auf der Arbeitsfläche"
+title: "Hallo Welt auf der Fläche"
 description: "Zeigt den kleinsten Aufbau einer Mini-App am vorhandenen Actor: eine reine Anzeige ohne neuen Actor oder Serverfunktion."
 category: "Mini-Apps"
 order: 5
 tags: "Konzeptdemo, Mini-Apps"
 ---
 
-Ich hätte gern an Deinem vorhandenen Actor eine kleine Oberfläche auf der Arbeitsfläche, die einfach nur Hallo Welt sagt. Sie soll sonst nichts tun. Lege dafür keinen neuen Actor und keine Serverfunktion an.
+Ich hätte gern an Deinem vorhandenen Actor eine kleine Oberfläche auf der Fläche, die einfach nur Hallo Welt sagt. Sie soll sonst nichts tun. Lege dafür keinen neuen Actor und keine Serverfunktion an.

package/plugins/ragents.reference/skills/decision-brief/SKILL.md

@@ -29,5 +29,5 @@ Arbeitsanweisung für den Koordinator und erstellt keine zusätzlichen Agenten o
    Option, verbleibende Unsicherheit und ein konkreter nächster Schritt. Die Entscheidung bleibt
    beim Benutzer. Erkläre danach knapp, welche Schritte dieser wiederverwendbare Ablauf geführt hat.
 
-Der Abschluss ist der Vermerk im Chat. Es wird nichts gebucht, verschickt oder außerhalb der
-Unterhaltung verändert. Behaupte keinen Abschluss, solange die Auswahl noch offen ist.
+Der Abschluss ist der Vermerk im Chat. Es wird nichts gebucht, verschickt oder außerhalb des
+Gesprächs verändert. Behaupte keinen Abschluss, solange die Auswahl noch offen ist.

package/plugins/ragents.reference/walkthroughs.ts

@@ -3,7 +3,7 @@ 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", "Kachelfläche"],
+    tags: ["Anwendungsfall", "Konzeptdemo", "Fläche"],
     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.",
@@ -15,9 +15,9 @@ export const referenceWalkthroughs = [
     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", "Kachelfläche"],
+    tags: ["Anwendungsfall", "Konzeptdemo", "Fläche"],
     steps: [
-      "Im Profil showcase den Einstieg Gesprächsrunde einrichten ausführen und den Aufbau abwarten. Die vom Run gesetzte Aufteilung ansehen.",
+      "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.",
@@ -25,20 +25,20 @@ export const referenceWalkthroughs = [
   },
   {
     id: "global-run-overview",
-    title: "Zwei Unterhaltungen im Blick behalten",
-    description: "Der übergeordnete Koordinator liest vorhandene Runs, während die aktuelle Arbeitsfläche geöffnet bleibt.",
+    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"],
     steps: [
-      "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.",
+      "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.",
     ],
   },
   {
     id: "global-prepared-run",
     title: "Eine vorbereitete Runde global starten",
-    description: "Der übergeordnete Koordinator wählt aus dem vorhandenen Katalog ein Run-Script und erstellt damit einen neuen Run.",
+    description: "Der globale Koordinator wählt aus dem vorhandenen Katalog ein Run-Script und erstellt damit einen neuen Run.",
     tags: ["Anwendungsfall", "Konzeptdemo", "Globaler Koordinator"],
     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.",
@@ -92,7 +92,7 @@ export const referenceWalkthroughs = [
     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.",
-      "Eine neue Unterhaltung 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.",
+      "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.",
     ],
   },
@@ -102,21 +102,21 @@ export const referenceWalkthroughs = [
     description: "Neue Erzeugungen lassen sich deaktivieren; vorhandene und ausdrücklich gesetzte Titel bleiben erhalten.",
     tags: ["Anwendungsfall", "Konzeptdemo", "Einstellungen und Modellwahl"],
     steps: [
-      "Eine Unterhaltung mit bereits erzeugtem Kurztitel in der Run-Liste ansehen. Unter Einstellungen, Modelle, Überschriften Keine automatischen Überschriften auswählen und speichern.",
+      "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.",
-      "Eine weitere Unterhaltung mit einem normalen Auftrag beginnen. Erwartung: Die Run-Liste zeigt den Auftrag, ohne dafür einen automatischen Kurztitel anzufordern.",
+      "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.",
     ],
   },
   {
     id: "extension-capability-settings",
-    title: "Eine Fähigkeit ihrer Extension zuordnen",
+    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"],
     steps: [
-      "Über das Zahnrad die Einstellungen öffnen und zu Erweiterungen wechseln. In Nach Extension die Actor-Programm-Extension 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 ihrer jeweiligen Extension als Eigentümer.",
-      "Den Link zur Actor-Programm-Extension öffnen. Erwartung: Ihr vollständiges Inventar ist wieder sichtbar; ein vorheriger Suchfilter verdeckt die Detailseite nicht.",
+      "Ü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.",
     ],
   },
@@ -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 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.",
+      "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.",
@@ -183,7 +183,7 @@ export const referenceWalkthroughs = [
   {
     id: "restore-conversation-context",
     title: "Zwei Gesprächsverläufe nach Neustart fortsetzen",
-    description: "Normale Unterhaltung und globaler Koordinator behalten ihre jeweils eigene Geschichte.",
+    description: "Normaler Run und globaler Koordinator behalten ihre jeweils eigene Geschichte.",
     tags: ["Anwendungsfall", "Konzeptdemo", "Wiederherstellung nach Neustart"],
     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.",
@@ -198,7 +198,7 @@ export const referenceWalkthroughs = [
     description: "Ein Bild aus der Zwischenablage wird vor dem Senden geprüft und danach als Anhang im Verlauf gezeigt.",
     tags: ["Anwendungsfall", "Konzeptdemo", "Multimodale Eingaben"],
     steps: [
-      "Eine eigene unkritische Skizze in die Zwischenablage kopieren. Eine neue Unterhaltung öffnen und ein angebotenes Modell wählen, das Bildeingaben unterstützt.",
+      "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.",

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

@@ -1,6 +1,6 @@
 import { useState } from "react";
-import type { EntryGuideContext } from "@aicontainer/web/PluginRegistry";
-import { Button, Card, Input, Textarea } from "@aicontainer/web/ui";
+import type { EntryGuideContext } from "@ragents/web/PluginRegistry";
+import { Button, Card, Input, Textarea } from "@ragents/web/ui";
 
 const formClass = "grid gap-5.5 mx-auto max-w-[820px] p-6 text-foreground max-sm:p-4.5";
 const introClass = "leading-[1.6] text-muted-foreground";

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

@@ -1,4 +1,4 @@
-import type { WebPlugin } from "@aicontainer/web/PluginRegistry";
+import type { WebPlugin } from "@ragents/web/PluginRegistry";
 import { ConversationGuide, SharedBoardGuide } from "./StartGuides";
 
 export const webPlugin: WebPlugin = {

package/plugins/ragents.todo/ragents-plugin.json

@@ -0,0 +1,3 @@
+{
+  "id": "ragents.todo"
+}

package/plugins/ragents.todo/server/index.ts

@@ -1,5 +1,5 @@
-import type { RAgentsPlugin } from "@aicontainer/ragents";
-import type { PluginModule } from "@aicontainer/server/plugin-support/plugin-module.js";
+import type { RAgentsPlugin } from "@ragents/engine";
+import type { PluginModule } from "@ragents/host/plugin-support/plugin-module.js";
 import { createTodoToolContributor } from "./tool-contributor.js";
 
 const todoPlugin: RAgentsPlugin = {

package/plugins/ragents.todo/server/todo-tool.ts

@@ -3,10 +3,9 @@ import {
   DomainError,
   defineRunFunction,
   defineToolAvailability,
-  eventResultSchema,
   holdsUsable,
   type RunFunction,
-} from "@aicontainer/ragents";
+} from "@ragents/engine";
 import { TODO_PLUGIN_ID, TODO_STATUS_INPUTS, todoStatusOf } from "../contract.js";
 
 export const todoToolMetadata = {
@@ -56,15 +55,15 @@ export const createTodoTool = (): RunFunction =>
         }),
       ),
     }),
-    resultSchema: eventResultSchema,
+    resultSchema: Type.Null(),
     available: canManageTodos,
-    run: ({ runtime, caller, context, eventsFor }, toolCallId, input) => {
+    run: ({ runtime, caller, context }, toolCallId, input) => {
       runtime.replacePluginState(context(toolCallId), caller.runId, {
         pluginId: TODO_PLUGIN_ID,
         scope: { kind: "actor", actorId: caller.actorId },
         state: { todos: checked(input.todos) },
       });
 
-      return eventsFor(toolCallId);
+      return null;
     },
   });

package/plugins/ragents.todo/server/tool-contributor.ts

@@ -1,5 +1,5 @@
-import type { ToolContributor } from "@aicontainer/ragents";
-import { toolDescriptorFrom } from "@aicontainer/server/plugin-support/agent-tool.js";
+import type { ToolContributor } from "@ragents/engine";
+import { toolDescriptorFrom } from "@ragents/host/plugin-support/agent-tool.js";
 import { canManageTodos, createTodoTool, todoToolMetadata } from "./todo-tool.js";
 
 export const createTodoToolContributor = (): ToolContributor => ({

package/plugins/ragents.todo/web/TodoSection.tsx

@@ -1,7 +1,7 @@
-import { actorPluginState, runActorFrom, runViewFrom } from "@aicontainer/plugins/ragents.orchestration/web/contract";
+import { actorPluginState, runActorFrom, runViewFrom } from "@ragents/web/run-view";
 import { TODO_PLUGIN_ID, todoStateOf, type TodoItem } from "../contract";
-import type { CardSectionContext } from "@aicontainer/web/PluginRegistry";
-import { SectionLabel } from "@aicontainer/web/ui";
+import type { CardSectionContext } from "@ragents/web/PluginRegistry";
+import { SectionLabel } from "@ragents/web/ui";
 
 const MAX_ITEMS = 12;
 const markerOf = (todo: TodoItem) => todo.status;

package/plugins/ragents.todo/web/index.ts

@@ -1,5 +1,5 @@
 import { TodoSection } from "./TodoSection";
-import type { WebPlugin } from "@aicontainer/web/PluginRegistry";
+import type { WebPlugin } from "@ragents/web/PluginRegistry";
 
 export const webPlugin: WebPlugin = {
   id: "ragents.todo",

package/plugins/ragents.transcript/ragents-plugin.json

@@ -0,0 +1,3 @@
+{
+  "id": "ragents.transcript"
+}

package/plugins/ragents.transcript/server/index.ts

@@ -1,7 +1,7 @@
-import type { RAgentsPlugin, ToolContributor } from "@aicontainer/ragents";
-import { toolDescriptorFrom } from "@aicontainer/server/plugin-support/agent-tool.js";
-import type { PluginModule } from "@aicontainer/server/plugin-support/plugin-module.js";
-import { runtimeProviderToken } from "@aicontainer/server/ragents/host-services.js";
+import type { RAgentsPlugin, ToolContributor } from "@ragents/engine";
+import { toolDescriptorFrom } from "@ragents/host/plugin-support/agent-tool.js";
+import type { PluginModule } from "@ragents/host/plugin-support/plugin-module.js";
+import { runtimeProviderToken } from "@ragents/host/ragents/host-services.js";
 import { canReadTranscripts, createTranscriptTool, transcriptToolMetadata } from "./transcript.js";
 
 const transcriptPlugin: RAgentsPlugin = {

package/plugins/ragents.transcript/server/transcript.ts

@@ -1,5 +1,5 @@
 import { Type } from "typebox";
-import { defineRunFunction, defineToolAvailability, holdsUsable, type JournalEvent, type Orchestration, type RunFunction } from "@aicontainer/ragents";
+import { actorByReference, defineRunFunction, defineToolAvailability, holdsUsable, type JournalEvent, type Orchestration, type RunFunction } from "@ragents/engine";
 
 export interface CompactTranscript { text: string; lines: number; truncated: boolean }
 
@@ -70,8 +70,7 @@ export const createTranscriptTool = (runtime: () => Orchestration): RunFunction
     available: canReadTranscripts,
     run: ({ caller }, _toolCallId, input) => {
       const view = runtime().view(caller.runId);
-      const handle = input.actor.replace(/^@/, "");
-      const actor = view.actors.find((entry) => entry.id === input.actor || entry.handle === handle);
+      const actor = actorByReference(view.actors, input.actor);
       if (!actor) throw new Error(`Unbekannter Actor in diesem Run: ${input.actor}`);
       return { actorId: actor.id, handle: actor.handle, ...compactTranscript(runtime().events(caller.runId), actor.id, input.maxChars) };
     },

package/plugins/ragents.watch/ragents-plugin.json

@@ -0,0 +1,6 @@
+{
+  "id": "ragents.watch",
+  "exports": {
+    "server": ["contract", "server/contract"]
+  }
+}

package/plugins/ragents.watch/server/condition.ts

@@ -1,5 +1,5 @@
 import { createContext, runInContext } from "node:vm";
-import { compileVirtualTypeScriptAsync, type JsonValue } from "@aicontainer/ragents";
+import { compileVirtualTypeScriptAsync, type JsonValue } from "@ragents/engine";
 
 const conditionFile = "watch-condition.ts";
 const RUN_TIMEOUT_MS = 200;
@@ -14,7 +14,7 @@ interface WatchSource {
   readonly completedTurns: number;
   readonly lastTurn?: WatchTurn;
   readonly pendingInputs: number;
-  readonly openQuestions: number;
+  readonly pendingActions: number;
   readonly lastOutput?: string;
 }
 interface WatchState {

package/plugins/ragents.watch/server/contract.ts

@@ -1,4 +1,4 @@
-import { serviceToken, type ServiceToken } from "@aicontainer/ragents";
+import { serviceToken, type ServiceToken } from "@ragents/engine";
 import type { WatchServiceApi } from "../contract.js";
 
 export const watchServiceToken: ServiceToken<WatchServiceApi> = serviceToken("ragents.watch.service");

package/plugins/ragents.watch/server/functions.ts

@@ -1,6 +1,6 @@
 import { Type } from "typebox";
-import { defineRunFunction, defineToolAvailability, type ToolContributor } from "@aicontainer/ragents";
-import { toolDescriptorFrom } from "@aicontainer/server/plugin-support/agent-tool.js";
+import { defineRunFunction, defineToolAvailability, type ToolContributor } from "@ragents/engine";
+import { toolDescriptorFrom } from "@ragents/host/plugin-support/agent-tool.js";
 import type { WatchServiceApi } from "../contract.js";
 
 const available = defineToolAvailability({ availability: "always", availabilityDetail: "In jedem Run verfügbar." }, () => true);
@@ -26,7 +26,7 @@ const summarySchema = Type.Object({
 
 const createSchema = Type.Object({
   source: Type.String({ minLength: 1, description: "Beobachteter Actor als @handle oder Kennung" }),
-  condition: Type.String({ minLength: 1, maxLength: 4_000, description: "Weckbedingung als TypeScript-Funktionsrumpf von (now: WatchState, before: WatchState) => string | undefined; liefert den Weckgrund als Text oder undefined. WatchState: source { lifecycle idle|running|stopped, completedTurns, lastTurn { status, reason? }, pendingInputs, openQuestions, lastOutput? }, observed (Ergebnis der observe-Operation als Record<string, unknown>), stalledForSeconds (nur bei Stillstand). before ist der Stand bei der letzten Weckung. Beispiel: return now.source.completedTurns > before.source.completedTurns && now.observed?.phase !== \"ready\" ? \"Turn beendet, Auftrag nicht fertig\" : undefined;" }),
+  condition: Type.String({ minLength: 1, maxLength: 4_000, description: "Weckbedingung als TypeScript-Funktionsrumpf von (now: WatchState, before: WatchState) => string | undefined; liefert den Weckgrund als Text oder undefined. WatchState: source { lifecycle idle|running|stopped, completedTurns, lastTurn { status, reason? }, pendingInputs, pendingActions, lastOutput? }, observed (Ergebnis der observe-Operation als Record<string, unknown>), stalledForSeconds (nur bei Stillstand). before ist der Stand bei der letzten Weckung. Beispiel: return now.source.completedTurns > before.source.completedTurns && now.observed?.phase !== \"ready\" ? \"Turn beendet, Auftrag nicht fertig\" : undefined;" }),
   target: Type.Optional(Type.String({ minLength: 1, description: "Zu weckender Actor als @handle oder Kennung; ohne Angabe der Aufrufer" })),
   observe: Type.Optional(Type.String({ minLength: 1, description: "Benannte Operation ohne Eingabe, deren Ergebnis den beobachteten Stand ergänzt und per Differenz verglichen wird" })),
   instruction: Type.Optional(Type.String({ minLength: 1, maxLength: 2_000, description: "Text, der jeder Weckung angehängt wird, etwa wie der Geweckte reagieren soll" })),

package/plugins/ragents.watch/server/index.ts

@@ -1,7 +1,7 @@
-import type { JsonValue, RAgentsPlugin } from "@aicontainer/ragents";
+import type { JsonValue, RAgentsPlugin } from "@ragents/engine";
 import { randomUUID } from "node:crypto";
-import type { PluginModule } from "@aicontainer/server/plugin-support/plugin-module.js";
-import { runtimeProviderToken } from "@aicontainer/server/ragents/host-services.js";
+import type { PluginModule } from "@ragents/host/plugin-support/plugin-module.js";
+import { runtimeProviderToken } from "@ragents/host/ragents/host-services.js";
 import { WATCH_PLUGIN_ID } from "../contract.js";
 import { watchServiceToken } from "./contract.js";
 import { compileWatchCondition } from "./condition.js";

package/plugins/ragents.watch/server/observation.ts

@@ -1,4 +1,4 @@
-import type { ExecutableActor, JournalEvent, JsonValue, RunView } from "@aicontainer/ragents";
+import { actorByReference, type ExecutableActor, type JournalEvent, type JsonValue, type RunView } from "@ragents/engine";
 
 const OUTPUT_CHARS = 600;
 
@@ -8,13 +8,13 @@ export interface ActorObservation {
   completedTurns: number;
   lastTurn?: { status: string; reason?: string };
   pendingInputs: number;
-  openQuestions: number;
+  pendingActions: number;
   lastOutput?: string;
 }
 
-export const actorByReference = (view: RunView, reference: string): ExecutableActor | undefined => {
-  const handle = reference.startsWith("@") ? reference.slice(1) : reference;
-  return view.actors.find((actor): actor is ExecutableActor => actor.kind !== "human" && (actor.id === reference || actor.handle === handle));
+export const watchableActorOf = (view: RunView, reference: string): ExecutableActor | undefined => {
+  const actor = actorByReference(view.actors, reference);
+  return actor?.kind === "human" ? undefined : actor;
 };
 
 export const observeActor = (view: RunView, actorId: string): ActorObservation | undefined => {
@@ -29,7 +29,7 @@ export const observeActor = (view: RunView, actorId: string): ActorObservation |
     completedTurns: turns.filter((turn) => turn.status !== "running").length,
     ...(last ? { lastTurn: { status: last.status, ...(last.reason ? { reason: last.reason } : {}) } } : {}),
     pendingInputs: view.inputs.filter((input) => input.actorId === actorId && input.lifecycle.kind === "pending").length,
-    openQuestions: view.actions.filter((action) => action.askedBy === actorId && action.kind === "question" && action.status === "pending").length,
+    pendingActions: view.actions.filter((action) => action.askedBy === actorId && action.status === "pending").length,
     ...(output ? { lastOutput: output.length > OUTPUT_CHARS ? `...${output.slice(-OUTPUT_CHARS)}` : output } : {}),
   };
 };