@schlenkr/ragents 0.1.11 → 0.1.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schlenkr/ragents",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "RAgents host: server, engine, plugins and tools without a source checkout",
   "keywords": [
     "agents",
@@ -70,6 +70,6 @@
     "yaml": "2.9.0"
   },
   "ragents": {
-    "hostVersion": "ce2b8edbb72a1499a5e4ad3b5e5dd6045043d928"
+    "hostVersion": "2fe07b19a1aa4533d20428b040e88960fedc44cb"
   }
 }

package/packages/ai/src/providers/openrouter.models.ts

@@ -1,5 +1,5 @@
-// Statischer Modellkatalog für openrouter. Einzige Quelle: es gibt keinen
-// Laufzeit-Store und keine Auffrischung über das Netz.
+// Static model catalog for openrouter. Single source: there is no
+// runtime store and no refresh over the network.
 
 import type { Model } from "../types.ts";
 

package/packages/ragents/src/runtime/journal-storage.ts

@@ -8,7 +8,7 @@ import { isRunId } from "../domain/portable-id.ts";
 import { syncDirectory } from "./durable-fs.ts";
 import type { CommandRecord, JournalCommand } from "./journal.ts";
 
-/** Rises whenever an older stand would reject newly written lines; formats 7 and 8 stay readable because they only lack the input origin and the compaction threshold. */
+/** Rises whenever an older version would reject newly written lines; formats 7 and 8 stay readable because they only lack the input origin and the compaction threshold. */
 export const journalStorageVersion = 9;
 const oldestReadableJournalStorageVersion = 7;
 const readableJournalStorageVersions: readonly unknown[] = [oldestReadableJournalStorageVersion, 8, journalStorageVersion];

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

