wizards 0.4.4 → 0.4.6

package/apps/runtime/dist/agents/architect.js

@@ -53,7 +53,8 @@ HOW YOU WORK
 - Finish with one to three sentences to the admin: what you built or changed, and at most one suggestion. If they only asked a question, just answer it.`;
 }
 /** Turns a tool call into the line the admin sees while it runs. */
-function activity(tool, args) {
+function activity(tool, args, lang = "en") {
+    const de = lang === "de";
     const host = (u) => {
         try {
             return new URL(String(u)).hostname;
@@ -65,24 +66,42 @@ function activity(tool, args) {
     switch (tool) {
         case "replace_wizard":
         case "edit_wizard":
-            return "Baut den Ablauf …";
+            return de ? "Baut den Ablauf …" : "Building the flow …";
         case "write_file":
-            return args.path ? `Schreibt ${String(args.path)} …` : "Schreibt eine Datei …";
+            return args.path
+                ? de
+                    ? `Schreibt ${String(args.path)} …`
+                    : `Writing ${String(args.path)} …`
+                : de
+                    ? "Schreibt eine Datei …"
+                    : "Writing a file …";
         case "download_files":
-            return "Lädt Daten herunter …";
+            return de ? "Lädt Daten herunter …" : "Downloading data …";
         case "web_fetch":
-            return args.url ? `Liest ${host(args.url)} …` : "Liest im Web …";
+            return args.url
+                ? de
+                    ? `Liest ${host(args.url)} …`
+                    : `Reading ${host(args.url)} …`
+                : de
+                    ? "Liest im Web …"
+                    : "Reading the web …";
         case "web_search":
-            return "Sucht im Web …";
+            return de ? "Sucht im Web …" : "Searching the web …";
         case "check_widget":
-            return "Testet das Widget …";
+            return de ? "Testet das Widget …" : "Testing the widget …";
         case "run_script":
-            return args.output ? `Bereitet ${String(args.output)} vor …` : "Rechnet …";
+            return args.output
+                ? de
+                    ? `Bereitet ${String(args.output)} vor …`
+                    : `Preparing ${String(args.output)} …`
+                : de
+                    ? "Rechnet …"
+                    : "Calculating …";
         case "list_files":
         case "read_file":
-            return "Sieht sich die Dateien an …";
+            return de ? "Sieht sich die Dateien an …" : "Looking at the files …";
         case "delete_file":
-            return "Räumt Dateien auf …";
+            return de ? "Räumt Dateien auf …" : "Tidying up files …";
         default:
             return null;
     }
@@ -410,7 +429,7 @@ export async function runArchitect(input) {
         }
         else if (chunk.type === "tool-call-input-streaming-start") {
             streaming.set(payload.toolCallId, { tool: payload.toolName, args: "", named: false });
-            const label = activity(payload.toolName, {});
+            const label = activity(payload.toolName, {}, input.lang);
             if (label) {
                 input.onActivity?.(label);
             }
@@ -422,7 +441,7 @@ export async function runArchitect(input) {
                 const path = s.args.match(/"path"\s*:\s*"([^"]+)"/)?.[1];
                 if (path) {
                     s.named = true;
-                    const label = activity(s.tool, { path });
+                    const label = activity(s.tool, { path }, input.lang);
                     if (label) {
                         input.onActivity?.(label);
                     }
@@ -430,7 +449,7 @@ export async function runArchitect(input) {
             }
         }
         else if (chunk.type === "tool-call") {
-            const label = activity(payload.toolName, (payload.args ?? payload.input ?? {}));
+            const label = activity(payload.toolName, (payload.args ?? payload.input ?? {}), input.lang);
             if (label) {
                 input.onActivity?.(label);
             }

package/apps/runtime/dist/agents/subscription.js

@@ -38,18 +38,18 @@ const SYSTEM = (wizardId) => [
 ].join("\n");
 const BUILDING = /edit_wizard|write_wizard|write_file|delete_file|create_wizard/;
 const ACTIVITY = [
-    [/get_authoring_guide/, "Liest die Bauanleitung"],
-    [/get_starter|list_starters/, "Sieht sich eine Vorlage an"],
-    [/get_wizard|list_files|read_file/, "Liest den Wizard"],
-    [/write_file|delete_file/, "Schreibt Dateien"],
-    [/edit_wizard|write_wizard/, "Baut den Wizard um"],
-    [/check_widget|preview/, "Prüft das Widget"],
-    [/start_test_run|get_test_run/, "Testet den Wizard"],
-    [/find_connectors|import_connector/, "Sucht einen Dienst"],
+    [/get_authoring_guide/, { de: "Liest die Bauanleitung", en: "Reading the building guide" }],
+    [/get_starter|list_starters/, { de: "Sieht sich eine Vorlage an", en: "Looking at a template" }],
+    [/get_wizard|list_files|read_file/, { de: "Liest den Wizard", en: "Reading the wizard" }],
+    [/write_file|delete_file/, { de: "Schreibt Dateien", en: "Writing files" }],
+    [/edit_wizard|write_wizard/, { de: "Baut den Wizard um", en: "Rebuilding the wizard" }],
+    [/check_widget|preview/, { de: "Prüft das Widget", en: "Checking the widget" }],
+    [/start_test_run|get_test_run/, { de: "Testet den Wizard", en: "Testing the wizard" }],
+    [/find_connectors|import_connector/, { de: "Sucht einen Dienst", en: "Looking for a service" }],
 ];
 /** The activity for one tool call, naming the file or service it is about when it says. */
-function activity(name, args) {
-    const label = ACTIVITY.find(([re]) => re.test(name))?.[1] ?? "Arbeitet";
+function activity(name, args, lang = "en") {
+    const label = ACTIVITY.find(([re]) => re.test(name))?.[1][lang] ?? (lang === "de" ? "Arbeitet" : "Working");
     const about = [args.path, args.query].find((v) => typeof v === "string" && v.trim());
     return about ? `${label}: ${String(about)} …` : `${label} …`;
 }
@@ -129,7 +129,7 @@ export async function subscriptionTurn(input) {
         if (event.type === "stream_event") {
             const e = event.event ?? {};
             if (e.type === "content_block_start" && e.content_block?.type === "tool_use") {
-                input.onActivity(activity(String(e.content_block.name ?? ""), {}));
+                input.onActivity(activity(String(e.content_block.name ?? ""), {}, input.lang));
             }
             else if (e.type === "content_block_start" && e.content_block?.type === "thinking") {
                 thinking = "";
@@ -156,7 +156,7 @@ export async function subscriptionTurn(input) {
                         changed = true;
                         input.onBuilding();
                     }
-                    input.onActivity(activity(name, block.input ?? {}));
+                    input.onActivity(activity(name, block.input ?? {}, input.lang));
                 }
             }
         }

package/apps/runtime/dist/app.js

@@ -23,6 +23,7 @@ import { PLUGIN_NAME, pluginArchive, pluginMarketplace } from "./plugin.js";
 import { apiRoutes } from "./routes/api.js";
 import { browserReport, localDebugRoutes } from "./routes/debug.js";
 import { internalRoutes } from "./routes/internal.js";
+import { inLang, requestLang } from "./routes/lang.js";
 import { marketplaceStudio } from "./routes/marketplace.js";
 import { publicPluginRoutes } from "./routes/plugin-public.js";
 import { pluginRoutes } from "./routes/plugins.js";
@@ -40,16 +41,16 @@ const app = new Hono();
 const { serves } = env;
 app.onError((err, c) => {
     if (err instanceof ServiceError) {
-        return c.json(err.toJSON(), err.status);
+        return c.json(err.toJSON(requestLang(c)), err.status);
     }
     if (err instanceof ZodError) {
-        return c.json({ error: "Ungültige Eingabe", issues: err.issues }, 400);
+        return c.json({ error: inLang(c, "Ungültige Eingabe", "Invalid input"), issues: err.issues }, 400);
     }
     if (err instanceof HTTPException) {
         return err.getResponse();
     }
     console.error(err);
-    return c.json({ error: "Interner Fehler" }, 500);
+    return c.json({ error: inLang(c, "Interner Fehler", "Internal error") }, 500);
 });
 // --- who may talk to this server at all ---------------------------------------------
 // A runtime that runs alone listens on the loopback interface. A web page in the person's
@@ -203,7 +204,10 @@ if (serves.studio) {
             return c.json({ error: "unauthorized" }, 401);
         }
         if ((await tenantStatus(user.tenantId)) === "suspended") {
-            return c.json({ error: "Dieses Konto ist gesperrt.", code: "suspended" }, 403);
+            return c.json({
+                error: inLang(c, "Dieses Konto ist gesperrt.", "This account is suspended."),
+                code: "suspended",
+            }, 403);
         }
         c.set("user", user);
         return withTenant(user.tenantId, () => asRole(user.role, next));
@@ -220,7 +224,7 @@ if (serves.runner) {
 // answers are text; an upload is a photo, a recording or a clip from a phone (routes/delivery.ts).
 const tooLarge = (max) => bodyLimit({
     maxSize: max,
-    onError: (c) => c.json({ error: "Das ist zu groß.", code: "too_large" }, 413),
+    onError: (c) => c.json({ error: inLang(c, "Das ist zu groß.", "That is too large."), code: "too_large" }, 413),
 });
 const answers = tooLarge(4 * 1024 * 1024);
 const upload = tooLarge(48 * 1024 * 1024);

package/apps/runtime/dist/assistant/knows.js

@@ -8,7 +8,7 @@ import { db, schema } from "../db/client.js";
 import { env } from "../env.js";
 import { detectHarnesses } from "../harness/index.js";
 import { managed, publicPlans, tenantInfo, tenantUsage } from "../manage.js";
-import { classWays } from "../models.js";
+import { classWays, waysIn } from "../models.js";
 import { pluginToolsOf } from "../plugins/registry.js";
 import { earlierChats, readChat, searchChats } from "../services/assistant-chats.js";
 import { asLang, marketplaceDetail, searchMarketplace } from "../services/marketplace.js";
@@ -298,7 +298,7 @@ export function knowsTools(ctx) {
             execute: () => attempt(async () => {
                 ctx.doing(ctx.lang === "de" ? "Sieht die Modelle nach …" : "Looking up the models …");
                 return {
-                    classes: await classWays(),
+                    classes: waysIn(await classWays(), "en"),
                     clients: managed
                         ? []
                         : (await detectHarnesses()).map((h) => ({

package/apps/runtime/dist/authoring/example.js

@@ -4,29 +4,30 @@
  */
 export const EXAMPLE_WIZARD = {
     version: 1,
-    title: "X-Post mit Bild",
-    description: "Aus einem Thema wird ein fertiger Post mit Bild.",
+    title: "X post with an image",
+    description: "Turns a topic into a finished post with an image.",
     avatar: "flame",
-    intro: "Erzähl mir kurz, worum es geht – ich schreibe den Post und zeichne das Bild dazu.",
+    lang: "en",
+    intro: "Tell me briefly what it is about – I write the post and draw the image for it.",
     steps: [
         {
             id: "about",
             type: "page",
-            title: "Worum geht's?",
+            title: "What is it about?",
             fields: [
                 {
                     id: "topic",
-                    label: "Thema oder Anlass",
+                    label: "Topic or occasion",
                     kind: "textarea",
                     required: true,
-                    placeholder: "z. B. Wir eröffnen am Freitag unser neues Studio in Wien",
+                    placeholder: "e.g. We open our new studio in Vienna on Friday",
                 },
                 {
                     id: "tone",
-                    label: "Ton",
+                    label: "Tone",
                     kind: "select",
-                    options: ["Locker", "Professionell", "Witzig", "Inspirierend"],
-                    default: "Locker",
+                    options: ["Casual", "Professional", "Funny", "Inspiring"],
+                    default: "Casual",
                 },
                 { id: "link", label: "Link (optional)", kind: "url" },
             ],
@@ -34,9 +35,9 @@ export const EXAMPLE_WIZARD = {
         {
             id: "post",
             type: "agent",
-            title: "Post schreiben",
-            working: "Schreibt den Post …",
-            instructions: "Schreibe einen Post für X (Twitter) zum Thema: {{topic}}. Ton: {{tone}}. Höchstens 270 Zeichen inklusive Link und höchstens zwei Hashtags. Wenn ein Link angegeben ist ({{link}}), setze ihn ans Ende. Ein starker erster Satz. Nur den Post ausgeben.",
+            title: "Write the post",
+            working: "Writing the post …",
+            instructions: "Write a post for X (Twitter) on the topic: {{topic}}. Tone: {{tone}}. At most 270 characters including the link, and at most two hashtags. If a link is given ({{link}}), put it at the end. A strong first sentence. Output only the post.",
             tools: [],
             output: { format: "text" },
             model: "standard",
@@ -44,17 +45,17 @@ export const EXAMPLE_WIZARD = {
         {
             id: "visual",
             type: "generate",
-            title: "Bild zeichnen",
-            working: "Zeichnet das Bild …",
+            title: "Draw the image",
+            working: "Drawing the image …",
             asset: "image",
-            prompt: "Ein auffälliges Bild, das diesen Post begleitet: {{steps.post}}. Thema: {{topic}}. Kein Text im Bild.",
+            prompt: "A striking image to go with this post: {{steps.post}}. Topic: {{topic}}. No text in the image.",
             options: { aspectRatio: "16:9", style: "modern editorial, clean, high contrast" },
         },
         {
             id: "check",
             type: "review",
-            title: "Passt das so?",
-            description: "Du kannst den Text direkt ändern oder eine neue Variante anfordern.",
+            title: "Does this work?",
+            description: "You can change the text directly or ask for a new variant.",
             show: ["post", "visual"],
             edit: true,
             regenerate: true,
@@ -62,11 +63,11 @@ export const EXAMPLE_WIZARD = {
         {
             id: "done",
             type: "result",
-            title: "Fertig zum Posten",
-            message: "Kopiere den Text und lade das Bild herunter.",
+            title: "Ready to post",
+            message: "Copy the text and download the image.",
             deliverables: [
                 { from: "post", label: "Post", formats: ["txt", "md"] },
-                { from: "visual", label: "Bild", formats: ["png"] },
+                { from: "visual", label: "Image", formats: ["png"] },
             ],
         },
     ],

package/apps/runtime/dist/authoring/guide.js

@@ -13,6 +13,7 @@ type Wizard = {
   description: string           // one sentence
   avatar: "round"|"drop"|"dome"|"flame"|"oval"|"bean"|"pebble"|"sprout"|"tower"|"wedge"  // the engenty mascot shown to end users
   intro?: string                // one friendly sentence above the first page
+  lang?: "en"|"de"              // the language the wizard's texts are in — ALWAYS set it to the language you write them in
   lists?: List[]                // tabular data the wizard KEEPS between runs — separately for each person who runs it, or for all with "shared"
   connections?: Connection[]    // accounts the PERSON connects during a run (their mailbox); kept for their next run
   steps: Step[]                 // run top to bottom; the LAST step is always a "result"
@@ -148,7 +149,8 @@ type AgentStep = {
   working?: string              // shown while it runs ("Recherchiert im Web …")
 }
 // Every agent step also has, without listing them: list_read / list_write (the wizard's lists), files_list,
-//   read_document (PDF, scans and photos, Word, Excel, CSV, saved mails) and scan_documents (invoice / receipt fields, many at once);
+//   read_document (PDF, scans and photos, Word, Excel, CSV, saved mails) and scan_documents (invoice / receipt fields, many at once)
+//   — on an installed client only where there is something to read: tools or connections, uploads, lists or kept files;
 //   and where the space has Wissen: project_search (a question, "where" on its typed Kategorien, hits checked for relevance),
 //   project_list (by Kategorien), page_read / table_read / project_document (an item whole, by its path).
 // "pages" brings: page_read / page_write — Markdown pages of the space the wizard keeps for every run (notes, a log
@@ -249,7 +251,7 @@ Templates (in instructions/prompt): {{fieldId}} · {{steps.stepId}} (whole outpu
 A template may only use fields asked and steps run EARLIER.`;
 export const PRINCIPLES = `
 How good wizards look:
-- For non-technical end users. Plain words, friendly titles phrased as questions ("Wofür ist der Post?").
+- For non-technical end users. Plain words, friendly titles phrased as questions ("What is the post for?").
 - A page whose fields depend on an earlier answer uses "when" on its fields, never one copy of the page per answer and a branch to each copy. Choices that depend on what an earlier step found use "optionsFrom", never one page per possible result.
 - Few pages, 1–5 fields each, one theme per page. Only ask what the result really needs; prefer selects with sensible defaults.
 - Put a review step before anything expensive (video) and before the final result, so people can correct or regenerate.

package/apps/runtime/dist/connectors/imap.js

@@ -240,12 +240,12 @@ export const imapConnector = {
         kind: "api_key",
         apiKey: {
             fields: [
-                { key: "email", label: "E-Mail-Adresse", placeholder: "name@firma.at" },
-                { key: "password", label: "Passwort oder App-Passwort", secret: true },
+                { key: "email", label: "Email address", placeholder: "name@company.com" },
+                { key: "password", label: "Password or app password", secret: true },
                 {
                     key: "host",
-                    label: "IMAP-Server",
-                    placeholder: "leer lassen bei Gmail, GMX, iCloud …",
+                    label: "IMAP server",
+                    placeholder: "leave empty for Gmail, GMX, iCloud …",
                     required: false,
                 },
                 { key: "port", label: "Port", placeholder: "993", required: false },

package/apps/runtime/dist/connectors/index.js

@@ -1,8 +1,10 @@
+import { bilingual } from "@engenty-wizards/shared/run";
 import { eq } from "drizzle-orm";
 import { db, schema } from "../db/client.js";
 import { buildAuthorizationUrl, createOAuth2Pkce, exchangeAuthorizationCode, refreshAccessToken, } from "../engenty/connections-sdk/oauth2.js";
 import { scopesForGroups, } from "../engenty/connections-sdk/types.js";
 import { env } from "../env.js";
+import { NotedError } from "../model-errors.js";
 import { seal, unseal } from "../secrets/crypto.js";
 import { deleteSecret, getSecret, putSecret } from "../store/index.js";
 import { connectorFetch, MAIL_CONNECTORS, resolveEnv, usable, viaAccount } from "./builtin.js";
@@ -11,7 +13,18 @@ import { AccountConnectError, redeemTicket, refreshThroughAccount, startThroughA
 /** The connectors a person can pick for each kind of connection. */
 const CONNECTORS = { mail: MAIL_CONNECTORS };
 const HINTS = {
-    imap: "Bei Gmail, iCloud, GMX und web.de brauchst du ein App-Passwort (in den Sicherheitseinstellungen deines Kontos), nicht dein normales Passwort.",
+    imap: {
+        de: "Bei Gmail, iCloud, GMX und web.de brauchst du ein App-Passwort (in den Sicherheitseinstellungen deines Kontos), nicht dein normales Passwort.",
+        en: "Gmail, iCloud, GMX and web.de need an app password (in your account's security settings), not your normal password.",
+    },
+};
+/** The built-in connectors' fields in German; their definitions say them in English. */
+const GERMAN_FIELDS = {
+    imap: {
+        email: { label: "E-Mail-Adresse", placeholder: "name@firma.at" },
+        password: { label: "Passwort oder App-Passwort" },
+        host: { label: "IMAP-Server", placeholder: "leer lassen bei Gmail, GMX, iCloud …" },
+    },
 };
 /**
  * What a connection asks the provider for: what reading needs, plus what each action the wizard
@@ -43,7 +56,7 @@ async function candidates(connection, projectId) {
     }
     return connection.kind ? CONNECTORS[connection.kind] : [];
 }
-export async function connectorOptions(connection, projectId) {
+export async function connectorOptions(connection, projectId, lang = "en") {
     const out = [];
     for (const c of await candidates(connection, projectId)) {
         if (!(await usable(c))) {
@@ -54,8 +67,10 @@ export async function connectorOptions(connection, projectId) {
                 id: c.id,
                 name: c.name,
                 auth: "api_key",
-                fields: c.auth.apiKey.fields,
-                hint: HINTS[c.id],
+                fields: lang === "de"
+                    ? c.auth.apiKey.fields.map((f) => ({ ...f, ...GERMAN_FIELDS[c.id]?.[f.key] }))
+                    : c.auth.apiKey.fields,
+                hint: HINTS[c.id]?.[lang],
             }
             : { id: c.id, name: c.name, auth: "oauth2" });
     }
@@ -68,7 +83,9 @@ async function connectorFor(connection, connectorId, projectId) {
     }
     return connector;
 }
-export async function connectionViews(connections, scope, projectId) {
+export async function connectionViews(connections, scope, projectId, 
+/** The language the person reads the connectors' fields in. */
+lang = "en") {
     return Promise.all(connections.map(async (c) => {
         const stored = await getSecret(scope, slot(c.id));
         const only = c.connector ? (await candidates(c, projectId))[0] : undefined;
@@ -87,11 +104,11 @@ export async function connectionViews(connections, scope, projectId) {
                 : only && open(only)
                     ? { connector: only.id, label: only.name, connectedAt: new Date(0).toISOString() }
                     : null,
-            connectors: await connectorOptions(c, projectId),
+            connectors: await connectorOptions(c, projectId, lang),
         };
     }));
 }
-export async function startOAuth(scope, projectId, runId, connection, connectorId) {
+export async function startOAuth(scope, projectId, runId, connection, connectorId, lang) {
     const connector = await connectorFor(connection, connectorId, projectId);
     if (connector.auth.kind !== "oauth2") {
         throw new Error(`${connector.name} is not connected by signing in.`);
@@ -106,6 +123,7 @@ export async function startOAuth(scope, projectId, runId, connection, connectorI
             connectorId,
             verifier: "",
             exp: Date.now() + 15 * 60_000,
+            lang,
         };
         try {
             return await startThroughAccount(scopesFor(connection, connector), seal(state), connectRedirectUri());
@@ -125,6 +143,7 @@ export async function startOAuth(scope, projectId, runId, connection, connectorI
         connectorId,
         verifier: pkce.codeVerifier,
         exp: Date.now() + 15 * 60_000,
+        lang,
     };
     return buildAuthorizationUrl({
         connector,
@@ -135,6 +154,11 @@ export async function startOAuth(scope, projectId, runId, connection, connectorI
         resolveEnv,
     });
 }
+/** The language a sign-in was started in, a wizard's or a plugin's; null where it names none. */
+export function oauthStateLang(rawState) {
+    const lang = unseal(rawState)?.lang;
+    return lang === "de" || lang === "en" ? lang : null;
+}
 /** The run an OAuth callback belongs to; its tenant is looked up before the state is used. */
 export function oauthStateRun(rawState) {
     return unseal(rawState)?.runId ?? null;
@@ -146,7 +170,7 @@ export function oauthStateRun(rawState) {
 export async function finishOAuth(answer, rawState) {
     const state = unseal(rawState);
     if (!state || state.exp < Date.now()) {
-        throw new Error("Die Anmeldung ist abgelaufen. Bitte noch einmal verbinden.");
+        throw new Error("The sign-in has expired. Please connect again.");
     }
     const run = await db.query.run.findFirst({ where: eq(schema.run.id, state.runId) });
     const connection = run?.definition.connections?.find((c) => c.id === state.connectionId);
@@ -190,7 +214,7 @@ export async function connectWithCredentials(scope, projectId, connection, conne
     for (const field of connector.auth.apiKey.fields) {
         const value = String(values[field.key] ?? "").trim();
         if (!value && field.required !== false) {
-            throw new ConnectError(`„${field.label}“ fehlt.`);
+            throw new ConnectError(bilingual(`„${field.label}“ fehlt.`, `“${field.label}” is missing.`));
         }
         if (value) {
             credentials[field.key] = value.slice(0, 500);
@@ -213,22 +237,23 @@ export async function connectWithCredentials(scope, projectId, connection, conne
     return account.label;
 }
 /** A connect attempt the person can fix (wrong password, unknown server). */
-export class ConnectError extends Error {
+export class ConnectError extends NotedError {
 }
 function connectFailure(err) {
     const e = err;
     const host = e.imapHost ? ` (${e.imapHost})` : "";
     if (e.authenticationFailed) {
-        const server = e.responseText ? ` Antwort des Servers: ${e.responseText.slice(0, 160)}` : "";
-        return `Anmeldung abgelehnt${host}. Stimmen Adresse und (App-)Passwort? Bei Gmail und Google Workspace braucht es ein App-Passwort und aktiviertes IMAP.${server}`;
+        const answer = e.responseText?.slice(0, 160);
+        return bilingual(`Anmeldung abgelehnt${host}. Stimmen Adresse und (App-)Passwort? Bei Gmail und Google Workspace braucht es ein App-Passwort und aktiviertes IMAP.${answer ? ` Antwort des Servers: ${answer}` : ""}`, `Sign-in refused${host}. Are the address and (app) password right? Gmail and Google Workspace need an app password and IMAP switched on.${answer ? ` The server answered: ${answer}` : ""}`);
     }
     if (e.code === "ENOTFOUND") {
-        return `Den Mail-Server${host} gibt es nicht. Bitte den IMAP-Server eintragen, bei Gmail und Google Workspace imap.gmail.com.`;
+        return bilingual(`Den Mail-Server${host} gibt es nicht. Bitte den IMAP-Server eintragen, bei Gmail und Google Workspace imap.gmail.com.`, `The mail server${host} does not exist. Please enter the IMAP server; for Gmail and Google Workspace it is imap.gmail.com.`);
     }
     if (e.code === "ETIMEDOUT" || e.code === "ETIMEOUT" || e.code === "ECONNREFUSED") {
-        return `Der Mail-Server${host} antwortet nicht. Bitte IMAP-Server und Port prüfen.`;
+        return bilingual(`Der Mail-Server${host} antwortet nicht. Bitte IMAP-Server und Port prüfen.`, `The mail server${host} does not answer. Please check the IMAP server and port.`);
     }
-    return `Verbinden hat nicht geklappt${host}: ${String(e.message ?? err).slice(0, 200)}`;
+    const detail = String(e.message ?? err).slice(0, 200);
+    return bilingual(`Verbinden hat nicht geklappt${host}: ${detail}`, `Connecting did not work${host}: ${detail}`);
 }
 export function disconnect(scope, connectionId) {
     return deleteSecret(scope, slot(connectionId));

package/apps/runtime/dist/connectors/plugin-connections.js

@@ -101,7 +101,7 @@ export function pluginStateTenant(rawState) {
 export async function finishPluginOAuth(answer, rawState) {
     const state = unseal(rawState);
     if (!state?.plugin || state.exp < Date.now()) {
-        throw new Error("Die Anmeldung ist abgelaufen. Bitte noch einmal verbinden.");
+        throw new Error("The sign-in has expired. Please connect again.");
     }
     const connector = oauthConnector(state.connectorId);
     if (connector.auth.kind !== "oauth2") {
@@ -222,7 +222,7 @@ export function pluginConnections(plugin) {
             }
             return out;
         },
-        async start({ space, connector: connectorId, actions }) {
+        async start({ space, connector: connectorId, actions, lang }) {
             const connector = oauthConnector(connectorId);
             if (connector.auth.kind !== "oauth2") {
                 throw new Error("not an oauth connector");
@@ -236,6 +236,7 @@ export function pluginConnections(plugin) {
                 connectorId,
                 actions: [...new Set(actions)],
                 exp: Date.now() + 15 * 60_000,
+                lang,
             };
             if (await viaAccount(connector)) {
                 // The Manage-App keeps the PKCE verifier; ours stays empty.

package/apps/runtime/dist/connectors/via-account.js

@@ -1,5 +1,7 @@
+import { bilingual } from "@engenty-wizards/shared/run";
 import { accountToken } from "../auth/account.js";
 import { env } from "../env.js";
+import { NotedError } from "../model-errors.js";
 /*
  * Google accounts on a local install without an OAuth client of its own: the Manage-App of the
  * linked account runs the consent at Google with its client and hands the tokens over, and
@@ -7,7 +9,7 @@ import { env } from "../env.js";
  */
 const base = () => `${env.local.accountUrl}/v1/connect`;
 /** Something the person can mend or retry; the message is for them. */
-export class AccountConnectError extends Error {
+export class AccountConnectError extends NotedError {
 }
 let offered = null;
 /** Whether the Manage-App connects Google accounts; asked at most every ten minutes. */
@@ -24,7 +26,7 @@ export async function googleThroughAccount() {
 async function call(path, body) {
     const token = await accountToken();
     if (!token) {
-        throw new AccountConnectError("Verbinde zuerst dein engenty-Konto (Einstellungen → Konto), dann lässt sich Google hier verbinden.");
+        throw new AccountConnectError(bilingual("Verbinde zuerst dein engenty-Konto (Einstellungen → Konto), dann lässt sich Google hier verbinden.", "Connect your engenty account first (Settings → Account); then Google can be connected here."));
     }
     const res = await fetch(`${base()}${path}`, {
         method: "POST",
@@ -33,15 +35,15 @@ async function call(path, body) {
         signal: AbortSignal.timeout(20_000),
     }).catch(() => null);
     if (!res) {
-        throw new AccountConnectError("Dein engenty-Konto ist gerade nicht erreichbar. Bitte später noch einmal.");
+        throw new AccountConnectError(bilingual("Dein engenty-Konto ist gerade nicht erreichbar. Bitte später noch einmal.", "Your engenty account cannot be reached right now. Please try again later."));
     }
     const data = (await res.json().catch(() => ({})));
     if (!res.ok) {
         throw new AccountConnectError(data.code === "invalid_grant"
-            ? "Google nimmt diese Verbindung nicht mehr an. Bitte das Konto neu verbinden."
+            ? bilingual("Google nimmt diese Verbindung nicht mehr an. Bitte das Konto neu verbinden.", "Google no longer accepts this connection. Please connect the account again.")
             : data.code === "not_configured"
-                ? "Google lässt sich über dein engenty-Konto gerade nicht verbinden."
-                : `Verbinden über dein engenty-Konto hat nicht geklappt (${data.code ?? res.status}).`);
+                ? bilingual("Google lässt sich über dein engenty-Konto gerade nicht verbinden.", "Google cannot be connected through your engenty account right now.")
+                : bilingual(`Verbinden über dein engenty-Konto hat nicht geklappt (${data.code ?? res.status}).`, `Connecting through your engenty account did not work (${data.code ?? res.status}).`));
     }
     return data;
 }

package/apps/runtime/dist/docs/dev/plugins/connections.md

@@ -29,7 +29,7 @@ const { events } = await server.connections.call<{ events: unknown[] }>(account.
 | `server.connections.` | Does |
 |---|---|
 | `available(ids)` | Of these connector ids, the ones a person can connect here now: `{ id, name, auth }`, and for `auth: "api_key"` the `fields` to ask for (`key`, `label`, `placeholder`, `required`, `secret`). An OAuth connector is offered once its client is set up (`GOOGLE_OAUTH_CLIENT_ID` …), and on a local install Google also through the linked account; a connector that takes keys (HubSpot, S3) always |
-| `start({ space, connector, actions })` | An OAuth connector: the provider's sign-in page. Only the rights `actions` need are asked for |
+| `start({ space, connector, actions, lang? })` | An OAuth connector: the provider's sign-in page. Only the rights `actions` need are asked for. `lang` (`"en"` or `"de"`) is the language of the page the person comes back to; without it, their browser's |
 | `connect({ space, connector, actions, credentials })` | A connector that takes keys: the keys by field key, tried once at the provider, then kept sealed. Keys the provider refuses throw an error with the status `400` and the code `credentials`, whose message says what was wrong. Answers the connection |
 | `list(space)`, `get(id)` | What is connected: `{ id, space, connector, label, actions, createdAt }`, the newest first. `label` is the account as the provider names it |
 | `call(id, action, input)` | Runs one of the connector's actions with the account. A fresh token is fetched first when the old one runs out |

package/apps/runtime/dist/docs/dev/plugins/reference.md

@@ -1,7 +1,7 @@
 ---
 title: Reference
 description: Every call, type, address and setting of the plugin framework on one page.
-version: 0.4.3
+version: 0.4.4
 ---
 
 ## Server half
@@ -43,7 +43,7 @@ The default export is a `WizardsPluginFactory`: `(wizards: WizardsPluginApi) =>
 | `publicRef(): Promise<string>` | [Routes](./routes.md#shared-routes). The part of `publicUrl` that names the current tenant |
 | `registerSharedRoute(route: PluginSharedRoute)` | [Routes](./routes.md#shared-routes). One route for every tenant; `handler({ request, path, params, query, inTenant })` |
 | `sharedUrl(path): string` | The full address of a shared route, the same for every tenant |
-| `channels.get()`, `.request({ userId, country, wish?, lang })`, `.withdraw()`, `.book({ kind, quantity, key, runId? })` | [Numbers of the Manage-App](./server.md#numbers-of-the-manage-app). `get`: `{ number, request, shared }` or `null` without a Manage-App |
+| `channels.get()`, `.request({ userId, country, wish?, lang })`, `.withdraw()`, `.book({ kind, quantity, key, runId? })` | [Numbers of the Manage-App](./server.md#numbers-of-the-manage-app). `get`: `{ number, request, shared, allowed }` or `null` without a Manage-App |
 | `registerMigrations(folder: string)` | [Tables](./tables.md). The folder is relative to the plugin's |
 | `on(event, listener)` | [Events](./events.md). `event`: `"run.done"`, `"run.failed"`, `"run.cancelled"`, `"space.created"`, `"space.updated"`, `"space.deleted"`, `"space.file.ready"`, `"space.file.removed"` |
 | `every(name, everyMs, handler)` | [Jobs](./server.md#jobs). Per tenant that has the plugin, at most once per `everyMs` (a minute at least). `handler({ tenantId, lastRun, signal })` |
@@ -243,6 +243,7 @@ The default export is a `StudioPlugin`: `(studio: StudioPluginContext) => void`.
 | `studio.registerNav({ to, label, icon })` | An icon in the app bar. `label: () => string` |
 | `studio.registerSettingsSection({ id, label, icon, component, menu? })` | A section at `/studio/settings/<id>` |
 | `studio.registerShareSection({ runner, component })` | [Runners](./runners.md#the-runners-part-of-the-share-dialog). The runner's own settings for a wizard (a keyword), under the share dialog's gear once it is switched on and set up. `component` gets `{ wizard: { id, title } }` |
+| `studio.registerShareSetup({ runner, title, component, notice? })` | [Runners](./runners.md#setting-up-inside-the-dialog). What "Einrichten" in the runner's row opens inside the share dialog. `component` gets `{ wizard, Actions, done(banner?) }`, `notice` `{ wizard, open }` |
 | `studio.registerAssistantCard({ tool, component })` | Draws a tool's result in the space assistant's chat. `component` gets `{ data, send }` |
 | `studio.registerSpaceSection({ id, group?, label, hint?, component })` | A section of a part of the space page at `/studio/space/<group>#<id>`; `group`: `info`, `knowledge` (default), `data` or `results` |
 | `studio.registerSpacePart({ id, label, icon, after?, component })` | [A part of the plugin's own](./studio.md#a-part-of-the-plugins-own) at `/studio/space/<id>`, after `info`, `knowledge` or `data` (default) in the menu |