@schlenkr/ragents 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schlenkr/ragents",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "RAgents-Host: Server, Engine, Plugins und Werkzeuge ohne Quell-Checkout",
   "keywords": [
     "agents",
@@ -37,9 +37,11 @@
     "@silvia-odwyer/photon-node": "0.3.4",
     "@tailwindcss/node": "4.3.3",
     "@tailwindcss/oxide": "4.3.3",
+    "@tailwindcss/vite": "4.3.3",
     "@types/node": "24.13.3",
     "@types/react": "19.2.18",
     "@types/react-dom": "19.2.4",
+    "@vitejs/plugin-react": "4.7.0",
     "@xyflow/react": "12.11.6",
     "ai": "7.0.99",
     "chalk": "5.6.2",
@@ -47,6 +49,7 @@
     "cn": "0.3.0",
     "cross-spawn": "7.0.6",
     "diff": "8.0.4",
+    "dompurify": "3.4.13",
     "elkjs": "0.12.0",
     "esbuild": "0.28.2",
     "glob": "13.0.6",
@@ -73,10 +76,11 @@
     "typescript": "5.9.3",
     "typescript-language-server": "6.0.0",
     "undici": "8.5.0",
+    "vite": "6.4.3",
     "vscode-jsonrpc": "9.0.2",
     "yaml": "2.9.0"
   },
   "ragents": {
-    "hostVersion": "c21cf651ca70b5851dbedfbc6f03d21cea77e596"
+    "hostVersion": "1f5768e0029dbc9663ecd4e31b365c4e4e99f531"
   }
 }

package/packages/ragents/src/plugin-host.ts

@@ -522,7 +522,10 @@ const validateStartEntry = (entry: StartEntryContribution): void => {
       }
       return;
     case "script":
-      assertKnownFields(entry, entry, [...base, "script"], "Einstieg");
+      assertKnownFields(entry, entry, [...base, "script", "category"], "Einstieg");
+      if (entry.category !== undefined && (typeof entry.category !== "string" || !entry.category.trim() || entry.category !== entry.category.trim())) {
+        throw new Error(`Einstieg ${entry.id}: category muss ein einzelner nicht leerer Text sein`);
+      }
       validateScriptPackage(entry, entry.script);
       return;
     default:
@@ -572,7 +575,7 @@ export class StartEntryContributionRegistry {
           case "skill":
             return { ...base, action: "skill", skill: value.skill, category: value.category, prompt: value.prompt };
           case "script":
-            return { ...base, action: "script", coordinator: value.script.coordinator };
+            return { ...base, action: "script", coordinator: value.script.coordinator, ...(value.category !== undefined ? { category: value.category } : {}) };
         }
       })
       .sort(byOrderThenId);

package/packages/ragents/src/plugin-types.ts

