wizards 0.6.1 → 0.7.0

package/apps/runtime/dist/docs/dev/wizard-format.md

@@ -1,7 +1,7 @@
 ---
 title: The wizard format
 description: A wizard as JSON and as a .wizard file, its JSON Schema, and checking it with wizards validate.
-version: 0.5.0
+version: 0.5.13
 ---
 
 A wizard is one JSON document, its **definition**. The studio exports it as a `.wizard` file
@@ -30,9 +30,11 @@ tool may read and write wizards.
 lists the step types and their fields. The studio’s MCP tool `get_authoring_guide` explains them
 with a complete example.
 
-`lang` is the language the wizard speaks to people: `de` or `en`. It sets the runner’s own words
-and how numbers and dates are written. Without it, the language is read from the wizard’s own
-words, and English is the default where they are not clearly German.
+`lang` is the language the wizard speaks to people, as a two-letter code: `en`, `de`, `it`, `fr`
+and so on. The schema checks the shape of the code; `wizards validate` and the studio check that
+it names a real language. It sets the runner’s own words and how numbers and dates are written.
+Without it, the language is read from the wizard’s own words, and English is the default where
+they are not clearly German.
 
 `version` is the definition’s version. It changes only with a breaking change; the schemas of
 each version stay online in their own folder (`/schema/v1/`, `/schema/v2/`, …).

package/apps/runtime/dist/docs/user/command-line.md

