@schlenkr/ragents 0.1.5 → 0.1.6

package/plugins/ragents.profile-distribution/server/archive.ts

@@ -1,20 +1,16 @@
 import { createHash } from "node:crypto";
 import { readdirSync, statSync, lstatSync } from "node:fs";
-import { copyFile, mkdir } from "node:fs/promises";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 import { create as createTar } from "tar";
-import { hostConfigKeys } from "@aicontainer/server/config.js";
-import { isEnvironmentReference, isProvisionedReference } from "@aicontainer/server/config-definition.js";
-import { resolveAnonymousUser, resolveProfileUsers, SECRET_KEY_PATTERN } from "@aicontainer/server/config-file.js";
-import { discoverPluginIds } from "@aicontainer/server/profile/plugin-discovery.js";
-import { isPluginPath, PLUGIN_SERVER_FOLDER, pluginFolderFor, pluginIdOf, pluginsRoot } from "@aicontainer/server/plugin-support/plugins-root.js";
-import { CLIENT_WEB_FOLDER } from "../contract.js";
+import { hostConfigKeys } from "@ragents/host/config.js";
+import { isEnvironmentReference, isProvisionedReference } from "@ragents/host/config-definition.js";
+import { resolveAnonymousUser, resolveProfileUsers, SECRET_KEY_PATTERN } from "@ragents/host/config-file.js";
+import { discoverPluginIds, resolvePluginEntries, type ResolvedPlugin } from "@ragents/host/profile/plugin-discovery.js";
+import { bundlesRoot, isPluginPath } from "@ragents/host/plugin-support/plugins-root.js";
 
