@schlenkr/ragents 0.1.0 → 0.1.2

package/README.md

@@ -22,11 +22,15 @@ npm install -g @schlenkr/ragents
   RAGENTS_TOKEN=<token> ragents connect https://ragents.example.com
   ```
 
-- `start <profile>` - start a profile shipped with the package (`core`, `developer`) or a stand that
-  `connect` already fetched, without asking the server.
+- `start <profile|path>` - start a profile shipped with the package (`core`, `developer`), your
+  own `ragents.config.<name>.ts` anywhere on disk, or a stand that `connect` already fetched,
+  without asking the server. The web interface is built for that set of plugins when it is
+  missing or was last built for another profile or host version; the result goes to
+  `<data dir>/web/<profile>`, never into the package folder.
 
   ```sh
   ragents start developer
+  ragents start ~/projects/mine/ragents.config.mine.ts
   ```
 
 - `provision [<profile>|--workspace]` - fetch the tools the plugins of that profile need, such as
@@ -44,7 +48,8 @@ npm install -g @schlenkr/ragents
   ```
 
 - `run <folder> "<task>"` - start the host if none answers, bind a new run to the folder and wait
-  until the turn is finished; the last line is always `run: <id>`.
+  until the turn is finished; the last line is always `run: <id>`. This host serves no web
+  interface - an agent does not need one; use `start` for that.
 
   ```sh
   ragents run ~/projects/demo "Fix the type error in src/broken.ts"
@@ -71,7 +76,8 @@ npm install -g @schlenkr/ragents
 
 ## Requirements
 
-- Node 22 (>= 22.19.0). No git, no pnpm, no build step.
+- Node 22 (>= 22.19.0). No git, no pnpm, no source checkout; the package builds its own web
+  interface per profile with the Vite it brings along.
 - `dotnet` (.NET 10 SDK) for the C# diagnostics through Roslyn and the F# diagnostics through FSAC;
   without it TypeScript diagnostics still work.
 - Model access: either `OPENROUTER_API_KEY` in the environment, or `ragents connect <server-url>`

package/apps/server/src/plugin-support/language-server/contract.ts

@@ -3,7 +3,12 @@ import { defineOperation } from "@aicontainer/ragents/src/rpc/contract";
 import { openJson } from "@aicontainer/ragents/src/http/contracts";
 import type { LanguageServerSnapshot } from "@aicontainer/workspace-executor";
 
-export type { LanguageServerSeverity, LanguageServerSnapshot } from "@aicontainer/workspace-executor";
+export type {
+  LanguageServerInstanceSnapshot,
+  LanguageServerSeverity,
+  LanguageServerSnapshot,
+  LanguageServerState,
+} from "@aicontainer/workspace-executor";
 
 /** Je Sprachserver-Plugin eine Methode; die Rechte tragen seine Kennung. */
 export const languageServerSnapshotContract = (pluginId: string) =>

package/apps/server/src/plugin-support/language-server/tools.ts

@@ -1,6 +1,7 @@
 import { Type } from "typebox";
 import { defineRunFunction, type ToolContributor } from "@aicontainer/ragents";
 import {
+  languageServerCloseTool,
   languageServerDiagnosticsTool,
   languageServerOpenTool,
   type LanguageServerAdapter,
@@ -19,15 +20,22 @@ export const createLanguageServerToolContributor = (
   const openMetadata = {
     name: languageServerOpenTool(id),
     nativeTool: true,
-    description: `Start the ${label} language server for this conversation's workspace and load ${rootDescription}. `
+    description: `Start a ${label} language server instance for this conversation's workspace and load ${rootDescription}. `
       + `Afterwards every edit or write of a ${extensions} file gets its diagnostics appended automatically, `
