wizards 0.5.7 → 0.5.8

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

@@ -15,6 +15,7 @@ import { deleteFile, listFiles, readFileText, writeFile } from "../services/file
 import { checkDraftWidget } from "../services/widgets.js";
 import { editWizard, ownedWizard, writeDraft } from "../services/wizards.js";
 import { currentTenant } from "../tenants/tenant.js";
+import { serverText } from "../texts.js";
 import { assertPublicUrl, safeFetch } from "../tools/net-guard.js";
 import { runScript } from "../widgets/script.js";
 import { thoughtLine } from "./thought.js";
@@ -54,7 +55,7 @@ HOW YOU WORK
 }
 /** Turns a tool call into the line the admin sees while it runs. */
 function activity(tool, args, lang = "en") {
-    const de = lang === "de";
+    const say = (key, params) => serverText(lang, key, params);
     const host = (u) => {
         try {
             return new URL(String(u)).hostname;
@@ -66,42 +67,28 @@ function activity(tool, args, lang = "en") {
     switch (tool) {
         case "replace_wizard":
         case "edit_wizard":
-            return de ? "Baut den Ablauf …" : "Building the flow …";
+            return say("doingFlow");
         case "write_file":
             return args.path
-                ? de
-                    ? `Schreibt ${String(args.path)} …`
-                    : `Writing ${String(args.path)} …`
-                : de
-                    ? "Schreibt eine Datei …"
-                    : "Writing a file …";
+                ? say("doingWriteFile", { path: String(args.path) })
+                : say("doingWriteAFile");
         case "download_files":
-            return de ? "Lädt Daten herunter …" : "Downloading data …";
+            return say("doingDownload");
         case "web_fetch":
-            return args.url
-                ? de
-                    ? `Liest ${host(args.url)} …`
-                    : `Reading ${host(args.url)} …`
-                : de
-                    ? "Liest im Web …"
-                    : "Reading the web …";
+            return args.url ? say("doingReadSite", { host: host(args.url) }) : say("doingReadWeb");
         case "web_search":
-            return de ? "Sucht im Web …" : "Searching the web …";
+            return say("doingWebSearch");
         case "check_widget":
-            return de ? "Testet das Widget …" : "Testing the widget …";
+            return say("doingTestWidget");
         case "run_script":
             return args.output
-                ? de
-                    ? `Bereitet ${String(args.output)} vor …`
-                    : `Preparing ${String(args.output)} …`
-                : de
-                    ? "Rechnet …"
-                    : "Calculating …";
+                ? say("doingPrepare", { output: String(args.output) })
+                : say("doingCalculate");
         case "list_files":
         case "read_file":
-            return de ? "Sieht sich die Dateien an …" : "Looking at the files …";
+            return say("doingLookFiles");
         case "delete_file":
-            return de ? "Räumt Dateien auf …" : "Tidying up files …";
+            return say("doingTidyFiles");
         default:
             return null;
     }

package/apps/runtime/dist/agents/studio-assistant.js

@@ -15,6 +15,7 @@ import { documentText } from "../services/project-index.js";
 import { ownedProject, updateProject } from "../services/projects.js";
 import { categoryRows } from "../services/space-categories.js";
 import { currentTenant } from "../tenants/tenant.js";
+import { serverText } from "../texts.js";
 import { assistantPageOf, assistantToolsOf } from "../tools/plugin.js";
 import { readWebsite } from "./website.js";
 /** How a message written meanwhile reaches the model. */
@@ -60,19 +61,19 @@ HOW YOU WORK
 - Call independent tools together. Work in few steps.
 - Finish with one to three sentences: what you did or found, what is still open, and at most one question.`;
 const LABELS = {
-    save_logo: { de: "Holt das Logo …", en: "Fetching the logo …" },
-    save_file: { de: "Holt eine Datei …", en: "Fetching a file …" },
-    set_logo_sections: { de: "Ordnet die Logos …", en: "Grouping the logos …" },
-    set_asset_sections: { de: "Ordnet die Assets …", en: "Grouping the assets …" },
-    set_typography: { de: "Trägt die Schriften ein …", en: "Entering the fonts …" },
-    set_gradients: { de: "Trägt die Verläufe ein …", en: "Entering the gradients …" },
-    set_rules: { de: "Trägt Regeln ein …", en: "Entering rules …" },
-    set_profile: { de: "Schreibt Titel und Beschreibung …", en: "Writing title and description …" },
-    set_facts: { de: "Trägt Fakten ein …", en: "Entering facts …" },
-    set_colors: { de: "Trägt die Farben ein …", en: "Entering the colours …" },
-    look_at_file: { de: "Sieht sich eine Datei an …", en: "Looking at a file …" },
-    describe_file: { de: "Beschreibt eine Datei …", en: "Describing a file …" },
-    web_search: { de: "Sucht im Web …", en: "Searching the web …" },
+    save_logo: "doingSaveLogo",
+    save_file: "doingSaveFile",
+    set_logo_sections: "doingSetLogoSections",
+    set_asset_sections: "doingSetAssetSections",
+    set_typography: "doingSetTypography",
+    set_gradients: "doingSetGradients",
+    set_rules: "doingSetRules",
+    set_profile: "doingSetProfile",
+    set_facts: "doingSetFacts",
+    set_colors: "doingSetColors",
+    look_at_file: "doingLookAtFile",
+    describe_file: "doingDescribeFile",
+    web_search: "doingWebSearch",
 };
 function activity(tool, args, lang) {
     const host = (u) => {
@@ -85,20 +86,16 @@ function activity(tool, args, lang) {
     };
     if (tool === "read_website") {
         const at = args.url ? host(args.url) : "";
-        return lang === "de"
-            ? at
-                ? `Liest ${at} …`
-                : "Liest die Website …"
-            : at
-                ? `Reading ${at} …`
-                : "Reading the website …";
+        return at
+            ? serverText(lang, "doingReadSite", { host: at })
+            : serverText(lang, "doingReadWebsite");
     }
     const key = tool === "save_file" && args.kind === "logo"
         ? "save_logo"
         : tool === "remove_facts"
             ? "set_facts"
             : tool;
-    return LABELS[key]?.[lang] ?? null;
+    return LABELS[key] ? serverText(lang, LABELS[key]) : null;
 }
 async function attempt(run) {
     try {
@@ -886,7 +883,7 @@ export async function runStudioAssistant(input) {
         else if (chunk.type === "tool-call") {
             // The model's own search has no tool of ours that could say so.
             if (payload.toolName === "web_search") {
-                input.onActivity?.(LABELS.web_search[input.lang]);
+                input.onActivity?.(serverText(input.lang, LABELS.web_search));
             }
             // Keep what it says before and after a tool call apart.
             if (reply.trim() && !reply.endsWith("\n\n")) {

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

@@ -9,6 +9,7 @@ import { detectHarness, signedOut } from "../harness/index.js";
 import { localModelSettings } from "../models.js";
 import { ServiceError } from "../services/errors.js";
 import { deleteSetting, readSetting, writeSetting } from "../settings.js";
+import { serverText } from "../texts.js";
 import { thoughtLine } from "./thought.js";
 /** The AI clients installed on this machine whose subscription can answer the studio chat. */
 export async function subscriptionClients() {
@@ -38,18 +39,18 @@ const SYSTEM = (wizardId) => [
 ].join("\n");
 const BUILDING = /edit_wizard|write_wizard|write_file|delete_file|create_wizard/;
 const ACTIVITY = [
-    [/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" }],
+    [/get_authoring_guide/, "doingGuide"],
+    [/get_starter|list_starters/, "doingTemplate"],
+    [/get_wizard|list_files|read_file/, "doingReadWizard"],
+    [/write_file|delete_file/, "doingWriteFiles"],
+    [/edit_wizard|write_wizard/, "doingRebuild"],
+    [/check_widget|preview/, "doingCheckWidget"],
+    [/start_test_run|get_test_run/, "doingTestWizard"],
+    [/find_connectors|import_connector/, "doingFindService"],
 ];
 /** The activity for one tool call, naming the file or service it is about when it says. */
 function activity(name, args, lang = "en") {
-    const label = ACTIVITY.find(([re]) => re.test(name))?.[1][lang] ?? (lang === "de" ? "Arbeitet" : "Working");
+    const label = serverText(lang, ACTIVITY.find(([re]) => re.test(name))?.[1] ?? "doingWork");
     const about = [args.path, args.query].find((v) => typeof v === "string" && v.trim());
     return about ? `${label}: ${String(about)} …` : `${label} …`;
 }

package/apps/runtime/dist/app.js

@@ -23,7 +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, notFoundAnswer, requestLang } from "./routes/lang.js";
+import { notFoundAnswer, requestLang, say } from "./routes/lang.js";
 import { marketplaceGuest, marketplaceStudio } from "./routes/marketplace.js";
 import { publicPluginRoutes } from "./routes/plugin-public.js";
 import { pluginRoutes } from "./routes/plugins.js";
@@ -44,13 +44,13 @@ app.onError((err, c) => {
         return c.json(err.toJSON(requestLang(c)), err.status);
     }
     if (err instanceof ZodError) {
-        return c.json({ error: inLang(c, "Ungültige Eingabe", "Invalid input"), issues: err.issues }, 400);
+        return c.json({ error: say(c, "invalidInput"), issues: err.issues }, 400);
     }
     if (err instanceof HTTPException) {
         return err.getResponse();
     }
     console.error(err);
-    return c.json({ error: inLang(c, "Interner Fehler", "Internal error") }, 500);
+    return c.json({ error: say(c, "internalError") }, 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
@@ -202,13 +202,13 @@ if (serves.studio) {
         const user = await principalOf(c);
         if (!user) {
             return c.json({
-                error: inLang(c, "Du bist nicht angemeldet.", "You’re not signed in."),
+                error: say(c, "notSignedIn"),
                 code: "unauthorized",
             }, 401);
         }
         if ((await tenantStatus(user.tenantId)) === "suspended") {
             return c.json({
-                error: inLang(c, "Dieses Konto ist gesperrt.", "This account is suspended."),
+                error: say(c, "accountSuspended"),
                 code: "suspended",
             }, 403);
         }
@@ -227,7 +227,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: inLang(c, "Das ist zu groß.", "That is too large."), code: "too_large" }, 413),
+    onError: (c) => c.json({ error: say(c, "tooLarge"), code: "too_large" }, 413),
 });
 const answers = tooLarge(4 * 1024 * 1024);
 const upload = tooLarge(48 * 1024 * 1024);

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

@@ -13,6 +13,7 @@ import { pluginToolsOf } from "../plugins/registry.js";
 import { earlierChats, readChat, searchChats } from "../services/assistant-chats.js";
 import { asLang, marketplaceDetail, searchMarketplace } from "../services/marketplace.js";
 import { listWizards } from "../services/wizards.js";
+import { serverText } from "../texts.js";
 import { attempt } from "../tools/shared.js";
 import { readDoc, searchDocs } from "./docs.js";
 /** Where the account lives: the runtime's Manage-App, or the account a local install links. */
@@ -45,7 +46,7 @@ export function knowsTools(ctx) {
             description: "Search the engenty wizards user guide and plugin guide of this installed version. Gives the best sections with an excerpt and their engenty.ai/docs link. Use it before you explain how something works.",
             inputSchema: z.object({ query: z.string().min(2).max(200) }),
             execute: async ({ query }) => {
-                ctx.doing(ctx.lang === "de" ? "Liest in der Anleitung …" : "Reading the guide …");
+                ctx.doing(serverText(ctx.lang, "doingReadGuide"));
                 return { hits: searchDocs(query) };
             },
         }),
@@ -57,7 +58,7 @@ export function knowsTools(ctx) {
                 from: z.number().int().min(0).optional(),
             }),
             execute: async ({ page, from }) => {
-                ctx.doing(ctx.lang === "de" ? "Liest in der Anleitung …" : "Reading the guide …");
+                ctx.doing(serverText(ctx.lang, "doingReadGuide"));
                 return readDoc(page, from ?? 0);
             },
         }),
@@ -66,7 +67,7 @@ export function knowsTools(ctx) {
             description: "The authoring guide the wizard editor and AI apps build with: how a wizard is written (steps, fields, flows, tools, outputs, model classes). Long: read it in parts with `from`.",
             inputSchema: z.object({ from: z.number().int().min(0).optional() }),
             execute: ({ from }) => attempt(async () => {
-                ctx.doing(ctx.lang === "de" ? "Liest die Bauanleitung …" : "Reading the authoring guide …");
+                ctx.doing(serverText(ctx.lang, "doingAuthoringGuide"));
                 const guide = authoringGuide(ctx.project?.mcpServers ?? [], ctx.project ? await listConnectors(ctx.project.id) : [], await pluginToolsOf(user.tenantId));
                 const start = Math.min(from ?? 0, guide.length);
                 return {
@@ -80,7 +81,7 @@ export function knowsTools(ctx) {
             description: "Search the gallery of wizard templates (engenty.ai/wizards and the plugins' starters): title, pitch, what it needs that this install has no model for, and its price per run in credits.",
             inputSchema: z.object({ query: z.string().max(200).optional() }),
             execute: ({ query }) => attempt(async () => {
-                ctx.doing(ctx.lang === "de" ? "Sucht in der Galerie …" : "Searching the gallery …");
+                ctx.doing(serverText(ctx.lang, "doingGallery"));
                 const hits = await searchMarketplace({
                     q: query ?? "",
                     lang: asLang(ctx.lang),
@@ -146,7 +147,7 @@ export function knowsTools(ctx) {
             description: "The plans teams can be on (Free, Pro, Team): price a month, monthly credits, limits, and the credit packages to buy on top. Live from the account service.",
             inputSchema: z.object({}),
             execute: () => attempt(async () => {
-                ctx.doing(ctx.lang === "de" ? "Sieht die Pläne nach …" : "Looking up the plans …");
+                ctx.doing(serverText(ctx.lang, "doingPlans"));
                 const plans = await publicPlans(accountBase());
                 return { ...plans, billingPage: `${accountBase()}/billing` };
             }),
@@ -156,7 +157,7 @@ export function knowsTools(ctx) {
             description: "The person, their team, their role, the team's plan, the credit balance and credits that end on a date.",
             inputSchema: z.object({}),
             execute: () => attempt(async () => {
-                ctx.doing(ctx.lang === "de" ? "Sieht das Konto nach …" : "Looking up the account …");
+                ctx.doing(serverText(ctx.lang, "doingAccount"));
                 if (managed) {
                     const info = await tenantInfo(user.tenantId, true);
                     return {
@@ -194,7 +195,7 @@ export function knowsTools(ctx) {
             description: "Credits the team used per month (the last three), and the runs and wizards that cost the most.",
             inputSchema: z.object({}),
             execute: () => attempt(async () => {
-                ctx.doing(ctx.lang === "de" ? "Sieht den Verbrauch nach …" : "Looking up the usage …");
+                ctx.doing(serverText(ctx.lang, "doingUsage"));
                 if (!(managed || (await linkedAccount()))) {
                     return { linked: false, note: NOT_LINKED };
                 }
@@ -296,7 +297,7 @@ export function knowsTools(ctx) {
             description: "What thinks and makes for this install, per model class: an installed AI client, an own key, a local model, credits, or nothing (with the problem). Also which AI clients are installed and signed in.",
             inputSchema: z.object({}),
             execute: () => attempt(async () => {
-                ctx.doing(ctx.lang === "de" ? "Sieht die Modelle nach …" : "Looking up the models …");
+                ctx.doing(serverText(ctx.lang, "doingModels"));
                 return {
                     classes: waysIn(await classWays(), "en"),
                     clients: managed
@@ -315,7 +316,7 @@ export function knowsTools(ctx) {
             description: "Search the person's earlier chats with you (their messages and summaries) for words: what was asked, changed or decided before.",
             inputSchema: z.object({ query: z.string().min(3).max(200) }),
             execute: ({ query }) => attempt(async () => {
-                ctx.doing(ctx.lang === "de" ? "Sucht in früheren Chats …" : "Searching earlier chats …");
+                ctx.doing(serverText(ctx.lang, "doingEarlierChats"));
                 const hits = (await searchChats(user, query)).filter((h) => h.chatId !== ctx.chatId);
                 return {
                     hits,

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

@@ -1,4 +1,4 @@
-import { bilingual } from "@engenty-wizards/shared/run";
+import { note } from "@engenty-wizards/shared/run";
 import { and, asc, eq } from "drizzle-orm";
 import { z } from "zod";
 import { db, schema } from "../db/client.js";
@@ -275,7 +275,7 @@ export async function importConnector(userId, projectId, input) {
     await requireWritableProject(projectId);
     await requireAdmin();
     if (await load(projectId, input.id)) {
-        throw new ServiceError("invalid", bilingual(`Den Connector „${input.id}“ gibt es in diesem Space schon.`, `The connector “${input.id}” already exists in this space.`));
+        throw new ServiceError("invalid", note("connectorAlreadyExistsSpace", { id: input.id }));
     }
     try {
         const { discover, surface, prepared } = await prepare(input);
@@ -352,7 +352,7 @@ export async function refreshConnector(projectId, id, accessToken) {
     await requireWritableProject(projectId);
     const record = await load(projectId, id);
     if (!record) {
-        throw new ServiceError("not_found", bilingual("Diesen Connector gibt es nicht.", "This connector doesn’t exist."));
+        throw new ServiceError("not_found", note("connectorNotExist"));
     }
     try {
         const { surface } = record.registry_surface_slug

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

@@ -1,4 +1,5 @@
-import { bilingual } from "@engenty-wizards/shared/run";
+import { isLang } from "@engenty-wizards/shared/definition";
+import { note } 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";
@@ -7,23 +8,21 @@ 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 { serverText } from "../texts.js";
 import { connectorFetch, MAIL_CONNECTORS, resolveEnv, usable, viaAccount } from "./builtin.js";
 import { resolveConnector } from "./external.js";
 import { AccountConnectError, redeemTicket, refreshThroughAccount, startThroughAccount, } from "./via-account.js";
 /** The connectors a person can pick for each kind of connection. */
 const CONNECTORS = { mail: MAIL_CONNECTORS };
-const HINTS = {
-    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 …" },
+const HINTS = { imap: "imapHint" };
+/** The built-in connectors' fields in each language; their definitions say them in English. */
+const FIELD_WORDS = {
+    de: {
+        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 …" },
+        },
     },
 };
 /**
@@ -67,10 +66,11 @@ export async function connectorOptions(connection, projectId, lang = "en") {
                 id: c.id,
                 name: c.name,
                 auth: "api_key",
-                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],
+                fields: c.auth.apiKey.fields.map((f) => ({
+                    ...f,
+                    ...(lang === "en" ? undefined : FIELD_WORDS[lang]?.[c.id]?.[f.key]),
+                })),
+                hint: HINTS[c.id] && serverText(lang, HINTS[c.id]),
             }
             : { id: c.id, name: c.name, auth: "oauth2" });
     }
@@ -157,7 +157,7 @@ export async function startOAuth(scope, projectId, runId, connection, connectorI
 /** 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;
+    return isLang(lang) ? lang : null;
 }
 /** The run an OAuth callback belongs to; its tenant is looked up before the state is used. */
 export function oauthStateRun(rawState) {
@@ -214,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(bilingual(`„${field.label}“ fehlt.`, `“${field.label}” is missing.`));
+            throw new ConnectError(note("fieldMissing", { label: field.label }));
         }
         if (value) {
             credentials[field.key] = value.slice(0, 500);
@@ -244,16 +244,16 @@ function connectFailure(err) {
     const host = e.imapHost ? ` (${e.imapHost})` : "";
     if (e.authenticationFailed) {
         const answer = e.responseText?.slice(0, 160);
-        return bilingual(`Anmeldung abgelehnt${host}. Stimmen Adresse und (App-)Passwort? Gmail und Google Workspace brauchen ein App-Passwort und eingeschaltetes IMAP.${answer ? ` Antwort des Servers: ${answer}` : ""}`, `The sign-in was refused${host}. Are the address and (app) password right? Gmail and Google Workspace need an app password and IMAP turned on.${answer ? ` The server said: ${answer}` : ""}`);
+        return note("signInRefused", { host, answer: answer ? note("serverSaid", { answer }) : "" });
     }
     if (e.code === "ENOTFOUND") {
-        return bilingual(`Den Mail-Server${host} gibt es nicht. Trag den IMAP-Server ein, bei Gmail und Google Workspace imap.gmail.com.`, `The mail server${host} doesn’t exist. Enter the IMAP server. For Gmail and Google Workspace, it’s imap.gmail.com.`);
+        return note("mailServerNotExist", { host });
     }
     if (e.code === "ETIMEDOUT" || e.code === "ETIMEOUT" || e.code === "ECONNREFUSED") {
-        return bilingual(`Der Mail-Server${host} antwortet nicht. Prüf IMAP-Server und Port.`, `The mail server${host} isn’t responding. Check the IMAP server and port.`);
+        return note("mailServerNotResponding", { host });
     }
     const detail = String(e.message ?? err).slice(0, 200);
-    return bilingual(`Verbinden hat nicht geklappt${host}: ${detail}`, `Connecting didn’t work${host}: ${detail}`);
+    return note("connectingNotWork", { host, detail });
 }
 export function disconnect(scope, connectionId) {
     return deleteSecret(scope, slot(connectionId));

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

@@ -1,4 +1,4 @@
-import { bilingual } from "@engenty-wizards/shared/run";
+import { note } from "@engenty-wizards/shared/run";
 import { accountToken } from "../auth/account.js";
 import { env } from "../env.js";
 import { NotedError } from "../model-errors.js";
@@ -26,7 +26,7 @@ export async function googleThroughAccount() {
 async function call(path, body) {
     const token = await accountToken();
     if (!token) {
-        throw new AccountConnectError(bilingual("Verbinde zuerst dein engenty-Konto (Einstellungen → Konto). Dann kannst du Google hier verbinden.", "Connect your engenty account first (Settings → Account). Then you can connect Google here."));
+        throw new AccountConnectError(note("connectEngentyAccountFirst"));
     }
     const res = await fetch(`${base()}${path}`, {
         method: "POST",
@@ -35,15 +35,15 @@ async function call(path, body) {
         signal: AbortSignal.timeout(20_000),
     }).catch(() => null);
     if (!res) {
-        throw new AccountConnectError(bilingual("Dein engenty-Konto ist gerade nicht erreichbar. Versuch es später noch einmal.", "Your engenty account can’t be reached right now. Try again later."));
+        throw new AccountConnectError(note("engentyAccountNotReached"));
     }
     const data = (await res.json().catch(() => ({})));
     if (!res.ok) {
         throw new AccountConnectError(data.code === "invalid_grant"
-            ? bilingual("Google nimmt diese Verbindung nicht mehr an. Verbinde das Konto neu.", "Google no longer accepts this connection. Connect the account again.")
+            ? note("googleNoLongerAccepts")
             : data.code === "not_configured"
-                ? bilingual("Google lässt sich über dein engenty-Konto gerade nicht verbinden.", "Google can’t 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 didn’t work (${data.code ?? res.status}).`));
+                ? note("googleNotConnectedThrough")
+                : note("viaAccountFailed", { code: data.code ?? res.status }));
     }
     return data;
 }

