@schlenkr/ragents 0.1.10 → 0.1.12

package/bundles/ragents.profile-distribution/ragents-bundle.json

@@ -1,5 +1,5 @@
 {
-  "format": 4,
+  "format": 5,
   "id": "ragents.profile-distribution",
   "api": 7,
   "hostNames": {
@@ -52,8 +52,8 @@
     },
     "web": {}
   },
-  "stand": "8894e98d0ae19da1b57689c3434e69a04ccbb6d4ead9e6a2003e9b7f4a20f3cf",
-  "sourceStand": "09c1232121a90042e1ffbb8e6a9509cd7bff36e19534cb3baa3efa12de631da6",
+  "revision": "3e99cf5cb8921685ad83aa6aaf9657da4c648f9d68cb744988a73f227c342e1d",
+  "sourceRevision": "f86bd0f1a439a2c9d143101af2a58881306dd8910240226548afbebfc125682c",
   "server": "server/index.js",
   "exports": {
     "server": {},

package/bundles/ragents.profile-distribution/server/index.js

@@ -12,25 +12,25 @@ import { defineOperation } from "@ragents/engine/src/rpc/contract";
 var pluginEntry = Type.Object({
   id: Type.String({ minLength: 1 }),
   source: Type.Union([Type.Literal("host"), Type.Literal("archive")], {
-    description: "host: der Client nimmt das eingebaute Bundle seines Hosts; archive: das Bundle liegt im Archiv"
+    description: "host: the client takes the built-in bundle of its host; archive: the bundle is in the archive"
   })
 }, { additionalProperties: false });
 var description = Type.Object({
-  profile: Type.String({ minLength: 1, description: "Profilname; die Datei hei\xDFt ragents.config.<profil>.ts" }),
-  version: Type.String({ minLength: 64, maxLength: 64, description: "Stand des Archivs als SHA-256" }),
-  hostApi: Type.Integer({ minimum: 1, description: "Nummer der Host-API, gegen die die Bundles im Archiv gebaut sind; der Host des Clients muss genau diese bieten" }),
-  hostVersion: Type.String({ minLength: 40, maxLength: 40, description: "Git-Commit des Hosts dieses Servers; ein Checkout mit anderer Host-API kommt damit zu einer passenden" }),
-  packageVersion: Type.String({ minLength: 1, description: "Fassung des npm-Pakets, die diesen Commit tr\xE4gt; eine Installation mit anderer Host-API kommt damit zu einer passenden" }),
-  file: Type.String({ minLength: 1, description: "Pfad der Profildatei innerhalb des Archivs" }),
-  size: Type.Integer({ minimum: 0, description: "Archivgr\xF6\xDFe in Byte" }),
-  archivePath: Type.String({ minLength: 1, description: "HTTP-Pfad des Archivs auf diesem Server" }),
+  profile: Type.String({ minLength: 1, description: "Profile name; the file is called ragents.config.<profile>.ts" }),
+  version: Type.String({ minLength: 64, maxLength: 64, description: "Version of the archive as SHA-256" }),
+  hostApi: Type.Integer({ minimum: 1, description: "Number of the host API the bundles in the archive are built against; the client's host must offer exactly this one" }),
+  hostVersion: Type.String({ minLength: 40, maxLength: 40, description: "Git commit of this server's host; a checkout with a different host API uses it to get a matching one" }),
+  packageVersion: Type.String({ minLength: 1, description: "Version of the npm package that carries this commit; an installation with a different host API uses it to get a matching one" }),
+  file: Type.String({ minLength: 1, description: "Path of the profile file inside the archive" }),
+  size: Type.Integer({ minimum: 0, description: "Archive size in bytes" }),
+  archivePath: Type.String({ minLength: 1, description: "HTTP path of the archive on this server" }),
   plugins: Type.Array(pluginEntry)
 }, { additionalProperties: false });
 var profileArchivePath = (version) => `/profile/${version}.tar.gz`;
 var profileDistributionContracts = {
   describe: defineOperation({
     id: "ragents.profile.describe",
-    description: "Das Client-Profil dieses Servers: Name, Stand, verlangte Host-API, Host- und Paketfassung, Plugins und Archiv. Recht: profile.fetch.",
+    description: "The client profile of this server: name, version, required host API, host and package version, plugins and archive. Right: profile.fetch.",
     rights: ["profile.fetch"],
     input: Type.Object({}, { additionalProperties: false }),
     result: description
@@ -54,7 +54,7 @@ var commonRoot = (first, others) => {
   for (const folder of others) {
     while (folder !== root && !folder.startsWith(root + path.sep)) {
       const parent = path.dirname(root);
-      if (parent === root) throw new Error(`Profildatei und Plugin ${folder} haben keinen gemeinsamen Ordner`);
+      if (parent === root) throw new Error(`Profile file and plugin ${folder} have no common folder`);
       root = parent;
     }
   }
@@ -64,36 +64,36 @@ var posixRelative = (root, target) => path.relative(root, target).split(path.sep
 var placeholderEnvironment = new Proxy({}, { get: () => "client-placeholder-value" });
 var checkSections = (source, raw, pluginIds) => {
   for (const [section, value] of Object.entries(raw)) {
-    if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(`${source}: die Sektion ${section} ist kein Objekt`);
-    if (section !== "host" && !pluginIds.has(section)) throw new Error(`${source}: die Sektion ${section} geh\xF6rt zu keinem Plugin aus host.PLUGINS`);
+    if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(`${source}: the section ${section} is not an object`);
+    if (section !== "host" && !pluginIds.has(section)) throw new Error(`${source}: the section ${section} belongs to no plugin from host.PLUGINS`);
     for (const [key, entry] of Object.entries(value)) {
-      if (section === "host" && !hostConfigKeys.includes(key)) throw new Error(`${source}: host.${key} ist kein Host-Schl\xFCssel`);
+      if (section === "host" && !hostConfigKeys.includes(key)) throw new Error(`${source}: host.${key} is not a host key`);
       if (isEnvironmentReference(entry) || isProvisionedReference(entry)) continue;
-      if (SECRET_KEY_PATTERN.test(key)) throw new Error(`${source}: ${section}.${key} ist ein Secret und muss als env("...") stehen`);
+      if (SECRET_KEY_PATTERN.test(key)) throw new Error(`${source}: ${section}.${key} is a secret and must be written as env("...")`);
       const valid = typeof entry === "string" || typeof entry === "number" || typeof entry === "boolean" || Array.isArray(entry) && entry.every((item) => typeof item === "string") || Array.isArray(entry) && entry.every((item) => !!item && typeof item === "object" && !Array.isArray(item));
-      if (!valid) throw new Error(`${source}: ${section}.${key} hat keinen g\xFCltigen Wert`);
-      if (typeof entry === "string" && /^\$\{[A-Za-z_][A-Za-z0-9_]*\}$/.test(entry)) throw new Error(`${source}: ${section}.${key} verweist als Text auf die Umgebung; env("...") verwenden`);
+      if (!valid) throw new Error(`${source}: ${section}.${key} has no valid value`);
+      if (typeof entry === "string" && /^\$\{[A-Za-z_][A-Za-z0-9_]*\}$/.test(entry)) throw new Error(`${source}: ${section}.${key} references the environment as text; use env("...")`);
     }
   }
 };
 var inspectClientProfile = async (source, root = bundlesRoot) => {
   const name = PROFILE_FILE.exec(path.basename(source));
-  if (!name) throw new Error(`Die Client-Profildatei muss ragents.config.<profil>.ts hei\xDFen: ${source}`);
-  if (!statSync(source, { throwIfNoEntry: false })?.isFile()) throw new Error(`Die Client-Profildatei ${source} fehlt`);
+  if (!name) throw new Error(`The client profile file must be called ragents.config.<profile>.ts: ${source}`);
+  if (!statSync(source, { throwIfNoEntry: false })?.isFile()) throw new Error(`The client profile file ${source} is missing`);
   const profile = name[1];
   const module = await import(pathToFileURL(source).href);
   const raw = module.config;
-  if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`${source} exportiert keine Konstante config`);
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`${source} exports no constant config`);
   const host = raw.host;
   const entries = host?.PLUGINS;
   if (!Array.isArray(entries) || entries.length === 0 || !entries.every((entry) => typeof entry === "string" && entry)) {
-    throw new Error(`${source}: host.PLUGINS muss eine nicht leere Liste sein`);
+    throw new Error(`${source}: host.PLUGINS must be a non-empty list`);
   }
-  if (host?.PRODUCT_PROFILE !== profile) throw new Error(`${source}: host.PRODUCT_PROFILE muss ${profile} sein`);
+  if (host?.PRODUCT_PROFILE !== profile) throw new Error(`${source}: host.PRODUCT_PROFILE must be ${profile}`);
   const directory = path.dirname(source);
   const unportable = entries.filter((entry) => isPluginPath(entry) && !/^\.{1,2}\//.test(entry));
   if (unportable.length > 0) {
-    throw new Error(`${source}: ${unportable.join(", ")} nennt ein Bundle absolut oder mit ~/; der Client l\xF6st diesen Pfad auf seinem eigenen Rechner auf und f\xE4nde dort nicht das gelieferte Bundle. Im Client-Profil jedes Bundle relativ zur Profildatei nennen (./ oder ../)`);
+    throw new Error(`${source}: ${unportable.join(", ")} names a bundle absolutely or with ~/; the client resolves this path on its own machine and would not find the delivered bundle there. In the client profile, name every bundle relative to the profile file (./ or ../)`);
   }
   const plugins = (() => {
     try {
@@ -105,7 +105,7 @@ var inspectClientProfile = async (source, root = bundlesRoot) => {
   checkSections(source, raw, /* @__PURE__ */ new Set([...discoverPluginIds(root), ...plugins.map((plugin2) => plugin2.id)]));
   const users = resolveProfileUsers(source, module.users, placeholderEnvironment);
   const anonymous = resolveAnonymousUser(source, module.anonymousUser);
-  if (users && anonymous) throw new Error(`${source}: users und anonymousUser schlie\xDFen einander aus`);
+  if (users && anonymous) throw new Error(`${source}: users and anonymousUser exclude each other`);
   const archived = plugins.filter((plugin2) => plugin2.source === "archive").map((plugin2) => plugin2.folder);
   const commonDirectory = commonRoot(directory, archived);
   return { profile, source, root: commonDirectory, file: posixRelative(commonDirectory, source), plugins };
@@ -114,7 +114,7 @@ var collectFiles = (folder, root) => {
   const files = [];
   for (const entry of readdirSync(folder, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name, "en"))) {
     const absolute = path.join(folder, entry.name);
-    if (entry.isSymbolicLink()) throw new Error(`Das Client-Profil enth\xE4lt einen symbolischen Link, den das Archiv nicht abbildet: ${absolute}`);
+    if (entry.isSymbolicLink()) throw new Error(`The client profile contains a symbolic link that the archive does not represent: ${absolute}`);
     if (entry.isDirectory()) {
       files.push(...collectFiles(absolute, root));
     } else if (entry.isFile()) {
@@ -126,7 +126,7 @@ var collectFiles = (folder, root) => {
 var clientProfileEntries = (inspected) => {
   const entries = [inspected.file, ...inspected.plugins.filter((plugin2) => plugin2.source === "archive").flatMap((plugin2) => collectFiles(plugin2.folder, inspected.root))];
   for (const entry of entries) {
-    if (!lstatSync(path.join(inspected.root, entry)).isFile()) throw new Error(`Der Archiveintrag ${entry} ist keine Datei`);
+    if (!lstatSync(path.join(inspected.root, entry)).isFile()) throw new Error(`The archive entry ${entry} is not a file`);
   }
   return entries;
 };
@@ -159,7 +159,7 @@ var profileDistributionConfig = Object.freeze({
   clientProfileFile: resolveClientProfileFile,
   hostVersion: () => {
     const value = env.optional("HOST_VERSION");
-    if (value !== void 0 && !/^[0-9a-f]{40}$/.test(value)) throw new Error(`HOST_VERSION muss ein vollst\xE4ndiger Git-Commit sein, nicht "${value}"`);
+    if (value !== void 0 && !/^[0-9a-f]{40}$/.test(value)) throw new Error(`HOST_VERSION must be a full Git commit, not "${value}"`);
     return value;
   }
 });
@@ -175,7 +175,7 @@ var archiveRoute = (state) => ({
     const current = state();
     const version = archivePattern.exec(url.pathname)?.[1];
     if (version !== current.description.version) {
-      writeJson(response, 404, { error: `Der Stand ${version} wird nicht mehr angeboten; aktuell ist ${current.description.version}` });
+      writeJson(response, 404, { error: `Version ${version} is no longer offered; the current one is ${current.description.version}` });
       return;
     }
     response.writeHead(200, {
@@ -194,13 +194,13 @@ var profileDistributionPlugin = {
     if (!file) {
       host.lifecycle({
         id: "ragents.profile-distribution",
-        initialize: () => console.log("Profilverteilung: CLIENT_PROFILE_FILE ist nicht gesetzt, dieser Server bietet kein Client-Profil an")
+        initialize: () => console.log("Profile distribution: CLIENT_PROFILE_FILE is not set, this server offers no client profile")
       });
       return;
     }
     let ready;
     const state = () => {
-      if (!ready) throw new DomainError("profile-not-ready", "Das Client-Profil ist noch nicht gepackt.", 503);
+      if (!ready) throw new DomainError("profile-not-ready", "The client profile is not packed yet.", 503);
       return ready;
     };
     host.lifecycle({
@@ -225,7 +225,7 @@ var profileDistributionPlugin = {
             plugins: inspected.plugins.map((plugin2) => ({ id: plugin2.id, source: plugin2.source }))
           }
         };
-        console.log(`Profilverteilung: ${inspected.profile} Stand ${packed.version.slice(0, 12)} (${packed.entries.length} Dateien, ${packed.archive.byteLength} Byte, Host-API ${hostApi}, Host ${hostVersion.slice(0, 12)}, Paket ${packageVersion})`);
+        console.log(`Profile distribution: ${inspected.profile} version ${packed.version.slice(0, 12)} (${packed.entries.length} files, ${packed.archive.byteLength} bytes, host API ${hostApi}, host ${hostVersion.slice(0, 12)}, package ${packageVersion})`);
       }
     });
     host.methods(implement(profileDistributionContracts.describe, () => state().description));

package/bundles/ragents.profile-distribution/server/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../plugins/ragents.profile-distribution/server/index.ts", "../../../plugins/ragents.profile-distribution/contract.ts", "../../../plugins/ragents.profile-distribution/server/archive.ts", "../../../plugins/ragents.profile-distribution/server/config.ts"],
-  "sourcesContent": ["import { DomainError, implement, type HttpRouteContribution, type RAgentsPlugin } from \"@ragents/engine\";\nimport { readHostApiVersion, readHostVersion, readPackageVersion } from \"@ragents/host/host-version.js\";\nimport type { PluginModule } from \"@ragents/host/plugin-support/plugin-module.js\";\nimport { writeJson } from \"@ragents/host/plugin-support/http.js\";\nimport { profileArchivePath, profileDistributionContracts, type ClientProfileDescription } from \"../contract.js\";\nimport { inspectClientProfile, packClientProfile } from \"./archive.js\";\nimport { profileDistributionConfig, profileDistributionConfigDescriptors } from \"./config.js\";\n\ninterface DistributionState {\n  readonly description: ClientProfileDescription;\n  readonly archive: Buffer;\n}\n\nconst archivePattern = /^\\/profile\\/([0-9a-f]{64})\\.tar\\.gz$/;\n\nconst archiveRoute = (state: () => DistributionState): HttpRouteContribution => ({\n  id: \"ragents.profile-distribution.archive\",\n  isApiPath: (pathname) => pathname.startsWith(\"/profile/\"),\n  matches: (request, url) => request.method === \"GET\" && archivePattern.test(url.pathname),\n  requiredRights: [\"profile.fetch\"],\n  handle: ({ response, url }) => {\n    const current = state();\n    const version = archivePattern.exec(url.pathname)?.[1];\n    if (version !== current.description.version) {\n      writeJson(response, 404, { error: `Der Stand ${version} wird nicht mehr angeboten; aktuell ist ${current.description.version}` });\n      return;\n    }\n    response.writeHead(200, {\n      \"Content-Type\": \"application/gzip\",\n      \"Content-Length\": current.archive.byteLength,\n      \"Cache-Control\": \"no-store\",\n    });\n    response.end(current.archive);\n  },\n});\n\nconst profileDistributionPlugin: RAgentsPlugin = {\n  manifest: { id: \"ragents.profile-distribution\" },\n  register: (host) => {\n    host.config(...profileDistributionConfigDescriptors);\n    const file = profileDistributionConfig.clientProfileFile();\n    if (!file) {\n      host.lifecycle({\n        id: \"ragents.profile-distribution\",\n        initialize: () => console.log(\"Profilverteilung: CLIENT_PROFILE_FILE ist nicht gesetzt, dieser Server bietet kein Client-Profil an\"),\n      });\n      return;\n    }\n    let ready: DistributionState | undefined;\n    const state = (): DistributionState => {\n      if (!ready) throw new DomainError(\"profile-not-ready\", \"Das Client-Profil ist noch nicht gepackt.\", 503);\n      return ready;\n    };\n    host.lifecycle({\n      id: \"ragents.profile-distribution\",\n      initialize: async () => {\n        const hostVersion = profileDistributionConfig.hostVersion() ?? readHostVersion();\n        const packageVersion = readPackageVersion();\n        const hostApi = readHostApiVersion();\n        const inspected = await inspectClientProfile(file);\n        const packed = await packClientProfile(inspected);\n        ready = {\n          archive: packed.archive,\n          description: {\n            profile: inspected.profile,\n            version: packed.version,\n            hostApi,\n            hostVersion,\n            packageVersion,\n            file: inspected.file,\n            size: packed.archive.byteLength,\n            archivePath: profileArchivePath(packed.version),\n            plugins: inspected.plugins.map((plugin) => ({ id: plugin.id, source: plugin.source })),\n          },\n        };\n        console.log(`Profilverteilung: ${inspected.profile} Stand ${packed.version.slice(0, 12)} (${packed.entries.length} Dateien, ${packed.archive.byteLength} Byte, Host-API ${hostApi}, Host ${hostVersion.slice(0, 12)}, Paket ${packageVersion})`);\n      },\n    });\n    host.methods(implement(profileDistributionContracts.describe, () => state().description));\n    host.http(archiveRoute(state));\n  },\n};\n\nexport const plugin: PluginModule = {\n  create: () => profileDistributionPlugin,\n};\n", "import { Type, type Static } from \"typebox\";\nimport { defineOperation } from \"@ragents/engine/src/rpc/contract\";\n\nconst pluginEntry = Type.Object({\n  id: Type.String({ minLength: 1 }),\n  source: Type.Union([Type.Literal(\"host\"), Type.Literal(\"archive\")], {\n    description: \"host: der Client nimmt das eingebaute Bundle seines Hosts; archive: das Bundle liegt im Archiv\",\n  }),\n}, { additionalProperties: false });\n\nconst description = Type.Object({\n  profile: Type.String({ minLength: 1, description: \"Profilname; die Datei hei\u00DFt ragents.config.<profil>.ts\" }),\n  version: Type.String({ minLength: 64, maxLength: 64, description: \"Stand des Archivs als SHA-256\" }),\n  hostApi: Type.Integer({ minimum: 1, description: \"Nummer der Host-API, gegen die die Bundles im Archiv gebaut sind; der Host des Clients muss genau diese bieten\" }),\n  hostVersion: Type.String({ minLength: 40, maxLength: 40, description: \"Git-Commit des Hosts dieses Servers; ein Checkout mit anderer Host-API kommt damit zu einer passenden\" }),\n  packageVersion: Type.String({ minLength: 1, description: \"Fassung des npm-Pakets, die diesen Commit tr\u00E4gt; eine Installation mit anderer Host-API kommt damit zu einer passenden\" }),\n  file: Type.String({ minLength: 1, description: \"Pfad der Profildatei innerhalb des Archivs\" }),\n  size: Type.Integer({ minimum: 0, description: \"Archivgr\u00F6\u00DFe in Byte\" }),\n  archivePath: Type.String({ minLength: 1, description: \"HTTP-Pfad des Archivs auf diesem Server\" }),\n  plugins: Type.Array(pluginEntry),\n}, { additionalProperties: false });\n\nexport type ClientProfileDescription = Static<typeof description>;\n\nexport const profileArchivePath = (version: string): string => `/profile/${version}.tar.gz`;\n\nexport const profileDistributionContracts = {\n  describe: defineOperation({\n    id: \"ragents.profile.describe\",\n    description: \"Das Client-Profil dieses Servers: Name, Stand, verlangte Host-API, Host- und Paketfassung, Plugins und Archiv. Recht: profile.fetch.\",\n    rights: [\"profile.fetch\"],\n    input: Type.Object({}, { additionalProperties: false }),\n    result: description,\n  }),\n};\n", "import { createHash } from \"node:crypto\";\nimport { readdirSync, statSync, lstatSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { create as createTar } from \"tar\";\nimport { hostConfigKeys } from \"@ragents/host/config.js\";\nimport { isEnvironmentReference, isProvisionedReference } from \"@ragents/host/config-definition.js\";\nimport { resolveAnonymousUser, resolveProfileUsers, SECRET_KEY_PATTERN } from \"@ragents/host/config-file.js\";\nimport { discoverPluginIds, resolvePluginEntries, type ResolvedPlugin } from \"@ragents/host/profile/plugin-discovery.js\";\nimport { bundlesRoot, isPluginPath } from \"@ragents/host/plugin-support/plugins-root.js\";\n\nexport interface ClientProfilePlugin extends ResolvedPlugin {\n  readonly source: \"host\" | \"archive\";\n}\n\nexport interface InspectedClientProfile {\n  readonly profile: string;\n  readonly source: string;\n  readonly root: string;\n  readonly file: string;\n  readonly plugins: readonly ClientProfilePlugin[];\n}\n\nexport interface PackedClientProfile {\n  readonly archive: Buffer;\n  readonly version: string;\n  readonly entries: readonly string[];\n}\n\nconst PROFILE_FILE = /^ragents\\.config\\.([a-z0-9]+(?:-[a-z0-9]+)*)\\.ts$/;\n\nconst commonRoot = (first: string, others: readonly string[]): string => {\n  let root = first;\n  for (const folder of others) {\n    while (folder !== root && !folder.startsWith(root + path.sep)) {\n      const parent = path.dirname(root);\n      if (parent === root) throw new Error(`Profildatei und Plugin ${folder} haben keinen gemeinsamen Ordner`);\n      root = parent;\n    }\n  }\n  return root;\n};\n\nconst posixRelative = (root: string, target: string): string => path.relative(root, target).split(path.sep).join(\"/\");\n\n// Jeder Name ist frei, damit ein Passwort- oder Token-Verweis auch ohne die Client-Umgebung pr\u00FCfbar ist.\nconst placeholderEnvironment: Readonly<Record<string, string | undefined>> = new Proxy({}, { get: () => \"client-placeholder-value\" });\n\nconst checkSections = (source: string, raw: Record<string, unknown>, pluginIds: ReadonlySet<string>): void => {\n  for (const [section, value] of Object.entries(raw)) {\n    if (!value || typeof value !== \"object\" || Array.isArray(value)) throw new Error(`${source}: die Sektion ${section} ist kein Objekt`);\n    if (section !== \"host\" && !pluginIds.has(section)) throw new Error(`${source}: die Sektion ${section} geh\u00F6rt zu keinem Plugin aus host.PLUGINS`);\n    for (const [key, entry] of Object.entries(value as Record<string, unknown>)) {\n      if (section === \"host\" && !hostConfigKeys.includes(key)) throw new Error(`${source}: host.${key} ist kein Host-Schl\u00FCssel`);\n      if (isEnvironmentReference(entry) || isProvisionedReference(entry)) continue;\n      if (SECRET_KEY_PATTERN.test(key)) throw new Error(`${source}: ${section}.${key} ist ein Secret und muss als env(\"...\") stehen`);\n      const valid = typeof entry === \"string\" || typeof entry === \"number\" || typeof entry === \"boolean\"\n        || (Array.isArray(entry) && entry.every((item) => typeof item === \"string\"))\n        || (Array.isArray(entry) && entry.every((item) => !!item && typeof item === \"object\" && !Array.isArray(item)));\n      if (!valid) throw new Error(`${source}: ${section}.${key} hat keinen g\u00FCltigen Wert`);\n      if (typeof entry === \"string\" && /^\\$\\{[A-Za-z_][A-Za-z0-9_]*\\}$/.test(entry)) throw new Error(`${source}: ${section}.${key} verweist als Text auf die Umgebung; env(\"...\") verwenden`);\n    }\n  }\n};\n\n/** Pr\u00FCft die Client-Profildatei ohne ihre Umgebung und bestimmt, welche Plugins ins Archiv geh\u00F6ren. */\nexport const inspectClientProfile = async (source: string, root = bundlesRoot): Promise<InspectedClientProfile> => {\n  const name = PROFILE_FILE.exec(path.basename(source));\n  if (!name) throw new Error(`Die Client-Profildatei muss ragents.config.<profil>.ts hei\u00DFen: ${source}`);\n  if (!statSync(source, { throwIfNoEntry: false })?.isFile()) throw new Error(`Die Client-Profildatei ${source} fehlt`);\n  const profile = name[1]!;\n  const module = await import(pathToFileURL(source).href) as Record<string, unknown>;\n  const raw = module.config;\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) throw new Error(`${source} exportiert keine Konstante config`);\n  const host = (raw as Record<string, unknown>).host as Record<string, unknown> | undefined;\n  const entries = host?.PLUGINS;\n  if (!Array.isArray(entries) || entries.length === 0 || !entries.every((entry) => typeof entry === \"string\" && entry)) {\n    throw new Error(`${source}: host.PLUGINS muss eine nicht leere Liste sein`);\n  }\n  if (host?.PRODUCT_PROFILE !== profile) throw new Error(`${source}: host.PRODUCT_PROFILE muss ${profile} sein`);\n  const directory = path.dirname(source);\n  const unportable = (entries as string[]).filter((entry) => isPluginPath(entry) && !/^\\.{1,2}\\//.test(entry));\n  if (unportable.length > 0) {\n    throw new Error(`${source}: ${unportable.join(\", \")} nennt ein Bundle absolut oder mit ~/; der Client l\u00F6st diesen Pfad auf seinem eigenen Rechner auf und f\u00E4nde dort nicht das gelieferte Bundle. Im Client-Profil jedes Bundle relativ zur Profildatei nennen (./ oder ../)`);\n  }\n  const plugins = ((): readonly ClientProfilePlugin[] => {\n    try {\n      return resolvePluginEntries(entries as string[], directory, root)\n        .map((plugin, index) => ({ ...plugin, source: isPluginPath((entries as string[])[index]!) ? \"archive\" : \"host\" }));\n    } catch (cause) {\n      throw new Error(`${source}: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });\n    }\n  })();\n  checkSections(source, raw as Record<string, unknown>, new Set([...discoverPluginIds(root), ...plugins.map((plugin) => plugin.id)]));\n  const users = resolveProfileUsers(source, module.users, placeholderEnvironment);\n  const anonymous = resolveAnonymousUser(source, module.anonymousUser);\n  if (users && anonymous) throw new Error(`${source}: users und anonymousUser schlie\u00DFen einander aus`);\n  const archived = plugins.filter((plugin) => plugin.source === \"archive\").map((plugin) => plugin.folder);\n  const commonDirectory = commonRoot(directory, archived);\n  return { profile, source, root: commonDirectory, file: posixRelative(commonDirectory, source), plugins };\n};\n\nconst collectFiles = (folder: string, root: string): string[] => {\n  const files: string[] = [];\n  for (const entry of readdirSync(folder, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name, \"en\"))) {\n    const absolute = path.join(folder, entry.name);\n    if (entry.isSymbolicLink()) throw new Error(`Das Client-Profil enth\u00E4lt einen symbolischen Link, den das Archiv nicht abbildet: ${absolute}`);\n    if (entry.isDirectory()) {\n      files.push(...collectFiles(absolute, root));\n    } else if (entry.isFile()) {\n      files.push(posixRelative(root, absolute));\n    }\n  }\n  return files;\n};\n\n/** Die Eintr\u00E4ge des Archivs: die Profildatei und die Dateien der Bundles, die sie per Pfad nennt; das Web hat der Client selbst. */\nexport const clientProfileEntries = (inspected: InspectedClientProfile): readonly string[] => {\n  const entries = [inspected.file, ...inspected.plugins.filter((plugin) => plugin.source === \"archive\").flatMap((plugin) => collectFiles(plugin.folder, inspected.root))];\n  for (const entry of entries) {\n    if (!lstatSync(path.join(inspected.root, entry)).isFile()) throw new Error(`Der Archiveintrag ${entry} ist keine Datei`);\n  }\n  return entries;\n};\n\n/** Packt die Eintr\u00E4ge deterministisch aus ihrem gemeinsamen Ordner; der Stand ist der SHA-256 des Archivs. */\nexport const packClientProfile = async (inspected: InspectedClientProfile): Promise<PackedClientProfile> => {\n  const entries = clientProfileEntries(inspected);\n  const chunks: Buffer[] = [];\n  for await (const chunk of createTar({ gzip: { level: 9 }, cwd: inspected.root, portable: true, noMtime: true }, [...entries])) {\n    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n  }\n  const archive = Buffer.concat(chunks);\n  return { archive, version: createHash(\"sha256\").update(archive).digest(\"hex\"), entries };\n};\n", "import path from \"node:path\";\nimport { configFilePath } from \"@ragents/host/config-file.js\";\nimport { declaredEnvironment } from \"@ragents/host/plugin-support/plugin-config.js\";\n\nexport const profileDistributionConfigDescriptors = [\n  { key: \"CLIENT_PROFILE_FILE\", source: \"environment\" },\n  { key: \"HOST_VERSION\", source: \"environment\" },\n] as const;\n\nconst env = declaredEnvironment(profileDistributionConfigDescriptors);\n\n/** Der Pfad gilt relativ zur Server-Profildatei, damit beide Dateien nebeneinander liegen k\u00F6nnen. */\nconst resolveClientProfileFile = (): string | undefined => {\n  const value = env.optional(\"CLIENT_PROFILE_FILE\");\n  if (!value) return undefined;\n  const profile = configFilePath();\n  return path.resolve(profile ? path.dirname(profile) : process.cwd(), value);\n};\n\nexport const profileDistributionConfig = Object.freeze({\n  clientProfileFile: resolveClientProfileFile,\n  hostVersion: () => {\n    const value = env.optional(\"HOST_VERSION\");\n    if (value !== undefined && !/^[0-9a-f]{40}$/.test(value)) throw new Error(`HOST_VERSION muss ein vollst\u00E4ndiger Git-Commit sein, nicht \"${value}\"`);\n    return value;\n  },\n});\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { DomainError, implement, type HttpRouteContribution, type RAgentsPlugin } from \"@ragents/engine\";\nimport { readHostApiVersion, readHostVersion, readPackageVersion } from \"@ragents/host/host-version.js\";\nimport type { PluginModule } from \"@ragents/host/plugin-support/plugin-module.js\";\nimport { writeJson } from \"@ragents/host/plugin-support/http.js\";\nimport { profileArchivePath, profileDistributionContracts, type ClientProfileDescription } from \"../contract.js\";\nimport { inspectClientProfile, packClientProfile } from \"./archive.js\";\nimport { profileDistributionConfig, profileDistributionConfigDescriptors } from \"./config.js\";\n\ninterface DistributionState {\n  readonly description: ClientProfileDescription;\n  readonly archive: Buffer;\n}\n\nconst archivePattern = /^\\/profile\\/([0-9a-f]{64})\\.tar\\.gz$/;\n\nconst archiveRoute = (state: () => DistributionState): HttpRouteContribution => ({\n  id: \"ragents.profile-distribution.archive\",\n  isApiPath: (pathname) => pathname.startsWith(\"/profile/\"),\n  matches: (request, url) => request.method === \"GET\" && archivePattern.test(url.pathname),\n  requiredRights: [\"profile.fetch\"],\n  handle: ({ response, url }) => {\n    const current = state();\n    const version = archivePattern.exec(url.pathname)?.[1];\n    if (version !== current.description.version) {\n      writeJson(response, 404, { error: `Version ${version} is no longer offered; the current one is ${current.description.version}` });\n      return;\n    }\n    response.writeHead(200, {\n      \"Content-Type\": \"application/gzip\",\n      \"Content-Length\": current.archive.byteLength,\n      \"Cache-Control\": \"no-store\",\n    });\n    response.end(current.archive);\n  },\n});\n\nconst profileDistributionPlugin: RAgentsPlugin = {\n  manifest: { id: \"ragents.profile-distribution\" },\n  register: (host) => {\n    host.config(...profileDistributionConfigDescriptors);\n    const file = profileDistributionConfig.clientProfileFile();\n    if (!file) {\n      host.lifecycle({\n        id: \"ragents.profile-distribution\",\n        initialize: () => console.log(\"Profile distribution: CLIENT_PROFILE_FILE is not set, this server offers no client profile\"),\n      });\n      return;\n    }\n    let ready: DistributionState | undefined;\n    const state = (): DistributionState => {\n      if (!ready) throw new DomainError(\"profile-not-ready\", \"The client profile is not packed yet.\", 503);\n      return ready;\n    };\n    host.lifecycle({\n      id: \"ragents.profile-distribution\",\n      initialize: async () => {\n        const hostVersion = profileDistributionConfig.hostVersion() ?? readHostVersion();\n        const packageVersion = readPackageVersion();\n        const hostApi = readHostApiVersion();\n        const inspected = await inspectClientProfile(file);\n        const packed = await packClientProfile(inspected);\n        ready = {\n          archive: packed.archive,\n          description: {\n            profile: inspected.profile,\n            version: packed.version,\n            hostApi,\n            hostVersion,\n            packageVersion,\n            file: inspected.file,\n            size: packed.archive.byteLength,\n            archivePath: profileArchivePath(packed.version),\n            plugins: inspected.plugins.map((plugin) => ({ id: plugin.id, source: plugin.source })),\n          },\n        };\n        console.log(`Profile distribution: ${inspected.profile} version ${packed.version.slice(0, 12)} (${packed.entries.length} files, ${packed.archive.byteLength} bytes, host API ${hostApi}, host ${hostVersion.slice(0, 12)}, package ${packageVersion})`);\n      },\n    });\n    host.methods(implement(profileDistributionContracts.describe, () => state().description));\n    host.http(archiveRoute(state));\n  },\n};\n\nexport const plugin: PluginModule = {\n  create: () => profileDistributionPlugin,\n};\n", "import { Type, type Static } from \"typebox\";\nimport { defineOperation } from \"@ragents/engine/src/rpc/contract\";\n\nconst pluginEntry = Type.Object({\n  id: Type.String({ minLength: 1 }),\n  source: Type.Union([Type.Literal(\"host\"), Type.Literal(\"archive\")], {\n    description: \"host: the client takes the built-in bundle of its host; archive: the bundle is in the archive\",\n  }),\n}, { additionalProperties: false });\n\nconst description = Type.Object({\n  profile: Type.String({ minLength: 1, description: \"Profile name; the file is called ragents.config.<profile>.ts\" }),\n  version: Type.String({ minLength: 64, maxLength: 64, description: \"Version of the archive as SHA-256\" }),\n  hostApi: Type.Integer({ minimum: 1, description: \"Number of the host API the bundles in the archive are built against; the client's host must offer exactly this one\" }),\n  hostVersion: Type.String({ minLength: 40, maxLength: 40, description: \"Git commit of this server's host; a checkout with a different host API uses it to get a matching one\" }),\n  packageVersion: Type.String({ minLength: 1, description: \"Version of the npm package that carries this commit; an installation with a different host API uses it to get a matching one\" }),\n  file: Type.String({ minLength: 1, description: \"Path of the profile file inside the archive\" }),\n  size: Type.Integer({ minimum: 0, description: \"Archive size in bytes\" }),\n  archivePath: Type.String({ minLength: 1, description: \"HTTP path of the archive on this server\" }),\n  plugins: Type.Array(pluginEntry),\n}, { additionalProperties: false });\n\nexport type ClientProfileDescription = Static<typeof description>;\n\nexport const profileArchivePath = (version: string): string => `/profile/${version}.tar.gz`;\n\nexport const profileDistributionContracts = {\n  describe: defineOperation({\n    id: \"ragents.profile.describe\",\n    description: \"The client profile of this server: name, version, required host API, host and package version, plugins and archive. Right: profile.fetch.\",\n    rights: [\"profile.fetch\"],\n    input: Type.Object({}, { additionalProperties: false }),\n    result: description,\n  }),\n};\n", "import { createHash } from \"node:crypto\";\nimport { readdirSync, statSync, lstatSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { create as createTar } from \"tar\";\nimport { hostConfigKeys } from \"@ragents/host/config.js\";\nimport { isEnvironmentReference, isProvisionedReference } from \"@ragents/host/config-definition.js\";\nimport { resolveAnonymousUser, resolveProfileUsers, SECRET_KEY_PATTERN } from \"@ragents/host/config-file.js\";\nimport { discoverPluginIds, resolvePluginEntries, type ResolvedPlugin } from \"@ragents/host/profile/plugin-discovery.js\";\nimport { bundlesRoot, isPluginPath } from \"@ragents/host/plugin-support/plugins-root.js\";\n\nexport interface ClientProfilePlugin extends ResolvedPlugin {\n  readonly source: \"host\" | \"archive\";\n}\n\nexport interface InspectedClientProfile {\n  readonly profile: string;\n  readonly source: string;\n  readonly root: string;\n  readonly file: string;\n  readonly plugins: readonly ClientProfilePlugin[];\n}\n\nexport interface PackedClientProfile {\n  readonly archive: Buffer;\n  readonly version: string;\n  readonly entries: readonly string[];\n}\n\nconst PROFILE_FILE = /^ragents\\.config\\.([a-z0-9]+(?:-[a-z0-9]+)*)\\.ts$/;\n\nconst commonRoot = (first: string, others: readonly string[]): string => {\n  let root = first;\n  for (const folder of others) {\n    while (folder !== root && !folder.startsWith(root + path.sep)) {\n      const parent = path.dirname(root);\n      if (parent === root) throw new Error(`Profile file and plugin ${folder} have no common folder`);\n      root = parent;\n    }\n  }\n  return root;\n};\n\nconst posixRelative = (root: string, target: string): string => path.relative(root, target).split(path.sep).join(\"/\");\n\n// Every name is set so a password or token reference can be checked even without the client environment.\nconst placeholderEnvironment: Readonly<Record<string, string | undefined>> = new Proxy({}, { get: () => \"client-placeholder-value\" });\n\nconst checkSections = (source: string, raw: Record<string, unknown>, pluginIds: ReadonlySet<string>): void => {\n  for (const [section, value] of Object.entries(raw)) {\n    if (!value || typeof value !== \"object\" || Array.isArray(value)) throw new Error(`${source}: the section ${section} is not an object`);\n    if (section !== \"host\" && !pluginIds.has(section)) throw new Error(`${source}: the section ${section} belongs to no plugin from host.PLUGINS`);\n    for (const [key, entry] of Object.entries(value as Record<string, unknown>)) {\n      if (section === \"host\" && !hostConfigKeys.includes(key)) throw new Error(`${source}: host.${key} is not a host key`);\n      if (isEnvironmentReference(entry) || isProvisionedReference(entry)) continue;\n      if (SECRET_KEY_PATTERN.test(key)) throw new Error(`${source}: ${section}.${key} is a secret and must be written as env(\"...\")`);\n      const valid = typeof entry === \"string\" || typeof entry === \"number\" || typeof entry === \"boolean\"\n        || (Array.isArray(entry) && entry.every((item) => typeof item === \"string\"))\n        || (Array.isArray(entry) && entry.every((item) => !!item && typeof item === \"object\" && !Array.isArray(item)));\n      if (!valid) throw new Error(`${source}: ${section}.${key} has no valid value`);\n      if (typeof entry === \"string\" && /^\\$\\{[A-Za-z_][A-Za-z0-9_]*\\}$/.test(entry)) throw new Error(`${source}: ${section}.${key} references the environment as text; use env(\"...\")`);\n    }\n  }\n};\n\n/** Checks the client profile file without its environment and determines which plugins belong in the archive. */\nexport const inspectClientProfile = async (source: string, root = bundlesRoot): Promise<InspectedClientProfile> => {\n  const name = PROFILE_FILE.exec(path.basename(source));\n  if (!name) throw new Error(`The client profile file must be called ragents.config.<profile>.ts: ${source}`);\n  if (!statSync(source, { throwIfNoEntry: false })?.isFile()) throw new Error(`The client profile file ${source} is missing`);\n  const profile = name[1]!;\n  const module = await import(pathToFileURL(source).href) as Record<string, unknown>;\n  const raw = module.config;\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) throw new Error(`${source} exports no constant config`);\n  const host = (raw as Record<string, unknown>).host as Record<string, unknown> | undefined;\n  const entries = host?.PLUGINS;\n  if (!Array.isArray(entries) || entries.length === 0 || !entries.every((entry) => typeof entry === \"string\" && entry)) {\n    throw new Error(`${source}: host.PLUGINS must be a non-empty list`);\n  }\n  if (host?.PRODUCT_PROFILE !== profile) throw new Error(`${source}: host.PRODUCT_PROFILE must be ${profile}`);\n  const directory = path.dirname(source);\n  const unportable = (entries as string[]).filter((entry) => isPluginPath(entry) && !/^\\.{1,2}\\//.test(entry));\n  if (unportable.length > 0) {\n    throw new Error(`${source}: ${unportable.join(\", \")} names a bundle absolutely or with ~/; the client resolves this path on its own machine and would not find the delivered bundle there. In the client profile, name every bundle relative to the profile file (./ or ../)`);\n  }\n  const plugins = ((): readonly ClientProfilePlugin[] => {\n    try {\n      return resolvePluginEntries(entries as string[], directory, root)\n        .map((plugin, index) => ({ ...plugin, source: isPluginPath((entries as string[])[index]!) ? \"archive\" : \"host\" }));\n    } catch (cause) {\n      throw new Error(`${source}: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });\n    }\n  })();\n  checkSections(source, raw as Record<string, unknown>, new Set([...discoverPluginIds(root), ...plugins.map((plugin) => plugin.id)]));\n  const users = resolveProfileUsers(source, module.users, placeholderEnvironment);\n  const anonymous = resolveAnonymousUser(source, module.anonymousUser);\n  if (users && anonymous) throw new Error(`${source}: users and anonymousUser exclude each other`);\n  const archived = plugins.filter((plugin) => plugin.source === \"archive\").map((plugin) => plugin.folder);\n  const commonDirectory = commonRoot(directory, archived);\n  return { profile, source, root: commonDirectory, file: posixRelative(commonDirectory, source), plugins };\n};\n\nconst collectFiles = (folder: string, root: string): string[] => {\n  const files: string[] = [];\n  for (const entry of readdirSync(folder, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name, \"en\"))) {\n    const absolute = path.join(folder, entry.name);\n    if (entry.isSymbolicLink()) throw new Error(`The client profile contains a symbolic link that the archive does not represent: ${absolute}`);\n    if (entry.isDirectory()) {\n      files.push(...collectFiles(absolute, root));\n    } else if (entry.isFile()) {\n      files.push(posixRelative(root, absolute));\n    }\n  }\n  return files;\n};\n\n/** The archive entries: the profile file and the files of the bundles it names by path; the client has the web itself. */\nexport const clientProfileEntries = (inspected: InspectedClientProfile): readonly string[] => {\n  const entries = [inspected.file, ...inspected.plugins.filter((plugin) => plugin.source === \"archive\").flatMap((plugin) => collectFiles(plugin.folder, inspected.root))];\n  for (const entry of entries) {\n    if (!lstatSync(path.join(inspected.root, entry)).isFile()) throw new Error(`The archive entry ${entry} is not a file`);\n  }\n  return entries;\n};\n\n/** Packs the entries deterministically from their common folder; the version is the SHA-256 of the archive. */\nexport const packClientProfile = async (inspected: InspectedClientProfile): Promise<PackedClientProfile> => {\n  const entries = clientProfileEntries(inspected);\n  const chunks: Buffer[] = [];\n  for await (const chunk of createTar({ gzip: { level: 9 }, cwd: inspected.root, portable: true, noMtime: true }, [...entries])) {\n    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n  }\n  const archive = Buffer.concat(chunks);\n  return { archive, version: createHash(\"sha256\").update(archive).digest(\"hex\"), entries };\n};\n", "import path from \"node:path\";\nimport { configFilePath } from \"@ragents/host/config-file.js\";\nimport { declaredEnvironment } from \"@ragents/host/plugin-support/plugin-config.js\";\n\nexport const profileDistributionConfigDescriptors = [\n  { key: \"CLIENT_PROFILE_FILE\", source: \"environment\" },\n  { key: \"HOST_VERSION\", source: \"environment\" },\n] as const;\n\nconst env = declaredEnvironment(profileDistributionConfigDescriptors);\n\n/** The path is relative to the server profile file so both files can sit next to each other. */\nconst resolveClientProfileFile = (): string | undefined => {\n  const value = env.optional(\"CLIENT_PROFILE_FILE\");\n  if (!value) return undefined;\n  const profile = configFilePath();\n  return path.resolve(profile ? path.dirname(profile) : process.cwd(), value);\n};\n\nexport const profileDistributionConfig = Object.freeze({\n  clientProfileFile: resolveClientProfileFile,\n  hostVersion: () => {\n    const value = env.optional(\"HOST_VERSION\");\n    if (value !== undefined && !/^[0-9a-f]{40}$/.test(value)) throw new Error(`HOST_VERSION must be a full Git commit, not \"${value}\"`);\n    return value;\n  },\n});\n"],
+  "mappings": "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",
   "names": ["plugin", "path", "plugin"]
 }

package/bundles/ragents.reference/ragents-bundle.json

@@ -1,5 +1,5 @@
 {
-  "format": 4,
+  "format": 5,
   "id": "ragents.reference",
   "api": 7,
   "hostNames": {
@@ -20,8 +20,8 @@
       ]
     }
   },
-  "stand": "b3fa5275dc209c315f26ec832458603d442d2a56974471ee83292e7d26079a12",
-  "sourceStand": "da96161902a69ec9b16e63d49ce99ff931ed25eb082b6210a3bbdfe10bb04d58",
+  "revision": "809c8770905fa2a4d557425abf27aee27a863aec8a80655b96e40bd82307f493",
+  "sourceRevision": "abe068f9695702223dd49b2169ecca54e5a82fd4b37d02346d0c9df3582cff87",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.reference/run-scripts/balcony-wizard/RUN.md

@@ -1,27 +1,27 @@
 ---
-title: Balkon-Wizard einrichten
-description: "Ein vorbereitetes KI-Interview zeigt adaptive Fragen in einer eigenen Mini-App. Der Berater ist von Anfang an Primary-Actor; das Formular zählt fünf Antworten."
+title: Set up balcony wizard
+description: "A prepared AI interview shows adaptive questions in a mini-app of its own. The advisor is the primary actor from the start; the form counts five answers."
 order: 140
 coordinator: false
-tags: Run-Scripts, Anwendungsfall, Konzeptdemo, Mini-Apps, LLM-Actor mit View, Frei gesteuerter Chat, Primary-Actor
+tags: Run scripts, Use case, Concept demo, Mini-apps, LLM actor with view, Controlled chat, Primary actor
 ---
 
-Das TypeScript-Setup legt einen Balkon-Berater mit der Rolle `standard` und ausdrücklich
-ohne Werkzeuge an. Das mitgelieferte Programm `actors/balcony-app/` bindet eine eigenständige
-Mini-App an diesen Actor. Die Fläche zeigt allein deren Kachel statt einer Chatkachel; ein Koordinator
-wird für diesen Run nicht angelegt. Der Berater wird zum Primary-Actor und behält seinen eigenen
-Interview-Prompt.
+The TypeScript setup creates a balcony advisor with the role `standard` and explicitly
+without tools. The bundled program `actors/balcony-app/` binds a standalone mini-app to
+this actor. The surface shows only its tile instead of a chat tile; no coordinator
+is created for this run. The advisor becomes the primary actor and keeps its own
+interview prompt.
 
-In der App beginnt "Beratung starten" das Gespräch. Das LLM stellt jeweils eine Frage anhand
-der bisherigen Antworten, ohne feste Fragenliste. Die App zählt fünf Antworten und zeigt danach
-die Empfehlung zu Stil, Pflanzen, Möbeln, Pflege und nächsten Schritten. Der Benutzer schreibt in
-ein Formular, nicht in ein Chat-Widget. Fortschritt und abgeschlossene Antworten lassen sich nach
-dem Neuladen aus dem Gespräch rekonstruieren; eine fehlgeschlagene Modellantwort kann erneut
-angefordert werden, ohne eine weitere Antwort zu zählen.
+In the app, "Start consultation" begins the conversation. The LLM asks one question at a time
+based on the previous answers, without a fixed list of questions. The app counts five answers and
+then shows the recommendation on style, plants, furniture, care, and next steps. The user writes
+into a form, not into a chat widget. Progress and completed answers can be reconstructed from the
+conversation after a reload; a failed model answer can be requested again without counting
+another answer.
 
-Die Vorlage benötigt keine Startwerte. Das Setup wird einmal ausgeführt und startet noch keinen
-Modellaufruf. Erst eine Aktion in der App schickt Text an den Berater. Fragen und Empfehlungen
-bleiben Modellantworten; die App prüft ihre fachliche Qualität nicht automatisch.
+The template needs no start values. The setup runs once and does not start a model call yet.
+Only an action in the app sends text to the advisor. Questions and recommendations
+remain model answers; the app does not check their subject-matter quality automatically.
 
-Dies ist ein vorbereitetes Demo zum direkten Starten. Die separate Skill "Balkon-Wizard"
-beauftragt weiterhin den Run-Builder, selbst eine App für diese Aufgabe zu bauen.
+This is a prepared demo to start directly. The separate skill "Balcony wizard"
+still asks the run builder to build an app for this task itself.

package/bundles/ragents.reference/run-scripts/balcony-wizard/actors/balcony-app/package.json

@@ -3,8 +3,8 @@
   "private": true,
   "type": "module",
   "ragents": {
-    "title": "Balkonberatung",
-    "description": "Fünf Fragen und eine persönliche Gestaltungsempfehlung in einer eigenen Mini-App.",
+    "title": "Balcony advice",
+    "description": "Five questions and a personal design recommendation in a mini-app of its own.",
     "views": [{ "id": "main", "client": "src/client.tsx" }]
   }
 }

package/bundles/ragents.reference/run-scripts/balcony-wizard/actors/balcony-app/src/client.tsx

@@ -41,34 +41,34 @@ function App() {
   const evaluating = conversation.answers === answerCount || sender.finalAnswer;
   const disabled = Boolean(snapshot?.readOnly || snapshot?.running || pending);
 
-  return <UI.AppLayout title="Dein Balkon" description="Fünf Fragen zu deinem Balkon. Daraus entsteht eine persönliche Gestaltungsempfehlung.">
+  return <UI.AppLayout title="Your balcony" description="Five questions about your balcony. They lead to a personal design recommendation.">
     <UI.Stack gap="large">
       <UI.Stack gap="small">
-        <label htmlFor="interview-progress">{conversation.answers} von {answerCount} Antworten</label>
+        <label htmlFor="interview-progress">{conversation.answers} of {answerCount} answers</label>
         <progress className="h-2.5 w-full [accent-color:var(--foreground)]" id="interview-progress" max={answerCount} value={conversation.answers} />
       </UI.Stack>
-      {snapshot?.readOnly && <p>Dieser Run ist schreibgeschützt.</p>}
+      {snapshot?.readOnly && <p>This run is read-only.</p>}
       {(sendError || conversation.error) && <p role="alert">{sendError || conversation.error}</p>}
       {conversation.phase === "start" && !pending && <UI.Stack>
-        <p>Du beantwortest immer nur eine Frage. Deine bisherigen Angaben bleiben beim erneuten Öffnen erhalten.</p>
-        <UI.Stack direction="row"><UI.Button disabled={disabled} onClick={() => void send(startMarker)}>Beratung starten</UI.Button></UI.Stack>
+        <p>You always answer only one question. Your previous answers are kept when you open this again.</p>
+        <UI.Stack direction="row"><UI.Button disabled={disabled} onClick={() => void send(startMarker)}>Start consultation</UI.Button></UI.Stack>
       </UI.Stack>}
-      {waiting && <p role="status">{evaluating ? "Deine Antworten werden ausgewertet. Die Empfehlung entsteht ..." : "Deine nächste Frage entsteht ..."}</p>}
+      {waiting && <p role="status">{evaluating ? "Your answers are being evaluated. The recommendation is being created ..." : "Your next question is being created ..."}</p>}
       {conversation.canRetry && <UI.Stack>
-        <p>Die nächste Modellantwort konnte nicht angezeigt werden. Deine bereits gesendeten Antworten bleiben erhalten.</p>
-        <UI.Stack direction="row"><UI.Button disabled={disabled} onClick={() => void send(retryMarker)} variant="outline">Modellantwort erneut anfordern</UI.Button></UI.Stack>
+        <p>The next model answer could not be shown. The answers you already sent are kept.</p>
+        <UI.Stack direction="row"><UI.Button disabled={disabled} onClick={() => void send(retryMarker)} variant="outline">Request model answer again</UI.Button></UI.Stack>
       </UI.Stack>}
       {conversation.phase === "question" && !pending && <UI.Stack>
-        <h2>Frage {conversation.answers + 1} von {answerCount}</h2>
+        <h2>Question {conversation.answers + 1} of {answerCount}</h2>
         <UI.Markdown text={conversation.text} />
-        <UI.Form title="Deine Antwort" fields={[
-          { id: "answer", label: "Antwort", type: "textarea", rows: 4, required: true, placeholder: "Beschreibe deinen Balkon und deine Wünsche ..." },
+        <UI.Form title="Your answer" fields={[
+          { id: "answer", label: "Answer", type: "textarea", rows: 4, required: true, placeholder: "Describe your balcony and your wishes ..." },
         ]} values={values} onChange={setValues} disabled={disabled} onSubmit={async (next) => {
           await send(answerInput(conversation.answers, String(next.answer ?? "")));
-        }} submitLabel={conversation.answers === 4 ? "Antwort senden und auswerten" : "Antwort senden"} />
+        }} submitLabel={conversation.answers === 4 ? "Send answer and evaluate" : "Send answer"} />
       </UI.Stack>}
       {conversation.phase === "complete" && !pending && <UI.Stack>
-        <h2>Deine Gestaltungsempfehlung</h2>
+        <h2>Your design recommendation</h2>
         <UI.Markdown text={conversation.text} />
       </UI.Stack>}
     </UI.Stack>
@@ -76,5 +76,5 @@ function App() {
 }
 
 const root = document.getElementById("root");
-if (!root) throw new Error("Das Wurzelelement #root fehlt.");
+if (!root) throw new Error("The #root element is missing.");
 createRoot(root).render(<App />);

package/bundles/ragents.reference/run-scripts/balcony-wizard/actors/balcony-app/src/conversation.ts

@@ -52,8 +52,8 @@ export function deriveConversation(snapshot: ChatSnapshot | undefined): Conversa
 }
 
 export function answerInput(answers: number, text: string): string {
-  if (!Number.isInteger(answers) || answers < 0 || answers >= answerCount) throw new Error("Das Interview nimmt genau fünf Antworten an.");
-  if (!text.trim()) throw new Error("Bitte eine Antwort eingeben.");
+  if (!Number.isInteger(answers) || answers < 0 || answers >= answerCount) throw new Error("The interview accepts exactly five answers.");
+  if (!text.trim()) throw new Error("Please enter an answer.");
   return `ANSWER ${answers + 1}/5\n${text.trim()}`;
 }