-export interface ClientProfilePlugin {
-  readonly id: string;
+export interface ClientProfilePlugin extends ResolvedPlugin {
   readonly source: "host" | "archive";
-  readonly folder: string;
 }
 
 export interface InspectedClientProfile {
@@ -31,12 +27,8 @@ export interface PackedClientProfile {
   readonly entries: readonly string[];
 }
 
-const EXCLUDED_FOLDERS = new Set(["node_modules", "tests", ".git"]);
 const PROFILE_FILE = /^ragents\.config\.([a-z0-9]+(?:-[a-z0-9]+)*)\.ts$/;
 
-const hasServerEntry = (folder: string): boolean =>
-  ["index.ts", "index.js"].some((name) => statSync(path.join(folder, PLUGIN_SERVER_FOLDER, name), { throwIfNoEntry: false })?.isFile() === true);
-
 const commonRoot = (first: string, others: readonly string[]): string => {
   let root = first;
   for (const folder of others) {
@@ -71,7 +63,7 @@ const checkSections = (source: string, raw: Record<string, unknown>, pluginIds:
 };
 
 /** Prüft die Client-Profildatei ohne ihre Umgebung und bestimmt, welche Plugins ins Archiv gehören. */
-export const inspectClientProfile = async (source: string, root = pluginsRoot): Promise<InspectedClientProfile> => {
+export const inspectClientProfile = async (source: string, root = bundlesRoot): Promise<InspectedClientProfile> => {
   const name = PROFILE_FILE.exec(path.basename(source));
   if (!name) throw new Error(`Die Client-Profildatei muss ragents.config.<profil>.ts heißen: ${source}`);
   if (!statSync(source, { throwIfNoEntry: false })?.isFile()) throw new Error(`Die Client-Profildatei ${source} fehlt`);
@@ -85,25 +77,20 @@ export const inspectClientProfile = async (source: string, root = pluginsRoot):
     throw new Error(`${source}: host.PLUGINS muss eine nicht leere Liste sein`);
   }
   if (host?.PRODUCT_PROFILE !== profile) throw new Error(`${source}: host.PRODUCT_PROFILE muss ${profile} sein`);
-  const known = discoverPluginIds(root);
   const directory = path.dirname(source);
-  const plugins = (entries as string[]).map((entry): ClientProfilePlugin => {
-    if (!isPluginPath(entry)) {
-      if (!known.includes(entry)) throw new Error(`${source}: das Plugin ${entry} ist im Host nicht bekannt (bekannt: ${known.join(", ")})`);
-      return { id: entry, source: "host", folder: path.join(root, entry) };
-    }
-    const folder = pluginFolderFor(entry, directory, root);
-    if (!statSync(folder, { throwIfNoEntry: false })?.isDirectory() || !hasServerEntry(folder)) {
-      throw new Error(`${source}: das Plugin ${entry} hat keinen Ordner ${folder} mit ${PLUGIN_SERVER_FOLDER}/index.ts`);
-    }
-    if (statSync(path.join(folder, "node_modules"), { throwIfNoEntry: false })) {
-      throw new Error(`${source}: das Plugin ${entry} bringt eigene node_modules mit; Abhängigkeiten müssen aus dem Host kommen`);
+  const unportable = (entries as string[]).filter((entry) => isPluginPath(entry) && !/^\.{1,2}\//.test(entry));
+  if (unportable.length > 0) {
+    throw new Error(`${source}: ${unportable.join(", ")} nennt ein Bundle absolut oder mit ~/; der Client löst diesen Pfad auf seinem eigenen Rechner auf und fände dort nicht das gelieferte Bundle. Im Client-Profil jedes Bundle relativ zur Profildatei nennen (./ oder ../)`);
+  }
+  const plugins = ((): readonly ClientProfilePlugin[] => {
+    try {
+      return resolvePluginEntries(entries as string[], directory, root)
+        .map((plugin, index) => ({ ...plugin, source: isPluginPath((entries as string[])[index]!) ? "archive" : "host" }));
+    } catch (cause) {
+      throw new Error(`${source}: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
     }
-    return { id: pluginIdOf(folder), source: "archive", folder };
-  });
-  const duplicate = plugins.find((plugin, index) => plugins.findIndex((other) => other.id === plugin.id) !== index);
-  if (duplicate) throw new Error(`${source}: das Plugin ${duplicate.id} steht mehrfach in host.PLUGINS`);
-  checkSections(source, raw as Record<string, unknown>, new Set([...known, ...plugins.map((plugin) => plugin.id)]));
+  })();
+  checkSections(source, raw as Record<string, unknown>, new Set([...discoverPluginIds(root), ...plugins.map((plugin) => plugin.id)]));
   const users = resolveProfileUsers(source, module.users, placeholderEnvironment);
   const anonymous = resolveAnonymousUser(source, module.anonymousUser);
   if (users && anonymous) throw new Error(`${source}: users und anonymousUser schließen einander aus`);
@@ -118,7 +105,7 @@ const collectFiles = (folder: string, root: string): string[] => {
     const absolute = path.join(folder, entry.name);
     if (entry.isSymbolicLink()) throw new Error(`Das Client-Profil enthält einen symbolischen Link, den das Archiv nicht abbildet: ${absolute}`);
     if (entry.isDirectory()) {
-      if (!EXCLUDED_FOLDERS.has(entry.name)) files.push(...collectFiles(absolute, root));
+      files.push(...collectFiles(absolute, root));
     } else if (entry.isFile()) {
       files.push(posixRelative(root, absolute));
     }
@@ -126,32 +113,20 @@ const collectFiles = (folder: string, root: string): string[] => {
   return files;
 };
 
-const collectStaged = (folder: string, root: string): string[] =>
-  readdirSync(folder, { withFileTypes: true })
-    .sort((left, right) => left.name.localeCompare(right.name, "en"))
-    .flatMap((entry) => entry.isDirectory() ? collectStaged(path.join(folder, entry.name), root) : [posixRelative(root, path.join(folder, entry.name))]);
-
-/** Kopiert Profildatei und Archiv-Plugins in den Staging-Ordner, in dem das gebaute Web schon unter web/ liegt. */
-export const stageClientProfile = async (inspected: InspectedClientProfile, staging: string): Promise<readonly string[]> => {
+/** Die Einträge des Archivs: die Profildatei und die Dateien der Bundles, die sie per Pfad nennt; das Web hat der Client selbst. */
+export const clientProfileEntries = (inspected: InspectedClientProfile): readonly string[] => {
   const entries = [inspected.file, ...inspected.plugins.filter((plugin) => plugin.source === "archive").flatMap((plugin) => collectFiles(plugin.folder, inspected.root))];
   for (const entry of entries) {
     if (!lstatSync(path.join(inspected.root, entry)).isFile()) throw new Error(`Der Archiveintrag ${entry} ist keine Datei`);
-    if (entry === CLIENT_WEB_FOLDER || entry.startsWith(`${CLIENT_WEB_FOLDER}/`)) {
-      throw new Error(`Der Archiveintrag ${entry} kollidiert mit ${CLIENT_WEB_FOLDER}/, dem Ordner des gebauten Webs`);
-    }
-    const target = path.join(staging, ...entry.split("/"));
-    await mkdir(path.dirname(target), { recursive: true });
-    await copyFile(path.join(inspected.root, entry), target);
   }
   return entries;
 };
 
-/** Packt den Staging-Ordner deterministisch; der Stand ist der SHA-256 des Archivs. */
-export const packClientProfile = async (inspected: InspectedClientProfile, staging: string): Promise<PackedClientProfile> => {
-  await stageClientProfile(inspected, staging);
-  const entries = collectStaged(staging, staging);
+/** Packt die Einträge deterministisch aus ihrem gemeinsamen Ordner; der Stand ist der SHA-256 des Archivs. */
+export const packClientProfile = async (inspected: InspectedClientProfile): Promise<PackedClientProfile> => {
+  const entries = clientProfileEntries(inspected);
   const chunks: Buffer[] = [];
-  for await (const chunk of createTar({ gzip: { level: 9 }, cwd: staging, portable: true, noMtime: true }, entries)) {
+  for await (const chunk of createTar({ gzip: { level: 9 }, cwd: inspected.root, portable: true, noMtime: true }, [...entries])) {
     chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
   }
   const archive = Buffer.concat(chunks);

package/plugins/ragents.profile-distribution/server/config.ts

@@ -1,6 +1,6 @@
 import path from "node:path";
-import { configFilePath } from "@aicontainer/server/config-file.js";
-import { declaredEnvironment } from "@aicontainer/server/plugin-support/plugin-config.js";
+import { configFilePath } from "@ragents/host/config-file.js";
+import { declaredEnvironment } from "@ragents/host/plugin-support/plugin-config.js";
 
 export const profileDistributionConfigDescriptors = [
   { key: "CLIENT_PROFILE_FILE", source: "environment" },

package/plugins/ragents.profile-distribution/server/index.ts

@@ -1,13 +1,10 @@
-import { rm } from "node:fs/promises";
-import path from "node:path";
-import { DomainError, implement, type HttpRouteContribution, type RAgentsPlugin } from "@aicontainer/ragents";
-import { readHostVersion, readPackageVersion } from "@aicontainer/server/host-version.js";
-import type { PluginModule } from "@aicontainer/server/plugin-support/plugin-module.js";
-import { writeJson } from "@aicontainer/server/plugin-support/http.js";
-import { CLIENT_WEB_FOLDER, profileArchivePath, profileDistributionContracts, type ClientProfileDescription } from "../contract.js";
+import { DomainError, implement, type HttpRouteContribution, type RAgentsPlugin } from "@ragents/engine";
+import { readHostApiVersion, readHostVersion, readPackageVersion } from "@ragents/host/host-version.js";
+import type { PluginModule } from "@ragents/host/plugin-support/plugin-module.js";
+import { writeJson } from "@ragents/host/plugin-support/http.js";
+import { profileArchivePath, profileDistributionContracts, type ClientProfileDescription } from "../contract.js";
 import { inspectClientProfile, packClientProfile } from "./archive.js";
 import { profileDistributionConfig, profileDistributionConfigDescriptors } from "./config.js";
-import { buildClientWeb } from "./web.js";
 
 interface DistributionState {
   readonly description: ClientProfileDescription;
@@ -59,28 +56,24 @@ const profileDistributionPlugin: RAgentsPlugin = {
       initialize: async () => {
         const hostVersion = profileDistributionConfig.hostVersion() ?? readHostVersion();
         const packageVersion = readPackageVersion();
+        const hostApi = readHostApiVersion();
         const inspected = await inspectClientProfile(file);
-        const staging = host.storage.root("staging");
-        await rm(staging, { recursive: true, force: true });
-        console.log(`Profilverteilung: Web für ${inspected.profile} bauen`);
-        await buildClientWeb(inspected, path.join(staging, CLIENT_WEB_FOLDER), (line) => console.log(`  ${line}`));
-        const packed = await packClientProfile(inspected, staging);
+        const packed = await packClientProfile(inspected);
         ready = {
           archive: packed.archive,
           description: {
             profile: inspected.profile,
             version: packed.version,
+            hostApi,
             hostVersion,
             packageVersion,
             file: inspected.file,
-            web: CLIENT_WEB_FOLDER,
             size: packed.archive.byteLength,
             archivePath: profileArchivePath(packed.version),
             plugins: inspected.plugins.map((plugin) => ({ id: plugin.id, source: plugin.source })),
           },
         };
-        await rm(staging, { recursive: true, force: true });
-        console.log(`Profilverteilung: ${inspected.profile} Stand ${packed.version.slice(0, 12)} (${packed.entries.length} Dateien, ${packed.archive.byteLength} Byte, Host ${hostVersion.slice(0, 12)}, Paket ${packageVersion})`);
+        console.log(`Profilverteilung: ${inspected.profile} Stand ${packed.version.slice(0, 12)} (${packed.entries.length} Dateien, ${packed.archive.byteLength} Byte, Host-API ${hostApi}, Host ${hostVersion.slice(0, 12)}, Paket ${packageVersion})`);
       },
     });
     host.methods(implement(profileDistributionContracts.describe, () => state().description));

package/plugins/ragents.reference/examples.ts

@@ -5,7 +5,7 @@ export const referenceConcepts = [
   { id: "fifo", label: "Input-Warteschlange" },
   { id: "stop", label: "Actor-Stopp" },
   { id: "artifacts", label: "Artefakte und Zugriff" },
-  { id: "tiles", label: "Kachelfläche", entryKind: "walkthrough" },
+  { id: "tiles", label: "Fläche", entryKind: "walkthrough" },
   { id: "actor-views", label: "Mini-Apps" },
   { id: "actor-state", label: "Actor-Zustand" },
   { id: "llm-actor-view", label: "LLM-Actor mit View" },

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

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

package/plugins/ragents.reference/run-scripts/balcony-wizard/RUN.md

@@ -6,7 +6,7 @@ coordinator: false
 tags: Run-Scripts, Anwendungsfall, Konzeptdemo, Mini-Apps, LLM-Actor mit View, Frei gesteuerter Chat, Primary-Actor
 ---
 
-Das TypeScript-Setup legt einen Balkon-Berater mit dem Modellprofil `standard` und ausdrücklich
+Das TypeScript-Setup legt einen Balkon-Berater mit der Rolle `standard` und ausdrücklich
 ohne Werkzeuge an. Das mitgelieferte Programm `actors/balcony-app/` bindet eine eigenständige
 Mini-App an diesen Actor. Die Fläche zeigt allein deren Kachel statt einer Chatkachel; ein Koordinator
 wird für diesen Run nicht angelegt. Der Berater wird zum Primary-Actor und behält seinen eigenen
@@ -19,7 +19,7 @@ ein Formular, nicht in ein Chat-Widget. Fortschritt und abgeschlossene Antworten
 dem Neuladen aus dem Gespräch rekonstruieren; eine fehlgeschlagene Modellantwort kann erneut
 angefordert werden, ohne eine weitere Antwort zu zählen.
 
-Der Einstieg benötigt keine Startwerte. Das Setup wird einmal ausgeführt und startet noch keinen
+Die Vorlage benötigt keine Startwerte. Das Setup wird einmal ausgeführt und startet noch keinen
 Modellaufruf. Erst eine Aktion in der App schickt Text an den Berater. Fragen und Empfehlungen
 bleiben Modellantworten; die App prüft ihre fachliche Qualität nicht automatisch.
 

package/plugins/ragents.reference/run-scripts/balcony-wizard/actors/balcony-app/src/client.tsx

@@ -47,7 +47,7 @@ function App() {
         <label htmlFor="interview-progress">{conversation.answers} von {answerCount} Antworten</label>
         <progress className="h-2.5 w-full [accent-color:var(--foreground)]" id="interview-progress" max={answerCount} value={conversation.answers} />
       </UI.Stack>
-      {snapshot?.readOnly && <p>Dieser Lauf ist schreibgeschützt.</p>}
+      {snapshot?.readOnly && <p>Dieser Run ist schreibgeschützt.</p>}
       {(sendError || conversation.error) && <p role="alert">{sendError || conversation.error}</p>}
       {conversation.phase === "start" && !pending && <UI.Stack>
         <p>Du beantwortest immer nur eine Frage. Deine bisherigen Angaben bleiben beim erneuten Öffnen erhalten.</p>

package/plugins/ragents.reference/run-scripts/balcony-wizard/src/server.ts

@@ -20,7 +20,7 @@ export default defineActor(contract, {
     if (context.state.read().built) return;
     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 advisor = await context.functions.agent_spawn({
       handle: "balcony-advisor", displayName: "Balkon-Berater", prompt, profile: profile.name, tools: [],
     });

package/plugins/ragents.reference/run-scripts/balcony-wizard/tests/program.test.ts

@@ -21,7 +21,7 @@ function setup(options: { missingProfile?: boolean; failActivation?: boolean } =
       const activation = value as { name: string; actor: string };
       return { name: activation.name, actor: activation.actor, views: 1, active: true };
     }
-    return [];
+    return null;
   }]));
   const context = createTestContext<{ built?: boolean }>({ state: {}, functions });
   return { calls, context };
@@ -43,14 +43,14 @@ test("richtet einen Berater ohne Werkzeuge und seine eigene Mini-App als einzige
   assert.equal(calls.length, 5);
 });
 
-test("fehlendes Modellprofil baut keinen unbrauchbaren Berater", async () => {
+test("fehlende Rolle baut keinen unbrauchbaren Berater", async () => {
   const { calls, context } = setup({ missingProfile: true });
-  await assert.rejects(async () => program.onInput!(input, context), /Modellprofil standard fehlt/);
+  await assert.rejects(async () => program.onInput!(input, context), /Rolle standard fehlt/);
   assert.deepEqual(calls.map((call) => call.name), ["model_list"]);
   assert.deepEqual(context.state.read(), {});
 });
 
-test("eine fehlgeschlagene View-Aktivierung setzt weder Canvas noch Erfolgszustand", async () => {
+test("eine fehlgeschlagene View-Aktivierung setzt weder Fläche noch Erfolgszustand", async () => {
   const options = { failActivation: true };
   const { calls, context } = setup(options);
   await assert.rejects(async () => program.onInput!(input, context), /View kann nicht aktiviert/);

package/plugins/ragents.reference/run-scripts/conversation-circle/RUN.md

@@ -7,7 +7,7 @@ tags: Run-Scripts, Anwendungsfall, Konzeptdemo, Startleitfaden, Agententeams
 ---
 
 Ein deterministisches Setup: das Script stellt mira, jon und ada als gewöhnliche LLMs auf, teilt
-die Kachelfläche unter ihnen auf und übergibt dem Koordinator das Briefing.
+die Fläche unter ihnen auf und übergibt dem Koordinator das Briefing.
 Die Karte prüft das Modell, dieses Script prüft die Plattform.
 
 Der Leitfaden übergibt `{ "topic": "...", "rounds": 2 }`. `topic` enthält 1 bis 160 Zeichen, `rounds` ist eine ganze Zahl von 1 bis 5. Der Startwert `null` wählt ausdrücklich das Thema "Sollten Innenstädte autofrei werden?" und zwei Runden. Andere unvollständige oder ungültige Werte werden vor dem Aufbau abgelehnt. Thema und Rundenzahl steuern die Darstellung und den Auftrag, das Thema auch den Run-Titel.

package/plugins/ragents.reference/run-scripts/conversation-circle/src/server.ts

@@ -42,7 +42,7 @@ export default defineActor(contract, {
     const catalog = await context.functions.model_list({});
     const profiles = catalog.profiles.filter((profile) => profile.driver === "agent" && profile.name !== "coordinator");
     const first = profiles[0];
-    if (!first) throw new Error("Kein Agentenprofil außer dem Koordinator; agent_spawn braucht eines.");
+    if (!first) throw new Error("Keine Rolle außer coordinator; agent_spawn braucht eine.");
 
     await context.functions.run_configure({ title: `Gesprächsrunde: ${topic}` });
 

package/plugins/ragents.reference/run-scripts/conversation-circle/tests/helpers.ts

@@ -15,7 +15,7 @@ export const setupContext = (profiles = [{ name: "coordinator", driver: "agent"
     return name === "model_list" ? {
       profiles: profiles.map((profile) => ({ ...profile, description: "Testprofil", turnTimeoutMs: null,
         isolateWorkspace: false, provider: "test", model: "test" })), models: [],
-    } : [];
+    } : name === "actor_input" ? [] : null;
   }]));
   return { calls, context: createTestContext<{ built?: boolean }>({ state: {}, functions }) };
 };

package/plugins/ragents.reference/run-scripts/learning-afternoon/RUN.md

@@ -7,7 +7,7 @@ tags: Run-Scripts, Anwendungsfall, Konzeptdemo, Mini-Apps, TypeScript-Actors, Ag
 ---
 
 Das vorbereitete TypeScript-Programm richtet zwei KI-Helfer ohne Werkzeuge ein und zeigt seine
-eigene Mini-App. Beide verwenden das Modellprofil `standard`. Ein Koordinator ist nicht nötig;
+eigene Mini-App. Beide verwenden die Rolle `standard`. Ein Koordinator ist nicht nötig;
 der TypeScript-Actor steuert den Ablauf und ist der Primary-Actor.
 
 Erst "Ideen sammeln" beauftragt die beiden Helfer: Helfer A schlägt ein einfaches Experiment
@@ -19,6 +19,6 @@ Ergebnisliste. Die Ideen sind echte Modellantworten und werden nicht fachlich ge
 Ein Fehler bei einem Helfer lässt das Ergebnis des anderen stehen. Leere Antworten und
 unterbrochene Modell-Turns erscheinen als Fehler. Der Ablauf startet einmal und wiederholt
 weder Aufträge noch fehlgeschlagene Antworten automatisch. Für neue Ideen beginnt ein neuer Run.
-Der Einstieg benötigt keine Startwerte und löst vor dem Button keinen Modellaufruf aus.
+Die Vorlage benötigt keine Startwerte und löst vor dem Button keinen Modellaufruf aus.
 
 Die Homepage verwendet dieselbe React-Ansicht mit ausdrücklich markierten Vorschaudaten.

package/plugins/ragents.reference/run-scripts/learning-afternoon/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/learning-afternoon/src/server.ts

@@ -66,7 +66,7 @@ export default defineActor(contract, {
     if (!state.board) {
       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 prompt = await workflowInstructions(learningWorkflow, "helper", readPrompt);
       const helpers = await Promise.all(initialState.helpers.map(async (helper) => {
         const actor = await context.functions.agent_spawn({ handle: `learning-${helper.id}`, displayName: helper.label, profile: profile.name, prompt, tools: [] });

package/plugins/ragents.reference/run-scripts/learning-afternoon/src/state.ts

@@ -19,7 +19,7 @@ export interface LearningState {
 
 export const initialState: LearningState = {
   phase: "ready",
-  helpers: helperSteps.map((step, index) => ({ id: step.id, label: `Helfer ${String.fromCharCode(65 + index)}`, task: step.title, status: "waiting", text: "" })),
+  helpers: helperSteps.map((step, index) => ({ id: step.id, label: `Helper ${String.fromCharCode(65 + index)}`, task: step.title, status: "waiting", text: "" })),
 };
 
 const helperStatuses = { waiting: "pending", working: "active", complete: "done", error: "blocked" } as const;
@@ -32,7 +32,7 @@ export function learningWorkflowState(state: LearningState): WorkflowState {
     }])),
     collect: {
       status: state.phase === "complete" ? "done" : state.phase === "error" ? "blocked" : state.phase === "working" ? "active" : "pending",
-      detail: `${state.helpers.filter((helper) => helper.status === "complete").length} von ${state.helpers.length} Ideen gesammelt.`,
+      detail: `${state.helpers.filter((helper) => helper.status === "complete").length} of ${state.helpers.length} ideas collected.`,
     },
   } };
 }

package/plugins/ragents.reference/run-scripts/learning-afternoon/src/view.tsx

@@ -11,7 +11,7 @@ export interface LearningAfternoonProps {
   preview?: boolean;
 }
 
-const phaseLabels = { ready: "Bereit", working: "Die Helfer arbeiten", complete: "Beide Ideen sind da", error: "Mit Fehler beendet" };
+const phaseLabels = { ready: "Ready", working: "The helpers are working", complete: "Both ideas are ready", error: "Finished with an error" };
 const rowClass = "flex items-center justify-between gap-2.5";
 const noteClass = "text-xs text-muted-foreground";
 
@@ -20,21 +20,21 @@ export function LearningAfternoonView({ state, onStart, pending, error, preview
   return (
     <main className="min-h-full bg-background text-base **:min-w-0 **:[overflow-wrap:anywhere]">
       <header className={`${rowClass} flex-wrap`}>
-        <div><p className={`mb-1.5 ${noteClass}`}>Zwei Helfer, eine Sammlung</p><h1 className="text-[1.55rem] leading-[1.2] font-semibold">{learningWorkflow.title}</h1></div>
-        <span className={`shrink-0 ${noteClass}`}>{entries.length} / {state.helpers.length} Ideen</span>
+        <div><p className={`mb-1.5 ${noteClass}`}>Two helpers, one collection</p><h1 className="text-[1.55rem] leading-[1.2] font-semibold">{learningWorkflow.title}</h1></div>
+        <span className={`shrink-0 ${noteClass}`}>{entries.length} / {state.helpers.length} ideas</span>
       </header>
-      <p className="mt-3.5 mb-5">Je eine Idee für einen Lernnachmittag mit Grundschulkindern: gemeinsam experimentieren und spielerisch Wissen testen.</p>
-      {preview && <p className={`mb-4 ${noteClass}`}>Vorschau mit Beispielideen. Keine aufgenommenen KI-Antworten.</p>}
-      <WorkflowDiagram definition={learningWorkflow} state={learningWorkflowState(state)} label="Ablauf des Lernnachmittags" direction="down" viewport="fit-width" />
-      <section className="mt-5 rounded-lg border border-border bg-card p-4" aria-label="Gemeinsame Ergebnisliste">
-        <div className={`${rowClass} flex-wrap`}><h2 className="text-base font-semibold">Gemeinsame Ergebnisliste</h2><span className={noteClass}>Automatisch gesammelt</span></div>
-        {entries.length === 0 ? <p className="py-5 text-sm text-muted-foreground">Hier erscheinen die fertigen Ideen.</p> : <ol className="mt-3 grid gap-3">
+      <p className="mt-3.5 mb-5">One idea each for an afternoon with primary-school children: explore together and test knowledge through play.</p>
+      {preview && <p className={`mb-4 ${noteClass}`}>Preview with example ideas. No recorded AI responses.</p>}
+      <WorkflowDiagram definition={learningWorkflow} state={learningWorkflowState(state)} label="Learning afternoon workflow" direction="down" viewport="fit-width" />
+      <section className="mt-5 rounded-lg border border-border bg-card p-4" aria-label="Shared result list">
+        <div className={`${rowClass} flex-wrap`}><h2 className="text-base font-semibold">Shared result list</h2><span className={noteClass}>Collected automatically</span></div>
+        {entries.length === 0 ? <p className="py-5 text-sm text-muted-foreground">Completed ideas appear here.</p> : <ol className="mt-3 grid gap-3">
           {entries.map((helper) => <li className="border-t border-border pt-3" key={helper.id}><strong className={noteClass}>{helper.label}</strong><p className="mt-1.5 whitespace-pre-wrap">{helper.text}</p></li>)}
         </ol>}
       </section>
       <footer className={`${rowClass} mt-4 min-h-9 flex-wrap`}>
-        <p className={noteClass} role="status">{pending ? "Auftrag wird gesendet" : phaseLabels[state.phase]}</p>
-        {state.phase === "ready" && <Button onClick={onStart} disabled={pending || !onStart}>Ideen sammeln</Button>}
+        <p className={noteClass} role="status">{pending ? "Sending tasks" : phaseLabels[state.phase]}</p>
+        {state.phase === "ready" && <Button onClick={onStart} disabled={pending || !onStart}>Collect ideas</Button>}
       </footer>
       {error && <p className="mt-2 text-destructive" role="alert">{error}</p>}
     </main>

package/plugins/ragents.reference/run-scripts/learning-afternoon/src/workflow.ts

@@ -2,31 +2,31 @@ import { defineWorkflow } from "@ragents/workflow";
 
 export const learningWorkflow = defineWorkflow({
   id: "learning-afternoon",
-  title: "Lernnachmittag",
+  title: "Learning afternoon",
   roles: {
-    helper: { title: "Ideenhelfer", prompt: "prompts/helper.md" },
-    collection: { title: "Automatische Sammlung" },
+    helper: { title: "Idea helper", prompt: "prompts/helper.md" },
+    collection: { title: "Automatic collection" },
   },
   steps: [
     {
-      id: "experiment", title: "Ein einfaches Experiment", role: "helper",
-      goal: "Entwickle genau eine Experimentidee für einen gemeinsamen Lernnachmittag mit Grundschulkindern.",
+      id: "experiment", title: "A simple experiment", role: "helper",
+      goal: "Create exactly one experiment idea for an afternoon with primary-school children.",
       prompt: "prompts/experiment.md",
-      completion: { source: "agent", description: "Der Helfer hat eine konkrete Idee als Text geliefert." },
-      freedom: { mode: "fixed", description: "Material und Experiment frei wählen; genau eine Idee liefern." },
+      completion: { source: "agent", description: "The helper provided one concrete idea as text." },
+      freedom: { mode: "fixed", description: "Choose the material and experiment freely; provide exactly one idea." },
     },
     {
-      id: "quiz", title: "Ein kleines Lernquiz", role: "helper",
-      goal: "Entwickle genau eine Quizidee für einen gemeinsamen Lernnachmittag mit Grundschulkindern.",
+      id: "quiz", title: "A short learning quiz", role: "helper",
+      goal: "Create exactly one quiz idea for an afternoon with primary-school children.",
       prompt: "prompts/quiz.md",
-      completion: { source: "agent", description: "Der Helfer hat eine konkrete Idee als Text geliefert." },
-      freedom: { mode: "fixed", description: "Thema und Spielweise frei wählen; genau eine Idee liefern." },
+      completion: { source: "agent", description: "The helper provided one concrete idea as text." },
+      freedom: { mode: "fixed", description: "Choose the topic and format freely; provide exactly one idea." },
     },
     {
-      id: "collect", title: "Ideen gemeinsam sammeln", role: "collection",
-      goal: "Die Antworten beider unabhängig arbeitenden Helfer in der gemeinsamen Ergebnisliste anzeigen.",
-      completion: { source: "service", description: "Beide Helfer sind beendet; erfolgreiche Ideen und Fehler bleiben sichtbar." },
-      freedom: { mode: "fixed", description: "Antworten unverändert übernehmen; keine weitere Modellantwort erzeugen." },
+      id: "collect", title: "Collect ideas", role: "collection",
+      goal: "Show the responses from both independent helpers in one shared result list.",
+      completion: { source: "service", description: "Both helpers have finished; successful ideas and errors remain visible." },
+      freedom: { mode: "fixed", description: "Keep responses unchanged and do not generate another model response." },
     },
   ],
   transitions: [

package/plugins/ragents.reference/run-scripts/learning-afternoon/tests/program.test.ts

@@ -27,12 +27,7 @@ function setup(options: { missingProfile?: boolean; failDispatch?: string; befor
       const handle = (input as { handle: string }).handle;
       return { id: `actor-${handle}`, handle };
     }
-    if (name === "event_subscribe") return {
-      subscriptionId: "ideas", subscriberId: "test-actor", sourceActorIds: ["actor-learning-experiment", "actor-learning-quiz"],
-      sources: ["@learning-experiment", "@learning-quiz"], sourceActorKinds: null,
-      eventTypes: ["turn.finished", "turn.interrupted", "actor.stopped"], includeSelf: false,
-      createdBy: "test-actor", createdAt: "2026-09-13T12:00:00.000Z", createdSequence: 1, status: "active",
-    };
+    if (name === "event_subscribe") return { subscriptionId: "ideas", sources: ["@learning-experiment", "@learning-quiz"] };
     if (name === "event_query") return history.filter((event) => (input as { actorIds: string[] }).actorIds.includes(event.actorId));
     if (name === "actor_input") {
       const actor = (input as { actor: string }).actor;
@@ -40,7 +35,7 @@ function setup(options: { missingProfile?: boolean; failDispatch?: string; befor
       if (actor === options.failDispatch) throw new Error("Auftrag konnte nicht gesendet werden.");
       return [{ type: "actor.input.enqueued", payload: { actorId: `actor-${actor.slice(1)}`, inputId: `input-${actor.slice(1)}` } }];
     }
-    return [];
+    return null;
   }]));
   return { calls, context: Object.assign(createTestContext<{ board?: LearningState; subscriptionId?: string }>({ state: {}, functions }), { history }) };
 }
@@ -190,7 +185,7 @@ test("ein gescheiterter Input verhindert den Auftrag des anderen Helfers nicht",
 
 test("ohne Standardprofil wird kein Helfer angelegt", async () => {
   const { context, calls } = setup({ missingProfile: true });
-  await assert.rejects(async () => program.onInput(setupInput, context), /Modellprofil standard fehlt/);
+  await assert.rejects(async () => program.onInput(setupInput, context), /Rolle standard fehlt/);
   assert.deepEqual(calls.map((call) => call.name), ["model_list"]);
   assert.deepEqual(context.state.read(), {});
 });

package/plugins/ragents.reference/run-scripts/moderated-round/src/server.ts

@@ -23,7 +23,7 @@ export default defineActor(contract, {
     const catalog = await context.functions.model_list({});
     const profiles = catalog.profiles.filter((profile) => profile.driver === "agent" && profile.name !== "coordinator");
     const first = profiles[0];
-    if (!first) throw new Error("Kein Agentenprofil außer dem Koordinator; agent_spawn braucht eines.");
+    if (!first) throw new Error("Keine Rolle außer coordinator; agent_spawn braucht eine.");
 
     const moderator = await context.functions.agent_spawn({
       handle: "moderator",

package/plugins/ragents.reference/run-scripts/moderated-round/tests/helpers.ts

@@ -15,7 +15,7 @@ export const setupContext = (profiles = [{ name: "coordinator", driver: "agent"
     return name === "model_list" ? {
       profiles: profiles.map((profile) => ({ ...profile, description: "Testprofil", turnTimeoutMs: null,
         isolateWorkspace: false, provider: "test", model: "test" })), models: [],
-    } : [];
+    } : name === "actor_input" ? [] : null;
   }]));
   return { calls, context: createTestContext<{ built?: boolean }>({ state: {}, functions }) };
 };

package/plugins/ragents.reference/run-scripts/moderated-round/tests/program.test.ts

@@ -16,9 +16,9 @@ test("stellt Moderator und Gäste auf und übergibt ihm den Chat", async () => {
   assert.equal(calls.length, completedCalls);
 });
 
-test("ohne ein nutzbares Agentenprofil bleibt der Aufbau unverändert", async () => {
+test("ohne eine nutzbare Rolle bleibt der Aufbau unverändert", async () => {
   const { calls, context } = setupContext([{ name: "coordinator", driver: "agent" }]);
-  await assert.rejects(async () => program.onInput!(startInput(null), context), /Kein Agentenprofil/);
+  await assert.rejects(async () => program.onInput!(startInput(null), context), /Keine Rolle/);
   assert.deepEqual(calls.map((call) => call.name), ["model_list"]);
   assert.deepEqual(context.state.read(), {});
 });

package/plugins/ragents.reference/run-scripts/shared-actor-list/actors/shared-list/src/client.tsx

@@ -8,21 +8,21 @@ type FormValues = Parameters<typeof UI.Form>[0]["values"];
 const App = () => {
   const state = useAppState();
   const [values, setValues] = React.useState<FormValues>({ text: "" });
-  const [status, setStatus] = React.useState("Bereit");
+  const [status, setStatus] = React.useState("Ready");
   const entries = state.entries ?? [];
 
   const append = async (next: FormValues): Promise<void> => {
     const answer = await context.capabilities.call("append", { text: String(next.text ?? "") });
     setValues({ text: "" });
-    setStatus(`Hinzugefügt: ${answer.text}`);
+    setStatus(`Added: ${answer.text}`);
   };
 
   return (
-    <UI.AppLayout title="Gemeinsame Liste" description={<>{entries.length} {entries.length === 1 ? "Eintrag" : "Einträge"}</>}>
+    <UI.AppLayout title="Shared list" description={<>{entries.length} {entries.length === 1 ? "item" : "items"}</>}>
       <UI.Grid>
         <UI.Form fields={[
-          { id: "text", label: "Neuer Eintrag", type: "textarea", placeholder: "Text eingeben" },
-        ]} values={values} onChange={setValues} onSubmit={append} submitLabel="Hinzufügen" />
+          { id: "text", label: "New item", type: "textarea", placeholder: "Enter text" },
+        ]} values={values} onChange={setValues} onSubmit={append} submitLabel="Add" />
         <UI.Stack>
           <p className="text-muted-foreground" role="status">{status}</p>
           <ul className="border-t border-border">
@@ -35,5 +35,5 @@ const 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/shared-actor-list/src/server.ts

@@ -36,7 +36,7 @@ export default defineActor(contract, {
     const catalog = await context.functions.model_list({});
     const profiles = catalog.profiles.filter((profile) => profile.driver === "agent" && profile.name !== "coordinator");
     const first = profiles[0];
-    if (!first) throw new Error("Kein Agentenprofil außer dem Koordinator; agent_spawn braucht eines.");
+    if (!first) throw new Error("Keine Rolle außer coordinator; agent_spawn braucht eine.");
 
     await context.functions.run_configure({ title: `Sammelboard: ${title}` });
 
@@ -55,8 +55,8 @@ export default defineActor(contract, {
     });
     await context.functions.actor_input({
       actor: "@coordinator",
-      content: `Die gemeinsame Sammlung heißt ${JSON.stringify(title)}. Das Run-Script hat das Programm shared-list an @${helper.handle} gebunden. Seine View ist auf dem Canvas sichtbar; der Helfer ergänzt gerade den ersten Eintrag mit append_to_list. `
-        + "Unten unter Actors öffnet sein Name den Inspector mit Chat und Details. Seine Canvas-Karte ist standardmäßig ausgeblendet und lässt sich in der Actors-Liste bei Bedarf einschalten. "
+      content: `Die gemeinsame Sammlung heißt ${JSON.stringify(title)}. Das Run-Script hat das Programm shared-list an @${helper.handle} gebunden. Seine View ist auf der Fläche sichtbar; der Helfer ergänzt gerade den ersten Eintrag mit append_to_list. `
+        + "Unten unter Actors öffnet sein Name den Inspector mit Chat und Details. Seine Kachel ist standardmäßig ausgeblendet und lässt sich in der Actors-Liste bei Bedarf einschalten. "
         + "Erkläre dem Benutzer in drei Sätzen, wie er die sichtbare Liste bedient, den Helfer öffnet und dass View und Funktion denselben Listenstand teilen.",
     });
 

package/plugins/ragents.reference/run-scripts/shared-actor-list/tests/helpers.ts

@@ -15,7 +15,7 @@ export const setupContext = (profiles = [{ name: "coordinator", driver: "agent"
     return name === "model_list" ? {
       profiles: profiles.map((profile) => ({ ...profile, description: "Testprofil", turnTimeoutMs: null,
         isolateWorkspace: false, provider: "test", model: "test" })), models: [],
-    } : [];
+    } : name === "actor_input" ? [] : null;
   }]));
   return { calls, context: createTestContext<{ built?: boolean }>({ state: {}, functions }) };
 };