@schlenkr/ragents 0.1.8 → 0.1.9

package/plugins/ragents.workspace/server/binding.ts

@@ -2,6 +2,7 @@ import { statSync } from "node:fs";
 import path from "node:path";
 import { Type } from "typebox";
 import { DomainError, type JsonValue, type RunState, type StartOptionContribution } from "@ragents/engine";
+import type { ShellTools } from "@ragents/workspace-executor";
 import { shellPlatformChapter } from "./shell-platform.js";
 import { storedStartOption } from "@ragents/host/ragents/start-option-state.js";
 import type { WorkspaceResolver } from "@ragents/host/ragents/workspace-runtime.js";
@@ -87,13 +88,18 @@ export const serverDirectoryFolder = (directory: string): ExistingWorkspaceFolde
   return { path: resolved };
 };
 
-/** Die Bash eines Runs läuft auf dem Executor seiner Bindung; der Prompt nennt deshalb dessen Plattform, nicht die des Servers. */
-export const executorShellChapter = (registry: WorkspaceClientRegistry, owner: string | null, binding: WorkspaceBinding): string => {
+/** Die Bash eines Runs läuft auf dem Executor seiner Bindung; der Prompt nennt deshalb dessen Plattform und Werkzeuge, nicht die des Servers. */
+export const executorShellChapter = (
+  registry: WorkspaceClientRegistry,
+  owner: string | null,
+  binding: WorkspaceBinding,
+  serverTools: ShellTools,
+): string => {
   const { machine } = binding;
-  if (machine === "server") return shellPlatformChapter(process.platform);
+  if (machine === "server") return shellPlatformChapter(process.platform, serverTools);
   const client = registry.info(owner, machine.client);
   return client
-    ? shellPlatformChapter(client.platform as NodeJS.Platform)
+    ? shellPlatformChapter(client.platform as NodeJS.Platform, { ripgrep: client.ripgrep })
     : `## Shell platform\n\nThe workstation ${machine.label} that holds this project is not registered right now, `
       + "so the platform of its shell is unknown; the workspace tools fail until it connects again.";
 };

package/plugins/ragents.workspace/server/clients.ts

@@ -1,8 +1,10 @@
+import { Value } from "typebox/value";
 import {
   DomainError,
   RPC_ERROR_CODES,
   RpcError,
   implement,
+  schemaComplaints,
   type AccessContext,
   type MethodConnection,
   type MethodContribution,
@@ -10,11 +12,13 @@ import {
 import {
   WORKSPACE_EXECUTOR_VERSION,
   sandboxRunEnvironment,
+  type ExecutorContributionStand,
   type WorkspaceExecuteOptions,
   type WorkspaceExecutor,
 } from "@ragents/workspace-executor";
 import {
   WORKSPACE_CLIENT_STOP_OPERATION,
+  clientRegistrationSchema,
   workspaceClientContracts,
   workspaceContracts,
   type WorkspaceClientDescription,
@@ -75,6 +79,35 @@ const messageOf = (cause: unknown): string => cause instanceof Error ? cause.mes
 /** Ein Arbeitsplatz ist erst durch Besitzer und Kennung bestimmt; zwei Benutzer mit derselben Kennung teilen nichts. */
 const keyOf = (owner: string | null, id: string): string => JSON.stringify([owner, id]);
 
+/** Server und Arbeitsplatz brauchen denselben Executor; die Meldung sagt, wer von beiden zu alt ist. */
+const assertExecutor = (label: string, executor: string): void => {
+  if (executor === WORKSPACE_EXECUTOR_VERSION) return;
+  const action = Number(executor) > Number(WORKSPACE_EXECUTOR_VERSION)
+    ? "Den Server auf die Fassung des Arbeitsplatzes aktualisieren."
+    : "Die RAgents-Erweiterung in VS Code beziehungsweise das Paket @schlenkr/ragents auf dem Arbeitsplatz aktualisieren.";
+  throw new DomainError(
+    "workspace-executor-version",
+    `Der Arbeitsplatz ${label} bringt den Executor ${executor} mit, der Server verlangt ${WORKSPACE_EXECUTOR_VERSION}. ${action}`,
+    409,
+  );
+};
+
+const described = (contributions: readonly ExecutorContributionStand[]): string =>
+  contributions.map(({ plugin, stand }) => `${plugin} (${stand.slice(0, 12)})`).join(", ") || "keine";
+
+/** Ein Arbeitsplatz führt aus, was die Plugins des Servers beitragen; mit anderen Beiträgen liefen dieselben Werkzeuge dort anders als auf dem Server. */
+const assertContributions = (label: string, expected: readonly ExecutorContributionStand[], given: readonly ExecutorContributionStand[]): void => {
+  const key = (entry: ExecutorContributionStand): string => `${entry.plugin}\0${entry.stand}`;
+  const same = expected.length === given.length && expected.every((entry) => given.some((other) => key(other) === key(entry)));
+  if (same) return;
+  throw new DomainError(
+    "workspace-executor-contributions",
+    `Der Arbeitsplatz ${label} bringt die Executor-Beiträge ${described(given)} mit, der Server verlangt ${described(expected)}. `
+      + "Der Arbeitsplatz fragt sie mit ragents.workspace.clients.contributions ab und meldet sich danach erneut an.",
+    409,
+  );
+};
+
 /** Über das Netz nimmt der Server Arbeitsplätze nur von angemeldeten Benutzern an; ohne Benutzer gäbe es nur einen Besitzer für alle Zugänge. */
 export const assertMayRegister = (access: AccessContext, local: boolean): void => {
   if (local || (access.enabled && access.user !== null)) return;
@@ -88,27 +121,29 @@ export const assertMayRegister = (access: AccessContext, local: boolean): void =
 
 /** Kennt die angemeldeten Arbeitsplätze je Besitzer, hält je Client die Verbindung, über die der Server ihn zurückruft, und die Stopps, die ihn nicht erreicht haben. */
 export class WorkspaceClientRegistry {
+  /** Was die Plugins des Servers zum Executor beitragen; jeder Arbeitsplatz muss genau diese Beiträge tragen. */
+  readonly contributions: readonly ExecutorContributionStand[];
   readonly #clients = new Map<string, ClientEntry>();
   /** Stopps, die den Arbeitsplatz noch nicht erreicht haben, je Arbeitsplatz und Run mit dem Ordner der Bindung. */
   readonly #pendingStops = new Map<string, Map<string, string>>();
   readonly #stopRetries = new Map<string, NodeJS.Timeout>();
 
+  constructor(contributions: readonly ExecutorContributionStand[]) {
+    this.contributions = contributions.map(({ plugin, stand }) => ({ plugin, stand }));
+  }
+
   async register(
     id: string,
     description: WorkspaceClientDescription,
     executor: string,
+    contributions: readonly ExecutorContributionStand[],
     connection: MethodConnection,
   ): Promise<WorkspaceClientInfo> {
     if (connection.streamless) {
       throw new DomainError("stream-required", "Die Anmeldung eines Arbeitsplatzes braucht einen Ereignisstrom.", 409);
     }
-    if (executor !== WORKSPACE_EXECUTOR_VERSION) {
-      throw new DomainError(
-        "workspace-executor-version",
-        `Der Arbeitsplatz ${description.label} bringt den Executor ${executor} mit, der Server verlangt ${WORKSPACE_EXECUTOR_VERSION}.`,
-        409,
-      );
-    }
+    assertExecutor(description.label, executor);
+    assertContributions(description.label, this.contributions, contributions);
     const owner = connection.userId;
     const key = keyOf(owner, id);
     const previous = this.#clients.get(key);
@@ -318,9 +353,21 @@ export class WorkspaceClientRegistry {
 
 export const clientMethods = (registry: WorkspaceClientRegistry): MethodContribution[] => [
   implement(workspaceContracts.clients.list, (_input, { access }) => registry.list(ownerOf(access))),
-  implement(workspaceContracts.clients.register, ({ id, executor, ...description }, { access, connection, local }) => {
+  implement(workspaceContracts.clients.contributions, ({ label, executor }, { access, local }) => {
     assertMayRegister(access, local);
-    return registry.register(id, description, executor, connection);
+    assertExecutor(label, executor);
+    return registry.contributions.map((entry) => ({ ...entry }));
+  }),
+  implement(workspaceContracts.clients.register, (input, { access, connection, local }) => {
+    assertMayRegister(access, local);
+    // Erst der Stand: ein Arbeitsplatz mit einem anderen kennt die Form dieses Stands nicht, mit diesem gilt sie ganz.
+    assertExecutor(input.label, input.executor);
+    if (!Value.Check(clientRegistrationSchema, input)) {
+      throw new RpcError(RPC_ERROR_CODES.invalidParams,
+        `Ungültige Eingabe für ${workspaceContracts.clients.register.id}: ${schemaComplaints(clientRegistrationSchema, input, "params")}`);
+    }
+    const { id, executor, contributions, ...description } = input;
+    return registry.register(id, description, executor, contributions, connection);
   }),
   implement(workspaceContracts.clients.unregister, ({ id }, { access, connection }) => {
     registry.unregister(ownerOf(access), id, connection);

package/plugins/ragents.workspace/server/config.ts

@@ -5,6 +5,8 @@ export const workspaceConfigDescriptors = [
   { key: "PROCESS_SANDBOX", source: "environment" },
   { key: "PROCESS_SANDBOX_NETWORK", source: "environment" },
   { key: "RAGENTS_BASH", source: "environment" },
+  { key: "RAGENTS_RG", source: "environment" },
+  { key: "RAGENTS_BASH_TIMEOUT_SECONDS", source: "environment" },
 ] as const;
 
 const env = declaredEnvironment(workspaceConfigDescriptors);
@@ -28,3 +30,10 @@ export const processSandboxSetting = (): ProcessSandboxSetting => {
 
 /** Die Bash, mit der der Executor dieses Servers das Werkzeug bash startet; unter Windows setzt sie die VS-Code-Erweiterung für ihren lokalen Host. */
 export const bashSetting = (): string | undefined => env.optional("RAGENTS_BASH") || undefined;
+
+/** Das rg, das der Executor dieses Servers vorn in den PATH der Bash setzt; die VS-Code-Erweiterung setzt es für ihren lokalen Host. */
+export const rgSetting = (): string | undefined => env.optional("RAGENTS_RG") || undefined;
+
+/** Die Zeitgrenze von bash in Sekunden für Aufrufe ohne eigene; mehr als die größte, die ein Aufruf nennen darf, lehnt das Werkzeug beim Start ab. */
+export const bashTimeoutSetting = (): number | undefined =>
+  env.optional("RAGENTS_BASH_TIMEOUT_SECONDS") ? env.positiveNumber("RAGENTS_BASH_TIMEOUT_SECONDS", "") : undefined;

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

@@ -4,6 +4,7 @@ import { documentStoreToken } from "@ragents/host/ragents/document-store.js";
 import { workspaceResolverToken, workspaceRuntimeToken, type WorkspaceResolver } from "@ragents/host/ragents/workspace-runtime.js";
 import { sandboxServicesToken } from "@ragents/host/plugin-support/workspace-sandbox-host.js";
 import {
+  executorContributionsToken,
   hostAddressToken,
   runtimeProviderToken,
   runGuardToken,
@@ -12,6 +13,7 @@ import {
 } from "@ragents/host/ragents/host-services.js";
 import { pluginAsset } from "@ragents/host/plugin-support/plugin-folder.js";
 import { ServerProcessSandbox } from "@ragents/host/plugin-support/process-sandbox.js";
+import { ripgrepAvailable } from "@ragents/workspace-executor";
 import type { PluginModule } from "@ragents/host/plugin-support/plugin-module.js";
 import { boundToTools, handlebarsPrompt } from "@ragents/host/plugin-support/prompt.js";
 import { shellPlatformPrompt } from "./shell-platform.js";
@@ -21,7 +23,7 @@ import { WORKSPACE_BINDING_OPTION_ID, WORKSPACE_METADATA_ID } from "../contract.
 import { bindingOf, executorShellChapter, sessionMetadataOf, workspaceBindingOption, workspaceLocation, workspaceOwnerOf } from "./binding.js";
 import { createBrowseChannel, createBrowseMethods } from "./browse-route.js";
 import { clientMethods, WorkspaceClientRegistry } from "./clients.js";
-import { bashSetting, processSandboxSetting, workspaceConfigDescriptors } from "./config.js";
+import { bashSetting, bashTimeoutSetting, processSandboxSetting, rgSetting, workspaceConfigDescriptors } from "./config.js";
 import { RunWorkspaceRuntime } from "./runtime.js";
 
 const warnWithoutSandbox = (): void => {
@@ -48,7 +50,8 @@ const ragentsWorkspacePlugin = (skillPaths: () => Promise<readonly string[]>): R
       if (!directory) throw new Error("In diesem Profil gibt es keine Dateiablage; das Plugin ragents.documents fehlt");
       return directory;
     };
-    const clients = new WorkspaceClientRegistry();
+    const contributions = host.service(executorContributionsToken);
+    const clients = new WorkspaceClientRegistry(contributions);
     const contribution = (): WorkspaceResolver | undefined => host.optionalService(workspaceResolverToken);
     host.config(...workspaceConfigDescriptors);
     const sandboxSetting = processSandboxSetting();
@@ -60,10 +63,16 @@ const ragentsWorkspacePlugin = (skillPaths: () => Promise<readonly string[]>): R
       })
       : undefined;
     const bash = bashSetting();
+    const rg = rgSetting();
+    const bashTimeoutSeconds = bashTimeoutSetting();
+    const serverTools = { ripgrep: ripgrepAvailable(rg, process.env) };
     const runtime = new RunWorkspaceRuntime({
       clients,
+      contributions: contributions.map((contribution) => contribution.parts),
       ...(processSandbox ? { processSandbox } : {}),
       ...(bash === undefined ? {} : { bash }),
+      ...(rg === undefined ? {} : { rg }),
+      ...(bashTimeoutSeconds === undefined ? {} : { bashTimeoutSeconds }),
       globalDirectory: host.storage.root(),
       sessionDirectory: (runId, ...segments) => host.storage.session(runId, ...segments),
       storageRootFor: (runId) => path.join(host.storage.sessionsRoot, runId),
@@ -92,9 +101,9 @@ const ragentsWorkspacePlugin = (skillPaths: () => Promise<readonly string[]>): R
         // Die Regeln gelten für die Arbeitsbereiche des Hosts; eine beigesteuerte Art beschreibt ihre eigenen.
         render: (context) => contribution()?.kind ? "" : rules.render(context),
       }, ...agentWorkspaceToolNames),
-      shellPlatformPrompt("ragents.workspace.shell.prompt", 102, (runId) => {
+      shellPlatformPrompt("ragents.workspace.shell.prompt", 102, serverTools, (runId) => {
         const state = runState(runId);
-        return executorShellChapter(clients, workspaceOwnerOf(state), bindingOf(state));
+        return executorShellChapter(clients, workspaceOwnerOf(state), bindingOf(state), serverTools);
       }),
     );
     const browseOptions = {

package/plugins/ragents.workspace/server/runtime.ts

@@ -8,6 +8,7 @@ import {
   type SandboxHomeEnvironment,
   type WorkspaceExecuteOptions,
   type WorkspaceExecutor,
+  type WorkspaceExecutorParts,
 } from "@ragents/workspace-executor";
 import type {
   SessionWorkspace,
@@ -46,10 +47,16 @@ export interface RunWorkspaceRuntimeOptions {
   runState: (runId: string) => RunState | null;
   storeBinding: (runId: string, binding: WorkspaceBinding) => void;
   clients: WorkspaceClientRegistry;
+  /** Was die Plugins des Profils zum Executor des Servers beitragen; die Arbeitsplätze laden dieselben Beiträge selbst. */
+  contributions: readonly WorkspaceExecutorParts[];
   /** Die Prozess-Sandbox des Servers; ohne sie laufen die Prozesse des Servers ohne. */
   processSandbox?: RunProcessSandboxes;
   /** Die Bash des Servers aus RAGENTS_BASH; unter Windows Pflicht für das Werkzeug bash. */
   bash?: string;
+  /** Das rg des Servers aus RAGENTS_RG; ohne Angabe gilt eines im PATH. */
+  rg?: string;
+  /** Die Zeitgrenze von bash aus RAGENTS_BASH_TIMEOUT_SECONDS; ohne Angabe die des Werkzeugs. */
+  bashTimeoutSeconds?: number;
 }
 
 const runNotStarted = (): DomainError => new DomainError(
@@ -141,6 +148,7 @@ export class RunWorkspaceRuntime implements WorkspaceRuntime {
     this.#nugetCacheDirectory = path.join(options.globalDirectory, "nuget-cache");
     this.sandbox = new WorkspaceSandboxHost({
       contributorName: "ragents.workspace.sandbox",
+      contributions: options.contributions,
       workspaceFor: options.sessionWorkspaceFor,
       identFor: () => Promise.resolve(undefined),
       skillPaths: options.skillPaths,
@@ -150,6 +158,8 @@ export class RunWorkspaceRuntime implements WorkspaceRuntime {
       serverDirectoryFor: (runId) => this.#serverDirectoryFor(runId),
       ...(options.processSandbox ? { processSandbox: options.processSandbox } : {}),
       ...(options.bash === undefined ? {} : { bash: options.bash }),
+      ...(options.rg === undefined ? {} : { rg: options.rg }),
+      ...(options.bashTimeoutSeconds === undefined ? {} : { bashTimeoutSeconds: options.bashTimeoutSeconds }),
     });
   }
 

package/plugins/ragents.workspace/server/shell-platform.ts

@@ -1,19 +1,20 @@
 import type { PromptContribution } from "@ragents/engine";
-import { shellPlatformText } from "@ragents/workspace-executor";
+import { shellPlatformText, type ShellTools } from "@ragents/workspace-executor";
 import { boundToTools } from "@ragents/host/plugin-support/prompt.js";
 
-export const shellPlatformChapter = (platform: NodeJS.Platform): string =>
-  `## Shell platform\n\n${shellPlatformText(platform)}`;
+export const shellPlatformChapter = (platform: NodeJS.Platform, tools: ShellTools): string =>
+  `## Shell platform\n\n${shellPlatformText(platform, tools)}`;
 
-/** Ohne Angabe gilt die Plattform des Servers; `chapterFor` nennt die des Executors, der den Run ausführt. */
+/** Ohne Angabe gelten Plattform und Werkzeuge des Servers; `chapterFor` nennt die des Executors, der den Run ausführt. */
 export const shellPlatformPrompt = (
   id: string,
   order: number,
+  serverTools: ShellTools,
   chapterFor?: (runId: string) => string,
 ): PromptContribution => boundToTools({
   id,
   order,
   delivery: "initial",
-  render: () => shellPlatformChapter(process.platform),
+  render: () => shellPlatformChapter(process.platform, serverTools),
   ...(chapterFor ? { renderForRun: chapterFor } : {}),
 }, "bash");

package/plugins/ragents.workspace/web/WorkspaceBinding.tsx

@@ -42,7 +42,7 @@ const isClientInfo = (value: unknown): value is WorkspaceClientInfo => {
     && typeof raw.id === "string" && typeof raw.label === "string"
     && typeof raw.hostname === "string" && typeof raw.platform === "string"
     && Array.isArray(raw.folders) && raw.folders.every((folder) => typeof folder === "string")
-    && typeof raw.runsDirectory === "string";
+    && typeof raw.runsDirectory === "string" && typeof raw.ripgrep === "boolean";
 };
 
 const isFreshLabels = (value: unknown): value is FreshWorkspaceLabels => {

package/ragents.config.core.ts

@@ -6,7 +6,10 @@ export const config = {
     PRODUCT_PROFILE: "core",
     COMPACTION_MODEL: "google/gemma-4-26b-a4b-it",
     // Aliasse für andere RAgents-Server, die ihre Modelle über ragents.model-relay von hier beziehen.
-    MODEL_ALIASES: ["core-standard=openrouter/z-ai/glm-5.3-flash", "core-coordinator=openrouter/deepseek/deepseek-v4-flash-0731"],
+    MODEL_ALIASES: [
+      { alias: "core-standard", model: "openrouter/z-ai/glm-5.3-flash", compaction: { threshold: 160_000, keepRecentTokens: 24_000, summaryTokens: 12_000 } },
+      { alias: "core-coordinator", model: "openrouter/deepseek/deepseek-v4-flash-0731", compaction: { threshold: 300_000, keepRecentTokens: 40_000, summaryTokens: 16_000 } },
+    ],
     PRODUCT_ID: "ragents",
     PRODUCT_TITLE: "RAgents",
     PLUGINS: [

package/ragents.config.showcase.ts

@@ -7,7 +7,10 @@ export const config = {
     PRODUCT_PROFILE: "showcase",
     COMPACTION_MODEL: "google/gemma-4-26b-a4b-it",
     // Aliasse für andere RAgents-Server, die ihre Modelle über ragents.model-relay von hier beziehen.
-    MODEL_ALIASES: ["showcase-standard=openrouter/z-ai/glm-5.3-flash", "showcase-coordinator=openrouter/deepseek/deepseek-v4-flash-0731"],
+    MODEL_ALIASES: [
+      { alias: "showcase-standard", model: "openrouter/z-ai/glm-5.3-flash", compaction: { threshold: 160_000, keepRecentTokens: 24_000, summaryTokens: 12_000 } },
+      { alias: "showcase-coordinator", model: "openrouter/deepseek/deepseek-v4-flash-0731", compaction: { threshold: 300_000, keepRecentTokens: 40_000, summaryTokens: 16_000 } },
+    ],
     PRODUCT_ID: "ragents-showcase",
     PRODUCT_TITLE: "RAgents Showcase",
     PLUGINS: [

package/scripts/agent/journal.ts

@@ -114,7 +114,9 @@ export const journalLines = (events: readonly JournalEvent[], mode: JournalMode,
       const content = payload.subscriptionId ? `[event ${String((payload.sourceEventIds as string[] | undefined)?.[0] ?? "")}]` : text(payload.content);
       lines.push(`[${event.sequence}] INPUT -> ${String(payload.actorId ?? "").slice(0, 14)}: ${content.slice(0, 300)}`);
     } else if (type === "context.compacted" && mode !== "tools") {
-      lines.push(`[${event.sequence}] CONTEXT COMPACTED ${actor}: about ${String(payload.tokensBefore)} tokens summarized`);
+      const threshold = payload.threshold as { tokens?: unknown; source?: unknown } | undefined;
+      const applied = threshold ? ` (threshold ${String(threshold.tokens)} from ${String(threshold.source)})` : "";
+      lines.push(`[${event.sequence}] CONTEXT COMPACTED ${actor}: about ${String(payload.tokensBefore)} tokens summarized${applied}`);
     } else if (type === "turn.input-steered" && mode !== "tools") {
       lines.push(`[${event.sequence}] STEERING -> ${actor}: ${String(payload.inputId ?? "")} in ${String(payload.turnId ?? "")}`);
     } else if (type.startsWith("tool.call.") && mode !== "chat") {

package/scripts/package/build-package.ts

@@ -84,6 +84,8 @@ const PACKAGE_NAME_PATTERN = /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._
 const SCAN_SKIPPED = new Set(["node_modules", "dist"]);
 const SCANNED_EXTENSIONS = new Set([".ts", ".tsx", ".mts", ".mjs", ".js", ".css"]);
 const IMPORT_PATTERN = /\b(?:from|import|require(?:\.resolve)?)\s*\(?\s*["']([^"'\n]+)["']/g;
+/** Ein Beitrag zum Executor löst Pakete zur Laufzeit aus dem Host auf; auch sie muss das Paket tragen. */
+const HOST_PACKAGE_PATTERN = /\bhostPackageFile\([^,()]*,\s*["']([^"'\n]+)["']/g;
 
 const files = async (folder: string, skippedFolders: ReadonlySet<string> = SKIPPED_FOLDERS): Promise<readonly string[]> => {
   const found: string[] = [];
@@ -149,7 +151,7 @@ export const requiredPackages = (packageDirectory: string): ReadonlyMap<string,
   for (const folder of scanRoots(packageDirectory)) {
     for (const file of scannedFiles(folder)) {
       const content = readFileSync(file, "utf8");
-      for (const match of content.matchAll(IMPORT_PATTERN)) {
+      for (const match of [...content.matchAll(IMPORT_PATTERN), ...content.matchAll(HOST_PACKAGE_PATTERN)]) {
         const name = packageNameOf(match[1]!);
         if (name && !sources.has(name)) sources.set(name, path.relative(packageDirectory, file));
       }

package/scripts/provision/run-provision.ts

@@ -19,8 +19,8 @@ const repositoryRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url))
 
 const usage = (): string => `Verwendung: pnpm provision [<profil>|<pfad zu ragents.config.<profil>.ts>|--workspace]
 Provisioniert die Werkzeuge der Plugins eines Profils nach <Datenordner>/tools/<plugin-id>/ und
-berichtet je Plugin bereit, installiert oder fehlt. --workspace provisioniert stattdessen
-Sprachserver und Browser eines Arbeitsplatzes auf dieser Maschine. Ein relativer Pfad gilt ab dem
+berichtet je Plugin bereit, installiert oder fehlt. --workspace provisioniert stattdessen die
+eingebauten Plugins, die zum Executor eines Arbeitsplatzes beitragen. Ein relativer Pfad gilt ab dem
 aufrufenden Ordner; ohne Argument gilt das Profil aus der Umgebung (PRODUCT_PROFILE_FILE oder
 PRODUCT_PROFILE).`;
 

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

@@ -13,11 +13,13 @@ const usage = (): string => `Verwendung: [RAGENTS_TOKEN=<token>] pnpm workspace-
 Meldet die Ordner als Arbeitsplatz beim Server an und führt dessen Aufträge mit dem Executor
 dieses Rechners aus - dasselbe, was die VS-Code-Erweiterung tut, nur ohne VS Code. Ohne Ordner
 gilt das aktuelle Verzeichnis. Jeder Werkzeugaufruf erscheint als eine Zeile auf stdout.
-Sprachserver und Chromium holt der Start auf diesen Rechner (dasselbe wie pnpm provision
---workspace); ROSLYN_LANGUAGE_SERVER, FSHARP_LANGUAGE_SERVER und BROWSER_EXECUTABLE_PATH
-übersteuern das, TypeScript und playwright-core kommen aus dem Host-Ordner. Unter Windows nennt
+Was die Plugins des Servers zum Executor beitragen, etwa Sprachserver, lädt der Arbeitsplatz bei
+der Anmeldung aus den Bundles dieses Hosts; ihre Werkzeuge holt der Start auf diesen Rechner
+(dasselbe wie pnpm provision --workspace). Unter Windows nennt
 RAGENTS_BASH die bash.exe, die RAgents mitbringt (aus der Windows-Fassung der VS-Code-Erweiterung);
-ohne sie scheitert das Werkzeug bash. Das Skript läuft, bis es mit Strg-C beendet wird.`;
+ohne sie scheitert das Werkzeug bash. RAGENTS_RG nennt ein rg, dessen Ordner die Bash vorn im PATH
+hat, etwa das aus der Erweiterung; ohne Angabe gilt eines im PATH. Das Skript läuft, bis es mit
+Strg-C beendet wird.`;
 
 export interface WorkspaceClientArguments {
   readonly serverUrl: string;
@@ -79,6 +81,7 @@ const main = async (): Promise<void> => {
   const client = new WorkspaceClient(transport, identity, {
     hostRoot,
     bash: process.env.RAGENTS_BASH || undefined,
+    rg: process.env.RAGENTS_RG || undefined,
     onExecuted: ({ runId, operation, durationMs, error }) =>
       console.log(`== ${runId.slice(0, 8)} ${operation} ${durationMs} ms ${error ?? "ok"}`),
   });

package/bundles/ragents.ask/web/chunks/chunk-HGFDGTNC.js

@@ -1,2 +0,0 @@
-var r="ragents.ask",i=t=>Array.isArray(t)&&t.every(n=>typeof n=="string")?[...t]:void 0,o=t=>{if(typeof t!="object"||t===null)return;let n=t,e=i(n.options);if(!(typeof n.question!="string"||!e))return{question:n.question,options:e,multi:n.multi===!0,...typeof n.recipient=="string"?{recipient:n.recipient}:{}}};export{r as a,o as b};
-//# sourceMappingURL=/plugins/ragents.ask/web/chunks/chunk-HGFDGTNC.js.map

package/bundles/ragents.ask/web/chunks/chunk-HGFDGTNC.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../plugins/ragents.ask/ask-payload.ts"],
-  "sourcesContent": ["export const ASK_PLUGIN_ID = \"ragents.ask\";\n\nexport interface AskPayload {\n  question: string;\n  options: string[];\n  multi: boolean;\n  /** Der Actor, f\u00FCr den die Frage steht, wenn der Eigent\u00FCmer des Runs sie au\u00DFerhalb eines Turns stellt. */\n  recipient?: string;\n}\n\nconst stringArrayOf = (value: unknown): string[] | undefined =>\n  Array.isArray(value) && value.every((entry) => typeof entry === \"string\") ? [...value] : undefined;\n\nexport const askPayloadOf = (payload: unknown): AskPayload | undefined => {\n  if (typeof payload !== \"object\" || payload === null) return undefined;\n  const candidate = payload as Partial<AskPayload>;\n  const options = stringArrayOf(candidate.options);\n  if (typeof candidate.question !== \"string\" || !options) return undefined;\n  return {\n    question: candidate.question,\n    options,\n    multi: candidate.multi === true,\n    ...(typeof candidate.recipient === \"string\" ? { recipient: candidate.recipient } : {}),\n  };\n};\n"],
-  "mappings": "AAAO,IAAMA,EAAgB,cAUvBC,EAAiBC,GACrB,MAAM,QAAQA,CAAK,GAAKA,EAAM,MAAOC,GAAU,OAAOA,GAAU,QAAQ,EAAI,CAAC,GAAGD,CAAK,EAAI,OAE9EE,EAAgBC,GAA6C,CACxE,GAAI,OAAOA,GAAY,UAAYA,IAAY,KAAM,OACrD,IAAMC,EAAYD,EACZE,EAAUN,EAAcK,EAAU,OAAO,EAC/C,GAAI,SAAOA,EAAU,UAAa,UAAY,CAACC,GAC/C,MAAO,CACL,SAAUD,EAAU,SACpB,QAAAC,EACA,MAAOD,EAAU,QAAU,GAC3B,GAAI,OAAOA,EAAU,WAAc,SAAW,CAAE,UAAWA,EAAU,SAAU,EAAI,CAAC,CACtF,CACF",
-  "names": ["ASK_PLUGIN_ID", "stringArrayOf", "value", "entry", "askPayloadOf", "payload", "candidate", "options"]
-}

package/bundles/ragents.browser/server/chunks/chunk-2GKLLCBE.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../plugins/ragents.browser/server/contract.ts"],
-  "sourcesContent": ["import { serviceToken } from \"@ragents/engine\";\nimport type { BrowserSnapshot } from \"@ragents/workspace-executor\";\n\nexport type { BrowserSnapshot, BrowserTarget } from \"@ragents/workspace-executor\";\n\nexport interface BrowserEvidence {\n  checkedAt?: string;\n  url?: string;\n  screenshots: { name: string; url: string }[];\n  currentScreenshots: { name: string; url: string }[];\n  errors: string[];\n}\n\n/** Wer eine Operation an der Seite ausl\u00F6st: bei einem Werkzeugaufruf dessen Kennung, dazu der Abbruch. */\nexport interface BrowserCallOptions {\n  signal?: AbortSignal;\n  toolCallId?: string;\n}\n\nexport interface BrowserRuntime {\n  open: (runId: string, url: string, options?: BrowserCallOptions) => Promise<BrowserSnapshot>;\n  evidence: (runId: string) => BrowserEvidence;\n}\n\nexport const browserRuntimeToken = serviceToken<BrowserRuntime>(\"ragents.browser.runtime\");\n"],
-  "mappings": ";;;;AAAA,SAAS,oBAAoB;AAwBtB,IAAM,sBAAsB,aAA6B,yBAAyB;",
-  "names": []
-}

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

@@ -1,60 +0,0 @@
-import { existsSync } from "node:fs";
-import path from "node:path";
-import { pathToFileURL } from "node:url";
-import { hostToolFile } from "../../tools.js";
-import type { LanguageServerAdapter } from "../host.js";
-import { dotnetCommand, resolveRootFile } from "../roots.js";
-import { solutionProjects } from "../solution.js";
-
-export const FSHARP_SERVER_VARIABLE = "FSHARP_LANGUAGE_SERVER";
-export const FSHARP_PLUGIN_ID = "ragents.lsp-fsharp";
-export const FSHARP_SERVER_FILE = "fsautocomplete/fsautocomplete.dll";
-
-const languages = { ".fs": "fsharp", ".fsi": "fsharp", ".fsx": "fsharp" } as const;
-
-const serverPath = (): string => {
-  const configured = process.env[FSHARP_SERVER_VARIABLE];
-  if (configured) return configured;
-  const provisioned = hostToolFile(FSHARP_PLUGIN_ID, FSHARP_SERVER_FILE);
-  if (existsSync(provisioned)) return provisioned;
-  throw new Error("fsautocomplete gibt es auf diesem Rechner nicht: weder "
-    + `${FSHARP_SERVER_VARIABLE} gesetzt noch ${provisioned} vorhanden. Ein Arbeitsplatz holt es mit `
-    + `pnpm provision --workspace, ein Server über pnpm provision <profil>; ${FSHARP_SERVER_VARIABLE} übersteuert beides`);
-};
-
-const contentOf = (params: unknown): string => (params as { content?: string } | undefined)?.content ?? "";
-
-export const fsharpAdapter: LanguageServerAdapter = {
-  id: "fsharp",
-  label: "FSAC",
-  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")]),
-    cwd: path.dirname(root),
-    env: context.env,
-    uid: context.uid,
-    gid: context.gid,
-    rootUri: pathToFileURL(path.dirname(root)).href,
-    initializationOptions: { AutomaticWorkspaceInit: false },
-    languages,
-  }),
-  open: async (session, root, timeoutMs) => {
-    const projects = root.toLowerCase().endsWith(".sln")
-      ? (await solutionProjects(root)).filter((project) => project.toLowerCase().endsWith(".fsproj"))
-      : [root];
-    if (projects.length === 0) throw new Error(`${path.basename(root)} enthält keine F#-Projekte`);
-    const finished = session.waitForNotification(timeoutMs, "Projekte geladen", (method, params) =>
-      method === "fsharp/notifyWorkspace"
-      && contentOf(params).includes("\"workspaceLoad\"")
-      && contentOf(params).includes("\"finished\""));
-    await session.request("fsharp/workspaceLoad", {
-      textDocuments: projects.map((project) => ({ uri: pathToFileURL(project).href })),
-    });
-    await finished;
-    return `${projects.length} F#-Projekt${projects.length === 1 ? "" : "e"} aus ${path.basename(root)} geladen`;
-  },
-};

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

@@ -1,7 +0,0 @@
-import type { LanguageServerAdapter } from "../host.js";
-import { fsharpAdapter } from "./fsharp.js";
-import { roslynAdapter } from "./roslyn.js";
-import { typescriptAdapter } from "./typescript.js";
-
-/** Jeder Executor bietet dieselbe Menge Sprachserver an; fehlt einer auf der Maschine, scheitert erst der Aufruf. */
-export const workspaceLanguageServers: readonly LanguageServerAdapter[] = [roslynAdapter, fsharpAdapter, typescriptAdapter];

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

@@ -1,56 +0,0 @@
-import { existsSync } from "node:fs";
-import path from "node:path";
-import { pathToFileURL } from "node:url";
-import { hostToolFile } from "../../tools.js";
-import type { LanguageServerAdapter } from "../host.js";
-import { dotnetCommand, resolveRootFile } from "../roots.js";
-
-export const ROSLYN_SERVER_VARIABLE = "ROSLYN_LANGUAGE_SERVER";
-export const ROSLYN_PLUGIN_ID = "ragents.lsp-roslyn";
-export const ROSLYN_SERVER_FILE = "roslyn/Microsoft.CodeAnalysis.LanguageServer.dll";
-
-const languages = { ".cs": "csharp" } as const;
-
-const serverPath = (): string => {
-  const configured = process.env[ROSLYN_SERVER_VARIABLE];
-  if (configured) return configured;
-  const provisioned = hostToolFile(ROSLYN_PLUGIN_ID, ROSLYN_SERVER_FILE);
-  if (existsSync(provisioned)) return provisioned;
-  throw new Error("Microsoft.CodeAnalysis.LanguageServer gibt es auf diesem Rechner nicht: weder "
-    + `${ROSLYN_SERVER_VARIABLE} gesetzt noch ${provisioned} vorhanden. Ein Arbeitsplatz holt ihn mit `
-    + `pnpm provision --workspace, ein Server über pnpm provision <profil>; ${ROSLYN_SERVER_VARIABLE} übersteuert beides`);
-};
-
-export const roslynAdapter: LanguageServerAdapter = {
-  id: "roslyn",
-  label: "Roslyn",
-  languages,
-  rootDescription: "the .sln file (or a single .csproj)",
-  solutionExtensions: [".sln", ".slnx"],
-  resolveRoot: (workspaceRoot, root) => resolveRootFile(workspaceRoot, root, [".sln", ".slnx", ".csproj"]),
-  rootDirectory: (root) => path.dirname(root),
-  launch: async (context, root) => ({
-    label: "Roslyn",
-    ...dotnetCommand(serverPath(), [
-      "--stdio",
-      "--logLevel", "Warning",
-      "--extensionLogDirectory", path.join(context.logDirectory, "roslyn-logs"),
-    ]),
-    cwd: path.dirname(root),
-    env: context.env,
-    uid: context.uid,
-    gid: context.gid,
-    rootUri: pathToFileURL(path.dirname(root)).href,
-    languages,
-    newFileSettleMs: 2_000,
-  }),
-  open: async (session, root, timeoutMs) => {
-    const uri = pathToFileURL(root).href;
-    const loaded = session.waitForNotification(timeoutMs, "Projekte geladen",
-      (method) => method === "workspace/projectInitializationComplete");
-    if (root.toLowerCase().endsWith(".csproj")) session.notify("project/open", { projects: [uri] });
-    else session.notify("solution/open", { solution: uri });
-    await loaded;
-    return `${path.basename(root)} geladen`;
-  },
-};