-      + `and ${languageServerDiagnosticsTool(id)} is available. Idempotent for the same root; a different root replaces the server.`,
+      + `and ${languageServerDiagnosticsTool(id)} is available. Idempotent for the same root; other roots stay open.`,
   } as const;
   const diagnosticsMetadata = {
     name: languageServerDiagnosticsTool(id),
     nativeTool: true,
     description: `Current ${label} diagnostics (errors, warnings on request) for ${extensions} files from the running `
-      + `language server, without building. Without paths: all changed files of the workspace according to git.`,
+      + `language server, without building. Without paths: all changed files of every open root according to git. `
+      + `With paths every file is answered by the instance whose root contains it; root asks one instance.`,
+  } as const;
+  const closeMetadata = {
+    name: languageServerCloseTool(id),
+    nativeTool: true,
+    description: `Stop the ${label} language server instance of one root; without root every ${label} instance of `
+      + "this conversation. Other languages and other conversations stay untouched.",
   } as const;
   const openTool = defineRunFunction({
     ...openMetadata,
@@ -51,6 +59,7 @@ export const createLanguageServerToolContributor = (
       paths: Type.Optional(Type.Array(Type.String(), {
         description: "Files relative to the workspace root; omit for all changed files",
       })),
+      root: Type.Optional(Type.String({ description: "Ask only the instance of this open root" })),
       warnings: Type.Optional(Type.Boolean({ description: "Also list warnings (default: only counted)" })),
     }),
     resultSchema: Type.String(),
@@ -62,12 +71,28 @@ export const createLanguageServerToolContributor = (
         ...(scope.signal ? { signal: scope.signal } : {}),
       }) as string,
   });
+  const closeTool = defineRunFunction({
+    ...closeMetadata,
+    label: `${label} schließen`,
+    schema: Type.Object({
+      root: Type.Optional(Type.String({ description: "The open root to stop; omit for every instance of this conversation" })),
+    }),
+    resultSchema: Type.String(),
+    available: alwaysAvailable,
+    executionMode: "sequential",
+    run: async (scope, toolCallId, input) =>
+      await sandbox.execute(scope.caller.runId, closeMetadata.name, input, {
+        toolCallId,
+        ...(scope.signal ? { signal: scope.signal } : {}),
+      }) as string,
+  });
   return {
     name: `ragents.lsp-${id}`,
     descriptors: [
       toolDescriptorFrom(openMetadata, alwaysAvailable),
       toolDescriptorFrom(diagnosticsMetadata, alwaysAvailable),
+      toolDescriptorFrom(closeMetadata, alwaysAvailable),
     ],
-    tools: () => [openTool, diagnosticsTool],
+    tools: () => [openTool, diagnosticsTool, closeTool],
   };
 };

package/apps/server/src/plugin-support/run-scripts.ts

@@ -6,7 +6,7 @@ import { flag, frontMatterOf, numberOf, tagsOf } from "./front-matter.js";
 export type ScriptStartEntry = Extract<StartEntryContribution, { action: "script" }>;
 
 const PACKAGE_NAME = /^[a-z0-9][a-z0-9-]*$/;