@@ -207,7 +207,8 @@ export interface RunScriptPackage {
 
 export type StartEntryContribution = StartEntryBase & (
   | { action: "skill"; skill: string; category: string; prompt: string }
-  | { action: "script"; script: RunScriptPackage }
+  /** A run script may name a category of its own; without one the start surfaces group it as a run script. */
+  | { action: "script"; script: RunScriptPackage; category?: string }
 );
 
 export type StartEntryAction = StartEntryContribution["action"];
@@ -215,7 +216,7 @@ export type StartEntryAction = StartEntryContribution["action"];
 /** The entry as the web sees it: a script entry shows its kind and coordinator flag, never its source. */
 export type PublicStartEntry = StartEntryBase & { owner: string } & (
   | { action: "skill"; skill: string; category: string; prompt: string }
-  | { action: "script"; coordinator: boolean }
+  | { action: "script"; coordinator: boolean; category?: string }
 );
 
 export interface SkillContribution {

package/packages/workspace-executor/src/context.ts

@@ -12,6 +12,8 @@ export interface WorkspaceProcessContext {
   home: string;
   /** Wohin ein Sprachserver Protokolle und Zwischenstände legen darf; nie das Home eines Entwicklers. */
   logDirectory: string;
+  /** Die Wurzel des Hosts auf dieser Maschine, aus der ein Adapter seinen Sprachserver auflöst; ohne Host bleibt sie offen. */
+  hostRoot: string | undefined;
   env: NodeJS.ProcessEnv;
   uid?: number;
   gid?: number;
@@ -78,6 +80,7 @@ export interface WorkspaceContextOptions {
   root: string;
   home: SandboxHomeEnvironment;
   logDirectory: string;
+  hostRoot: string | undefined;
   ident?: SessionIdent;
   additionalRoots?: readonly ResolvedWorkspaceRoot[];
   readOnlyRoots?: readonly ResolvedWorkspaceRoot[];
@@ -107,6 +110,7 @@ export const workspaceProcessContext = (options: WorkspaceContextOptions): Works
     root: options.root,
     home: options.home.home,
     logDirectory: options.logDirectory,
+    hostRoot: options.hostRoot,
     env: sandboxEnvironment(options.source ?? process.env, {
       home: options.home,
       ...(options.ident ? { ident: options.ident } : {}),

package/packages/workspace-executor/src/executor.ts

@@ -12,6 +12,8 @@ export const languageServerOpenTool = (adapterId: string): string => `${adapterI
 
 export const languageServerDiagnosticsTool = (adapterId: string): string => `${adapterId}_diagnostics`;
 
+export const languageServerCloseTool = (adapterId: string): string => `${adapterId}_close`;
+
 export const languageServerSnapshotTool = (adapterId: string): string => `${adapterId}_snapshot`;
 
 export interface WorkspaceExecuteOptions {
@@ -62,6 +64,7 @@ export class SandboxWorkspaceExecutor implements WorkspaceExecutor {
     const languageServer = this.#languageServers.find((host) =>
       tool === languageServerOpenTool(host.adapter.id)
       || tool === languageServerDiagnosticsTool(host.adapter.id)
+      || tool === languageServerCloseTool(host.adapter.id)
       || tool === languageServerSnapshotTool(host.adapter.id));
     if (languageServer) return this.#languageServerCall(languageServer, runId, tool, input);
     return this.#toolCall(runId, tool, input, options);
@@ -105,8 +108,12 @@ export class SandboxWorkspaceExecutor implements WorkspaceExecutor {
       const { root } = input as { root: string };
       return host.open(runId, root);
     }
-    const { paths, warnings } = input as { paths?: readonly string[]; warnings?: boolean };
-    return host.diagnostics(runId, paths, warnings ?? false);
+    if (tool === languageServerCloseTool(host.adapter.id)) {
+      const { root } = (input ?? {}) as { root?: string };
+      return host.close(runId, root);
+    }
+    const { paths, warnings, root } = input as { paths?: readonly string[]; warnings?: boolean; root?: string };
+    return host.diagnostics(runId, paths, warnings ?? false, root);
   }
 
   #sandbox(runId: string): Promise<SandboxTools> {

package/packages/workspace-executor/src/index.ts

@@ -9,6 +9,7 @@ export {
   SandboxWorkspaceExecutor,
   WORKSPACE_EXECUTOR_VERSION,
   WORKSPACE_STOP_OPERATION,
+  languageServerCloseTool,
   languageServerDiagnosticsTool,
   languageServerOpenTool,
   languageServerSnapshotTool,
@@ -38,6 +39,7 @@ export {
 export {
   type LanguageServerDiagnostic,
   type LanguageServerFileDiagnostics,
+  type LanguageServerInstanceSnapshot,
   type LanguageServerSeverity,
   type LanguageServerSnapshot,
   type LanguageServerState,

package/packages/workspace-executor/src/language-server/adapters/fsharp.ts

@@ -30,6 +30,7 @@ export const fsharpAdapter: LanguageServerAdapter = {
   languages,
   rootDescription: "the .sln file (or a single .fsproj)",
   resolveRoot: (workspaceRoot, root) => resolveRootFile(workspaceRoot, root, [".sln", ".fsproj"]),
+  rootDirectory: (root) => path.dirname(root),
   launch: async (context, root) => ({
     label: "FSAC",
     ...dotnetCommand(serverPath(), ["--state-directory", path.join(context.logDirectory, "fsautocomplete")]),

package/packages/workspace-executor/src/language-server/adapters/roslyn.ts

@@ -27,6 +27,7 @@ export const roslynAdapter: LanguageServerAdapter = {
   languages,
   rootDescription: "the .sln file (or a single .csproj)",
   resolveRoot: (workspaceRoot, root) => resolveRootFile(workspaceRoot, root, [".sln", ".slnx", ".csproj"]),
+  rootDirectory: (root) => path.dirname(root),
   launch: async (context, root) => ({
     label: "Roslyn",
     ...dotnetCommand(serverPath(), [

package/packages/workspace-executor/src/language-server/adapters/typescript.ts

@@ -5,10 +5,6 @@ import { pathToFileURL } from "node:url";
 import type { LanguageServerAdapter } from "../host.js";
 import { resolveRootDirectory } from "../roots.js";
 
-const require = createRequire(import.meta.url);
-const serverScript = require.resolve("typescript-language-server/lib/cli.mjs");
-const bundledTypeScriptLib = path.dirname(require.resolve("typescript"));
-
 const languages = {
   ".ts": "typescript",
   ".tsx": "typescriptreact",
@@ -18,6 +14,37 @@ const languages = {
   ".jsx": "javascriptreact",
 } as const;
 
+/** Der Sprachserver liegt in den node_modules des Hosts; ohne Host gibt es ihn auf dieser Maschine nicht. */
+const hostRequire = (hostRoot: string | undefined): NodeRequire => {
+  if (!hostRoot) {
+    throw new Error("Für TypeScript ist auf diesem Rechner kein Host bekannt, aus dem sich typescript-language-server "
+      + "auflösen ließe. Ein Arbeitsplatz bekommt ihn mit der ersten Verbindung zu einem verteilenden Server oder über "
+      + "die Einstellung ragents.hostPath");
+  }
+  return createRequire(path.join(hostRoot, "package.json"));
+};
+
+const missing = (hostRoot: string | undefined, name: string, cause: unknown): Error =>
+  new Error(`${name} liegt nicht im Host ${hostRoot}: ${cause instanceof Error ? cause.message : String(cause)}`);
+
+const serverScript = (hostRoot: string | undefined): string => {
+  const require = hostRequire(hostRoot);
+  try {
+    return require.resolve("typescript-language-server/lib/cli.mjs");
+  } catch (cause) {
+    throw missing(hostRoot, "typescript-language-server", cause);
+  }
+};
+
+const bundledTypeScriptLib = (hostRoot: string | undefined): string => {
+  const require = hostRequire(hostRoot);
+  try {
+    return path.dirname(require.resolve("typescript"));
+  } catch (cause) {
+    throw missing(hostRoot, "typescript", cause);
+  }
+};
+
 const hasWorkspaceTypeScript = (root: string): Promise<boolean> =>
   stat(path.join(root, "node_modules", "typescript", "lib", "tsserver.js")).then((info) => info.isFile(), () => false);
 
@@ -27,17 +54,18 @@ export const typescriptAdapter: LanguageServerAdapter = {
   languages,
   rootDescription: "the directory whose tsconfig.json projects should be served (e.g. src)",
   resolveRoot: resolveRootDirectory,
+  rootDirectory: (root) => root,
   launch: async (context, root) => ({
     label: "TypeScript",
     command: process.execPath,
-    args: [serverScript, "--stdio"],
+    args: [serverScript(context.hostRoot), "--stdio"],
     cwd: root,
     // Im Extension-Host ist process.execPath Electron; ohne diese Variable startet es die Anwendung statt des Skripts.
     env: { ...context.env, ELECTRON_RUN_AS_NODE: "1" },
     uid: context.uid,
     gid: context.gid,
     rootUri: pathToFileURL(root).href,
-    initializationOptions: await hasWorkspaceTypeScript(root) ? {} : { tsserver: { path: bundledTypeScriptLib } },
+    initializationOptions: await hasWorkspaceTypeScript(root) ? {} : { tsserver: { path: bundledTypeScriptLib(context.hostRoot) } },
     languages,
     publishesOnlyChangedDiagnostics: true,
   }),

package/packages/workspace-executor/src/language-server/contract.ts

@@ -1,4 +1,4 @@
-export type LanguageServerState = "closed" | "opening" | "ready" | "failed" | "suspended";
+export type LanguageServerState = "opening" | "ready" | "failed" | "suspended";
 
 export type LanguageServerSeverity = "error" | "warning" | "information" | "hint";
 
@@ -15,9 +15,13 @@ export interface LanguageServerFileDiagnostics {
   diagnostics: readonly LanguageServerDiagnostic[];
 }
 
-export interface LanguageServerSnapshot {
+export interface LanguageServerInstanceSnapshot {
   state: LanguageServerState;
-  root: string | null;
+  root: string;
   summary: string | null;
   files: readonly LanguageServerFileDiagnostics[];
 }
+
+export interface LanguageServerSnapshot {
+  instances: readonly LanguageServerInstanceSnapshot[];
+}