wizards 0.4.7 → 0.5.1

package/apps/runtime/dist/services/access.js

@@ -31,7 +31,7 @@ export function currentRole() {
     return actor.getStore() ?? "owner";
 }
 export const isAdminRole = (role) => role === "owner" || role === "admin";
-export const MEMBERS_EDIT_ONLY = bilingual("Das dürfen nur Admins des Teams. Als Mitglied bearbeitest du die Wizards, die es gibt.", "Only the team's admins may do that. As a member you edit the wizards that are there.");
+export const MEMBERS_EDIT_ONLY = bilingual("Das dürfen nur Admins des Teams. Als Mitglied bearbeitest du die Wizards, die es schon gibt.", "Only team admins can do that. As a member, you can edit the wizards that already exist.");
 /** Refuses a member: making and deleting is for the owner and the admins of the team. */
 export async function requireAdmin() {
     if (syncing() || !managed || isAdminRole(currentRole())) {
@@ -52,8 +52,8 @@ export async function mayBuild() {
     // An older Manage-App does not say: then it builds. One that cannot be reached: nothing changes.
     return info ? info.limits.build !== false : false;
 }
-export const READ_ONLY_PROJECT = bilingual("Dieses Projekt kommt aus einer lokalen Installation und wird dort geändert.", "This project comes from a local install and is changed there.");
-export const READ_ONLY_TENANT = bilingual("Hier wird nichts gebaut: Auf diesem Server laufen die Wizards, die deine lokale Installation veröffentlicht.", "Nothing is built here: this server runs the wizards your local install publishes.");
+export const READ_ONLY_PROJECT = bilingual("Diesen Space bearbeitest du in engenty wizards auf deinem Computer, nicht hier.", "You edit this space in engenty wizards on your computer, not here.");
+export const READ_ONLY_TENANT = bilingual("Hier laufen die Wizards, die du in engenty wizards auf deinem Computer veröffentlichst. Gebaut und bearbeitet wird dort.", "Wizards run here once you publish them in engenty wizards on your computer. You build and edit them there.");
 /** Refuses when the tenant builds nothing here. */
 export async function requireBuild() {
     if (syncing() || (await mayBuild())) {

package/apps/runtime/dist/services/assistant-chats.js

@@ -253,7 +253,7 @@ export async function readChat(user, chatId) {
         where: and(mine(user), eq(schema.assistantChat.id, chatId)),
     });
     if (!chat) {
-        throw new ServiceError("not_found", bilingual("Diesen Chat gibt es nicht.", "There is no such chat."));
+        throw new ServiceError("not_found", bilingual("Diesen Chat gibt es nicht.", "This chat doesn’t exist."));
     }
     return {
         id: chat.id,

package/apps/runtime/dist/services/brand.js

@@ -66,14 +66,14 @@ export async function describeGradient(brand, text, current) {
         answer = result.output;
     }
     catch {
-        throw new ServiceError("invalid", bilingual("Daraus ließ sich kein Verlauf machen. Beschreib ihn bitte anders.", "No gradient could be made from that. Please describe it differently."));
+        throw new ServiceError("invalid", bilingual("Daraus ließ sich kein Verlauf machen. Beschreib ihn anders.", "Couldn’t make a gradient from that. Try describing it differently."));
     }
     const stops = answer.stops
         .filter((s) => HEX.test(s.color))
         .slice(0, 12)
         .map((s) => ({ color: s.color.toLowerCase(), at: Math.min(100, Math.max(0, s.at)) }));
     if (stops.length < 2) {
-        throw new ServiceError("invalid", bilingual("Daraus ließ sich kein Verlauf machen. Beschreib ihn bitte anders.", "No gradient could be made from that. Please describe it differently."));
+        throw new ServiceError("invalid", bilingual("Daraus ließ sich kein Verlauf machen. Beschreib ihn anders.", "Couldn’t make a gradient from that. Try describing it differently."));
     }
     return {
         name: answer.name.trim().slice(0, 80),

package/apps/runtime/dist/services/cloud.js

@@ -1,4 +1,5 @@
 import { createHash } from "node:crypto";
+import { bilingual } from "@engenty-wizards/shared/run";
 import { and, asc, eq, inArray, isNotNull, isNull, like } from "drizzle-orm";
 import { accountToken, linkedAccount } from "../auth/account.js";
 import { control, controlDb, db, schema } from "../db/client.js";
@@ -25,7 +26,7 @@ export async function cloudState(wizardId) {
 async function call(method, path, body, timeoutMs = 30_000) {
     const token = await accountToken();
     if (!token) {
-        throw new ServiceError("refused", "The account is signed out. Please sign in again.", {
+        throw new ServiceError("refused", bilingual("Das Konto ist abgemeldet. Melde dich neu an.", "The account is signed out. Sign in again."), {
             reason: "signed_out",
         });
     }
@@ -39,7 +40,7 @@ async function call(method, path, body, timeoutMs = 30_000) {
         signal: AbortSignal.timeout(timeoutMs),
     }).catch(() => null);
     if (!res) {
-        throw new ServiceError("refused", "The cloud is not reachable right now.", {
+        throw new ServiceError("refused", bilingual("Die Cloud ist gerade nicht erreichbar.", "The cloud can’t be reached right now."), {
             reason: "unreachable",
         });
     }
@@ -49,7 +50,7 @@ async function call(method, path, body, timeoutMs = 30_000) {
 function refusal(answer, fallback) {
     const { error, reason, ...rest } = answer.body;
     const message = answer.status === 401
-        ? "The account is signed out. Please sign in again."
+        ? bilingual("Das Konto ist abgemeldet. Melde dich neu an.", "The account is signed out. Sign in again.")
         : typeof error === "string" && error
             ? error
             : fallback;
@@ -213,7 +214,7 @@ export async function syncToCloud(userId, wizardId) {
     const w = await ownedWizard(userId, wizardId);
     const version = await publishedVersion(w);
     if (!version) {
-        throw new ServiceError("refused", "Publish the wizard first.");
+        throw new ServiceError("refused", bilingual("Veröffentliche den Wizard zuerst.", "Publish the wizard first."));
     }
     const before = await cloudState(w.id);
     try {

package/apps/runtime/dist/services/errors.js

@@ -1,3 +1,4 @@
+import { bilingual } from "@engenty-wizards/shared/run";
 import { errorText, NotedError } from "../model-errors.js";
 const STATUS = {
     not_found: 404,
@@ -25,4 +26,4 @@ export class ServiceError extends NotedError {
         return { error: errorText(this, lang), code: this.code, ...this.data };
     }
 }
-export const notFound = () => new ServiceError("not_found", "not found");
+export const notFound = () => new ServiceError("not_found", bilingual("Das gibt es nicht oder nicht mehr.", "This doesn’t exist or was deleted."));

package/apps/runtime/dist/services/knowledge-model.js

@@ -256,7 +256,7 @@ export async function dropConverted(fileId) {
         .where(and(eq(schema.spaceTable.fileId, fileId), eq(schema.spaceTable.kept, false), isNull(schema.spaceTable.originKey)));
 }
 /**
- * Reads an uploaded document into Wissen: a table per sheet of a workbook, else a page — with
+ * Reads an uploaded document into Knowledge: a table per sheet of a workbook, else a page — with
  * sub-pages when it is long and has headings of its own. The file stays as the original. A file
  * nothing can read stays a file; UnreadableDocument says why.
  */
@@ -386,13 +386,13 @@ export async function convertDocument(file, data) {
         items: [`p:${parentId}`],
     };
 }
-// --- Kategorien a model fills ---------------------------------------------------------------
+// --- Categories a model fills ---------------------------------------------------------------
 /**
- * Fills the space's Kategorien of an item from its text, where the space has any and nothing
+ * Fills the space's categories of an item from its text, where the space has any and nothing
  * set them yet. Values a person set are never touched. True when anything was set.
  */
 export async function fillCategories(projectId, ref, text, name) {
-    // A column's Kategorie comes from its cells, not from a model.
+    // A column's category comes from its cells, not from a model.
     const categories = (await categoryRows(projectId)).filter((c) => !(c.proposed || c.tableId));
     if (!(categories.length && text.trim())) {
         return false;
@@ -443,9 +443,9 @@ export async function fillCategories(projectId, ref, text, name) {
     const { changed } = await setItemCategories(projectId, ref, input, "model");
     return changed;
 }
-// --- the Übersicht of a value ---------------------------------------------------------------
+// --- the summary of a value -----------------------------------------------------------------
 const SUMMARY_ITEMS = 40;
-/** What a value's items say, for the model that writes its Übersicht. */
+/** What a value's items say, for the model that writes its summary. */
 async function itemsOfValue(valueId) {
     const rows = await db.query.spaceItemCategory.findMany({
         where: eq(schema.spaceItemCategory.valueId, valueId),
@@ -496,7 +496,7 @@ async function itemsOfValue(valueId) {
     return { items: out, total: rows.length };
 }
 /**
- * Writes the Übersicht of a value: what its items are and what they say, so "which Zuschüsse are
+ * Writes the summary of a value: what its items are and what they say, so "which Zuschüsse are
  * there?" finds one page that answers it. Kept on the value and indexed like a page.
  */
 export async function writeSummary(valueId) {
@@ -504,12 +504,12 @@ export async function writeSummary(valueId) {
         where: eq(schema.spaceCategoryValue.id, valueId),
     });
     if (!value) {
-        throw new ServiceError("not_found", bilingual("Diesen Wert gibt es nicht.", "There is no such value."));
+        throw new ServiceError("not_found", bilingual("Diesen Wert gibt es nicht.", "This value doesn’t exist."));
     }
     const category = await categoryRow(value.categoryId);
     const { items, total } = await itemsOfValue(value.id);
     if (!items.length) {
-        throw new ServiceError("invalid", "Noch steht nichts unter diesem Wert.");
+        throw new ServiceError("invalid", bilingual("Unter diesem Wert steht noch nichts.", "Nothing is filed under this value yet."));
     }
     const model = await textModel("standard");
     const result = await generateText({
@@ -530,7 +530,7 @@ export async function writeSummary(valueId) {
     queueIndex(`v:${value.id}`);
     return summary;
 }
-/** After a source wrote: the values it filled that have three items or more get their Übersicht. */
+/** After a source wrote: the values it filled that have three items or more get their summary. */
 export async function summarizeValues(projectId, categoryName, value) {
     const categories = (await categoryRows(projectId)).filter((c) => c.type === "choice" &&
         !c.proposed &&

package/apps/runtime/dist/services/knowledge.js

@@ -172,7 +172,7 @@ async function convertedFiles(projectId) {
     ]);
     return new Set([...pages, ...tables].map((r) => r.id));
 }
-/** Everything Wissen holds: pages (sub-pages counted under them), tables, files, Kategorien. */
+/** Everything Knowledge holds: pages (sub-pages counted under them), tables, files, categories. */
 export async function listKnowledge(userId, projectId) {
     const project = await ownedProject(userId, projectId);
     const [tree, tables, rowCounts, files, converted, categories, embeddings, checker] = await Promise.all([
@@ -277,7 +277,7 @@ export async function listKnowledge(userId, projectId) {
     items.sort((a, b) => a.title.localeCompare(b.title, "de"));
     return { items, categories, embeddings, checked: checker };
 }
-/** A value opened in the studio: its Übersicht, and the items and rows that have it. */
+/** A value opened in the studio: its summary, and the items and rows that have it. */
 export async function valueContents(userId, valueId) {
     const value = await db.query.spaceCategoryValue.findFirst({
         where: eq(schema.spaceCategoryValue.id, valueId),
@@ -303,7 +303,7 @@ export async function valueContents(userId, valueId) {
         ...(await itemsHaving(userId, project.id, having)),
     };
 }
-/** Everything that has a Kategorie, whatever its value: what the Kategorie's page lists. */
+/** Everything that has a category, whatever its value: what the category's page lists. */
 export async function categoryContents(userId, categoryId) {
     const category = await db.query.spaceCategory.findFirst({
         where: eq(schema.spaceCategory.id, categoryId),
@@ -377,7 +377,7 @@ async function itemsHaving(userId, projectId, having) {
         })),
     };
 }
-/** What the studio shows around a page of Wissen: where it stands, its sub-pages, its origin. */
+/** What the studio shows around a page of Knowledge: where it stands, its sub-pages, its origin. */
 export async function knowledgePage(page) {
     const tree = await pageTree(page.projectId);
     const node = tree.get(page.id);
@@ -443,7 +443,7 @@ function sectionOf(markdown, wanted) {
     return start >= 0 ? lines.slice(start).join("\n").trim() : null;
 }
 /**
- * A page as a step reads it: front matter (title, path, Kategorien, where it came from, its
+ * A page as a step reads it: front matter (title, path, categories, where it came from, its
  * original, its parent and sub-pages) and its Markdown, or one section of it. Long pages come in
  * parts: `from` continues where the last part ended.
  */
@@ -472,7 +472,7 @@ export async function readPage(projectId, path, opts = {}) {
         ...(node?.parentId ? [`parent: ${tree.get(node.parentId)?.path}`] : []),
         ...(lines.length
             ? [
-                "kategorien:",
+                "categories:",
                 ...lines.map((l) => `  ${l.replace(/^([^:]+): (.*)$/, (_m, k, v) => `${yamlValue(k)}: ${yamlValue(v)}`)}`),
             ]
             : []),
@@ -586,15 +586,15 @@ export async function readTable(projectId, path, opts = {}) {
     };
 }
 /**
- * For project_list: without a filter, the Kategorien with their values and how many items each
- * has; with one, the items it leaves, with their paths and Kategorien.
+ * For project_list: without a filter, the categories with their values and how many items each
+ * has; with one, the items it leaves, with their paths and categories.
  */
 export async function listForStep(projectId, where) {
     const categories = await listCategories(projectId);
     const taken = categories.filter((c) => !c.proposed);
     if (!Object.keys(where ?? {}).length) {
         return {
-            kategorien: taken.map((c) => ({
+            categories: taken.map((c) => ({
                 name: c.name,
                 type: c.type,
                 ...(c.unit ? { unit: c.unit } : {}),
@@ -640,27 +640,27 @@ export async function listForStep(projectId, where) {
             .map((n) => ({
             path: n.path,
             title: n.title,
-            kategorien: categoryLines(taken, cats.get(`p:${n.id}`)),
+            categories: categoryLines(taken, cats.get(`p:${n.id}`)),
         })),
         ...[...(filtered?.tables ?? [])].map((id) => ({
             path: tPaths.get(id) ?? "",
             title: "",
-            kategorien: categoryLines(taken, cats.get(`t:${id}`)),
+            categories: categoryLines(taken, cats.get(`t:${id}`)),
         })),
         ...[...rowTables].map(([id, n]) => ({
             path: tPaths.get(id) ?? "",
             title: `${n} rows match: read them with table_read and the same values as its columns`,
-            kategorien: [],
+            categories: [],
         })),
         ...[...(filtered?.files ?? [])].map((id) => ({
             path: fPaths.get(id) ?? "",
             title: "",
-            kategorien: categoryLines(taken, cats.get(`f:${id}`)),
+            categories: categoryLines(taken, cats.get(`f:${id}`)),
         })),
     ];
     return { items: items.slice(0, 200), total: items.length };
 }
-/** How much Wissen a space holds: what the block of the steps' instructions says. */
+/** How much Knowledge a space holds: what the block of the steps' instructions says. */
 export async function knowledgeCounts(projectId) {
     const [pages, tables, files] = await Promise.all([
         db
@@ -679,8 +679,8 @@ export async function knowledgeCounts(projectId) {
     return { pages: pages[0].n, tables: tables[0].n, files: files[0].n };
 }
 /**
- * What every step of the space is told about Wissen: how much there is, the Kategorien to filter
- * by, the tools to find and read. Empty when Wissen is.
+ * What every step of the space is told about Knowledge: how much there is, the categories to filter
+ * by, the tools to find and read. Empty when Knowledge is.
  */
 export async function knowledgeBlock(projectId) {
     const counts = await knowledgeCounts(projectId);
@@ -708,14 +708,14 @@ export async function knowledgeBlock(projectId) {
         return `- ${c.name} (${type})${values}`;
     });
     return [
-        "# WISSEN — WHAT THE SPACE KNOWS",
+        "# KNOWLEDGE — WHAT THE SPACE KNOWS",
         `Ground truth the space's owner keeps for all wizards: ${what}. Use it when the task touches what it covers, and prefer it to what you remember.`,
         ...(lines.length
             ? [
-                "Kategorien, to filter with `where` in project_search and project_list before searching:",
+                "Categories, to filter with `where` in project_search and project_list before searching:",
                 ...lines,
             ]
             : []),
-        "Find with project_search (a question; `where` on Kategorien). List with project_list. Read whole with page_read and table_read by path. A page marks the pages of its original as <!-- S. n -->: quote them when the source matters.",
+        "Find with project_search (a question; `where` on categories). List with project_list. Read whole with page_read and table_read by path. A page marks the pages of its original as <!-- S. n -->: quote them when the source matters.",
     ].join("\n");
 }

package/apps/runtime/dist/services/marketplace.js

@@ -404,13 +404,13 @@ export async function marketplaceWizard(id, lang) {
         return null;
     }
     if (!readable(found.definition)) {
-        throw new ServiceError("refused", bilingual("Diese Vorlage braucht eine neuere Version der App. Bitte aktualisiere die App.", "This template needs a newer version of the app. Please update the app."));
+        throw new ServiceError("refused", bilingual("Diese Vorlage braucht eine neuere Version von engenty wizards. Aktualisiere zuerst engenty wizards.", "This template needs a newer version of engenty wizards. Update engenty wizards first."));
     }
     // A wizard whose plugins are not here would stop at its first step that uses them.
     const have = await pluginIdsOf(currentTenant());
     const needs = pluginsOf(wizardSchema.parse(found.definition)).filter((p) => !have.has(p));
     if (needs.length) {
-        throw new ServiceError("refused", bilingual(`Diese Vorlage braucht ${needs.length === 1 ? "das Plugin" : "die Plugins"} ${needs.join(", ")}: mit Pro auf engenty.ai dabei.`, `This template needs the ${needs.length === 1 ? "plugin" : "plugins"} ${needs.join(", ")}: included with Pro on engenty.ai.`));
+        throw new ServiceError("refused", bilingual(`Diese Vorlage braucht ${needs.length === 1 ? "das Plugin" : "die Plugins"} ${needs.join(", ")}: bei Pro auf engenty.ai dabei.`, `This template needs the ${needs.length === 1 ? "plugin" : "plugins"} ${needs.join(", ")}: included with Pro on engenty.ai.`));
     }
     return {
         id: found.id,

package/apps/runtime/dist/services/package-file.js

@@ -1,3 +1,4 @@
+import { bilingual } from "@engenty-wizards/shared/run";
 import { manifestSchema, PACKAGE_FILES, PACKAGE_FORMAT, PACKAGE_MANIFEST, PACKAGE_MAX_BYTES, } from "@engenty-wizards/shared/wizard-package";
 import { cleanPath, WORKSPACE_LIMITS } from "@engenty-wizards/shared/workspace";
 import { strFromU8, unzipSync } from "fflate";
@@ -6,13 +7,13 @@ import { ServiceError } from "./errors.js";
  * Reading a `.wizard` package, with nothing of a project or a database: the studio's import and
  * `wizards validate` both start here.
  */
-const invalid = (message) => new ServiceError("invalid", message);
+const invalid = (said) => new ServiceError("invalid", said);
 export function json(data) {
     try {
         return JSON.parse(strFromU8(data));
     }
     catch {
-        throw invalid("This is not a wizard package: wizard.json is not valid JSON.");
+        throw invalid(bilingual("Das ist keine Wizard-Datei: Die wizard.json darin lässt sich nicht lesen.", "This isn’t a wizard file: its wizard.json can’t be read."));
     }
 }
 /** A manifest, or a bare definition: a wizard without workspace is fully told by its JSON. */
@@ -22,7 +23,7 @@ export function readManifest(raw) {
     }
     const parsed = manifestSchema.safeParse(raw);
     if (!parsed.success) {
-        throw invalid("This wizard package comes from a newer version, or it is damaged.");
+        throw invalid(bilingual("Diese Wizard-Datei stammt aus einer neueren Version oder ist beschädigt. Aktualisiere engenty wizards oder exportiere den Wizard neu.", "This wizard file comes from a newer version, or it’s damaged. Update engenty wizards or export the wizard again."));
     }
     return parsed.data;
 }
@@ -45,24 +46,26 @@ export function readPackage(data) {
                 total += file.originalSize;
                 count += 1;
                 if (file.originalSize > WORKSPACE_LIMITS.fileBytes) {
-                    throw invalid(`${file.name} is larger than 5 MB.`);
+                    throw invalid(bilingual(`${file.name} ist größer als 5 MB.`, `${file.name} is larger than 5 MB.`));
                 }
                 if (count > WORKSPACE_LIMITS.files + 1 || total > PACKAGE_MAX_BYTES) {
-                    throw invalid("The package is larger than a workspace may be (200 files, 25 MB).");
+                    throw invalid(bilingual("Die Wizard-Datei ist zu groß: Ein Arbeitsbereich fasst höchstens 200 Dateien und 25 MB.", "The wizard file is too large: a workspace holds at most 200 files and 25 MB."));
                 }
                 return true;
             },
         });
     }
     catch (err) {
-        throw err instanceof ServiceError ? err : invalid("The package cannot be unpacked.");
+        throw err instanceof ServiceError
+            ? err
+            : invalid(bilingual("Die Wizard-Datei lässt sich nicht öffnen. Exportiere den Wizard neu und versuche es noch einmal.", "The wizard file can’t be opened. Export the wizard again and try once more."));
     }
     // A package unpacked and zipped again often sits in a folder of its own.
     const manifestPath = Object.keys(entries)
         .filter((name) => name === PACKAGE_MANIFEST || name.endsWith(`/${PACKAGE_MANIFEST}`))
         .sort((a, b) => a.length - b.length)[0];
     if (manifestPath === undefined) {
-        throw invalid("This is not a wizard package: wizard.json is missing.");
+        throw invalid(bilingual("Das ist keine Wizard-Datei: Die wizard.json fehlt.", "This isn’t a wizard file: wizard.json is missing."));
     }
     const root = manifestPath.slice(0, -PACKAGE_MANIFEST.length);
     const files = Object.entries(entries)
@@ -70,12 +73,12 @@ export function readPackage(data) {
         .map(([name, content]) => {
         const path = cleanPath(name.slice(root.length + PACKAGE_FILES.length));
         if (!path) {
-            throw invalid(`"${name}" is not a valid file path.`);
+            throw invalid(bilingual(`„${name}“ ist kein gültiger Dateipfad.`, `“${name}” isn’t a valid file path.`));
         }
         return { path, data: content };
     });
     if (files.reduce((n, f) => n + f.data.byteLength, 0) > WORKSPACE_LIMITS.totalBytes) {
-        throw invalid("The workspace in the package is larger than 25 MB.");
+        throw invalid(bilingual("Der Arbeitsbereich in der Wizard-Datei ist größer als 25 MB.", "The workspace in the wizard file is larger than 25 MB."));
     }
     return { manifest: readManifest(json(entries[manifestPath])), files };
 }

package/apps/runtime/dist/services/package.js

@@ -12,7 +12,7 @@ import { ownedProject } from "./projects.js";
 import { createWizard, deleteWizard, draftIssues, ownedWizard, parseDraft } from "./wizards.js";
 /** A wizard as a file — the format is `@engenty-wizards/shared/wizard-package`'s. */
 /** Where the project's pages go in a package, as Markdown the standalone runner reads inline. */
-export const KNOWLEDGE_DIR = "wissen/";
+export const KNOWLEDGE_DIR = "knowledge/";
 /** How much of the project's knowledge a package takes along: enough pages, never the whole space. */
 export const KNOWLEDGE_MAX_CHARS = 2_000_000;
 /** What one page may hold in the package (the plugin hands a file to the model up to there). */
@@ -151,8 +151,8 @@ lang = "en") {
             : `Imported${name ? ` from “${name}”` : ""}: ${draft.steps.length} steps, ${files.length} ${files.length === 1 ? "file" : "files"}.`,
         lacks.length
             ? de
-                ? `Diesem Projekt fehlt noch: ${lacks.join(", ")} – in den Einstellungen unter „Connectors“ hinzufügen.`
-                : `This project still lacks: ${lacks.join(", ")} – add it under “Connectors” in the settings.`
+                ? `Diesem Space fehlt noch: ${lacks.join(", ")}. Füge es unter Einstellungen → Connectors hinzu.`
+                : `This space still needs: ${lacks.join(", ")}. Add it under Settings → Connectors.`
             : "",
     ]
         .filter(Boolean)

package/apps/runtime/dist/services/project-files.js

@@ -28,7 +28,7 @@ export function fileView(row) {
         description: row.description,
         source: row.source,
         status: stale ? "failed" : row.status,
-        error: stale ? "Interrupted. Please read it in again." : row.error,
+        error: stale ? "Reading was interrupted. Read it in again." : row.error,
         indexed: row.indexed,
         pages: row.pages,
         chars: row.chars,
@@ -82,11 +82,11 @@ export async function addProjectFile(projectId, input) {
             ? bilingual("Ein Logo ist ein Bild (PNG, SVG, JPEG, WebP).", "A logo is an image (PNG, SVG, JPEG, WebP).")
             : input.kind === "pattern"
                 ? bilingual("Ein Muster ist ein Bild (SVG, PNG, JPEG, WebP).", "A pattern is an image (SVG, PNG, JPEG, WebP).")
-                : bilingual("Hierher gehören Bilder, Videos, Audio, PDFs, Schriften, Lottie und 3D-Modelle. Texte zum Nachschlagen bitte zu den Dokumenten.", "Images, videos, audio, PDFs, fonts, Lottie and 3D models belong here. Texts to look things up in go to the documents."));
+                : bilingual("Hierher gehören Bilder, Videos, Audio, PDFs, Schriften, Lottie und 3D-Modelle. Texte zum Nachschlagen gehören ins Wissen.", "Images, videos, audio, PDFs, fonts, Lottie and 3D models go here. Texts to look things up in go under knowledge."));
     }
     const limit = projectFileLimit(input.kind, mime);
     if (!input.data.byteLength || input.data.byteLength > limit) {
-        throw new ServiceError("invalid", bilingual(`Bitte eine Datei bis ${Math.round(limit / 1_000_000)} MB wählen.`, `Please choose a file of up to ${Math.round(limit / 1_000_000)} MB.`));
+        throw new ServiceError("invalid", bilingual(`Wähl eine Datei bis ${Math.round(limit / 1_000_000)} MB.`, `Choose a file of ${Math.round(limit / 1_000_000)} MB or less.`));
     }
     const scope = and(eq(schema.projectFile.projectId, projectId), eq(schema.projectFile.kind, input.kind));
     const [{ n, last }] = await db
@@ -94,7 +94,7 @@ export async function addProjectFile(projectId, input) {
         .from(schema.projectFile)
         .where(scope);
     if (n >= PROJECT_LIMITS.files[input.kind]) {
-        throw new ServiceError("refused", bilingual(`Höchstens ${PROJECT_LIMITS.files[input.kind]} Dateien.`, `At most ${PROJECT_LIMITS.files[input.kind]} files.`));
+        throw new ServiceError("refused", bilingual(`Hier haben höchstens ${PROJECT_LIMITS.files[input.kind]} Dateien Platz.`, `There’s room for at most ${PROJECT_LIMITS.files[input.kind]} files here.`));
     }
     const name = input.name.slice(0, 120) || "datei";
     const ref = await saveAsset({
@@ -150,15 +150,15 @@ export async function addProjectFileFromUrl(projectId, input) {
         headers: { "user-agent": "Mozilla/5.0 (compatible; engenty-wizards/0.1)" },
         signal: AbortSignal.any([AbortSignal.timeout(60_000), ...(signal ? [signal] : [])]),
     }).catch(() => {
-        throw new ServiceError("invalid", bilingual("Die Adresse ist nicht erreichbar.", "The address cannot be reached."));
+        throw new ServiceError("invalid", bilingual("Die Adresse ist nicht erreichbar.", "The address can’t be reached."));
     });
     if (!res.ok) {
-        throw new ServiceError("invalid", bilingual(`Die Adresse antwortete ${res.status}.`, `The address answered ${res.status}.`));
+        throw new ServiceError("invalid", bilingual(`Die Adresse antwortete mit ${res.status}.`, `The address responded with ${res.status}.`));
     }
     const mime = (res.headers.get("content-type") ?? "").split(";")[0].trim().toLowerCase();
     if (mime === "text/html" && kind !== "document") {
         await res.body?.cancel();
-        throw new ServiceError("invalid", bilingual("Unter der Adresse steht eine Webseite, kein Bild.", "The address holds a web page, not an image."), {
+        throw new ServiceError("invalid", bilingual("Unter der Adresse steht eine Webseite, kein Bild.", "The address leads to a web page, not an image."), {
             reason: "page",
             url: res.url,
         });
@@ -206,7 +206,7 @@ async function describeImage(row, data) {
         maxOutputTokens: 300,
         system: [
             "You catalogue the files of a project. Describe the picture in ONE sentence of at most 25 words: what it shows, its style and colours, and what it suits (a logo on dark ground, a header image, a team photo, a product shot).",
-            "Write in the language of the project's description; if unclear, German. No preamble, no quotes.",
+            "Write in the language of the project's description; if unclear, English. No preamble, no quotes.",
         ].join("\n"),
         messages: [
             {
@@ -237,7 +237,7 @@ async function describeDocument(row, text) {
     return result.text.trim().slice(0, 600);
 }
 /**
- * What a document became gets its Kategorien from a model, where the space has some: the first
+ * What a document became gets its categories from a model, where the space has some: the first
  * page or table it was read into, else the file itself.
  */
 async function categorize(row, items, text) {
@@ -248,7 +248,7 @@ async function categorize(row, items, text) {
             ? { tableId: first.slice(2) }
             : { fileId: row.id };
     const changed = await fillCategories(row.projectId, ref, text || row.description, row.name).catch((err) => {
-        console.error("[project-file] Kategorien", row.name, err);
+        console.error("[project-file] categories", row.name, err);
         return false;
     });
     if (changed) {
@@ -256,7 +256,7 @@ async function categorize(row, items, text) {
     }
 }
 /**
- * Reads a new file. A document is read into Wissen — a page, a page with sub-pages, a table per
+ * Reads a new file. A document is read into Knowledge — a page, a page with sub-pages, a table per
  * sheet — and stays as the original behind it; one that reads into nothing stays a file, found
  * by its name and description. A file nobody described is described.
  */
@@ -296,9 +296,7 @@ async function prepare(row) {
             console.error("[project-file]", row.name, err);
             await set({
                 status: "failed",
-                error: err instanceof UnreadableDocument
-                    ? err.message
-                    : "Reading did not work. Please try again.",
+                error: err instanceof UnreadableDocument ? err.message : "Reading didn’t work. Try again.",
             });
         }
     });
@@ -370,7 +368,7 @@ export async function removeProjectFiles(projectId) {
 }
 // --- what plugins keep as files ----------------------------------------------------
 /**
- * A plugin's file of Wissen (`server.spaceData.putFile`, or the original of a page it wrote):
+ * A plugin's file of Knowledge (`server.spaceData.putFile`, or the original of a page it wrote):
  * a document of the space under the plugin's key. The same key again replaces it. `text`: what
  * a step reads of it; without one only its name and description are found.
  */
@@ -382,7 +380,7 @@ export async function putOriginFile(origin, input) {
     });
     const mime = documentMime(input.name, input.mime) || "application/octet-stream";
     if (!input.data.byteLength || input.data.byteLength > projectFileLimit("document", mime)) {
-        throw new ServiceError("invalid", `"${input.name}" is empty or larger than a document may be.`);
+        throw new ServiceError("invalid", bilingual(`„${input.name}“ ist leer oder zu groß für ein Dokument.`, `“${input.name}” is empty or too large for a document.`));
     }
     const name = input.name.slice(0, 120) || "datei";
     const values = {
@@ -409,7 +407,7 @@ export async function putOriginFile(origin, input) {
             .from(schema.projectFile)
             .where(and(eq(schema.projectFile.projectId, input.space), eq(schema.projectFile.kind, "document")));
         if (n >= PROJECT_LIMITS.files.document) {
-            throw new ServiceError("refused", `A space keeps at most ${PROJECT_LIMITS.files.document} documents.`);
+            throw new ServiceError("refused", bilingual(`Ein Space hat höchstens ${PROJECT_LIMITS.files.document} Dokumente.`, `A space can have at most ${PROJECT_LIMITS.files.document} documents.`));
         }
         const ref = await saveAsset({ kind: "project", mime, name, data: input.data });
         id = ref.id;

package/apps/runtime/dist/services/project-index.js

@@ -159,7 +159,7 @@ async function indexPage(pageId) {
     const prefix = head(node?.titles ?? [page.title], lines);
     const sections = sectionsOf(page.markdown);
     const units = [];
-    // A page without text is still found by its title and Kategorien.
+    // A page without text is still found by its title and categories.
     for (const section of sections.length ? sections : [{ heading: [], sheet: null, body: "" }]) {
         // A page's own first heading is its title: the path says it already.
         const path = section.heading[0]?.toLowerCase() === page.title.toLowerCase()
@@ -244,7 +244,7 @@ async function indexFile(fileId) {
         .select({ heading: schema.projectChunk.heading, idx: schema.projectChunk.idx })
         .from(schema.projectChunk)
         .where(scope);
-    // Passages of a document read before Wissen had pages stay until it is read again.
+    // Passages of a document read before Knowledge had pages stay until it is read again.
     if (passages.some((p) => p.heading === null)) {
         return;
     }
@@ -279,7 +279,7 @@ async function indexValue(valueId) {
         valueId: value.id,
         heading: `${category.name}: ${value.value}`,
         idx: i,
-        text: `${category.name}: ${value.value} — Übersicht\n\n${part}`,
+        text: `${category.name}: ${value.value} — Summary\n\n${part}`,
     }));
     await writeUnits(scope, units);
 }
@@ -294,8 +294,8 @@ async function subPages(pageId) {
 }
 /**
  * Brings one item's units up to date. `p:` a page, `P:` a page and its sub-pages (its title or
- * Kategorien changed: they stand in theirs), `t:` a table's rows, `r:` one row, `f:` a file, `v:`
- * a value's Übersicht.
+ * categories changed: they stand in theirs), `t:` a table's rows, `r:` one row, `f:` a file, `v:`
+ * a value's summary.
  */
 export async function indexItem(key) {
     const id = key.slice(2);
@@ -423,7 +423,7 @@ export function trigramQuery(query) {
     return terms.length ? terms.join(" OR ") : null;
 }
 const COLUMNS = sql.raw("c.id, c.file_id, c.page_id, c.row_id, c.table_id, c.value_id, c.heading, c.sheet, c.plugin, c.ref, c.title, c.link, c.idx, c.text");
-/** A unit of the space's own Wissen, or of a plugin's text while the tenant has that plugin. */
+/** A unit of the space's own Knowledge, or of a plugin's text while the tenant has that plugin. */
 function searchable(plugins) {
     return plugins.length
         ? sql `(c.plugin IS NULL OR c.plugin IN (${sql.join(plugins.map((p) => sql `${p}`), sql `, `)}))`
@@ -465,7 +465,7 @@ function itemOf(u) {
     return `x:${u.plugin}:${u.ref}`;
 }
 /**
- * Searches Wissen: items whose Kategorien pass `where`, then the units the keywords, the
+ * Searches Knowledge: items whose categories pass `where`, then the units the keywords, the
  * trigrams and the vectors rank best, merged by rank (RRF), then the classifier's judgement of
  * each of the CANDIDATES best. Gives up to `limit` items with their best section. `check: false`
  * leaves the classifier out.
@@ -478,7 +478,7 @@ export async function searchKnowledge(projectId, query, opts = {}) {
     }
     const plugins = [...(await pluginIdsOf(currentTenant()))];
     const inFilter = filter ? filtered(filter) : null;
-    // A filter keeps plugins' texts and Übersichten out: they have no Kategorien.
+    // A filter keeps plugins' texts and summaries out: they have no categories.
     const where = and(sql `c.project_id = ${projectId}`, searchable(plugins), filter
         ? (inFilter ?? sql `(c.page_id IS NOT NULL OR c.row_id IS NOT NULL OR c.file_id IS NOT NULL)`)
         : undefined);
@@ -559,7 +559,7 @@ export async function searchKnowledge(projectId, query, opts = {}) {
         filtered: filter?.size ?? null,
     };
 }
-/** What a step and the studio see of each unit: the item's path, title and Kategorien. */
+/** What a step and the studio see of each unit: the item's path, title and categories. */
 async function describe(projectId, units) {
     const pageIds = [...new Set(units.flatMap((u) => (u.page_id ? [u.page_id] : [])))];
     const rowIds = [...new Set(units.flatMap((u) => (u.row_id ? [u.row_id] : [])))];
@@ -654,7 +654,7 @@ async function describe(projectId, units) {
                 kind: "summary",
                 open: `v:${u.value_id}`,
                 path: "",
-                title: `${category?.name}: ${value?.value} — Übersicht`,
+                title: `${category?.name}: ${value?.value} — Summary`,
                 categories: [],
             };
         }