wizards 0.5.7 → 0.5.9

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

@@ -1,6 +1,6 @@
 import { marginOf, } from "@engenty-wizards/shared/decision";
 import { branchValues, cardsFromData, conditionsOf, dataRef, followRules, formatsFor, isDecidedField, LIST_FORMATS, listRef, loopKey, MAX_SHOWN_FIELDS, optionsFromData, otherwiseOf, pageNeeds, whenHolds, wizardLang, } from "@engenty-wizards/shared/definition";
-import { bilingual, saidText, } from "@engenty-wizards/shared/run";
+import { note, saidText, } from "@engenty-wizards/shared/run";
 import { CONVERSATION_RUNNERS, DEFAULT_RUNNER_SETTINGS } from "@engenty-wizards/shared/runners";
 import { eq } from "drizzle-orm";
 import { nanoid } from "nanoid";
@@ -43,7 +43,7 @@ export class RunInputError extends NotedError {
 }
 export class NoCreditsError extends NotedError {
     constructor() {
-        super(bilingual("Dieser Wizard hat gerade kein Guthaben mehr. Versuch es später noch einmal.", "This wizard has run out of credits for now. Try again later."));
+        super(note("wizardRunOutCredits"));
     }
 }
 /** The runs this process drives right now, with the handle that stops each. */
@@ -113,19 +113,19 @@ function friendly(err) {
     }
     // A runtime that runs alone pays its provider itself: its admin can top the account up.
     if (!managed && /minimum balance|insufficient_funds|top up your credits/i.test(msg)) {
-        return bilingual("Das Guthaben beim Modellanbieter reicht dafür nicht aus (Videos brauchen dort ein Mindestguthaben). Lade dort auf und versuch es noch einmal.", "Your credit with the model provider isn’t enough for this (videos need a minimum balance there). Top up there and try again.");
+        return note("providerCreditLow");
     }
     if (/rate.?limit|429/i.test(msg)) {
-        return bilingual("Der KI-Dienst ist gerade ausgelastet. Versuch es gleich noch einmal.", "The AI service is busy right now. Try again in a moment.");
+        return note("aiServiceBusyRight");
     }
     if (/timeout|timed out/i.test(msg)) {
-        return bilingual("Der Schritt hat zu lange gedauert. Versuch es noch einmal.", "The step took too long. Try again.");
+        return note("stepTookTooLong");
     }
     // The platform's own provider account (budget, quota, key): nothing the person can fix.
     if (/budget|quota|insufficient|billing|credit balance|api key|unauthori[sz]ed|401|403/i.test(msg)) {
-        return bilingual("Der KI-Dienst ist gerade nicht erreichbar. Versuch es später noch einmal.", "The AI service can’t be reached right now. Try again later.");
+        return note("aiServiceNotReached");
     }