package/apps/runtime/dist/documents/parse.js

@@ -2,7 +2,7 @@ import { createHash } from "node:crypto";
 import { existsSync, mkdirSync } from "node:fs";
 import { readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { bilingual } from "@engenty-wizards/shared/run";
+import { note } from "@engenty-wizards/shared/run";
 import { generateText, Output } from "ai";
 import PostalMime from "postal-mime";
 import { z } from "zod";
@@ -170,7 +170,7 @@ async function read(input, opts) {
     const vision = new VisionProvider(opts.charge, opts.signal, opts.call);
     if (mime.startsWith("image/")) {
         if (!vision.canConvert(mime)) {
-            throw new UnreadableDocument(bilingual(`Bilder vom Typ ${mime} lassen sich nicht lesen (PNG, JPEG und WebP gehen).`, `Images of type ${mime} can’t be read (PNG, JPEG and WebP work).`));
+            throw new UnreadableDocument(note("imageTypeNotReadable", { mime }));
         }
         const result = await vision.convert(data, name, mime);
         return { markdown: result.markdown, pages: 1, via: "vision" };
@@ -214,7 +214,7 @@ async function read(input, opts) {
     if (mime === "application/json" || mime.startsWith("text/")) {
         return { markdown: text(), pages: null, via: "text" };
     }
-    throw new UnreadableDocument(bilingual(`„${name}“ (${mime}) lässt sich nicht lesen.`, `“${name}” (${mime}) can’t be read.`));
+    throw new UnreadableDocument(note("fileNotReadable", { name, mime }));
 }
 // --- structured extraction -----------------------------------------------------
 /** The scanner's schemas say nothing about the currency; SaaS invoices come in several. */

package/apps/runtime/dist/engine/input.js

@@ -1,5 +1,5 @@
-import { isDecidedField, isLocationValue, MAX_FILES, offeredSlot, shownFields, } from "@engenty-wizards/shared/definition";
-import { bilingual, saidText } from "@engenty-wizards/shared/run";
+import { isDecidedField, isLang, isLocationValue, MAX_FILES, offeredSlot, shownFields, } from "@engenty-wizards/shared/definition";
+import { note, saidText } from "@engenty-wizards/shared/run";
 /** The field errors in a language, for whoever reads them. */
 export function fieldErrorsIn(errors, lang) {
     return errors.map((e) => ({ field: e.field, message: saidText(e.message, lang) }));
@@ -120,7 +120,7 @@ function readAudio(raw) {
     if (typeof input.transcript === "string") {
         out.transcript = input.transcript.slice(0, 20_000);
     }
-    if (input.lang === "de" || input.lang === "en") {
+    if (isLang(input.lang)) {
         out.lang = input.lang;
     }
     return out;
@@ -142,21 +142,21 @@ export function readPageInput(step, input, context = {}) {
             continue;
         }
         if (field.required && empty(v) && field.kind !== "toggle") {
-            errors.push({ field: field.id, message: bilingual("Pflichtfeld", "Required") });
+            errors.push({ field: field.id, message: note("fieldRequired") });
             continue;
         }
         if (Array.isArray(v) && (field.kind === "image" || field.kind === "file")) {
             if (field.min && v.length < field.min) {
                 errors.push({
                     field: field.id,
-                    message: bilingual(`Wähl mindestens ${field.min} aus`, `Choose at least ${field.min}`),
+                    message: note("chooseAtLeast", { min: field.min }),
                 });
                 continue;
             }
             if (field.max && v.length > field.max) {
                 errors.push({
                     field: field.id,
-                    message: bilingual(`Höchstens ${field.max} – entferne einige`, `At most ${field.max} – remove some`),
+                    message: note("chooseAtMost", { max: field.max }),
                 });
                 continue;
             }
@@ -164,25 +164,25 @@ export function readPageInput(step, input, context = {}) {
         if (field.kind === "number" && Number.isNaN(v)) {
             errors.push({
                 field: field.id,
-                message: bilingual("Gib eine Zahl ein", "Enter a number"),
+                message: note("enterNumber"),
             });
             continue;
         }
         if (field.kind === "select" && !empty(v) && !field.options?.includes(String(v))) {
-            errors.push({ field: field.id, message: bilingual("Ungültige Auswahl", "Invalid choice") });
+            errors.push({ field: field.id, message: note("invalidChoice") });
             continue;
         }
         if (field.kind === "slot" && !empty(v) && !field.options?.includes(String(v))) {
             errors.push({
                 field: field.id,
-                message: bilingual("Dieser Termin wird nicht angeboten", "This time isn’t offered"),
+                message: note("timeNotOffered"),
             });
             continue;
         }
         if (field.kind === "email" && !empty(v) && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(String(v))) {
             errors.push({
                 field: field.id,
-                message: bilingual("Keine gültige E-Mail-Adresse", "Not a valid email address"),
+                message: note("notValidEmailAddress"),
             });
             continue;
         }
@@ -193,7 +193,7 @@ export function readPageInput(step, input, context = {}) {
             catch {
                 errors.push({
                     field: field.id,
-                    message: bilingual("Keine gültige URL", "Not a valid URL"),
+                    message: note("notValidUrl"),
                 });
                 continue;
             }

package/apps/runtime/dist/engine/requirements.js

@@ -1,6 +1,6 @@
 import { conditionMatches, conditionsOf, isDecidedField, isDecisionStep, isOtherwise, MODEL_CLASSES, } from "@engenty-wizards/shared/definition";
 import { closedChoicesFor, openValue, otherwiseIndex, unavoidableFrom, unavoidableSteps, } from "@engenty-wizards/shared/fit";
-import { bilingual, saidText } from "@engenty-wizards/shared/run";
+import { note, saidText } from "@engenty-wizards/shared/run";
 import { classProblem, filmClient } from "../models.js";
 // The steps every run passes through, and the choices that lead around a missing model, are
 // pure and shared (packages/shared/src/fit.ts): the standalone check uses the same.
@@ -273,13 +273,12 @@ export function blockingMessage(missing) {
     if (!blocking.length) {
         return null;
     }
-    const line = (lang) => blocking
-        .map((m) => {
-        const steps = m.steps.map((s) => (lang === "de" ? `„${s.title}“` : `“${s.title}”`));
-        return `${steps.join(", ")}: ${saidText(m.problem, lang)}`;
-    })
-        .join(" ");
-    return bilingual(line("de"), line("en"));
+    return blocking
+        .map((m) => note("blockedSteps", {
+        steps: m.steps.map((s) => note("quoted", { text: s.title })),
+        problem: m.problem,
+    }))
+        .reduce((first, second) => note("joined", { first, second }));
 }
 /** The class a marketplace capability stands for; the rest need no model of their own. */
 const CAPABILITY_CLASS = {