-const RUN_FIELDS = ["title", "description", "order", "guide", "tags", "coordinator"];
+const RUN_FIELDS = ["title", "description", "order", "guide", "tags", "coordinator", "category"];
 
 const requiredFile = (directory: string, name: string): string => {
   const file = path.join(directory, name);
@@ -45,6 +45,8 @@ const runScriptFrom = (directory: string, name: string, id: string): ScriptStart
   const order = numberOf(runFile, "order", fields.get("order"));
   const guide = fields.get("guide");
   const tags = tagsOf(runFile, fields.get("tags"));
+  const category = fields.get("category");
+  if (category !== undefined && !category.trim()) throw new Error(`${runFile}: category ist leer`);
   const programsDirectory = path.join(directory, "actors");
   const programsStats = statSync(programsDirectory, {throwIfNoEntry: false});
   if (programsStats && !programsStats.isDirectory()) throw new Error(`${programsDirectory} muss ein Verzeichnis sein`);
@@ -60,6 +62,7 @@ const runScriptFrom = (directory: string, name: string, id: string): ScriptStart
     ...(order !== undefined ? {order} : {}),
     ...(guide ? {guide} : {}),
     ...(tags !== undefined ? {tags} : {}),
+    ...(category ? {category} : {}),
     script: {
       handle: name,
       coordinator: flag(runFile, "coordinator", fields.get("coordinator"), true),

package/apps/server/src/plugin-support/start-entries-contract.ts

@@ -13,7 +13,7 @@ export interface StartEntryBase {
 /** One entry of the start surface as GET /api/plugins publishes it; a script entry never carries its source. */
 export type StartEntry = StartEntryBase & (
   | { action: "skill"; skill: string; category: string; prompt: string }
-  | { action: "script"; coordinator: boolean }
+  | { action: "script"; coordinator: boolean; category?: string }
 );
 
 export type SkillStartEntry = Extract<StartEntry, { action: "skill" }>;
@@ -62,9 +62,10 @@ export const startEntryFrom = (value: unknown): StartEntry => {
       return { ...base, action: "skill", skill: value.skill, category: value.category, prompt: value.prompt };
     }
     case "script":
-      allowed(["coordinator"]);
+      allowed(["coordinator", "category"]);
       if (typeof value.coordinator !== "boolean") throw invalid(`${id}: coordinator muss true oder false sein`);
-      return { ...base, action: "script", coordinator: value.coordinator };
+      if (value.category !== undefined && (!text(value.category) || value.category !== value.category.trim())) throw invalid(`${id}: category muss ein einzelner nicht leerer Text sein`);
+      return { ...base, action: "script", coordinator: value.coordinator, ...(value.category !== undefined ? { category: value.category } : {}) };
     default:
       throw invalid(`${id}: unbekannte Aktion ${String(value.action)}; gültig sind skill und script`);
   }

package/apps/server/src/plugin-support/workspace-sandbox-host.ts

@@ -25,6 +25,7 @@ import {
   type WorkspaceExecutor,
   type WorkspaceProcessContext,
 } from "@aicontainer/workspace-executor";
+import { hostRoot } from "../host-version.js";
 import type { SessionWorkspace } from "../ragents/workspace-runtime.js";
 import { agentToolFrom, toolDescriptorFrom, type AgentToolDefinition } from "./agent-tool.js";
 import { alwaysAvailable } from "./tool-availability.js";
@@ -137,6 +138,7 @@ export class WorkspaceSandboxHost implements SandboxServices {
       root: await workspace.currentRoot(),
       home,
       logDirectory: home.home,
+      hostRoot: hostRoot(),
       ...(ident ? { ident } : {}),
       additionalRoots: await this.#additionalRoots(runId, ident),
       readOnlyRoots,

package/apps/server/src/profile-target.ts

@@ -0,0 +1,25 @@
+import { statSync } from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { isEnvironmentReference } from "./config-definition.js";
+import { defaultDataDirectory } from "./data-directory.js";
+
+export interface ProfileTarget {
+  readonly profile: string;
+  readonly profileFile: string;
+  readonly port: number;
+  readonly dataDirectory: string;
+  readonly baseUrl: string;
+}
+
+/** Port und Datenordner eines Profils, wie der Server sie später selbst bestimmt: Umgebung vor Profildatei vor Vorgabe. */
+export const readProfileTarget = async (profile: string, profileFile: string, environment = process.env): Promise<ProfileTarget> => {
+  if (!statSync(profileFile, { throwIfNoEntry: false })?.isFile()) throw new Error(`Die Profildatei fehlt: ${profileFile}`);
+  const module = await import(pathToFileURL(profileFile).href) as { config: { host: { PORT?: number; DATA_DIR?: unknown } } };
+  const port = Number(environment.PORT || module.config.host.PORT);
+  if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error(`host.PORT des Profils ${profile} ist keine gültige Portnummer.`);
+  const configured = module.config.host.DATA_DIR;
+  const fromFile = isEnvironmentReference(configured) ? environment[configured.name] : typeof configured === "string" ? configured : undefined;
+  const dataDirectory = path.resolve(environment.DATA_DIR ?? fromFile ?? defaultDataDirectory(profile));
+  return { profile, profileFile, port, dataDirectory, baseUrl: `http://localhost:${port}` };
+};

package/apps/server/src/web-build.ts

@@ -0,0 +1,82 @@
+import { spawn } from "node:child_process";
+import { statSync } from "node:fs";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { createInterface } from "node:readline";
+import { readHostVersion } from "./host-version.js";
+
+/** Vite kommt im Checkout aus apps/web/node_modules, im Paket aus dessen Abhängigkeiten; beide Male ab apps/web aufgelöst. */
+export const viteEntry = (root: string): string => {
+  try {
+    const manifest = createRequire(path.join(root, "apps/web/package.json")).resolve("vite/package.json");
+    return path.join(path.dirname(manifest), "bin/vite.js");
+  } catch (cause) {
+    throw new Error(`Der Web-Build findet Vite neben ${path.join(root, "apps/web")} nicht: `
+      + `${cause instanceof Error ? cause.message : String(cause)}`);
+  }
+};
+
+const run = (file: string, args: readonly string[], cwd: string, environment: NodeJS.ProcessEnv, log: (line: string) => void): Promise<void> =>
+  new Promise((resolve, reject) => {
+    const child = spawn(file, args, { cwd, env: environment, stdio: ["ignore", "pipe", "pipe"] });
+    for (const stream of [child.stdout, child.stderr]) createInterface({ input: stream! }).on("line", log);
+    child.once("error", reject);
+    child.once("exit", (code) => code === 0 ? resolve() : reject(new Error(`Der Web-Build endete mit Code ${code}`)));
+  });
+
+export interface WebBuild {
+  readonly root: string;
+  /** Node, das Vite ausführt; in der Erweiterung ist process.execPath Electron und taugt nicht. */
+  readonly node?: string;
+  readonly outputDirectory: string;
+  readonly environment: NodeJS.ProcessEnv;
+  readonly log: (line: string) => void;
+}
+
+/** Baut das Web für den Pluginsatz, den die Umgebung nennt: PRODUCT_PROFILE samt Datei oder PLUGIN_LIST_FILE. */
+export const buildWeb = async (build: WebBuild): Promise<void> => {
+  const entry = viteEntry(build.root);
+  await rm(build.outputDirectory, { recursive: true, force: true });
+  await mkdir(path.dirname(build.outputDirectory), { recursive: true });
+  await run(build.node ?? process.execPath, [entry, "build", "--outDir", build.outputDirectory, "--emptyOutDir"], path.join(build.root, "apps/web"), build.environment, build.log);
+  if (!statSync(path.join(build.outputDirectory, "index.html"), { throwIfNoEntry: false })?.isFile()) {
+    throw new Error(`Der Web-Build hat keine index.html in ${build.outputDirectory} hinterlassen`);
+  }
+};
+
+/** Je Profil ein gebautes Web im Datenordner; der Paketordner bleibt unberührt. */
+export const webBuildDirectory = (dataDirectory: string, profile: string): string => path.join(dataDirectory, "web", profile);
+
+export interface WebBuildTarget {
+  readonly root: string;
+  readonly node?: string;
+  readonly profile: string;
+  readonly profileFile: string;
+  readonly dataDirectory: string;
+  readonly environment: NodeJS.ProcessEnv;
+  readonly log: (line: string) => void;
+  readonly build?: (build: WebBuild) => Promise<void>;
+}
+
+const stampOf = (target: WebBuildTarget): string =>
+  JSON.stringify({ root: target.root, profileFile: target.profileFile, hostVersion: readHostVersion(target.root) }, null, 2);
+
+/** Baut das Web des Profils, wenn es fehlt oder zuletzt für ein anderes Profil oder eine andere Host-Fassung gebaut wurde. */
+export const ensureWebBuild = async (target: WebBuildTarget): Promise<string> => {
+  const directory = webBuildDirectory(target.dataDirectory, target.profile);
+  const stampFile = `${directory}.json`;
+  const stamp = stampOf(target);
+  const built = statSync(path.join(directory, "index.html"), { throwIfNoEntry: false })?.isFile() === true;
+  if (built && (await readFile(stampFile, "utf8").catch(() => undefined))?.trim() === stamp) return directory;
+  target.log(`== Web des Profils ${target.profile} bauen nach ${directory}`);
+  await (target.build ?? buildWeb)({
+    root: target.root,
+    node: target.node,
+    outputDirectory: directory,
+    environment: { ...target.environment, PRODUCT_PROFILE: target.profile, PRODUCT_PROFILE_FILE: target.profileFile },
+    log: target.log,
+  });
+  await writeFile(stampFile, `${stamp}\n`);
+  return directory;
+};

package/apps/server/tsconfig.json

@@ -0,0 +1,38 @@
+{
+  "compilerOptions": {
+    "target": "ES2024",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "allowImportingTsExtensions": true,
+    "strict": true,
+    "isolatedModules": true,
+    "skipLibCheck": true,
+    "types": [
+      "node"
+    ],
+    "noEmit": true,
+    "lib": [
+      "ES2024"
+    ],
+    "paths": {
+      "@aicontainer/server/*": [
+        "../../apps/server/src/*"
+      ],
+      "@aicontainer/web/*": [
+        "../../apps/web/src/*"
+      ],
+      "@aicontainer/plugins/*": [
+        "../../plugins/*"
+      ],
+      "@ragents/workflow": [
+        "../../plugins/ragents.actor-programs/workflow/index.ts"
+      ]
+    }
+  },
+  "include": [
+    "src",
+    "../../plugins/*/server",
+    "../../plugins/*/contract.ts",
+    "../../ragents.config.*.ts"
+  ]
+}

package/apps/web/column.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="de">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>RAgents Panel</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/column.tsx"></script>
+  </body>
+</html>

package/apps/web/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="de">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>RAgents</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/apps/web/src/App.tsx

@@ -30,7 +30,6 @@ export function App() {
   const overviewButtonRef = useRef<HTMLButtonElement>(null);
   const settingsButtonRef = useRef<HTMLButtonElement>(null);
   const [runHeaderContainer, setRunHeaderContainer] = useState<HTMLDivElement | null>(null);
-  const [canvasToolbarContainer, setCanvasToolbarContainer] = useState<HTMLDivElement | null>(null);
   const [workspaceHeaderContainer, setWorkspaceHeaderContainer] = useState<HTMLDivElement | null>(null);
   const [statusContainer, setStatusContainer] = useState<HTMLElement | null>(null);
   const [workspaceModalContainer, setWorkspaceModalContainer] = useState<HTMLDivElement | null>(null);
@@ -80,13 +79,6 @@ export function App() {
     if (restoreFocus) overviewButtonRef.current?.focus({ preventScroll: true });
   }, []);
 
-  useEffect(() => {
-    if (!canvasToolbarContainer) return;
-    const activateCanvas = () => { closeOverview(); setToolbarPanel(undefined); };
-    canvasToolbarContainer.addEventListener("click", activateCanvas);
-    return () => canvasToolbarContainer.removeEventListener("click", activateCanvas);
-  }, [canvasToolbarContainer, closeOverview]);
-
   // Overview contributions keep their state after the first opening.
   const openOverview = useCallback(() => {
     setToolbarPanel(undefined);
@@ -202,7 +194,6 @@ export function App() {
             {busy ? <Spinner aria-hidden className="size-[18px]" /> : <SparklesIcon size={22} />}
           </button>
         </div>}
-        <div className="relative flex flex-none self-stretch empty:hidden" ref={setCanvasToolbarContainer} />
         {toolbarPanels.map(({ id, Panel }) => <ToolbarPanelHost
           id={id} key={id} onBusy={setPanelBusy}
           onClose={() => setToolbarPanel(undefined)}
@@ -230,7 +221,6 @@ export function App() {
         {readRuns && activeId
           ? (
             <PluginChat
-              canvasToolbarContainer={canvasToolbarContainer}
               headerContainer={runHeaderContainer}
               workspaceHeaderContainer={workspaceHeaderContainer}
               statusContainer={statusContainer}

package/apps/web/src/PluginChat.tsx

@@ -55,7 +55,7 @@ export type ChatLayout = "workspace" | "column" | { element: string };
 
 interface PluginChatProps {
   layout?: ChatLayout;
-  canvasToolbarContainer?: HTMLElement | null;
+  toolbarContainer?: HTMLElement | null;
   statusContainer?: HTMLElement | null;
   headerContainer?: HTMLElement | null;
   workspaceHeaderContainer?: HTMLElement | null;
@@ -71,7 +71,7 @@ interface PluginChatProps {
 
 interface ChatWorkspaceProps {
   layout: ChatLayout;
-  canvasToolbarContainer?: HTMLElement | null;
+  toolbarContainer?: HTMLElement | null;
   statusContainer?: HTMLElement | null;
   panelState: WorkspacePanelState;
   onTogglePanel: () => void;
@@ -90,7 +90,7 @@ interface ChatWorkspaceProps {
   tabs: readonly WorkspaceTabContribution[];
 }
 
-export function PluginChat({ layout = "workspace", headerContainer, canvasToolbarContainer, workspaceHeaderContainer, statusContainer, initialStartOptions, onStarted, onLocationChange, onViewed, viewing = false, registry, session, startDialog }: PluginChatProps) {
+export function PluginChat({ layout = "workspace", headerContainer, toolbarContainer, workspaceHeaderContainer, statusContainer, initialStartOptions, onStarted, onLocationChange, onViewed, viewing = false, registry, session, startDialog }: PluginChatProps) {
   const access = useAccess();
   const startOnly = startDialog !== undefined;
   const [modalContainer, setModalContainer] = useState<HTMLDivElement | null>(null);
@@ -235,7 +235,7 @@ export function PluginChat({ layout = "workspace", headerContainer, canvasToolba
             panelVisible={panelState === "expanded"} runId={session.id} tabs={availableTabs} />}
           <ChatWorkspace
             layout={layout}
-            canvasToolbarContainer={canvasToolbarContainer}
+            toolbarContainer={toolbarContainer}
             panelState={panelState}
             onTogglePanel={() => updatePanelState(panelState === "expanded" ? "collapsed" : "expanded")}
             headerContainer={headerContainer}
@@ -281,7 +281,7 @@ function UserLocationReporter({ activeTabId, onChange, panelVisible, runId, tabs
 
 function ChatWorkspace({
   layout,
-  canvasToolbarContainer = null,
+  toolbarContainer = null,
   panelState,
   onTogglePanel,
   headerContainer,
@@ -385,7 +385,7 @@ function ChatWorkspace({
           ? <CanvasElementView elementId={layout.element} navigation={navigation} registry={registry} session={session} />
           : CanvasColumn
             ? <CanvasColumn
-              toolbarContainer={canvasToolbarContainer}
+              toolbarContainer={toolbarContainer}
               runToolbarContainer={null}
               statusContainer={statusContainer}
               cardSections={registry.cardSections}
@@ -420,7 +420,7 @@ function ChatWorkspace({
         {CanvasCenter
             ? (
               <CanvasCenter
-                toolbarContainer={canvasToolbarContainer}
+                toolbarContainer={toolbarContainer}
                 runToolbarContainer={runToolbarContainer}
                 statusContainer={statusContainer}
                 cardSections={registry.cardSections}
@@ -477,7 +477,7 @@ function CanvasElementView({ elementId, navigation, registry, session }: {
     {session.runView === undefined ? "Der Run wird geladen ..." : "Diese Mini-App gibt es in dem Run nicht mehr."}
   </div>;
   return <div className="flex min-h-0 min-w-0 flex-1 flex-col" data-view="element">
-    <match.Element definition={match.definition} navigation={navigation} presentation="tiled" session={session} />
+    <match.Element definition={match.definition} navigation={navigation} session={session} />
   </div>;
 }
 

package/apps/web/src/PluginRegistry.tsx

@@ -152,25 +152,13 @@ export interface CanvasElementDefinition {
   id: string;
   visible?: boolean;
   title?: string;
-  width: number;
-  height: number;
-  collapsedHeight?: number;
   anchorActorId?: string;
   entity?: EntityReference;
-  resizable?: {
-    minWidth: number;
-    maxWidth: number;
-    minHeight: number;
-    maxHeight: number;
-  };
   data?: unknown;
 }
 
 export interface CanvasElementContext {
   definition: CanvasElementDefinition;
-  presentation?: "canvas" | "tiled";
-  collapsed?: boolean;
-  onCollapsedChange?: (collapsed: boolean) => void;
   navigation: SessionNavigation;
   session: SessionContext;
 }

package/apps/web/src/StartSurface.tsx

@@ -120,13 +120,13 @@ export function StartEntryLibrary({ skills, scripts, launchDisabled, onOpen, has
   const sorted = useMemo(() => [...[...skills].sort(byOrder), ...[...scripts].sort(byOrder)], [skills, scripts]);
   const tags = [...new Set(sorted.flatMap((entry) => entry.tags ?? []))].sort((a, b) => a.localeCompare(b, "de-DE"));
   const filtered = sorted.filter((entry) => (!tag || entry.tags?.includes(tag))
-    && `${entry.title} ${entry.description} ${entry.action === "skill" ? entry.category : kindLabel(entry)} ${entry.owner} ${(entry.tags ?? []).join(" ")}`
+    && `${entry.title} ${entry.description} ${entry.category ?? kindLabel(entry)} ${entry.owner} ${(entry.tags ?? []).join(" ")}`
       .toLocaleLowerCase("de-DE").includes(query.trim().toLocaleLowerCase("de-DE")));
   const selected = filtered.find((entry) => entry.id === selectedId) ?? filtered[0];
   const guided = selected && hasGuide(selected);
   const tagOptions = [{ value: "", label: "Alle Schlagworte" }, ...tags.map((value) => ({ value, label: value }))];
   const items: ListDetailItem[] = filtered.map((entry) => ({ id: entry.id, title: entry.title,
-    description: entry.description, group: entry.action === "skill" ? entry.category : technical ? "Run-Scripts" : "Abläufe",
+    description: entry.description, group: entry.category ?? (technical ? "Run-Scripts" : "Abläufe"),
     icon: entryIcon(entry), meta: technical ? kindLabel(entry) : undefined, tone: entry.action === "skill" ? "purple" : "success" }));
 
   return <ListDetail className="min-h-0 flex-1" label="Skills und Abläufe" detailLabel="Vorschau" items={items}

package/apps/web/src/ThemeSettings.tsx

@@ -25,7 +25,7 @@ export function ThemeSettings() {
         </div>
         <div className="flex-[1_1_220px]">
           <h3 className="mb-1.5 text-lg font-semibold" id="theme-settings-title">Schichtwerk</h3>
-          <p className={noteClasses}>Matte Flächen, gestapelte Tiefe und gezeichnete Konturen.</p>
+          <p className={noteClasses}>Matte Flächen und gezeichnete Konturen.</p>
         </div>
         <ToggleGroup aria-label="Schichtwerk-Farbschema" className="flex-none max-sm:w-full" disabled={!writable} size="sm" spacing={0}
           value={[preference]} variant="outline"