-    return bilingual(`Dieser Schritt hat nicht geklappt: ${msg.slice(0, 300)}`, `This step failed: ${msg.slice(0, 300)}`);
+    return note("stepFailed", { detail: msg.slice(0, 300) });
 }
 /**
  * A step that failed ends the run. A failure with a note (Apple Intelligence's) goes into the log
@@ -637,7 +637,7 @@ export async function submitPage(runId, stepId, input) {
             (choice.values.length === 0 || choice.values.some((v) => String(v) === String(answer)))) {
             errors.push({
                 field: id,
-                message: bilingual("Das ist hier gerade nicht verfügbar.", "That isn’t available here right now."),
+                message: note("notAvailableNow"),
             });
         }
     }
@@ -653,9 +653,7 @@ export async function submitPage(runId, stepId, input) {
             for (const id of Array.isArray(value) ? value : value ? [value] : []) {
                 const asset = await db.query.asset.findFirst({ where: eq(schema.asset.id, String(id)) });
                 if (asset?.runId !== runId) {
-                    throw new RunInputError([
-                        { field: field.id, message: bilingual("Datei nicht gefunden", "File not found") },
-                    ]);
+                    throw new RunInputError([{ field: field.id, message: note("fileNotFound") }]);
                 }
             }
         }
@@ -666,9 +664,7 @@ export async function submitPage(runId, stepId, input) {
                 values[field.id] = account.label;
             }
             else if (field.required) {
-                throw new RunInputError([
-                    { field: field.id, message: bilingual("Verbinde zuerst", "Connect first") },
-                ]);
+                throw new RunInputError([{ field: field.id, message: note("connectFirst") }]);
             }
         }
     }

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

@@ -1,7 +1,7 @@
 import { pOf } from "@engenty-wizards/shared/decision";
 import { allFields, dataRef, isDecisionStep, LOCALES, templateRefs, wizardLang, } from "@engenty-wizards/shared/definition";
 import { mainLogo, ruleLines } from "@engenty-wizards/shared/projects";
-import { bilingual } from "@engenty-wizards/shared/run";
+import { note as runNote } from "@engenty-wizards/shared/run";
 import { SURFACE_GUIDE, validateSurface, } from "@engenty-wizards/shared/surface";
 import { Agent } from "@mastra/core/agent";
 import { generateText, Output } from "ai";
@@ -379,7 +379,7 @@ function agentEntries(step, ctx) {
 async function runAgentEach(step, ctx) {
     const entries = agentEntries(step, ctx);
     if (!entries.length) {
-        throw new StepError(bilingual("Es gibt keine Einträge, für die dieser Schritt arbeiten könnte.", "There are no entries for this step to work on."));
+        throw new StepError(runNote("noEntriesStepWork"));
     }
     // The view, if any, is composed once over the table of all entries.
     const single = {
@@ -554,7 +554,7 @@ export async function runAgentStep(step, ctx) {
         const text = step.output.format === "json" ? everything : closing || everything;
         if (step.output.format !== "json") {
             if (!text && !assets.length) {
-                throw new StepError(bilingual("Der Schritt hat kein Ergebnis geliefert.", "The step didn’t return a result."));
+                throw new StepError(runNote("stepNotReturnResult"));
             }
             return { text, assets: assets.length ? assets : undefined, at: new Date().toISOString() };
         }
@@ -755,7 +755,7 @@ async function writeHtml(step, ctx, kind) {
         .replace(/```\s*$/, "")
         .trim();
     if (!/<html|<!doctype/i.test(html)) {
-        throw new StepError(bilingual("Das Dokument konnte nicht erstellt werden.", "The document couldn’t be created."));
+        throw new StepError(runNote("documentNotCreated"));
     }
     // On screen (preview, PNG) a print document needs the margin its @page rule gives it on paper.
     return kind === "document"
@@ -806,7 +806,7 @@ async function inParallel(items, limit, work) {
 async function runMediaStep(step, ctx, asset) {
     const entries = entriesOf(step, ctx);
     if (!entries.length) {
-        throw new StepError(bilingual("Für diesen Schritt fehlen die Vorlagen (Bilder oder Szenen).", "This step is missing its sources (images or scenes)."));
+        throw new StepError(runNote("stepMissingSourcesImages"));
     }
     const previous = ctx.state.outputs[step.id];
     const before = previous?.assets?.filter((a) => a.kind === asset) ?? [];
@@ -898,7 +898,7 @@ export async function runGenerateStep(step, ctx) {
         case "voice": {
             const text = renderTemplate(step.prompt, ctx.scope).trim().slice(0, 4000);
             if (!text) {
-                throw new StepError(bilingual("Es gibt keinen Text zum Vorlesen.", "There is no text to read aloud."));
+                throw new StepError(runNote("noTextReadAloud"));
             }
             const note = ctx.state.notes[step.id];
             const media = await generateSpeechMedia({

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

@@ -1,5 +1,5 @@
 import { assembleSurface, dataRef, listRef, } from "@engenty-wizards/shared/definition";
-import { bilingual } from "@engenty-wizards/shared/run";
+import { note } from "@engenty-wizards/shared/run";
 import { validateSurface } from "@engenty-wizards/shared/surface";
 import { decide } from "./decide.js";
 import { answersAsText, resolveRef } from "./template.js";
@@ -14,7 +14,7 @@ export async function runSurfaceStep(step, ctx) {
     const components = step.components ?? (await decidedComponents(step, ctx));
     const issues = validateSurface(components, Object.keys(data));
     if (issues.length) {
-        throw new StepError(bilingual(`Die Ansicht hat Fehler: ${issues.map((i) => i.message).join(" ")}`, `The view has errors: ${issues.map((i) => i.message).join(" ")}`));
+        throw new StepError(note("viewErrors", { detail: issues.map((i) => i.message).join(" ") }));
     }
     return { surface: { components, data }, at: new Date().toISOString() };
 }

package/apps/runtime/dist/film/step.js

@@ -2,12 +2,12 @@ import { spawn } from "node:child_process";
 import { existsSync } from "node:fs";
 import { readFile, rm, stat } from "node:fs/promises";
 import { isAbsolute, join, normalize } from "node:path";
-import { bilingual } from "@engenty-wizards/shared/run";
+import { note as runNote } from "@engenty-wizards/shared/run";
 import { StepError } from "../engine/types.js";
 import { CLAUDE_BIN, claudeEnv } from "../harness/claude.js";
 import { failureOf } from "../harness/model.js";
 import { openBridge } from "../mcp/bridge.js";
-import { errorText } from "../model-errors.js";
+import { saidOf } from "../model-errors.js";
 import { filmClient } from "../models.js";
 import { prepareFilmFolder, savedSession, saveSession } from "./project.js";
 import { runHyperframes } from "./tools.js";
@@ -229,13 +229,13 @@ export async function runFilmStep(step, ctx) {
             if (ctx.signal.aborted) {
                 throw err;
             }
-            throw new StepError(bilingual(`${client.name} hat beim Film aufgehört: ${err.message}. Die Arbeit ist gespeichert. Ein neuer Versuch macht dort weiter.`, `${client.name} stopped working on the film: ${err.message}. The work is saved. A new try carries on from there.`));
+            throw new StepError(runNote("filmClientStopped", { name: client.name, detail: err.message }));
         });
         const result = last;
         if (!result || result.is_error) {
             const detail = String(result?.result ?? (stderr.trim() || "no result")).slice(0, 400);
             const failure = failureOf(client, detail);
-            throw new StepError(bilingual(`${errorText(failure, "de")} Die Arbeit ist gespeichert. Ein neuer Versuch macht dort weiter.`, `${errorText(failure, "en")} The work is saved. A new try carries on from there.`));
+            throw new StepError(runNote("filmWorkSaved", { problem: saidOf(failure) }));
         }
         return result;
     };
@@ -265,7 +265,7 @@ export async function runFilmStep(step, ctx) {
             }
             const problem = renderProblem(render.out);
             if (attempt >= RENDER_FIXES) {
-                throw new StepError(bilingual(`Der Film ließ sich nicht rendern: ${problem.slice(0, 400)}`, `The film couldn’t be rendered: ${problem.slice(0, 400)}`));
+                throw new StepError(runNote("filmRenderFailed", { detail: problem.slice(0, 400) }));
             }
             await ctx.emit("tool", { code: "filmFix" });
             const fixed = await turn(`The final render of film/ failed:\n\n${problem}\n\nFind the cause in the composition's code, fix it, run \`check\` and a draft render through the hyperframes tool until both pass, and end with one line on what you fixed.`, await savedSession(root));

package/apps/runtime/dist/harness/apple.js

@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { release } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { langOf, SPEECH_LOCALES } from "@engenty-wizards/shared/definition";
 import { nanoid } from "nanoid";
 import { env } from "../env.js";
 import { ffmpeg, hasFfmpeg } from "../media/ffmpeg.js";
@@ -168,7 +169,7 @@ export function appleModel(alias) {
 /** The Mac's own language: what a voice note is most likely in, unless the call names one. */
 function systemLocale() {
     const locale = Intl.DateTimeFormat().resolvedOptions().locale;
-    return /^[a-z]{2}-[A-Z]{2}$/.test(locale) ? locale : locale.startsWith("de") ? "de-DE" : "en-US";
+    return /^[a-z]{2}-[A-Z]{2}$/.test(locale) ? locale : SPEECH_LOCALES[langOf(locale) ?? "en"];
 }
 /** What AVAudioFile reads as it is; a browser's WebM or Ogg (Opus) is turned into WAV first. */
 function audioExtension(mediaType) {

package/apps/runtime/dist/harness/claude.js

@@ -1,4 +1,4 @@
-import { bilingual } from "@engenty-wizards/shared/run";
+import { note } from "@engenty-wizards/shared/run";
 import { resolveEnv, run } from "./env.js";
 import { failureOf, HarnessModel, lastJson, runClient, } from "./model.js";
 /**
@@ -143,5 +143,5 @@ export const claude = {
     },
     login: { args: ["auth", "login"], interactive: false },
     model: (alias, effort) => new ClaudeCodeModel(claude, alias || "sonnet", effort),
-    exhausted: bilingual("Das Anthropic-Konto, mit dem Claude Code angemeldet ist, hat kein Guthaben. Melde Claude Code unter Einstellungen → Modelle mit deinem Abo an.", "The Anthropic account Claude Code is signed in with has no credit. Sign Claude Code in with your subscription under Settings → Models."),
+    exhausted: note("anthropicAccountClaudeCode"),
 };

package/apps/runtime/dist/harness/codex.js

@@ -1,7 +1,7 @@
 import { existsSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import { bilingual } from "@engenty-wizards/shared/run";
+import { note } from "@engenty-wizards/shared/run";
 import { resolveEnv, run } from "./env.js";
 import { failureOf, HarnessImageModel, HarnessModel, runClient, } from "./model.js";
 /**
@@ -225,5 +225,5 @@ export const codex = {
     login: { args: ["login"], interactive: false },
     model: (alias, effort) => new CodexModel(codex, alias || "default", effort),
     image: { alias: "image", model: (alias) => new CodexImageModel(codex, alias || "image") },
-    exhausted: bilingual("Das Kontingent des ChatGPT-Kontos, mit dem Codex angemeldet ist, ist aufgebraucht. Versuch es später noch einmal oder wähle einen anderen Client.", "The ChatGPT account Codex is signed in with has used up its quota. Try again later or choose another client."),
+    exhausted: note("chatgptAccountCodexSigned"),
 };

package/apps/runtime/dist/harness/model.js

@@ -1,17 +1,16 @@
 import { spawn } from "node:child_process";
 import { mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { bilingual } from "@engenty-wizards/shared/run";
+import { note } from "@engenty-wizards/shared/run";
 import { nanoid } from "nanoid";
 import { env } from "../env.js";
 import { openBridge } from "../mcp/bridge.js";
 import { ModelUnavailableError } from "../model-errors.js";
 import { extensionOf, jsonInstruction, parseJsonAnswer, renderPrompt } from "./prompt.js";
 const workDir = join(env.dataDir, "harness");
-export const signedOut = (h) => bilingual(`${h.name} ist auf diesem Computer nicht angemeldet. Melde dich unter Einstellungen → Modelle an.`, `${h.name} isn’t signed in on this computer. Sign in under Settings → Models.`);
-export const notInstalled = (h) => bilingual(`${h.name} ist auf diesem Computer nicht installiert. Installiere es unter Einstellungen → Modelle.`, `${h.name} isn’t installed on this computer. Install it under Settings → Models.`);
-export const exhausted = (h) => h.exhausted ??
-    bilingual(`Das Konto, mit dem ${h.name} angemeldet ist, hat kein Guthaben oder Kontingent mehr.`, `The account ${h.name} is signed in with has no credit or quota left.`);
+export const signedOut = (h) => note("clientNotSignedIn", { name: h.name });
+export const notInstalled = (h) => note("clientNotInstalled", { name: h.name });
+export const exhausted = (h) => h.exhausted ?? note("clientNoCredit", { name: h.name });
 /** The failure a client reports, as the person should read it. */
 export function failureOf(h, detail) {
     // The client's own words stay in the log: the sentence below sums them up for the person.

package/apps/runtime/dist/harness/terminal.js

@@ -1,7 +1,7 @@
 import { accessSync, chmodSync, constants } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, join } from "node:path";
-import { bilingual } from "@engenty-wizards/shared/run";
+import { note } from "@engenty-wizards/shared/run";
 import { nanoid } from "nanoid";
 import { ServiceError } from "../services/errors.js";
 const BUFFER = 200_000;
@@ -37,7 +37,7 @@ async function ptyModule() {
         return { spawn };
     }
     catch {
-        throw new ServiceError("refused", bilingual("Das eingebaute Terminal ist auf diesem Computer nicht verfügbar. Führe den Befehl in deinem eigenen Terminal aus.", "The built-in terminal isn’t available on this computer. Run the command in your own terminal."));
+        throw new ServiceError("refused", note("builtTerminalNotAvailable"));
     }
 }
 function emit(session, event) {
@@ -85,7 +85,7 @@ export async function openTerminal(opts) {
         });
     }
     catch (err) {
-        throw new ServiceError("refused", bilingual(`Der Befehl konnte nicht starten: ${err.message}`, `The command couldn’t start: ${err.message}`));
+        throw new ServiceError("refused", note("commandNotStarted", { detail: err.message }));
     }
     const session = {
         id,
@@ -147,7 +147,7 @@ export async function openTerminal(opts) {
 function sessionOf(id) {
     const session = sessions.get(id);
     if (!session) {
-        throw new ServiceError("not_found", bilingual("Dieses Terminal gibt es nicht mehr.", "This terminal no longer exists."));
+        throw new ServiceError("not_found", note("terminalNoLongerExists"));
     }
     return session;
 }

package/apps/runtime/dist/media/conversation.js

@@ -1,3 +1,4 @@
+import { LANG_NAMES } from "@engenty-wizards/shared/definition";
 import { NotedError } from "../model-errors.js";
 import { conversationAccess } from "../models.js";
 /**
@@ -10,8 +11,8 @@ const SECRETS_URL = "https://api.openai.com/v1/realtime/client_secrets";
 const CALLS_URL = "https://api.openai.com/v1/realtime/calls";
 /** How long a minted secret opens a session; the session itself goes on until it ends. */
 const SECRET_TTL_SECONDS = 600;
-/** The voice the wizard speaks with, by language. */
-const VOICES = { de: "marin", en: "marin" };
+/** The voice the wizard speaks with: one that speaks every language engenty does. */
+const VOICE = "marin";
 /** What the model may do: one tool per command of the run page, run by the browser. */
 export const CONVERSATION_TOOLS = [
     {
@@ -97,41 +98,23 @@ export const CONVERSATION_TOOLS = [
         parameters: { type: "object", properties: {}, additionalProperties: false },
     },
 ];
-/** The rules the model speaks by, in the wizard's language. */
+/** The rules the model speaks by: written in English, it speaks the wizard's language. */
 export function conversationInstructions(view) {
-    const de = view.lang === "de";
-    const about = [
-        `${de ? "Du bist" : "You are"} ${view.wizard.title}.`,
-        view.wizard.description,
-        view.wizard.intro,
-    ]
+    const about = [`You are ${view.wizard.title}.`, view.wizard.description, view.wizard.intro]
         .filter(Boolean)
         .join(" ");
-    const rules = de
-        ? [
-            "Du führst ein Gespräch, das einen Wizard Schritt für Schritt ausfüllt. Die Person sieht den Wizard auch auf dem Bildschirm.",
-            "Sprich Deutsch, kurz und freundlich, wie am Telefon. Ein Satz, dann die nächste Frage.",
-            "Frag ein Feld nach dem anderen, in der Reihenfolge des Zustands. Nach jeder Antwort rufst du set_field auf. Sind alle Felder beantwortet, die du per Sprache füllen kannst, rufst du submit_page auf.",
-            "Bei einer Auswahl nennst du die Möglichkeiten (höchstens vier auf einmal) und gibst genau eine davon weiter.",
-            "E-Mail-Adressen, Links und Zahlen wiederholst du zur Bestätigung, bevor du sie weitergibst.",
-            "Ein Feld, das den Bildschirm braucht (ein Foto, eine Datei, eine Unterschrift, eine Verbindung), füllt die Person dort aus: sag das in einem Satz und warte auf den nächsten Zustand.",
-            "Während der Wizard arbeitet, sagst du in einem Satz, was er gerade tut, und wartest. Erfinde nichts.",
-            "Bei einer Prüfung liest du den Text kurz zusammengefasst vor und fragst, ob er passt. Dann accept_review, oder regenerate mit dem Wunsch der Person.",
-            "Am Ende sagst du, was entstanden ist und dass es auf dem Bildschirm liegt.",
-            "Ist die Kamera an, kannst du mit look sehen, was die Person zeigt, und mit take_photo ein Foto in ein Fotofeld legen; ein Fotofeld fragst du dann so: „Halte es in die Kamera, ich mache das Foto.“ Ist die Kamera aus, bitte die Person, sie einzuschalten, oder lass das Feld dem Bildschirm.",
-        ]
-        : [
-            "You hold a conversation that fills in a wizard step by step. The person also sees the wizard on the screen.",
-            "Speak English, short and friendly, as on the phone. One sentence, then the next question.",
-            "Ask one field at a time, in the order of the state. After each answer call set_field. When every field you can fill by voice is answered, call submit_page.",
-            "For a choice, name the options (at most four at a time) and pass exactly one of them on.",
-            "Read e-mail addresses, links and numbers back before passing them on.",
-            "A field that needs the screen (a photo, a file, a signature, a connection) is filled there by the person: say so in one sentence and wait for the next state.",
-            "While the wizard works, say in one sentence what it is doing and wait. Never make anything up.",
-            "At a review, sum the text up in a few words and ask whether it fits. Then accept_review, or regenerate with what the person wants changed.",
-            "At the end, say what was made and that it is on the screen.",
-            "With the camera on you can see what the person shows with look, and put a photo into a photo field with take_photo; ask for a photo field like this: 'Hold it to the camera, I will take the picture.' With the camera off, ask the person to switch it on, or leave the field to the screen.",
-        ];
+    const rules = [
+        "You hold a conversation that fills in a wizard step by step. The person also sees the wizard on the screen.",
+        `Speak ${LANG_NAMES[view.lang]} (${view.lang}), short and friendly, as on the phone. One sentence, then the next question.`,
+        "Ask one field at a time, in the order of the state. After each answer call set_field. When every field you can fill by voice is answered, call submit_page.",
+        "For a choice, name the options (at most four at a time) and pass exactly one of them on.",
+        "Read e-mail addresses, links and numbers back before passing them on.",
+        "A field that needs the screen (a photo, a file, a signature, a connection) is filled there by the person: say so in one sentence and wait for the next state.",
+        "While the wizard works, say in one sentence what it is doing and wait. Never make anything up.",
+        "At a review, sum the text up in a few words and ask whether it fits. Then accept_review, or regenerate with what the person wants changed.",
+        "At the end, say what was made and that it is on the screen.",
+        "With the camera on you can see what the person shows with look, and put a photo into a photo field with take_photo; ask for a photo field like this: 'Hold it to the camera, I will take the picture.' With the camera off, ask the person to switch it on, or leave the field to the screen.",
+    ];
     return `${about}\n\n${rules.join("\n")}`;
 }
 /** Mints the secret a browser opens a session with; a failure carries a note for the run's language. */
@@ -157,7 +140,7 @@ export async function mintConversation(view) {
                         noise_reduction: { type: "far_field" },
                         turn_detection: { type: "server_vad", threshold: 0.7, silence_duration_ms: 600 },
                     },
-                    output: { voice: VOICES[view.lang] },
+                    output: { voice: VOICE },
                 },
             },
         }),