@@ -41,18 +41,18 @@ export interface WorkspaceExecutorParts {
 export type WorkspaceExecutorContribution = (machine: WorkspaceExecutorMachine) => WorkspaceExecutorParts;
 
 /** Whose contribution in which version; server and workspace require the same ones. */
-export interface ExecutorContributionStand {
+export interface ExecutorContributionRevision {
   readonly plugin: string;
   /** SHA-256 of the file of the contribution. */
-  readonly stand: string;
+  readonly revision: string;
 }
 
-export interface LoadedExecutorContribution extends ExecutorContributionStand {
+export interface LoadedExecutorContribution extends ExecutorContributionRevision {
   readonly contribution: WorkspaceExecutorContribution;
 }
 
 /** A contribution built for this machine. */
-export interface PreparedExecutorContribution extends ExecutorContributionStand {
+export interface PreparedExecutorContribution extends ExecutorContributionRevision {
   readonly parts: WorkspaceExecutorParts;
 }
 
@@ -91,11 +91,11 @@ export const loadExecutorContribution = async (plugin: string, file: string, exp
   const content = await readFile(file).catch((cause: unknown) => {
     throw new Error(`The executor contribution of ${plugin} is missing at ${file}: ${messageOf(cause)}`);
   });
-  const stand = createHash("sha256").update(content).digest("hex");
-  if (expected !== undefined && stand !== expected) {
-    throw new Error(`The executor contribution of ${plugin} at ${file} has the version ${stand.slice(0, 12)}, required is ${expected.slice(0, 12)}`);
+  const revision = createHash("sha256").update(content).digest("hex");
+  if (expected !== undefined && revision !== expected) {
+    throw new Error(`The executor contribution of ${plugin} at ${file} has the version ${revision.slice(0, 12)}, required is ${expected.slice(0, 12)}`);
   }
-  const exported = await import(`${pathToFileURL(file).href}?stand=${stand}`).catch((cause: unknown) => {
+  const exported = await import(`${pathToFileURL(file).href}?revision=${revision}`).catch((cause: unknown) => {
     throw new Error(`The executor contribution of ${plugin} (${file}) does not load: ${messageOf(cause)}`, { cause });
   }) as Readonly<Record<string, unknown>>;
   const contribution = exported.executor;
@@ -103,7 +103,7 @@ export const loadExecutorContribution = async (plugin: string, file: string, exp
     throw new Error(`The bundle ${plugin} exports no valid executor contribution in ${file}; expected is `
       + "\"export const executor: WorkspaceExecutorContribution\" as a function of the machine");
   }
-  return { plugin, stand, contribution: contribution as WorkspaceExecutorContribution };
+  return { plugin, revision, contribution: contribution as WorkspaceExecutorContribution };
 };
 
 const isRecord = (value: unknown): value is Readonly<Record<string, unknown>> =>
@@ -146,5 +146,5 @@ export const prepareExecutorContribution = (loaded: LoadedExecutorContribution,
     const problems = adapterProblems(server);
     if (problems.length > 0) throw invalid(`the language server ${index + 1} needs ${problems.join(", ")}`);
   }
-  return { plugin: loaded.plugin, stand: loaded.stand, parts: parts as WorkspaceExecutorParts };
+  return { plugin: loaded.plugin, revision: loaded.revision, parts: parts as WorkspaceExecutorParts };
 };

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

@@ -4,7 +4,7 @@ import type { WorkspaceExecutorModule, WorkspaceModuleFactory, WorkspaceOperatio
 import { NO_ROOTS, type OperationFootprint } from "./paths.js";
 
 /** The version of the executor; server and workspace must carry the same one. */
-export const WORKSPACE_EXECUTOR_VERSION = "7";
+export const WORKSPACE_EXECUTOR_VERSION = "8";
 
 export interface WorkspaceExecuteOptions {
   toolCallId?: string;

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

@@ -101,7 +101,7 @@ const entryOf = async (directory: string, name: string, isDirectory: boolean): P
 
 const byKindThenName = (left: FileEntry, right: FileEntry): number =>
   (left.kind === right.kind ? 0 : left.kind === "directory" ? -1 : 1)
-  || left.name.localeCompare(right.name, "de");
+  || left.name.localeCompare(right.name, "en");
 
 const directoryIn = async (base: string, checked: string): Promise<string> => {
   const directory = await inside(base, checked);

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

@@ -23,7 +23,7 @@ export {
   executorMachine,
   loadExecutorContribution,
   prepareExecutorContribution,
-  type ExecutorContributionStand,
+  type ExecutorContributionRevision,
   type LoadedExecutorContribution,
   type PreparedExecutorContribution,
   type WorkspaceExecutorContribution,

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

@@ -351,7 +351,7 @@ export class LanguageServerHost {
       await this.#exists(path.resolve(context.root, expandWorkspaceAlias(file, context.workspaceAliases ?? {}))) ? { path: file, diagnostics: [...diagnostics] } : null));
     return entries
       .filter((entry): entry is { path: string; diagnostics: LanguageServerDiagnostic[] } => entry !== null)
-      .sort((left, right) => left.path.localeCompare(right.path, "de"));
+      .sort((left, right) => left.path.localeCompare(right.path, "en"));
   }
 
   async #changed(

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

@@ -78,7 +78,7 @@ export const workspaceSolutions = async (
   const tracked = await gitSolutions(context, extensions);
   const candidates = [...new Set(tracked ?? await directorySolutions(context.root, extensions))]
     .filter((relative) => matches(relative, extensions))
-    .sort((left, right) => left.localeCompare(right, "de"));
+    .sort((left, right) => left.localeCompare(right, "en"));
   const workspaceRoot = await realpath(context.root);
   const found = await Promise.all(candidates.map(async (relative): Promise<FoundSolution | undefined> => {
     const absolute = path.join(context.root, relative);

package/plugins/ragents.orchestration/web/ActorChat.tsx

@@ -32,7 +32,7 @@ export function ActorChat({ actor, view, presentation, display = presentation, p
   const detailMode = inspect || configuredMode === "off" ? configuredMode : "current";
   const messages = useMemo(() => actorChatMessages(view, actor, primaryMessages, conversation), [view, actor, primaryMessages, conversation]);
   const openLink = useCallback((href: string) => {
-    const match = /^ablauf:(actor|input|turn|subscription|action|artifact)\/(.+)$/.exec(href);
+    const match = /^flow:(actor|input|turn|subscription|action|artifact)\/(.+)$/.exec(href);
     if (!match) return false;
     if (!inspect) return true;
     onNavigate({ type: match[1] as FlowSelection["type"], id: match[2] });

package/plugins/ragents.orchestration/web/ActorChatControls.tsx

@@ -37,7 +37,6 @@ export function ActorChatControls({ actor, view, composerVisible = true, present
     <ChatInputToolbar
       {...attachments}
       disabled={disabledReason !== undefined}
-      layout={presentation === "surface" ? "inline" : "card"}
       maxRows={4}
       onSend={(text, files) => sendActorMessage(view.id, actor.id, text, files)}
       onStop={writable && actor.lifecycle?.kind === "running" ? () => {

package/plugins/ragents.todo/contract.ts

@@ -19,18 +19,15 @@ export const todoStatusOf = (value: unknown): TodoStatus | undefined => {
 
   switch (value.trim().toLowerCase()) {
     case "open":
-    case "offen":
     case "pending":
       return "open";
     case "active":
     case "doing":
     case "in_progress":
-    case "in arbeit":
     case "running":
       return "active";
     case "completed":
     case "done":
-    case "erledigt":
     case "finished":
       return "completed";
     default:

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

@@ -15,7 +15,7 @@ import {
   workspaceDataDirectory,
   workspaceExecutorModules,
   workspaceProcessContext,
-  type ExecutorContributionStand,
+  type ExecutorContributionRevision,
   type PreparedExecutorContribution,
   type WorkspaceProcessContext,
 } from "@ragents/workspace-executor";
@@ -119,8 +119,8 @@ const contextOf = (runs: ReadonlyMap<string, WorkspaceProcessContext>, runId: st
   return Promise.resolve(context);
 };
 
-const sameContributions = (left: readonly ExecutorContributionStand[], right: readonly ExecutorContributionStand[]): boolean =>
-  left.length === right.length && left.every((entry) => right.some((other) => other.plugin === entry.plugin && other.stand === entry.stand));
+const sameContributions = (left: readonly ExecutorContributionRevision[], right: readonly ExecutorContributionRevision[]): boolean =>
+  left.length === right.length && left.every((entry) => right.some((other) => other.plugin === entry.plugin && other.revision === entry.revision));
 
 /** The bundles of a workstation are the built-in ones of its host; it cannot run a plugin that is missing there. */
 const contributionFileOf = (hostRoot: string, plugin: string): string => join(hostRoot, "bundles", plugin, EXECUTOR_CONTRIBUTION_FILE);
@@ -128,7 +128,7 @@ const contributionFileOf = (hostRoot: string, plugin: string): string => join(ho
 /** Loads the contributions the server requires from the bundles of this machine's host; a missing bundle or a different version is an error with a cause. */
 const loadedContributions = async (
   hostRoot: string | undefined,
-  wanted: readonly ExecutorContributionStand[],
+  wanted: readonly ExecutorContributionRevision[],
 ): Promise<readonly PreparedExecutorContribution[]> => {
   if (wanted.length === 0) return [];
   if (!hostRoot) {
@@ -136,9 +136,9 @@ const loadedContributions = async (
       + "knows no host from whose bundles it could load them. It gets one with the first connection to a distributing "
       + "server or through the setting ragents.hostPath");
   }
-  return Promise.all(wanted.map(async ({ plugin, stand }) => {
+  return Promise.all(wanted.map(async ({ plugin, revision }) => {
     if (!PLUGIN_ID_PATTERN.test(plugin)) throw new Error(`The server names ${plugin} as a plugin; that is not a plugin ID`);
-    const loaded = await loadExecutorContribution(plugin, contributionFileOf(hostRoot, plugin), stand).catch((cause: unknown) => {
+    const loaded = await loadExecutorContribution(plugin, contributionFileOf(hostRoot, plugin), revision).catch((cause: unknown) => {
       throw new VersionMismatch(`${messageOf(cause)}. The host of this workstation (${hostRoot}) must carry the same bundles as the server: `
         + "the RAgents extension or the package @schlenkr/ragents in the server's version, in a checkout pnpm build:plugins");
     });
@@ -149,7 +149,7 @@ const loadedContributions = async (
 /** An executor from the contributions the server required at sign-in. */
 interface BuiltExecutor {
   readonly executor: WorkspaceOperationExecutor;
-  readonly contributions: readonly ExecutorContributionStand[];
+  readonly contributions: readonly ExecutorContributionRevision[];
 }
 
 /** What a sign-in on this machine holds: its own executor, the tasks of its runs, and its handlers on the message layer. */
@@ -261,7 +261,7 @@ export class WorkspaceClient {
   }
 
   /** Keeps the executor as long as the server requires the same contributions; otherwise it builds a new one from the bundles of this machine and ends the old one. */
-  async #built(attachment: Attachment, wanted: readonly ExecutorContributionStand[]): Promise<BuiltExecutor> {
+  async #built(attachment: Attachment, wanted: readonly ExecutorContributionRevision[]): Promise<BuiltExecutor> {
     const current = attachment.built;
     if (current && sameContributions(current.contributions, wanted)) return current;
     const contributions = await loadedContributions(this.options.hostRoot(), wanted);
@@ -273,7 +273,7 @@ export class WorkspaceClient {
           contributions: contributions.map((contribution) => contribution.parts),
         }),
       }),
-      contributions: contributions.map(({ plugin, stand }) => ({ plugin, stand })),
+      contributions: contributions.map(({ plugin, revision }) => ({ plugin, revision })),
     };
     if (attachment !== this.#attachment) {
       await built.executor.shutdown();

package/plugins/ragents.workspace/contract.ts

@@ -102,7 +102,7 @@ export const PLUGIN_ID_PATTERN = /^[a-z0-9]+(?:[.-][a-z0-9]+)*$/;
 
 const executorContributions = Type.Array(Type.Object({
   plugin: Type.String({ pattern: PLUGIN_ID_PATTERN.source, maxLength: 128, description: "ID of the plugin" }),
-  stand: Type.String({ pattern: "^[0-9a-f]{64}$", description: "SHA-256 of the contribution file" }),
+  revision: Type.String({ pattern: "^[0-9a-f]{64}$", description: "SHA-256 of the contribution file" }),
 }, { additionalProperties: false }), { maxItems: 64, description: "The plugins' contributions to the executor, in the order of the server's plugin list" });
 
 const clientDescription = {

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

@@ -12,7 +12,7 @@ import {
 import {
   WORKSPACE_EXECUTOR_VERSION,
   sandboxRunEnvironment,
-  type ExecutorContributionStand,
+  type ExecutorContributionRevision,
   type WorkspaceExecuteOptions,
   type WorkspaceExecutor,
 } from "@ragents/workspace-executor";
@@ -92,12 +92,12 @@ const assertExecutor = (label: string, executor: string): void => {
   );
 };
 
-const described = (contributions: readonly ExecutorContributionStand[]): string =>
-  contributions.map(({ plugin, stand }) => `${plugin} (${stand.slice(0, 12)})`).join(", ") || "none";
+const described = (contributions: readonly ExecutorContributionRevision[]): string =>
+  contributions.map(({ plugin, revision }) => `${plugin} (${revision.slice(0, 12)})`).join(", ") || "none";
 
 /** A workstation runs what the server's plugins contribute; with other contributions the same tools would behave differently there than on the server. */
-const assertContributions = (label: string, expected: readonly ExecutorContributionStand[], given: readonly ExecutorContributionStand[]): void => {
-  const key = (entry: ExecutorContributionStand): string => `${entry.plugin}\0${entry.stand}`;
+const assertContributions = (label: string, expected: readonly ExecutorContributionRevision[], given: readonly ExecutorContributionRevision[]): void => {
+  const key = (entry: ExecutorContributionRevision): string => `${entry.plugin}\0${entry.revision}`;
   const same = expected.length === given.length && expected.every((entry) => given.some((other) => key(other) === key(entry)));
   if (same) return;
   throw new DomainError(
@@ -122,21 +122,21 @@ export const assertMayRegister = (access: AccessContext, local: boolean): void =
 /** Knows the signed-in workstations per owner, holds per client the connection through which the server calls it back, and the stops that have not reached it. */
 export class WorkspaceClientRegistry {
   /** What the server's plugins contribute to the executor; every workstation must carry exactly these contributions. */
-  readonly contributions: readonly ExecutorContributionStand[];
+  readonly contributions: readonly ExecutorContributionRevision[];
   readonly #clients = new Map<string, ClientEntry>();
   /** Stops that have not reached the workstation yet, per workstation and run with the folder of the binding. */
   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 }));
+  constructor(contributions: readonly ExecutorContributionRevision[]) {
+    this.contributions = contributions.map(({ plugin, revision }) => ({ plugin, revision }));
   }
 
   async register(
     id: string,
     description: WorkspaceClientDescription,
     executor: string,
-    contributions: readonly ExecutorContributionStand[],
+    contributions: readonly ExecutorContributionRevision[],
     connection: MethodConnection,
   ): Promise<WorkspaceClientInfo> {
     if (connection.streamless) {

package/scripts/package/build-package.ts

@@ -7,7 +7,7 @@ import { fileURLToPath } from "node:url";
 import { readHostVersion, readPackageVersion } from "../../apps/server/src/host-version.ts";
 import { hostWebDirectory, hostWebProblem, isCheckout } from "../../apps/server/src/host-web.ts";
 import { runtimeLibraries } from "../../apps/server/src/plugin-support/actor-programs/runtime-libraries.ts";
-import { assertBundleStand, readBundleManifest, sourceStandOf } from "../../apps/server/src/profile/bundle-manifest.ts";
+import { assertBundleRevision, readBundleManifest, sourceRevisionOf } from "../../apps/server/src/profile/bundle-manifest.ts";
 import { builtInPluginFolders } from "../plugin/build-builtin-plugins.ts";
 
 export const PACKAGE_NAME = "@schlenkr/ragents";
@@ -216,7 +216,7 @@ const assertBuiltInBundles = (root: string): void => {
   for (const folder of builtInPluginFolders(path.join(root, "plugins"))) {
     const bundle = path.join(root, "bundles", path.basename(folder));
     if (!statSync(bundle, { throwIfNoEntry: false })?.isDirectory()) throw new Error(`The bundle ${bundle} is missing; run pnpm build:plugins first`);
-    if (readBundleManifest(bundle).sourceStand !== sourceStandOf(folder)) throw new Error(`The bundle ${bundle} no longer matches ${folder}; run pnpm build:plugins first`);
+    if (readBundleManifest(bundle).sourceRevision !== sourceRevisionOf(folder)) throw new Error(`The bundle ${bundle} no longer matches ${folder}; run pnpm build:plugins first`);
   }
 };
 
@@ -249,7 +249,7 @@ export const buildPackage = async (target: string, root = repositoryRoot): Promi
   }
   for (const folder of builtInPluginFolders(path.join(root, "plugins"))) {
     const bundle = path.join(target, "bundles", path.basename(folder));
-    assertBundleStand(bundle, readBundleManifest(bundle));
+    assertBundleRevision(bundle, readBundleManifest(bundle));
   }
   for (const file of await copyDeclarations(root, target)) {
     fileCount += 1;

package/scripts/package/ragents.mjs

@@ -27,7 +27,7 @@ const usage = `Usage: ragents <command> [arguments]
   stop <run> | stop --host         cancel the running turn or stop the remembered host
   connect <server-url>             fetch the client profile with its bundles and start the local server with it
   start <profile|path>             start a profile of the package, an own profile file or a
-                                   fetched stand; the UI comes prebuilt
+                                   fetched revision; the UI comes prebuilt
   provision [<profile>|--workspace] fetch the plugins' tools
   workspace-client <server-url>    register this machine as a workspace
   plugin build <folder...>         build plugin source folders into bundles (--out, --watch)

package/scripts/remote/connect.ts

@@ -10,7 +10,7 @@ import { ragentsDataRoot } from "../../apps/server/src/data-directory.ts";
 import { filesBelow } from "../../apps/server/src/folder-install.ts";
 import { removeHostRecord, writeHostRecord } from "../../apps/server/src/host-record.ts";
 import { hostRoot, readHostApiVersion, readHostPackage } from "../../apps/server/src/host-version.ts";
-import { BUNDLE_MANIFEST_FILE, bundleStand } from "../../apps/server/src/profile/bundle-manifest.ts";
+import { BUNDLE_MANIFEST_FILE, bundleRevision } from "../../apps/server/src/profile/bundle-manifest.ts";
 import { readProfileTarget } from "../../apps/server/src/profile-target.ts";
 import { RpcClient } from "../../apps/web/src/rpc/client.ts";
 import { profileDistributionContracts, type ClientProfileDescription } from "../../plugins/ragents.profile-distribution/contract.ts";
@@ -135,9 +135,9 @@ const markAsModule = async (directory: string): Promise<void> => {
 const assertArchivedBundles = (staging: string): void => {
   for (const manifestFile of filesBelow(staging).filter((file) => path.posix.basename(file) === BUNDLE_MANIFEST_FILE)) {
     const folder = path.join(staging, ...path.posix.dirname(manifestFile).split("/"));
-    const manifest = JSON.parse(readFileSync(path.join(folder, BUNDLE_MANIFEST_FILE), "utf8")) as { id?: unknown; stand?: unknown };
-    if (bundleStand(folder) !== manifest.stand) {
-      throw new Error(`The bundle ${String(manifest.id)} in the server's archive does not have the files it was built with (stand in ${manifestFile}); rebuild it on the server and repeat ragents connect`);
+    const manifest = JSON.parse(readFileSync(path.join(folder, BUNDLE_MANIFEST_FILE), "utf8")) as { id?: unknown; revision?: unknown };
+    if (bundleRevision(folder) !== manifest.revision) {
+      throw new Error(`The bundle ${String(manifest.id)} in the server's archive does not have the files it was built with (revision in ${manifestFile}); rebuild it on the server and repeat ragents connect`);
     }
   }
 };