@@ -18,13 +18,14 @@ version: 0.5.0
 | `wizards doctor` | Shows the status and checks for problems |
 | `wizards logs [n]` | Prints the last lines engenty wizards printed while running (100, or `n` up to 2000). Keys and tokens are taken out |
 | `wizards report` | Sends the status, the model settings (never a key) and the last 500 log lines to your [account](./models.md#account), so support can see what went wrong. Nothing is sent unless you run it. The command names the report’s ID. If this computer isn’t signed in, it tells you to sign in under Settings → Account or with `wizards account sign-in` |
-| `wizards stop` | Stops it. Your data is kept |
+| `wizards stop` | Stops it, with any other copy of it still running in the background. Your data is kept. AI apps that use your wizards start it again when you use one there |
 | `wizards restart` | Stops it and starts it again; after an update, that is the new version. If it isn’t running, it starts in the background |
 | `wizards update` | Installs the latest version |
 | `wizards autostart on` / `off` | Starts it when you log in, or stops doing so. It is a LaunchAgent on macOS and a systemd user service on Linux |
 | `wizards connect [app …]` | Adds your wizards to your [AI apps](./ai-apps.md): every app found, or the ones you name |
 | `wizards disconnect [app …]` | Takes them out again |
 | `wizards mcp` | Runs the MCP server over stdio. AI apps start it; you don’t |
+| `wizards uninstall` | Takes engenty wizards off this computer. It shows what it will remove first and asks about your data on its own; your data is kept unless you choose to delete it. `--dry-run` only shows the plan, `--yes` asks nothing and keeps your data, `--yes --delete-data` deletes it too. See [Remove](./install.md#remove) |
 | `wizards validate <path …>` | Checks wizards without the studio: `.wizard` files, unpacked wizard files, or a wizard’s JSON. `--json` prints the problems as JSON. A space’s connectors and plugins are checked when you import it |
 
 | Option | What it does |

package/apps/runtime/dist/docs/user/data.md

@@ -27,7 +27,7 @@ Keychain (as `engenty-wizards`). On other systems they are stored encrypted in t
 |---|---|
 | Back up | Stop engenty wizards (`wizards stop`) and copy the folder |
 | Move to another computer | Install engenty wizards there, stop it and put the folder in place. On a Mac, enter your API keys and sign in to your account again: the Keychain doesn’t move |
-| Start over | Delete the folder. On a Mac, the keys in the Keychain stay and are used again. To remove them, delete the `engenty-wizards` entries in Keychain Access |
+| Start over | Run `wizards uninstall`, choose to delete your data, then install again. On a Mac, the keys in the Keychain stay and are used again. To remove them, delete the `engenty-wizards` entries in Keychain Access |
 | Keep it elsewhere | Set `ENGENTY_HOME` to another folder. engenty wizards then keeps everything in its `wizards` folder there |
 
 After an update, engenty wizards brings your data up to date the next time it starts.

package/apps/runtime/dist/docs/user/install.md

@@ -71,6 +71,19 @@ the right of the address bar.
 
 ## Update
 
+engenty wizards updates itself: it looks for a new version when it starts and once a day,
+downloads it in the background and checks it, and switches to it at the next start (a restart or
+the next login), never while a wizard runs. The version before stays beside it. `wizards status`
+and the studio then say “Updated to …” with what changed. To turn it off:
+
+```bash
+wizards autoupdate off
+```
+
+or set `WIZARDS_DISABLE_AUTOUPDATE=1` (in the terminal or in `~/.engenty/wizards/.env`). In CI,
+and for an install set up without a terminal, it is off unless you turn it on with `wizards
+autoupdate on`. `npx wizards` never updates itself. To update now:
+
 ```bash
 wizards update
 ```
@@ -88,11 +101,21 @@ brought up to date at the next start.
 ## Remove
 
 ```bash
-wizards stop
-wizards autostart off
-wizards disconnect
+wizards uninstall
 ```
 
-`wizards disconnect` takes your wizards out of your AI apps again. Then delete `~/.engenty/wizards`
-and `~/.local/bin/wizards`. Your wizards and results are in `~/.engenty/wizards/data`:
-[back that folder up](./data.md) first if you want to keep them.
+First it shows what it will remove: your wizards in your AI apps, starting at login, everything of
+engenty wizards that is running, the program in `~/.engenty/wizards` and the command
+`~/.local/bin/wizards`. Your data in `~/.engenty/wizards/data` is kept unless you say to delete
+it, and installing again picks it up. [Back it up](./data.md) first if you delete it. At the end
+it lists anything it couldn’t remove.
+
+If the `wizards` command no longer runs, `npx wizards uninstall` does the same.
+
+| Option | What it does |
+|---|---|
+| `--dry-run` | Only shows what it would remove |
+| `--yes` | Removes everything without asking and keeps your data |
+| `--yes --delete-data` | Deletes your data as well |
+
+Without a terminal, it asks for `--yes`.

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

@@ -1,4 +1,5 @@
 import { isDecidedField, isLang, isLocationValue, MAX_FILES, offeredSlot, shownFields, } from "@engenty-wizards/shared/definition";
+import { readNumber } from "@engenty-wizards/shared/numbers";
 import { note, saidText } from "@engenty-wizards/shared/run";
 /** The field errors in a language, for whoever reads them. */
 export function fieldErrorsIn(errors, lang) {
@@ -13,11 +14,10 @@ function coerce(field, raw) {
     }
     switch (field.kind) {
         case "number": {
-            if (raw === "") {
+            if (String(raw).trim() === "") {
                 return undefined;
             }
-            const n = Number(String(raw).replace(",", "."));
-            return Number.isFinite(n) ? n : Number.NaN;
+            return readNumber(raw) ?? Number.NaN;
         }
         case "toggle":
             return raw === true || raw === "true" || raw === "on";
@@ -62,8 +62,7 @@ function coerce(field, raw) {
                 if (c.kind === "text") {
                     return [c.id, String(v ?? "").slice(0, 2000)];
                 }
-                const n = Number(String(v ?? "").replace(",", "."));
-                return [c.id, Number.isFinite(n) ? n : 0];
+                return [c.id, readNumber(v) ?? 0];
             })))
                 .filter((r) => Object.values(r).some((v) => v !== "" && v !== 0))
                 .slice(0, 200);

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

@@ -1,5 +1,5 @@
 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 { branchValues, cardsFromData, conditionsOf, dataRef, followRules, formatsFor, isDecidedField, LIST_FORMATS, listRef, loopKey, MAX_SHOWN_FIELDS, optionsFromData, otherwiseOf, pageNeeds, textLang, whenHolds, wizardLang, } from "@engenty-wizards/shared/definition";
 import { note, saidText, } from "@engenty-wizards/shared/run";
 import { CONVERSATION_RUNNERS, DEFAULT_RUNNER_SETTINGS } from "@engenty-wizards/shared/runners";
 import { fitData } from "@engenty-wizards/shared/shape";
@@ -140,7 +140,7 @@ function friendly(err) {
  */
 async function failRun(run, stepId, err) {
     const said = noteOf(err) ?? friendly(err);
-    const message = saidText(said, wizardLang(run.definition));
+    const message = saidText(said, textLang(wizardLang(run.definition)));
     await emitEvent(run.id, stepId, "error", said);
     await updateRun(run.id, { status: "failed", error: message });
 }
@@ -229,7 +229,7 @@ async function take(runId, tenant) {
         console.error(`[run ${runId}]`, err);
         await withTenant(tenant, async () => {
             const run = await loadRun(runId);
-            const lang = run ? wizardLang(run.definition) : "en";
+            const lang = run ? textLang(wizardLang(run.definition)) : "en";
             await updateRun(runId, { status: "failed", error: saidText(friendly(err), lang) });
         }).catch((e) => console.error(`[run ${runId}] marking it failed:`, e));
     })
@@ -655,7 +655,7 @@ export async function submitPage(runId, stepId, input) {
         throw new RunInputError(errors);
     }
     const connections = step.fields.some((f) => f.kind === "connection")
-        ? await connectionViews(run.definition.connections ?? [], scopeOf(run), await projectIdOf(run), wizardLang(run.definition))
+        ? await connectionViews(run.definition.connections ?? [], scopeOf(run), await projectIdOf(run), textLang(wizardLang(run.definition)))
         : [];
     for (const field of step.fields) {
         if (field.kind === "image" || field.kind === "file") {
@@ -961,7 +961,7 @@ export async function runView(run, brand) {
         ask: run.status === "running" ? run.ask : null,
         lists,
         connections: step?.type === "page" && step.fields.some((f) => f.kind === "connection")
-            ? await connectionViews(def.connections ?? [], scopeOf(run), await projectIdOf(run), wizardLang(def))
+            ? await connectionViews(def.connections ?? [], scopeOf(run), await projectIdOf(run), textLang(wizardLang(def)))
             : [],
         keeps: Boolean(def.lists?.length || def.connections?.length),
         shareUrl: run.shareToken ? `${env.publicUrl}/s/${run.shareToken}` : null,

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

@@ -1,5 +1,5 @@
 import { pOf } from "@engenty-wizards/shared/decision";
-import { allFields, dataRef, isDecisionStep, LOCALES, langNameEn, stepShape, templateRefs, wizardLang, } from "@engenty-wizards/shared/definition";
+import { allFields, dataRef, isDecisionStep, langNameEn, localeOf, stepShape, templateRefs, wizardLang, } from "@engenty-wizards/shared/definition";
 import { mainLogo, ruleLines, runTheme } from "@engenty-wizards/shared/projects";
 import { note as runNote } from "@engenty-wizards/shared/run";
 import { fitData, labelOf, recordsOf, shapeJsonSchema, shapeLines, shapeZod, titleKey, } from "@engenty-wizards/shared/shape";
@@ -11,7 +11,7 @@ import { snapshotHtmlImages } from "../files/web-images.js";
 import { runFilmStep } from "../film/step.js";
 import { generateImageMedia, generateSpeechMedia, generateVideoMedia, } from "../media/generate.js";
 import { markMedia } from "../media/marking.js";
-import { attachTools, costOf, isHarnessVendor, textModel } from "../models.js";
+import { agentModel, attachTools, costOf, isHarnessVendor, textModel, totalUsage, } from "../models.js";
 import { knowledgeBlock } from "../services/knowledge.js";
 import { buildStepTools } from "../tools/index.js";
 import { callPluginTool, spaceContextOf } from "../tools/plugin.js";
@@ -24,7 +24,7 @@ import { answersAsText, assetSectionLine, colorLine, factLines, logoSectionLine,
 import { StepError } from "./types.js";
 /** Today's date as the wizard's people write it. */
 function today(ctx) {
-    return new Date().toLocaleDateString(LOCALES[wizardLang(ctx.def)], {
+    return new Date().toLocaleDateString(localeOf(wizardLang(ctx.def)), {
         year: "numeric",
         month: "long",
         day: "numeric",
@@ -536,7 +536,7 @@ export async function runAgentStep(step, ctx) {
             id: `step-${step.id}`,
             name: step.title,
             instructions: system,
-            model: resolved.model,
+            model: agentModel(resolved),
             tools,
         });
         // Working through a mailbox or a row of portals takes many small tool calls.
@@ -564,7 +564,7 @@ export async function runAgentStep(step, ctx) {
         const result = step.output.format === "json"
             ? await streamWithProgress(agent, message, { maxSteps, abortSignal: ctx.signal }, step, ctx)
             : await agent.generate(message, { maxSteps, abortSignal: ctx.signal });
-        await ctx.chargeUsd(costOf(resolved, result.totalUsage ?? result.usage));
+        await ctx.chargeUsd(costOf(resolved, await totalUsage(result)));
         // `result.text` strings together what the model said between tool calls ("I open the page …").
         // A written result is its last message; structuring keeps everything, numbers may sit anywhere.
         const closing = String(result.steps?.at?.(-1)?.text ?? "").trim();

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

@@ -1,18 +1,11 @@
-import { allFields, isAudioValue, isLocationValue, itemsTotals, LOCALES, locationText, wizardLang, } from "@engenty-wizards/shared/definition";
+import { allFields, isAudioValue, isLocationValue, itemsTotals, localeOf, locationText, wizardLang, } from "@engenty-wizards/shared/definition";
+import { formatMoney } from "@engenty-wizards/shared/numbers";
 import { fontLicenseWords, gradientCss, textStyleLine, } from "@engenty-wizards/shared/projects";
 import { listAsMarkdown } from "@engenty-wizards/shared/store";
 const TEMPLATE_RE = /\{\{\s*([^}]+?)\s*\}\}/g;
-function money(n, currency, locale) {
-    try {
-        return new Intl.NumberFormat(locale, { style: "currency", currency }).format(n);
-    }
-    catch {
-        return `${n.toFixed(2)} ${currency}`;
-    }
-}
 /** Line items as a Markdown table with their totals — what a model needs to write a document. */
 export function itemsAsMarkdown(field, value, values, lang = "en") {
-    const locale = LOCALES[lang];
+    const locale = localeOf(lang);
     const totals = itemsTotals(field, value, values);
     const cols = field.columns ?? [];
     if (!totals.rows.length) {
@@ -21,13 +14,15 @@ export function itemsAsMarkdown(field, value, values, lang = "en") {
     const head = `| ${cols.map((c) => c.label).join(" | ")} | Amount |\n|${cols.map(() => " --- ").join("|")}| ---: |`;
     const body = totals.rows.map((r) => `| ${cols
         .map((c) => c.kind === "money"
-        ? money(Number(r[c.id]) || 0, totals.currency, locale)
+        ? formatMoney(Number(r[c.id]) || 0, totals.currency, locale)
         : String(r[c.id] ?? ""))
-        .join(" | ")} | ${money(r.amount, totals.currency, locale)} |`);
+        .join(" | ")} | ${formatMoney(r.amount, totals.currency, locale)} |`);
     const sums = [
-        `Net: ${money(totals.net, totals.currency, locale)}`,
-        totals.vatRate ? `VAT ${totals.vatRate}%: ${money(totals.vat, totals.currency, locale)}` : null,
-        `Total: ${money(totals.gross, totals.currency, locale)}`,
+        `Net: ${formatMoney(totals.net, totals.currency, locale)}`,
+        totals.vatRate
+            ? `VAT ${totals.vatRate}%: ${formatMoney(totals.vat, totals.currency, locale)}`
+            : null,
+        `Total: ${formatMoney(totals.gross, totals.currency, locale)}`,
     ].filter(Boolean);
     return [head, ...body, "", ...sums].join("\n");
 }

package/apps/runtime/dist/env.js

@@ -23,8 +23,7 @@ function loadEnvFiles() {
 loadEnvFiles();
 const str = (key, fallback = "") => process.env[key]?.trim() || fallback;
 /**
- * Without `SANDBOX`: Docker when the sandbox image is on this machine, else agentOS when its
- * packages are installed (a checkout has them, the image and the desktop app do not), else none.
+ * Without `SANDBOX`: Docker when the sandbox image is on this machine, else none.
  * The image is not published, so a fresh install would otherwise offer a tool that cannot start.
  */
 function sandboxEngine(image) {
@@ -33,12 +32,9 @@ function sandboxEngine(image) {
         return "off";
     }
     if (engine) {
-        return engine === "agentos" ? "agentos" : "docker";
-    }
-    if (dockerHasImage(image)) {
         return "docker";
     }
-    return agentOsInstalled() ? "agentos" : "off";
+    return dockerHasImage(image) ? "docker" : "off";
 }
 function dockerHasImage(image) {
     try {
@@ -49,19 +45,6 @@ function dockerHasImage(image) {
         return false;
     }
 }
-/** agentOS ships its sidecar for macOS and Linux on arm64 and x64 only. */
-function agentOsInstalled() {
-    if (!["darwin", "linux"].includes(process.platform) || !["arm64", "x64"].includes(process.arch)) {
-        return false;
-    }
-    try {
-        import.meta.resolve("@rivet-dev/agentos-core");
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 /** A comma-separated list. */
 const list = (key) => str(key)
     .split(",")
@@ -234,7 +217,7 @@ export const env = {
             : "/usr/bin/chromium")),
     /** Encodes widget animations to MP4; without it widgets offer no video. */
     ffmpegPath: str("FFMPEG_PATH", "ffmpeg"),
-    /** What runs an agent's shell and code: a Docker container, an agentOS VM, or nothing. */
+    /** What runs an agent's shell and code: a Docker container or nothing. */
     sandbox: sandboxEngine(sandboxImage),
     sandboxImage,
     /** Assets and workspace files in an S3-compatible bucket (R2); empty = the data folder. */

package/apps/runtime/dist/features.js

@@ -1,6 +1,6 @@
 import { mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
-import { declaredByPlugin, defaultFeatures, FEATURES, parseFeatures, resolveFeatures, } from "@engenty-wizards/shared/features";
+import { declaredByPlugin, defaultFeatures, FEATURES, featureOn, parseFeatures, resolveFeatures, } from "@engenty-wizards/shared/features";
 import { accountOverview } from "./auth/account.js";
 import { isCheckout, layout, packageRoot } from "./cli/home.js";
 import { env } from "./env.js";
@@ -61,7 +61,7 @@ export function features(remote) {
     return resolveFeatures(defaultFeatures(declaredFeatures()), envFeatures(), remote, fileFeatures());
 }
 export function feature(name, remote) {
-    return features(remote)[name] === true;
+    return featureOn(features(remote), name);
 }
 let accountCache = null;
 /**

package/apps/runtime/dist/index.js

@@ -17,7 +17,7 @@ import { purgeExpiredRuns } from "./services/shares.js";
 import { purgeUnusedStores } from "./store/index.js";
 import { forgetRunner, registerRunner } from "./tenants/control.js";
 import { LOCAL_TENANT } from "./tenants/tenant.js";
-import { onRestart, RESTART_EXIT } from "./update.js";
+import { onRestart, RESTART_EXIT, startUpdateChecks } from "./update.js";
 // Before anything prints: the last lines stay in memory for a look from afar (debug.ts).
 hookConsole();
 await migrateControlDb();
@@ -39,6 +39,8 @@ else {
     void loadCatalog();
     void checkModelsAtStart().catch(() => undefined);
     startProChecks();
+    // A newer release is downloaded beside this one and used from the next start.
+    startUpdateChecks();
 }
 // The marketplace's starters and the starred entries, kept for offline use; checked hourly.
 void syncMarketplace();

package/apps/runtime/dist/manage.js

@@ -202,6 +202,13 @@ export async function tenantChannels(id) {
     channels.set(id, { at: Date.now(), value });
     return value;
 }
+/**
+ * Forgets what the Manage-App said of the tenant's numbers: the next `tenantChannels` asks.
+ * The runtime tests of the Manage-App's channel plugins (sms, calls, whatsapp) call it.
+ */
+export function forgetChannels(id) {
+    channels.delete(id);
+}
 /** A person of the tenant asks for its number; what the Manage-App answers with is the request. */
 export async function requestChannelNumber(id, input) {
     channels.delete(id);

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

@@ -1,4 +1,4 @@
-import { LANG_NAMES } from "@engenty-wizards/shared/definition";
+import { langNameEn } from "@engenty-wizards/shared/definition";
 import { NotedError } from "../model-errors.js";
 import { conversationAccess } from "../models.js";
 /**
@@ -105,7 +105,7 @@ export function conversationInstructions(view) {
         .join(" ");
     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.`,
+        `Speak ${langNameEn(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.",

package/apps/runtime/dist/models.js

@@ -1042,6 +1042,18 @@ export function usageOf(u) {
         cachedInputTokens: u?.cachedInputTokens ?? u?.inputTokenDetails?.cacheReadTokens ?? 0,
     };
 }
+/** A class's model as Mastra's `Agent` takes it: the AI SDK's model, typed by Mastra's own copy of it. */
+export function agentModel(resolved) {
+    return resolved.model;
+}
+/**
+ * What an agent's call used over all its steps: `totalUsage` where Mastra's result has it, else
+ * `usage`. Takes a stream's promises and a finished call's values alike.
+ */
+export async function totalUsage(out) {
+    const result = out;
+    return (await result.totalUsage) ?? (await result.usage);
+}
 /** Provider cost of a text call a runtime that runs alone made; the gateway books the others itself. */
 export function costOf(resolved, usage) {
     // An installed client answers on its subscription: nothing to book.

package/apps/runtime/dist/plugins/runs.js

@@ -1,5 +1,5 @@
 import { createHash } from "node:crypto";
-import { LANGS, wizardLang } from "@engenty-wizards/shared/definition";
+import { LANGS, textLang, wizardLang } from "@engenty-wizards/shared/definition";
 import { noteText } from "@engenty-wizards/shared/run";
 import { and, asc, eq, inArray, isNotNull } from "drizzle-orm";
 import { db, schema, withTenant } from "../db/client.js";
@@ -64,7 +64,7 @@ export function runsApiFor(pluginId) {
                 runner: input.runner ?? pluginId,
             }).catch((err) => {
                 if (err instanceof ModelUnavailableError) {
-                    throw new ServiceError("refused", errorText(err, wizardLang(version.definition)));
+                    throw new ServiceError("refused", errorText(err, textLang(wizardLang(version.definition))));
                 }
                 if (err instanceof NoCreditsError) {
                     throw new ServiceError("no_credits", noteText({ code: "wizardRunOutCredits" }, wizardLang(version.definition)));
@@ -112,7 +112,7 @@ export function runsApiFor(pluginId) {
                             wizardId: w.id,
                             token: w.shareToken,
                             title: version.definition.title,
-                            lang: wizardLang(version.definition),
+                            lang: textLang(wizardLang(version.definition)),
                         },
                     ]
                     : [];
@@ -200,7 +200,7 @@ export function runsApiFor(pluginId) {
                 call: { runId: run.id },
             }).catch((err) => {
                 if (err instanceof ModelUnavailableError) {
-                    throw new ServiceError("refused", errorText(err, wizardLang(run.definition)));
+                    throw new ServiceError("refused", errorText(err, textLang(wizardLang(run.definition))));
                 }
                 throw err;
             });

package/apps/runtime/dist/routes/runs.js

@@ -302,14 +302,16 @@ export const publicRoutes = new Hono()
         throw err;
     }
 })
-    // The runner's own words in a language outside LANGS, booked to this wizard's owner when new.
+    // The runner's own words in a language outside LANGS (the wizard's own or a viewer's), booked
+    // to this wizard's owner when new.
     .get("/wizards/:token/texts/:lang", async (c) => {
     const found = await publishedWizard(c.req.param("token"));
     const lang = c.req.param("lang");
     if (!found || !isLangCode(lang) || isLang(lang)) {
         return c.json(notFoundAnswer(c), 404);
     }
-    if (!wantsTranslation(found.w, found.def, lang)) {
+    // The wizard's own language needs the runner's words too, translation offered or not.
+    if (lang !== wizardLang(found.def) && !wantsTranslation(found.w, found.def, lang)) {
         return refuse(c, { code: "translationOff" }, 403);
     }
     try {

package/apps/runtime/dist/sandbox/docker.js

@@ -6,8 +6,6 @@ const WRITE_CHUNK = 48 * 1024;
 /** What the engenty-sandbox image carries. The container sits on Docker's default bridge. */
 export const DOCKER_CAPABILITIES = {
     commands: ["bash", "python3", "pip", "uv", "node", "npm", "bun", "jq", "curl", "git", "unzip"],
-    python: "shell",
-    pythonPackages: "install what you need with pip or uv",
     network: "open internet",
     uses: "calculations, charts or file conversion",
     workdir: WORKDIR,

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

@@ -1,27 +1,20 @@
 import { env } from "../env.js";
-import { AGENTOS_CAPABILITIES, AgentOsSandbox } from "./agentos.js";
 import { DOCKER_CAPABILITIES, DockerRunSandbox } from "./docker.js";
 /** What this server's sandbox runs, or null when it is switched off. */
 export function sandboxCapabilities() {
     if (env.sandbox === "off") {
         return null;
     }
-    return env.sandbox === "agentos" ? AGENTOS_CAPABILITIES : DOCKER_CAPABILITIES;
+    return DOCKER_CAPABILITIES;
 }
 export function createSandbox(runId) {
     if (env.sandbox === "off") {
         throw new Error("The sandbox is switched off on this server.");
     }
-    return env.sandbox === "agentos"
-        ? new AgentOsSandbox()
-        : new DockerRunSandbox(runId, env.sandboxImage);
+    return new DockerRunSandbox(runId, env.sandboxImage);
 }
 export function shellToolDescription(caps) {
-    const python = caps.python === "tool" ? " Python is not a shell command here: use run_python." : "";
-    return `Run a shell command in a private Linux sandbox (${caps.commands.join(", ")}). Working directory ${caps.workdir}. Network: ${caps.network}.${python}`;
-}
-export function pythonToolDescription(caps) {
-    return `Run Python code in the sandbox (${caps.pythonPackages}). Working directory ${caps.workdir}, shared with run_command and export_file.`;
+    return `Run a shell command in a private Linux sandbox (${caps.commands.join(", ")}). Working directory ${caps.workdir}. Network: ${caps.network}.`;
 }
 /** The authoring guide's line about the sandbox tool. */
 export function sandboxGuideLine() {

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

@@ -1,4 +1,4 @@
-import { wizardLang, } from "@engenty-wizards/shared/definition";
+import { textLang, wizardLang, } from "@engenty-wizards/shared/definition";
 import { standaloneEntry } from "@engenty-wizards/shared/fit";
 import { pluginsOf } from "@engenty-wizards/shared/marketplace";
 import { noteText } from "@engenty-wizards/shared/run";
@@ -141,7 +141,7 @@ function answerText(field, value, lang) {
 /** What the person answered on the run's pages, by the fields' labels, in the order asked. */
 function answersOf(run) {
     const answers = [];
-    const lang = wizardLang(run.definition);
+    const lang = textLang(wizardLang(run.definition));
     for (const step of run.definition.steps) {
         if (step.type !== "page") {
             continue;

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

@@ -1,4 +1,4 @@
-import { wizardLang } from "@engenty-wizards/shared/definition";
+import { textLang, wizardLang } from "@engenty-wizards/shared/definition";
 import { note } from "@engenty-wizards/shared/run";
 import { BUILT_IN_RUNNERS, CONVERSATION_RUNNERS, DEFAULT_RUNNER, DEFAULT_RUNNER_SETTINGS, runnerFit, } from "@engenty-wizards/shared/runners";
 import { env } from "../env.js";
@@ -164,7 +164,7 @@ export async function servePageRunner(w, def, runnerId, rest, request) {
 export async function publicRunners(w, def) {
     const available = await runnersOf();
     const settings = runnerSettingsOf(w, available);
-    const lang = wizardLang(def);
+    const lang = textLang(wizardLang(def));
     return settings.enabled
         .map((id) => available.find((r) => r.id === id))
         .filter((r) => Boolean(r) && !r?.problem)

package/apps/runtime/dist/services/space-categories.js

@@ -1,4 +1,5 @@
 import { CATEGORY_TYPES, dayOf, } from "@engenty-wizards/shared/knowledge";
+import { readNumber } from "@engenty-wizards/shared/numbers";
 import { note } from "@engenty-wizards/shared/run";
 import { and, asc, eq, inArray, isNotNull, or, sql } from "drizzle-orm";
 import { nanoid } from "nanoid";
@@ -42,32 +43,9 @@ function refWhere(ref) {
     return eq(t.fileId, ref.fileId);
 }
 // --- typed values ---------------------------------------------------------------
-/** A number as people write it: `38 h`, `20.000 €`, `1,5`, `1.234,50`. */
+/** A number with what stands around it, as `readNumber` reads it: `38 h`, `19 %`, `1,5`. */
 export function numberOf(value) {
-    if (typeof value === "number") {
-        return Number.isFinite(value) ? value : null;
-    }
-    if (typeof value !== "string") {
-        return null;
-    }
-    let s = value.replace(/[^\d,.-]/g, "");
-    if (!/\d/.test(s)) {
-        return null;
-    }
-    if (s.includes(",") && s.includes(".")) {
-        s =
-            s.lastIndexOf(",") > s.lastIndexOf(".")
-                ? s.replace(/\./g, "").replace(",", ".")
-                : s.replace(/,/g, "");
-    }
-    else if (s.includes(",")) {
-        s = /^-?\d{1,3}(,\d{3}){2,}$/.test(s) ? s.replace(/,/g, "") : s.replace(",", ".");
-    }
-    else if (/^-?\d{1,3}(\.\d{3})+$/.test(s)) {
-        s = s.replace(/\./g, "");
-    }
-    const n = Number(s);
-    return Number.isFinite(n) ? n : null;
+    return readNumber(value, { units: true });
 }
 /** A day, or a day and a time, as milliseconds (UTC, as written: no time zone is applied). */
 export function dateOf(value) {

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

@@ -48,11 +48,14 @@ async function translate(texts, opts) {
         chunks.push(keys.slice(i, i + size));
     }
     const model = await textModel("standard", { effort: "low" });
+    // The model sees short keys (t0, t1, …): some providers allow only letters, digits, "_", "."
+    // and "-" in a schema's property names, and a text's own key may hold anything.
     const call = async (chunk) => {
+        const ids = chunk.map((_, i) => `t${i}`);
         const schema = jsonSchema({
             type: "object",
-            properties: Object.fromEntries(chunk.map((k) => [k, { type: "string" }])),
-            required: chunk,
+            properties: Object.fromEntries(ids.map((id) => [id, { type: "string" }])),
+            required: ids,
             additionalProperties: false,
         });
         const result = await generateText({
@@ -67,9 +70,9 @@ async function translate(texts, opts) {
             ]
                 .filter(Boolean)
                 .join("\n"),
-            prompt: JSON.stringify(Object.fromEntries(chunk.map((k) => [k, texts[k]])), null, 1),
+            prompt: JSON.stringify(Object.fromEntries(chunk.map((k, i) => [ids[i], texts[k]])), null, 1),
         });
-        return result.output;
+        return Object.fromEntries(chunk.map((k, i) => [k, result.output[ids[i]]]));
     };
     const out = {};
     const answers = await Promise.all(chunks.map(call));

package/apps/runtime/dist/tools/browser.js

@@ -9,7 +9,7 @@ import { nodeScript, PAGE_SCRIPT, settleScript, targetScript, } from "../browser
 import { env } from "../env.js";
 import { costOf, textModel } from "../models.js";
 import { assertPublicUrl } from "./net-guard.js";
-import { attempt } from "./shared.js";
+import { attempt, imageOutput } from "./shared.js";
 /** The page as an agent step reads it; retried while the page is between two documents. */
 export async function readPage(page) {
     for (let attempt = 0; attempt < 5; attempt++) {
@@ -473,19 +473,7 @@ export async function browserTools(ctx, assets, files) {
             }
             return { url: p.url(), saved, screenshot: Buffer.from(png).toString("base64") };
         }),
-        toModelOutput: (out) => {
-            if (!out?.screenshot) {
-                return { type: "json", value: out };
-            }
-            const { screenshot, ...rest } = out;
-            return {
-                type: "content",
-                value: [
-                    { type: "text", text: JSON.stringify(rest) },
-                    { type: "image-data", data: screenshot, mediaType: "image/png" },
-                ],
-            };
-        },
+        toModelOutput: imageOutput("screenshot"),
     });
     const handOver = async (input) => {
         const p = await page();