package/apps/runtime/dist/media/transcribe.js

@@ -1,5 +1,6 @@
 import { readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
+import { SPEECH_LOCALES } from "@engenty-wizards/shared/definition";
 import { generateText, experimental_transcribe as transcribe } from "ai";
 import { costOf, listenerModel, transcriptionCostUsd } from "../models.js";
 import { ffmpeg, hasFfmpeg, probeMedia, withTempDir } from "./ffmpeg.js";
@@ -18,7 +19,7 @@ export async function transcribeAudio(input) {
             audio: input.bytes,
             abortSignal: input.abortSignal,
             ...(input.language
-                ? { providerOptions: { apple: { locale: input.language === "en" ? "en-US" : "de-DE" } } }
+                ? { providerOptions: { apple: { locale: SPEECH_LOCALES[input.language] } } }
                 : {}),
         });
         return {

package/apps/runtime/dist/model-errors.js

@@ -1,6 +1,6 @@
 import { noteText } from "@engenty-wizards/shared/run";
 /**
- * A failure the person reads, given as a note of `RUN_NOTES` (or `bilingual` words) where it has
+ * A failure the person reads, given as a note of `RUN_NOTES` where it has
  * one: a run shows it in the wizard's language, a response in the asker's, and the message keeps
  * the English line for the log. Free text has no note.
  */

package/apps/runtime/dist/models.js

@@ -8,7 +8,7 @@ import { createOpenAI } from "@ai-sdk/openai";
 import { createReplicate } from "@ai-sdk/replicate";
 import { MODEL_CLASSES, TEXT_CLASSES, } from "@engenty-wizards/shared/definition";
 import { creditsModelOf, isCreditsRef, PROVIDER_IDS, providerInfo, providerOfRef, } from "@engenty-wizards/shared/providers";
-import { bilingual, saidText } from "@engenty-wizards/shared/run";
+import { note, saidText } from "@engenty-wizards/shared/run";
 import { generateSpeech, generateText, } from "ai";
 import { accountToken, linkedAccount } from "./auth/account.js";
 import { DeviceModel, deviceThinks } from "./engine/device.js";
@@ -22,6 +22,7 @@ import { seal, unseal } from "./secrets/crypto.js";
 import { vaultDelete, vaultGet, vaultSet } from "./secrets/vault.js";
 import { readSetting, writeSetting } from "./settings.js";
 import { currentTenant, currentTenantOrNull } from "./tenants/tenant.js";
+import { serverText } from "./texts.js";
 export { isHarnessVendor } from "./harness/index.js";
 /**
  * A step names a model class, never a model. Where the class runs is decided here, in this order:
@@ -234,27 +235,26 @@ function ownRef(cfg, cls) {
 }
 /** What a class makes, to say that nothing makes it. */
 const MAKES = {
-    classifier: { de: "Text", en: "text" },
-    standard: { de: "Text", en: "text" },
-    high: { de: "Text", en: "text" },
-    highest: { de: "Text", en: "text" },
-    image: { de: "Bilder", en: "images" },
-    video: { de: "Videos", en: "videos" },
-    speech: { de: "Sprachausgabe", en: "speech" },
-    audio: { de: "Sprachnotizen", en: "voice notes" },
+    classifier: "makesText",
+    standard: "makesText",
+    high: "makesText",
+    highest: "makesText",
+    image: "makesImages",
+    video: "makesVideos",
+    speech: "makesSpeech",
+    audio: "makesVoiceNotes",
 };
 /** Why a class has no way: the provider picked for it lacks its key, or nothing is set up. */
 function missingText(cfg, cls) {
     const bound = cfg.settings.bindings[cls];
     if (isCreditsRef(bound)) {
-        return bilingual("Dafür sind Credits gewählt, aber du bist mit keinem Konto angemeldet.", "This is set to run on credits, but you’re not signed in to an account.");
+        return note("creditsNotSignedIn");
     }
-    const makes = MAKES[cls];
     const provider = bound ? providerInfo(providerOfRef(bound) ?? "") : null;
     if (provider) {
-        return bilingual(`Für ${makes.de} ist ${provider.name} gewählt, aber kein API-Key hinterlegt.`, `${provider.name} is chosen for ${makes.en}, but no API key is set.`);
+        return note("providerKeyMissing", { provider: provider.name, makes: note(MAKES[cls]) });
     }
-    return bilingual(`Für ${makes.de} ist kein Modell eingerichtet.`, `No model is set up for ${makes.en}.`);
+    return note("noModelFor", { makes: note(MAKES[cls]) });
 }
 /**
  * The way to the credits. On a Manage-App's runtime always; alone, through the linked account —
@@ -274,7 +274,7 @@ async function creditAccess(cfg, chosen) {
     const token = await accountToken();
     if (!token) {
         if (chosen) {
-            throw new ModelUnavailableError(bilingual("Das Konto ist nicht mehr angemeldet. Melde dich unter Einstellungen → Konto neu an.", "The account is no longer signed in. Sign in again under Settings → Account."));
+            throw new ModelUnavailableError(note("accountNoLongerSigned"));
         }
         return null;
     }
@@ -301,7 +301,7 @@ async function routeOf(cls) {
 function need(cfg, name) {
     const key = cfg.keys[name];
     if (!key) {
-        throw new ModelUnavailableError(bilingual(`Für ${providerInfo(name)?.name ?? name} ist kein API-Key hinterlegt.`, `No API key is set for ${providerInfo(name)?.name ?? name}.`));
+        throw new ModelUnavailableError(note("noApiKeyFor", { provider: providerInfo(name)?.name ?? name }));
     }
     return key;
 }
@@ -412,7 +412,7 @@ async function ownLanguageModel(cfg, ref, meta) {
                 };
             }
     }
-    throw new ModelUnavailableError(bilingual(`Das Modell „${ref}“ lässt sich noch nicht nutzen. Hinterleg unter Einstellungen → Modelle einen API-Key oder melde dich mit einem Konto an.`, `The model “${ref}” can’t be used yet. Add an API key under Settings → Models, or sign in to an account.`));
+    throw new ModelUnavailableError(note("modelNotUsedYet", { ref }));
 }
 /**
  * The language model a text class runs on. A run watched from a device that offers the class
@@ -492,7 +492,7 @@ export async function imageModel(meta = {}) {
                 return own(createOpenAI({ apiKey: cfg.keys.openai }).image(aliasOf(id)));
             }
     }
-    throw new ModelUnavailableError(bilingual("Für Bilder ist kein Modell eingerichtet.", "No model is set up for images."));
+    throw new ModelUnavailableError(note("noModelForImages"));
 }
 export async function videoModel(meta = {}) {
     const route = await routeOf("video");
@@ -521,7 +521,7 @@ export async function videoModel(meta = {}) {
                 return own(createGateway({ apiKey: cfg.keys.gateway }).videoModel(id), true);
             }
     }
-    throw new ModelUnavailableError(bilingual("Für Videos ist kein Modell eingerichtet.", "No model is set up for videos."));
+    throw new ModelUnavailableError(note("noModelForVideos"));
 }
 /** The model that reads a text aloud. */
 export async function speechModel(meta = {}) {
@@ -529,7 +529,7 @@ export async function speechModel(meta = {}) {
     if (route.kind === "credits") {
         const resolved = await viaCredits(route, "speech", meta, (c, id) => c.speechModel(id));
         if (!resolved.ref) {
-            throw new ModelUnavailableError(bilingual("Für Sprachausgabe ist kein Modell eingerichtet.", "No model is set up for speech."));
+            throw new ModelUnavailableError(note("noModelForSpeech"));
         }
         return resolved;
     }
@@ -560,7 +560,7 @@ export async function speechModel(meta = {}) {
                 return own(createOpenAI({ apiKey: cfg.keys.openai }).speech(aliasOf(id)));
             }
     }
-    throw new ModelUnavailableError(bilingual("Für Sprachausgabe ist kein Modell eingerichtet.", "No model is set up for speech."));
+    throw new ModelUnavailableError(note("noModelForSpeech"));
 }
 /**
  * What turns a voice note into text: a transcription model (ElevenLabs Scribe, Whisper), or a
@@ -711,7 +711,10 @@ export function freeTierRefusal(err) {
 }
 /** What the person reads when Vercel's free tier leaves a model out, and how to fix it. */
 export function freeTierText(model) {
-    return bilingual(`Dein AI-Gateway-Key nutzt bei Vercel die kostenlose Stufe, und die schließt ${model ? `„${model}“` : "dieses Modell"} aus. Lade bei Vercel Guthaben auf (${GATEWAY_TOP_UP}) oder wähle unter Einstellungen → Modelle ein anderes Modell.`, `Your AI Gateway key is on Vercel’s free tier, which doesn’t include ${model ? `“${model}”` : "this model"}. Top up at Vercel (${GATEWAY_TOP_UP}) or choose another model under Settings → Models.`);
+    return note("freeTier", {
+        model: model ? note("quoted", { text: model }) : note("thisModel"),
+        url: GATEWAY_TOP_UP,
+    });
 }
 /** What a key was answered for a model: refusals are asked again soon, as a top-up lifts them. */
 const gatewayProbes = new Map();
@@ -765,7 +768,7 @@ const CONVERSATION_MODEL = env.conversationModel || "gpt-realtime";
 export async function conversationAccess() {
     const cfg = await config();
     if (!cfg.keys.openai) {
-        throw new ModelUnavailableError(bilingual("Für Sprachgespräche ist kein OpenAI-API-Key hinterlegt (Einstellungen → Modelle).", "No OpenAI API key is set for voice conversations (Settings → Models)."));
+        throw new ModelUnavailableError(note("noOpenaiApiKey"));
     }
     return { apiKey: cfg.keys.openai, model: CONVERSATION_MODEL };
 }
@@ -802,12 +805,10 @@ export async function classProblem(cls) {
             const named = creditsModelOf((await config()).settings.bindings[cls]);
             if (named) {
                 return catalog?.models && !catalog.models.some((m) => m.id === named)
-                    ? bilingual("Dieses Modell gibt es mit deinem Konto nicht.", "This model isn’t available with your account.")
+                    ? note("modelNotAvailableAccount")
                     : null;
             }
-            return catalog?.classes && !catalog.classes[cls]
-                ? bilingual("Dafür ist bei deinem Konto kein Modell eingerichtet.", "Your account has no model set up for this.")
-                : null;
+            return catalog?.classes && !catalog.classes[cls] ? note("accountNoModelSet") : null;
         }
         const client = harness(resolved.vendor);
         if (client && (await detectHarness(client.id))?.auth === "none") {
@@ -833,7 +834,7 @@ export async function filmClient(cls) {
     const client = managed ? null : harness(cfg.settings.source);
     if (!client || !FILM_CLIENTS.has(client.id)) {
         return {
-            problem: bilingual("Filme macht Claude Code auf diesem Computer mit deinem Abo. Richte es unter Einstellungen → Modelle als KI-Abo ein.", "Claude Code makes films on this computer, using your subscription. Set it up as an AI subscription under Settings → Models."),
+            problem: note("claudeCodeMakesFilms"),
         };
     }
     const status = await detectHarness(client.id);
@@ -918,9 +919,7 @@ async function appleProblem(cls) {
     if (!status.supported || status.reason === "missing") {
         return appleUnavailableNote(status);
     }
-    return (await hasFfmpeg())
-        ? null
-        : bilingual("Aufnahmen aus Chrome oder Firefox (WebM, Ogg) schreibt dieser Mac erst mit ffmpeg auf. Safari und die App brauchen es nicht. Installiere ffmpeg, z. B. mit „brew install ffmpeg“.", "This Mac needs ffmpeg to transcribe recordings from Chrome or Firefox (WebM, Ogg). Safari and the app don’t. Install ffmpeg, e.g. with “brew install ffmpeg”.");
+    return (await hasFfmpeg()) ? null : note("macNeedsFfmpegTranscribe");
 }
 /** At start the ways are asked once, so a model the key cannot reach shows before a run meets it. */
 export async function checkModelsAtStart() {
@@ -958,7 +957,6 @@ export async function modelSettings(lang = "en") {
 // --- Checking a key ------------------------------------------------------------------
 /** A cheap authenticated call: whether the provider takes the key. Nothing is generated. */
 export async function checkKey(name, key, lang = "en") {
-    const de = lang === "de";
     const requests = {
         openai: ["https://api.openai.com/v1/models", { authorization: `Bearer ${key}` }],
         anthropic: [
@@ -991,20 +989,14 @@ export async function checkKey(name, key, lang = "en") {
         return {
             ok: false,
             message: res.status === 401
-                ? de
-                    ? "Der Anbieter kennt diesen API-Key nicht."
-                    : "The provider doesn’t recognise this key."
-                : de
-                    ? `Der Anbieter antwortet mit Fehler ${res.status}.`
-                    : `The provider answered with error ${res.status}.`,
+                ? serverText(lang, "keyUnknown")
+                : serverText(lang, "providerError", { status: String(res.status) }),
         };
     }
     catch {
         return {
             ok: false,
-            message: de
-                ? "Der Anbieter ist gerade nicht erreichbar."
-                : "The provider cannot be reached right now.",
+            message: serverText(lang, "providerUnreachable"),
         };
     }
 }