@schlenkr/ragents 0.1.0 → 0.1.1

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

@@ -38,6 +38,13 @@ const contract = {
 const startMarker = "START_LEARNING_AFTERNOON";
 
 
+type Tile = { entity: string } | { direction: "vertical"; weights: [number, number]; children: [Tile, Tile] };
+
+function stackedTiles(entities: string[]): Tile {
+  const [first, ...rest] = entities;
+  return rest.length === 0 ? { entity: first! } : { direction: "vertical", weights: [1, rest.length], children: [{ entity: first! }, stackedTiles(rest)] };
+}
+
 function boardWith(helpers: HelperState[]): LearningState {
   const working = helpers.some((helper) => helper.status === "working");
   return { phase: working ? "working" : helpers.some((helper) => helper.status === "error") ? "error" : "complete", helpers };
@@ -65,10 +72,13 @@ export default defineActor(contract, {
         const actor = await context.functions.agent_spawn({ handle: `learning-${helper.id}`, displayName: helper.label, profile: profile.name, prompt, tools: [] });
         return { ...helper, actorId: actor.id };
       }));
-      await context.functions.canvas_layout_replace({ nodes: [
-        ...helpers.map((helper) => ({ entity: `@learning-${helper.id}` })),
-        { entity: `app:@${context.actor.handle}/main` },
-      ] });
+      await context.functions.canvas_layout_replace({
+        root: {
+          direction: "horizontal",
+          weights: [1, 1],
+          children: [{ entity: `app:@${context.actor.handle}/main` }, stackedTiles(helpers.map((helper) => `@learning-${helper.id}`))],
+        },
+      });
       await context.functions.run_configure({ title: learningWorkflow.title, primaryActor: `@${context.actor.handle}` });
       context.state.replace({ board: { phase: "ready", helpers } });
       return;

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

@@ -37,7 +37,7 @@ export default defineActor(contract, {
     try {
       if (!state.status) {
         await context.functions.run_configure({ title: "Wortspiel", primaryActor: context.actor.id });
-        await context.functions.canvas_layout_replace({ nodes: [{ entity: `app:@${context.actor.handle}/main`, width: 640, height: 700 }] });
+        await context.functions.canvas_layout_replace({ root: { entity: `app:@${context.actor.handle}/main` } });
         const start = payloadOf(JSON.parse(input.content));
         if (start.input !== null || !start.options || typeof start.options !== "object" || Array.isArray(start.options)
           || Object.keys(start).some((key) => key !== "input" && key !== "options")) {

package/plugins/ragents.reference/skills/210-moderator-handover/SKILL.md

@@ -6,7 +6,7 @@ title: "Gespräch an einen Moderator übergeben"
 description: "Zeigt die Übergabe eines laufenden Chats an einen anderen Primary-Actor. Der Moderator übernimmt als direkter Ansprechpartner und hält den Aufgabenfortschritt fest."
 category: "Zusammenarbeit"
 order: 210
-tags: "Rückfragen, To-dos, Anwendungsfall, Konzeptdemo, Agententeams, Primary-Actor, Canvas-Layout"
+tags: "Rückfragen, To-dos, Anwendungsfall, Konzeptdemo, Agententeams, Primary-Actor"
 ---
 
 Ich hätte gern einen Workshop für einen ruhigeren Arbeitstag: Ein Planer bringt zwei Ideen mit, ein skeptischer Gast prüft die Nachteile. Ein Moderator übernimmt die Runde und spricht danach direkt mit mir im Chat, damit ich einen Vorschlag auswählen kann. Zeig die drei auf der Fläche und übergib das Gespräch wirklich an den Moderator. Seine Aufgabenliste zeigt den Fortschritt.

package/plugins/ragents.reference/walkthroughs.ts

@@ -2,25 +2,25 @@ export const referenceWalkthroughs = [
   {
     id: "mini-app-owner-inspector",
     title: "Den Helfer hinter einer Mini-App öffnen",
-    description: "Die Mini-App bleibt auf der Fläche; ihr Besitzer ist auch ohne zusätzliche Karte erreichbar.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Persönliche Canvas-Ansicht"],
+    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 auf dem Canvas; die Karte ihres Besitzers ist in der Standardansicht ausgeblendet.",
-      "Unten Actors öffnen und den Namen des Listenbesitzers wählen. Erwartung: Rechts öffnen sich dessen Chat und Details, ohne eine zusätzliche Karte einzublenden.",
-      "In der Actorliste die Canvas-Sichtbarkeit dieses Actors einschalten. Erwartung: Seine Karte erscheint zusätzlich; die Mini-App bleibt bedienbar und behält ihre Einträge.",
-      "Die Karte wieder ausblenden und die App erneut bedienen. Erwartung: Actor und Funktionen arbeiten weiter. Unter Ansicht hebt Ansicht zurücksetzen die persönliche Einzelentscheidung wieder auf.",
+      "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.",
+      "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.",
     ],
   },
   {
-    id: "personal-conversation-canvas",
-    title: "Eine Gesprächsrunde übersichtlicher anzeigen",
-    description: "Actor-Karten und Verbindungen lassen sich persönlich ausblenden, ohne den Gesprächsaufbau zu verändern.",
-    tags: ["Anwendungsfall", "Konzeptdemo", "Persönliche Canvas-Ansicht"],
+    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"],
     steps: [
-      "Im Profil core den Skill-Einstieg Eine Gesprächsrunde auf der Fläche anordnen ausführen und den Aufbau abwarten. Die sichtbaren Karten und Verbindungen ansehen.",
-      "Unter Actors einen Gesprächspartner vom Canvas ausblenden. Erwartung: Seine Karte und ihre Verbindungen verschwinden; sein Name in der Liste öffnet weiterhin den Inspector. Die übrigen Beteiligten arbeiten weiter.",
-      "Unter Ansicht Verbindungen anzeigen ausschalten und denselben Run im selben Browser neu laden. Erwartung: Die persönliche Auswahl bleibt erhalten; die Actors und das gespeicherte Layout sind unverändert.",
-      "Unter Ansicht Ansicht zurücksetzen wählen. Erwartung: Verbindungen und gewöhnliche Actor-Karten erscheinen wieder; Actors mit eigener Mini-App bleiben nach der Standardvorgabe ausgeblendet. Bei einem gestoppten Actor bleiben sein Name und sein Verlauf in der Liste erreichbar.",
+      "Im Profil core 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.",
     ],
   },
   {

package/plugins/ragents.workspace/client/workspace-client.ts

@@ -37,6 +37,8 @@ export interface WorkspaceClientExecution {
 }
 
 export interface WorkspaceClientOptions {
+  /** Die Host-Wurzel dieses Rechners, aus der die Sprachserver aufgelöst werden; sie kann erst später entstehen. */
+  hostRoot: () => string | undefined;
   onExecuted?: (execution: WorkspaceClientExecution) => void;
 }
 
@@ -75,7 +77,7 @@ export class WorkspaceClient {
   constructor(
     private readonly transport: WorkspaceClientTransport,
     identity: WorkspaceClientIdentity,
-    private readonly options: WorkspaceClientOptions = {},
+    private readonly options: WorkspaceClientOptions,
   ) {
     this.#identity = { ...identity, folders: [...identity.folders] };
     this.#executor = new SandboxWorkspaceExecutor({
@@ -198,6 +200,7 @@ export class WorkspaceClient {
       root: await realPathOf(cwd),
       home: { home: homedir() },
       logDirectory: join(tmpdir(), "ragents-workspace-logs", input.runId),
+      hostRoot: this.options.hostRoot(),
       additions: input.env,
     }));
     const startedAt = Date.now();

package/scripts/package/publish-package.ts

@@ -80,6 +80,7 @@ export const publishPlan = (manifest: Record<string, unknown>, published: readon
 
 export interface PublishOptions {
   readonly directory: string;
+  readonly version: string;
   readonly token: string;
   readonly dryRun: boolean;
   readonly npm: NpmRunner;
@@ -92,7 +93,7 @@ const scopeAdvice = (output: string): string => /Scope not found/i.test(output)
     + "auf npmjs.com anlegen bzw. den Token für den Scope freigeben."
   : "";
 
-/** Veröffentlicht den gebauten Ordner und nennt danach die Fassung, die npm ausliefert. */
+/** Veröffentlicht den gebauten Ordner; der Exit 0 von npm publish ist die Bestätigung. */
 export const publishDirectory = (options: PublishOptions): void => {
   const hide = redacting(options.token);
   const published = options.npm(["publish", "--access", "public", ...options.dryRun ? ["--dry-run"] : []], { cwd: options.directory, token: options.token });
@@ -103,9 +104,7 @@ export const publishDirectory = (options: PublishOptions): void => {
     options.log("== Probelauf: nichts veröffentlicht");
     return;
   }
-  const view = options.npm(["view", PACKAGE_NAME, "version"], { cwd: repositoryRoot });
-  if (view.status !== 0) throw new Error(`npm view ${PACKAGE_NAME} version endete mit Code ${view.status}: ${hide(oneLine(view.stderr))}`);
-  options.log(`== Auf npm steht jetzt ${PACKAGE_NAME}@${view.stdout.trim()}`);
+  options.log(`== Veröffentlicht: ${PACKAGE_NAME}@${options.version}`);
 };
 
 const main = async (): Promise<void> => {
@@ -117,7 +116,7 @@ const main = async (): Promise<void> => {
   const built = await buildPackage(path.join(repositoryRoot, "dist", PACKAGE_FOLDER));
   const plan = publishPlan(built.manifest, publishedVersions(PACKAGE_NAME, runNpm));
   console.log(`== ${plan.name}@${plan.version} aus Host ${plan.hostVersion.slice(0, 12)}, ${built.fileCount} Dateien, ${(built.byteSize / 1024 / 1024).toFixed(1)} MB`);
-  publishDirectory({ directory: built.directory, token, dryRun, npm: runNpm, log: (line) => console.log(line) });
+  publishDirectory({ directory: built.directory, version: plan.version, token, dryRun, npm: runNpm, log: (line) => console.log(line) });
 };
 
 const moduleUrl: string | undefined = import.meta.url;

package/scripts/workspace-client/run-workspace-client.ts

@@ -3,6 +3,7 @@ import { statSync } from "node:fs";
 import { hostname } from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { hostRoot } from "../../apps/server/src/host-version.ts";
 import { provisionWorkspace } from "../../apps/server/src/profile/provisioning.ts";
 import { workspaceClientTransport } from "../../plugins/ragents.workspace/client/transport.ts";
 import { WorkspaceClient } from "../../plugins/ragents.workspace/client/workspace-client.ts";
@@ -13,7 +14,7 @@ dieses Rechners aus - dasselbe, was die VS-Code-Erweiterung tut, nur ohne VS Cod
 gilt das aktuelle Verzeichnis. Jeder Werkzeugaufruf erscheint als eine Zeile auf stdout.
 Die Sprachserver holt der Start in den Werkzeugordner dieses Rechners (dasselbe wie
 pnpm provision --workspace); ROSLYN_LANGUAGE_SERVER und FSHARP_LANGUAGE_SERVER übersteuern ihn,
-TypeScript bringt der Executor mit. Das Skript läuft, bis es mit Strg-C beendet wird.`;
+TypeScript kommt aus dem Host-Ordner. Das Skript läuft, bis es mit Strg-C beendet wird.`;
 
 export interface WorkspaceClientArguments {
   readonly serverUrl: string;
@@ -71,6 +72,7 @@ const main = async (): Promise<void> => {
   };
   const transport = workspaceClientTransport(parsed.serverUrl, process.env.RAGENTS_TOKEN);
   const client = new WorkspaceClient(transport, identity, {
+    hostRoot,
     onExecuted: ({ runId, tool, durationMs, error }) =>
       console.log(`== ${runId.slice(0, 8)} ${tool} ${durationMs} ms ${error ?? "ok"}`),
   });

package/apps/web/src/MaterialSettings.tsx

@@ -1,40 +0,0 @@
-import { useEffect, useId, useState } from "react";
-import { useAccess } from "./AccessContext";
-import { DEFAULT_MATERIAL_SETTINGS, MATERIAL_SETTINGS_LIMITS, resetMaterialSettings, saveMaterialSettings, useMaterialSettings } from "./material-settings";
-import { Button, Input } from "./ui";
-
-const noteClasses = "text-sm leading-[1.6] text-muted-foreground";
-
-export function MaterialSettings() {
-  const { settings, error } = useMaterialSettings();
-  const writable = useAccess().can("settings.write");
-  const prefix = useId();
-  const [steps, setSteps] = useState(String(settings.steps));
-  useEffect(() => { setSteps(String(settings.steps)); }, [settings]);
-  const valid = (text: string, min: number, max: number) => text.trim() !== "" && Number.isInteger(Number(text)) && Number(text) >= min && Number(text) <= max;
-  const stepsValid = valid(steps, MATERIAL_SETTINGS_LIMITS.minSteps, MATERIAL_SETTINGS_LIMITS.maxSteps);
-  const changeSteps = (value: string) => {
-    if (!writable) return;
-    setSteps(value);
-    if (valid(value, MATERIAL_SETTINGS_LIMITS.minSteps, MATERIAL_SETTINGS_LIMITS.maxSteps)) saveMaterialSettings({ ...settings, steps: Number(value) });
-  };
-  return <div className="flex min-w-0 max-w-[680px] flex-col gap-5">
-    <p className={noteClasses}>Schichtwerk mit matten Flächen und gestapelter Tiefe. Änderungen gelten sofort für alle Runs und werden in diesem Browser gespeichert.</p>
-    <div className="flex flex-col gap-2">
-      <label className="text-sm font-semibold text-foreground" id={`${prefix}-steps-label`} htmlFor={`${prefix}-steps`}>Tiefenstufen</label>
-      <div className="flex min-w-0 items-center gap-5">
-        <input className="w-0 min-w-0 flex-1 accent-primary" aria-labelledby={`${prefix}-steps-label`} disabled={!writable} type="range" min={MATERIAL_SETTINGS_LIMITS.minSteps} max={MATERIAL_SETTINGS_LIMITS.maxSteps} step="1" value={settings.steps} onChange={(event) => changeSteps(event.target.value)} />
-        <Input className="w-[84px] flex-none" id={`${prefix}-steps`} aria-invalid={!stepsValid} aria-describedby={`${prefix}-steps-note`} disabled={!writable} type="number" min={MATERIAL_SETTINGS_LIMITS.minSteps} max={MATERIAL_SETTINGS_LIMITS.maxSteps} step="1" value={steps} onChange={(event) => changeSteps(event.target.value)} />
-      </div>
-      <p id={`${prefix}-steps-note`} className={stepsValid ? noteClasses : "text-sm leading-[1.6] text-destructive"}>{stepsValid ? `0 ist flach, bis zu 5 gleich tiefe Stufen. Standard: ${DEFAULT_MATERIAL_SETTINGS.steps}.` : "Bitte eine ganze Zahl von 0 bis 5 eingeben."}</p>
-    </div>
-    <div><Button variant="outline" disabled={!writable} onClick={() => {
-      if (!writable) return;
-      if (resetMaterialSettings()) {
-        setSteps(String(DEFAULT_MATERIAL_SETTINGS.steps));
-      }
-    }}>Auf Standard zurücksetzen</Button></div>
-    {!writable && <p className={noteClasses}>Die Materialeinstellungen sind mit deinen Rechten nur lesbar.</p>}
-    {error && <p className="text-sm leading-[1.6] text-destructive" role="alert">{error}</p>}
-  </div>;
-}

package/apps/web/src/material-settings.ts

@@ -1,104 +0,0 @@
-import { useSyncExternalStore } from "react";
-import { subscribeStorageChanges } from "./lib/local-storage-setting";
-
-export interface MaterialSettings {
-  steps: number;
-}
-
-export const DEFAULT_MATERIAL_SETTINGS: MaterialSettings = Object.freeze({ steps: 1 });
-export const MATERIAL_SETTINGS_LIMITS = { minSteps: 0, maxSteps: 5 };
-export const MATERIAL_DEPTH_PER_STEP = 12;
-export const MATERIAL_SETTINGS_STORAGE_KEY = "ragents.material-settings";
-
-interface MaterialSettingsSnapshot {
-  settings: MaterialSettings;
-  error?: string;
-}
-
-export function parseMaterialSettings(raw: string | null): MaterialSettings {
-  if (raw === null) return DEFAULT_MATERIAL_SETTINGS;
-  const value: unknown = JSON.parse(raw);
-  if (!value || typeof value !== "object" || !("steps" in value)
-    || typeof value.steps !== "number" || !Number.isInteger(value.steps) || value.steps < MATERIAL_SETTINGS_LIMITS.minSteps || value.steps > MATERIAL_SETTINGS_LIMITS.maxSteps) {
-    throw new Error("Ungültiges Material: Tiefenstufen müssen eine ganze Zahl von 0 bis 5 sein. Bitte die Materialeinstellungen zurücksetzen.");
-  }
-  return Object.freeze({ steps: value.steps });
-}
-
-const errorMessage = (cause: unknown) => cause instanceof Error ? cause.message : String(cause);
-const serverSnapshot: MaterialSettingsSnapshot = { settings: DEFAULT_MATERIAL_SETTINGS };
-const getServerSnapshot = () => serverSnapshot;
-const subscribeServer = () => () => {};
-
-export function createMaterialSettingsStore(browser: Window) {
-  let snapshot: MaterialSettingsSnapshot;
-  try {
-    snapshot = { settings: parseMaterialSettings(browser.localStorage.getItem(MATERIAL_SETTINGS_STORAGE_KEY)) };
-  } catch (cause) {
-    snapshot = { settings: DEFAULT_MATERIAL_SETTINGS, error: `Das gespeicherte Material konnte nicht geladen werden. Die Standardwerte werden angezeigt. ${errorMessage(cause)}` };
-  }
-  const listeners = new Set<() => void>();
-  let disposed = false;
-  const publish = (next: MaterialSettingsSnapshot) => {
-    if (snapshot.settings.steps === next.settings.steps && snapshot.error === next.error) return;
-    snapshot = next;
-    for (const listener of listeners) listener();
-  };
-  const report = (message: string) => publish({ ...snapshot, error: message });
-  const storageChanged = (event: StorageEvent) => {
-    try {
-      const storage = browser.localStorage;
-      if (event.storageArea !== storage) return;
-      publish({ settings: parseMaterialSettings(storage.getItem(MATERIAL_SETTINGS_STORAGE_KEY)) });
-    } catch (cause) {
-      report(`Das Material aus einem anderen Browser-Tab konnte nicht übernommen werden. ${errorMessage(cause)}`);
-    }
-  };
-  const unsubscribeStorage = subscribeStorageChanges(browser, (key) => key === MATERIAL_SETTINGS_STORAGE_KEY, storageChanged);
-  return {
-    getSnapshot: () => snapshot,
-    subscribe(listener: () => void) {
-      if (disposed) throw new Error("Die Materialeinstellungen wurden bereits beendet.");
-      listeners.add(listener);
-      return () => { listeners.delete(listener); };
-    },
-    save(settings: MaterialSettings) {
-      if (disposed) throw new Error("Die Materialeinstellungen wurden bereits beendet.");
-      try {
-        const next = parseMaterialSettings(JSON.stringify(settings));
-        browser.localStorage.setItem(MATERIAL_SETTINGS_STORAGE_KEY, JSON.stringify(next));
-        publish({ settings: next });
-      } catch (cause) {
-        report(`Das Material konnte nicht gespeichert werden. ${errorMessage(cause)}`);
-      }
-    },
-    reset() {
-      if (disposed) throw new Error("Die Materialeinstellungen wurden bereits beendet.");
-      try {
-        browser.localStorage.removeItem(MATERIAL_SETTINGS_STORAGE_KEY);
-        publish({ settings: DEFAULT_MATERIAL_SETTINGS });
-        return true;
-      } catch (cause) {
-        report(`Das Material konnte nicht zurückgesetzt werden. ${errorMessage(cause)}`);
-        return false;
-      }
-    },
-    dispose() {
-      if (disposed) return;
-      disposed = true;
-      unsubscribeStorage();
-      listeners.clear();
-    },
-  };
-}
-
-let activeStore: ReturnType<typeof createMaterialSettingsStore> | undefined;
-const materialSettingsStore = () => activeStore ??= createMaterialSettingsStore(window);
-
-export function useMaterialSettings(): MaterialSettingsSnapshot {
-  const store = typeof window === "undefined" ? undefined : materialSettingsStore();
-  return useSyncExternalStore(store?.subscribe ?? subscribeServer, store?.getSnapshot ?? getServerSnapshot, getServerSnapshot);
-}
-
-export const saveMaterialSettings = (settings: MaterialSettings): void => materialSettingsStore().save(settings);
-export const resetMaterialSettings = (): boolean => materialSettingsStore().reset();