wizards 0.4.3 → 0.4.5

package/apps/runtime/dist/geocode.js

@@ -19,7 +19,7 @@ export function placeLabel(result) {
  * The address of a position, when the server has a geocoder (`GEOCODER_URL`). Calls go out one
  * at a time and at most one a second — what a public Nominatim asks of its users.
  */
-export function reverseGeocode(lat, lng, language = "de") {
+export function reverseGeocode(lat, lng, language = "en") {
     if (!env.geocoderUrl) {
         return Promise.resolve(null);
     }

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

@@ -2,7 +2,6 @@ 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 { noteText } from "@engenty-wizards/shared/run";
 import { nanoid } from "nanoid";
 import { env } from "../env.js";
 import { ffmpeg, hasFfmpeg } from "../media/ffmpeg.js";
@@ -103,10 +102,6 @@ export function appleUnavailableNote(status) {
             return { code: "appleDevice" };
     }
 }
-/** What to tell the person when Apple Intelligence cannot answer, in German (the settings). */
-export function appleUnavailable(status) {
-    return noteText(appleUnavailableNote(status), "de");
-}
 /**
  * The failure the helper reports, as the person should read it: a note, so a run shows it in the
  * wizard's language.

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

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

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

@@ -1,6 +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 { resolveEnv, run } from "./env.js";
 import { failureOf, HarnessImageModel, HarnessModel, runClient, } from "./model.js";
 /**
@@ -224,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: "Das Kontingent des ChatGPT-Kontos, mit dem Codex angemeldet ist, ist aufgebraucht. Später noch einmal versuchen oder einen anderen Client wählen.",
+    exhausted: bilingual("Das Kontingent des ChatGPT-Kontos, mit dem Codex angemeldet ist, ist aufgebraucht. Später noch einmal versuchen oder einen anderen Client wählen.", "The quota of the ChatGPT account Codex is signed in with is used up. Try again later or pick another client."),
 };

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

@@ -1,16 +1,17 @@
 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 { 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) => `${h.name} ist auf diesem Gerät nicht angemeldet. Melde dich in den Einstellungen unter „Modelle“ an.`;
-export const notInstalled = (h) => `${h.name} ist auf diesem Gerät nicht installiert. Installiere es in den Einstellungen unter „Modelle“.`;
+export const signedOut = (h) => bilingual(`${h.name} ist auf diesem Gerät nicht angemeldet. Melde dich in den Einstellungen unter „Modelle“ an.`, `${h.name} is not signed in on this device. Sign in under “Models” in the settings.`);
+export const notInstalled = (h) => bilingual(`${h.name} ist auf diesem Gerät nicht installiert. Installiere es in den Einstellungen unter „Modelle“.`, `${h.name} is not installed on this device. Install it under “Models” in the settings.`);
 export const exhausted = (h) => h.exhausted ??
-    `Das Konto, mit dem ${h.name} angemeldet ist, hat kein Guthaben oder Kontingent mehr.`;
+    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.`);
 /** 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,6 +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 { nanoid } from "nanoid";
 import { ServiceError } from "../services/errors.js";
 const BUFFER = 200_000;
@@ -36,7 +37,7 @@ async function ptyModule() {
         return { spawn };
     }
     catch {
-        throw new ServiceError("refused", "Das eingebaute Terminal ist auf diesem Gerät nicht verfügbar. Führe den Befehl in deinem eigenen Terminal aus.");
+        throw new ServiceError("refused", bilingual("Das eingebaute Terminal ist auf diesem Gerät nicht verfügbar. Führe den Befehl in deinem eigenen Terminal aus.", "The built-in terminal is not available on this device. Run the command in your own terminal."));
     }
 }
 function emit(session, event) {
@@ -84,7 +85,7 @@ export async function openTerminal(opts) {
         });
     }
     catch (err) {
-        throw new ServiceError("refused", `Der Befehl konnte nicht starten: ${err.message}`);
+        throw new ServiceError("refused", bilingual(`Der Befehl konnte nicht starten: ${err.message}`, `The command could not start: ${err.message}`));
     }
     const session = {
         id,
@@ -146,7 +147,7 @@ export async function openTerminal(opts) {
 function sessionOf(id) {
     const session = sessions.get(id);
     if (!session) {
-        throw new ServiceError("not_found", "Dieses Terminal gibt es nicht mehr.");
+        throw new ServiceError("not_found", bilingual("Dieses Terminal gibt es nicht mehr.", "This terminal is gone."));
     }
     return session;
 }

package/apps/runtime/dist/manage.js

@@ -187,6 +187,35 @@ export async function publicPlans(base) {
 export function bookUsage(input) {
     return call("POST", "/v1/usage", input);
 }
+const channels = new Map();
+/** The tenant's numbers, cached for a minute. */
+export async function tenantChannels(id) {
+    const hit = channels.get(id);
+    if (hit && Date.now() - hit.at < 60_000) {
+        return hit.value;
+    }
+    const value = await call("GET", `/v1/tenants/${encodeURIComponent(id)}/channels`);
+    channels.set(id, { at: Date.now(), value });
+    return value;
+}
+/** Forgets what the Manage-App said of the tenant's numbers: the next `tenantChannels` asks. */
+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);
+    return call("POST", `/v1/tenants/${encodeURIComponent(id)}/channels/requests`, input);
+}
+/** The tenant takes its open request back. */
+export async function withdrawChannelRequest(id) {
+    channels.delete(id);
+    return call("DELETE", `/v1/tenants/${encodeURIComponent(id)}/channels/requests`);
+}
+/** What a tenant's channel used, priced by the Manage-App: texts by segment, calls by minute. */
+export function bookChannelUsage(id, input) {
+    return call("POST", `/v1/tenants/${encodeURIComponent(id)}/channels/usage`, input);
+}
 /** A push to the mobile app on one device; the Manage-App holds the APNs and FCM keys. */
 export function pushToDevice(input) {
     return call("POST", "/v1/push", input);

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

@@ -1,12 +1,13 @@
 import { noteText } from "@engenty-wizards/shared/run";
 /**
- * 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, the message keeps the German line for the log. Free text has no note.
+ * A failure the person reads, given as a note of `RUN_NOTES` (or `bilingual` words) 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.
  */
 export class NotedError extends Error {
     note;
     constructor(said) {
-        super(typeof said === "string" ? said : noteText(said, "de"));
+        super(typeof said === "string" ? said : noteText(said, "en"));
         this.note = typeof said === "string" ? null : said;
     }
 }
@@ -17,6 +18,10 @@ export class ModelUnavailableError extends NotedError {
 export function noteOf(err) {
     return err instanceof NotedError ? err.note : null;
 }
+/** What a failure says, to pass on: its note where it has one, else its message. */
+export function saidOf(err) {
+    return noteOf(err) ?? err?.message ?? String(err);
+}
 /** A failure in a language: its note where it has one, else its message as it is. */
 export function errorText(err, lang) {
     const note = noteOf(err);

package/apps/runtime/dist/models.js

@@ -8,15 +8,16 @@ 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 { generateSpeech, generateText, } from "ai";
 import { accountToken, linkedAccount } from "./auth/account.js";
 import { DeviceModel, deviceThinks } from "./engine/device.js";
 import { env } from "./env.js";
-import { appleModel, appleStatus, appleTranscriptionModel, appleUnavailable, appleUnavailableNote, } from "./harness/apple.js";
+import { appleModel, appleStatus, appleTranscriptionModel, appleUnavailableNote, } from "./harness/apple.js";
 import { detectHarness, HarnessModel, harness, isHarnessVendor, notInstalled, signedOut, } from "./harness/index.js";
 import { managed } from "./manage.js";
 import { hasFfmpeg } from "./media/ffmpeg.js";
-import { ModelUnavailableError } from "./model-errors.js";
+import { ModelUnavailableError, saidOf } from "./model-errors.js";
 import { seal, unseal } from "./secrets/crypto.js";
 import { vaultDelete, vaultGet, vaultSet } from "./secrets/vault.js";
 import { readSetting, writeSetting } from "./settings.js";
@@ -231,27 +232,29 @@ function ownRef(cfg, cls) {
     // The defaults name gateway models; without a gateway key nothing reaches them.
     return reachable(cfg, env.models[cls]) ? env.models[cls] : "";
 }
-const NOTHING = {
-    classifier: "Für Text ist kein Modell eingerichtet.",
-    standard: "Für Text ist kein Modell eingerichtet.",
-    high: "Für Text ist kein Modell eingerichtet.",
-    highest: "Für Text ist kein Modell eingerichtet.",
-    image: "Für Bilder ist kein Modell eingerichtet.",
-    video: "Für Videos ist kein Modell eingerichtet.",
-    speech: "Für Sprachausgabe ist kein Modell eingerichtet.",
-    audio: "Für Sprachnotizen ist kein Modell eingerichtet.",
+/** 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" },
 };
 /** 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 "Dafür ist das Guthaben gewählt, aber kein Konto angemeldet.";
+        return bilingual("Dafür ist das Guthaben gewählt, aber kein Konto angemeldet.", "The credits are picked for this, but no account is signed in.");
     }
+    const makes = MAKES[cls];
     const provider = bound ? providerInfo(providerOfRef(bound) ?? "") : null;
     if (provider) {
-        return `${NOTHING[cls].replace(/ ist kein Modell eingerichtet\.$/, "")} ist ${provider.name} gewählt, aber kein API Key hinterlegt.`;
+        return bilingual(`Für ${makes.de} ist ${provider.name} gewählt, aber kein API Key hinterlegt.`, `${provider.name} is picked for ${makes.en}, but no API key is set.`);
     }
-    return NOTHING[cls];
+    return bilingual(`Für ${makes.de} ist kein Modell eingerichtet.`, `No model is set up for ${makes.en}.`);
 }
 /**
  * The way to the credits. On a Manage-App's runtime always; alone, through the linked account —
@@ -271,7 +274,7 @@ async function creditAccess(cfg, chosen) {
     const token = await accountToken();
     if (!token) {
         if (chosen) {
-            throw new ModelUnavailableError("Das Konto ist nicht mehr angemeldet. Bitte in den Einstellungen neu anmelden.");
+            throw new ModelUnavailableError(bilingual("Das Konto ist nicht mehr angemeldet. Bitte in den Einstellungen neu anmelden.", "The account is no longer signed in. Please sign in again in the settings."));
         }
         return null;
     }
@@ -298,7 +301,7 @@ async function routeOf(cls) {
 function need(cfg, name) {
     const key = cfg.keys[name];
     if (!key) {
-        throw new ModelUnavailableError(`Für ${providerInfo(name)?.name ?? name} ist kein API Key hinterlegt.`);
+        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}.`));
     }
     return key;
 }
@@ -409,7 +412,7 @@ async function ownLanguageModel(cfg, ref, meta) {
                 };
             }
     }
-    throw new ModelUnavailableError(`Für das Modell "${ref}" ist kein Zugang eingerichtet. Bitte in den Einstellungen einen API Key hinterlegen oder ein Konto anmelden.`);
+    throw new ModelUnavailableError(bilingual(`Für das Modell "${ref}" ist kein Zugang eingerichtet. Bitte in den Einstellungen einen API Key hinterlegen oder ein Konto anmelden.`, `There is no access set up for the model "${ref}". Please add an API key or sign in to an account in the settings.`));
 }
 /**
  * The language model a text class runs on. A run watched from a device that offers the class
@@ -489,7 +492,7 @@ export async function imageModel(meta = {}) {
                 return own(createOpenAI({ apiKey: cfg.keys.openai }).image(aliasOf(id)));
             }
     }
-    throw new ModelUnavailableError("Für Bilder ist kein Modell eingerichtet.");
+    throw new ModelUnavailableError(bilingual("Für Bilder ist kein Modell eingerichtet.", "No model is set up for images."));
 }
 export async function videoModel(meta = {}) {
     const route = await routeOf("video");
@@ -518,7 +521,7 @@ export async function videoModel(meta = {}) {
                 return own(createGateway({ apiKey: cfg.keys.gateway }).videoModel(id), true);
             }
     }
-    throw new ModelUnavailableError("Für Videos ist kein Modell eingerichtet.");
+    throw new ModelUnavailableError(bilingual("Für Videos ist kein Modell eingerichtet.", "No model is set up for videos."));
 }
 /** The model that reads a text aloud. */
 export async function speechModel(meta = {}) {
@@ -526,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("Für Sprachausgabe ist kein Modell eingerichtet.");
+            throw new ModelUnavailableError(bilingual("Für Sprachausgabe ist kein Modell eingerichtet.", "No model is set up for speech."));
         }
         return resolved;
     }
@@ -557,7 +560,7 @@ export async function speechModel(meta = {}) {
                 return own(createOpenAI({ apiKey: cfg.keys.openai }).speech(aliasOf(id)));
             }
     }
-    throw new ModelUnavailableError("Für Sprachausgabe ist kein Modell eingerichtet.");
+    throw new ModelUnavailableError(bilingual("Für Sprachausgabe ist kein Modell eingerichtet.", "No model is set up for speech."));
 }
 /**
  * What turns a voice note into text: a transcription model (ElevenLabs Scribe, Whisper), or a
@@ -708,7 +711,7 @@ 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 `Dein AI Gateway Key ist bei Vercel im kostenlosen Tarif, und der schließt ${model ? `„${model}“` : "dieses Modell"} aus. Abhilfe: bei Vercel Guthaben aufladen (${GATEWAY_TOP_UP}) oder unter Einstellungen → Modelle dafür einen anderen Weg wählen.`;
+    return bilingual(`Dein AI Gateway Key ist bei Vercel im kostenlosen Tarif, und der schließt ${model ? `„${model}“` : "dieses Modell"} aus. Abhilfe: bei Vercel Guthaben aufladen (${GATEWAY_TOP_UP}) oder unter Einstellungen → Modelle dafür einen anderen Weg wählen.`, `Your AI Gateway key is on Vercel's free tier, which leaves out ${model ? `“${model}”` : "this model"}. To fix it: top up at Vercel (${GATEWAY_TOP_UP}) or pick another way for it under Settings → Models.`);
 }
 /** What a key was answered for a model: refusals are asked again soon, as a top-up lifts them. */
 const gatewayProbes = new Map();
@@ -762,7 +765,7 @@ const CONVERSATION_MODEL = env.conversationModel || "gpt-realtime";
 export async function conversationAccess() {
     const cfg = await config();
     if (!cfg.keys.openai) {
-        throw new ModelUnavailableError("Für Sprachgespräche ist kein OpenAI API Key hinterlegt (Einstellungen → Modelle).");
+        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)."));
     }
     return { apiKey: cfg.keys.openai, model: CONVERSATION_MODEL };
 }
@@ -799,11 +802,11 @@ 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)
-                    ? "Dieses Modell gibt es beim Konto nicht."
+                    ? bilingual("Dieses Modell gibt es beim Konto nicht.", "The account has no such model.")
                     : null;
             }
             return catalog?.classes && !catalog.classes[cls]
-                ? "Dafür ist beim Konto kein Modell eingerichtet."
+                ? bilingual("Dafür ist beim Konto kein Modell eingerichtet.", "The account has no model set up for this.")
                 : null;
         }
         const client = harness(resolved.vendor);
@@ -814,7 +817,7 @@ export async function classProblem(cls) {
     }
     catch (err) {
         if (err instanceof ModelUnavailableError) {
-            return err.message;
+            return saidOf(err);
         }
         throw err;
     }
@@ -830,7 +833,7 @@ export async function filmClient(cls) {
     const client = managed ? null : harness(cfg.settings.source);
     if (!client || !FILM_CLIENTS.has(client.id)) {
         return {
-            problem: "Filme macht Claude Code auf diesem Computer mit deinem Abo. Richte es unter „Modelle“ als KI-Abo ein.",
+            problem: bilingual("Filme macht Claude Code auf diesem Computer mit deinem Abo. Richte es unter „Modelle“ als KI-Abo ein.", "Films are made by Claude Code on this computer with your subscription. Set it up as an AI subscription under “Models”."),
         };
     }
     const status = await detectHarness(client.id);
@@ -885,7 +888,7 @@ export async function classWays() {
         }
         let problem = null;
         const access = await creditAccess(cfg, creditsChosen(cfg, cls)).catch((err) => {
-            problem = err.message;
+            problem = saidOf(err);
             return null;
         });
         ways[cls] = access
@@ -910,25 +913,32 @@ export async function classWays() {
 async function appleProblem(cls) {
     const status = await appleStatus();
     if (cls !== "audio") {
-        return status.available ? null : appleUnavailable(status);
+        return status.available ? null : appleUnavailableNote(status);
     }
     if (!status.supported || status.reason === "missing") {
-        return appleUnavailable(status);
+        return appleUnavailableNote(status);
     }
     return (await hasFfmpeg())
         ? null
-        : "Aufnahmen aus Chrome oder Firefox (WebM, Ogg) schreibt dieser Mac erst mit ffmpeg auf; Safari und die App brauchen es nicht. ffmpeg installieren, z. B. mit „brew install ffmpeg“.";
+        : bilingual("Aufnahmen aus Chrome oder Firefox (WebM, Ogg) schreibt dieser Mac erst mit ffmpeg auf; Safari und die App brauchen es nicht. ffmpeg installieren, z. B. mit „brew install ffmpeg“.", "Recordings from Chrome or Firefox (WebM, Ogg) need ffmpeg before this Mac can write them down; Safari and the app do not. Install ffmpeg, e.g. with “brew install ffmpeg”.");
 }
 /** At start the ways are asked once, so a model the key cannot reach shows before a run meets it. */
 export async function checkModelsAtStart() {
     for (const [cls, way] of Object.entries(await classWays())) {
         if (way.kind !== "none" && way.problem) {
-            console.warn(`models: ${cls}: ${way.problem}`);
+            console.warn(`models: ${cls}: ${saidText(way.problem, "en")}`);
         }
     }
 }
+/** The ways with their problems in a language, for whoever reads them. */
+export function waysIn(ways, lang) {
+    return Object.fromEntries(Object.entries(ways).map(([cls, way]) => [
+        cls,
+        { ...way, problem: way.problem && saidText(way.problem, lang) },
+    ]));
+}
 /** What the settings page shows: the choices, which keys are there (never the keys), and the ways. */
-export async function modelSettings() {
+export async function modelSettings(lang = "en") {
     const cfg = await config();
     return {
         source: cfg.settings.source,
@@ -936,7 +946,7 @@ export async function modelSettings() {
         ollamaUrl: cfg.settings.ollamaUrl ?? env.ollamaUrl,
         creditFallback: cfg.settings.creditFallback !== false,
         keys: Object.fromEntries(LOCAL_KEYS.map((k) => [k, Boolean(cfg.keys[k])])),
-        ways: await classWays(),
+        ways: waysIn(await classWays(), lang),
         /** Apple Intelligence on this Mac: shown where the machine can run it, picked once it answers. */
         apple: managed ? null : await appleStatus(),
         /** What a class costs on the credits, where they are at hand. */
@@ -947,7 +957,8 @@ export async function modelSettings() {
 }
 // --- Checking a key ------------------------------------------------------------------
 /** A cheap authenticated call: whether the provider takes the key. Nothing is generated. */
-export async function checkKey(name, key) {
+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: [
@@ -980,12 +991,21 @@ export async function checkKey(name, key) {
         return {
             ok: false,
             message: res.status === 401
-                ? "Der Anbieter kennt diesen Key nicht."
-                : `Der Anbieter antwortet mit ${res.status}.`,
+                ? de
+                    ? "Der Anbieter kennt diesen Key nicht."
+                    : "The provider does not know this key."
+                : de
+                    ? `Der Anbieter antwortet mit ${res.status}.`
+                    : `The provider answers with ${res.status}.`,
         };
     }
     catch {
-        return { ok: false, message: "Der Anbieter ist gerade nicht erreichbar." };
+        return {
+            ok: false,
+            message: de
+                ? "Der Anbieter ist gerade nicht erreichbar."
+                : "The provider cannot be reached right now.",
+        };
     }
 }
 let catalog = new Map();

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

@@ -0,0 +1,77 @@
+import { bookChannelUsage, ManageError, managed, requestChannelNumber, tenantChannels, withdrawChannelRequest, } from "../manage.js";
+import { currentTenant } from "../tenants/tenant.js";
+/**
+ * `server.channels`: the numbers the Manage-App gives the current tenant
+ * (docs/manage-contract.md, "Numbers of a tenant"). Without a Manage-App there are none.
+ */
+/** A refusal of the Manage-App as a plugin passes it on: its status and its code. */
+const asked = (work) => work.catch((err) => {
+    throw err instanceof ManageError
+        ? Object.assign(new Error(err.message), { status: err.status, code: err.code })
+        : err;
+});
+const unmanaged = () => Object.assign(new Error("This runtime has no Manage-App, so it has no numbers."), {
+    status: 404,
+    code: "not_managed",
+});
+export const channelsApi = {
+    async get() {
+        if (!managed) {
+            return null;
+        }
+        const c = await asked(tenantChannels(currentTenant()));
+        return {
+            number: c.number
+                ? {
+                    number: c.number.number,
+                    country: c.number.country,
+                    kinds: c.number.kinds,
+                    providerRef: c.number.providerRef ?? null,
+                }
+                : null,
+            request: c.request
+                ? {
+                    id: c.request.id,
+                    country: c.request.country,
+                    wish: c.request.wish,
+                    createdAt: c.request.createdAt,
+                }
+                : null,
+            shared: c.shared,
+        };
+    },
+    async request(input) {
+        if (!managed) {
+            throw unmanaged();
+        }
+        const { request } = await asked(requestChannelNumber(currentTenant(), {
+            userId: input.userId,
+            country: input.country.toUpperCase(),
+            wish: input.wish ?? null,
+            lang: input.lang,
+        }));
+        return {
+            id: request.id,
+            country: request.country,
+            wish: request.wish,
+            createdAt: request.createdAt,
+        };
+    },
+    async withdraw() {
+        if (!managed) {
+            throw unmanaged();
+        }
+        return (await asked(withdrawChannelRequest(currentTenant()))).withdrawn;
+    },
+    async book(input) {
+        if (!managed || input.quantity <= 0) {
+            return { credits: 0 };
+        }
+        return asked(bookChannelUsage(currentTenant(), {
+            kind: input.kind,
+            quantity: input.quantity,
+            idempotencyKey: input.key,
+            ...(input.runId ? { runId: input.runId } : {}),
+        }));
+    },
+};

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

@@ -20,10 +20,11 @@ import { seal, unseal } from "../secrets/crypto.js";
 import { putIndexEntry, removeIndexEntries } from "../services/project-index.js";
 import { originData } from "../services/space-origin.js";
 import { safeFetch } from "../tools/net-guard.js";
+import { channelsApi } from "./channels.js";
 import { discoverPlugins } from "./discovery.js";
 import { migrateOpenTenants, migratePlugins } from "./migrations.js";
 import { proModulesDir, proSources } from "./pro-state.js";
-import { publicUrlOf } from "./public.js";
+import { publicRefOf, publicUrlOf, sharedUrlOf } from "./public.js";
 import { announceChange, compileRoute, dropPlugin, emptyRecord, loadedPlugin, loadedPlugins, setPlugin, } from "./registry.js";
 import { runsApiFor } from "./runs.js";
 /**
@@ -159,6 +160,12 @@ function apiFor(record) {
                 });
             },
             publicUrl: (path) => publicUrlOf(source.id, path),
+            publicRef: () => publicRefOf(source.id),
+            registerSharedRoute(route) {
+                record.sharedRoutes.push(compileRoute(route));
+            },
+            sharedUrl: (path) => sharedUrlOf(source.id, path),
+            channels: channelsApi,
             runs: runsApiFor(source.id),
             speech: {
                 async conversation() {
@@ -307,6 +314,7 @@ async function load(source) {
             record.assistantTools.clear();
             record.assistantPages = [];
             record.publicRoutes = [];
+            record.sharedRoutes = [];
             record.runners.clear();
             record.jobs.clear();
             record.starters.clear();

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

@@ -6,9 +6,24 @@ import { currentTenant } from "../tenants/tenant.js";
 /**
  * Public addresses of plugins (`server.publicUrl`): `/api/public/plugins/<plugin>/<ref>/…`. The
  * ref names the tenant without giving its id away; one per tenant and plugin, kept for good.
+ * A shared route (`server.sharedUrl`) is `/api/public/plugins/<plugin>/shared/…` for every
+ * tenant: a ref is 24 characters, so it is never `shared`.
  */
+export const SHARED = "shared";
+const rest = (path) => {
+    const p = path.startsWith("/") ? path : `/${path}`;
+    return p === "/" ? "" : p;
+};
 /** The full address of a plugin's public route for the current tenant. */
 export async function publicUrlOf(plugin, path) {
+    return `${env.publicUrl}/api/public/plugins/${plugin}/${await publicRefOf(plugin)}${rest(path)}`;
+}
+/** The full address of a plugin's shared route. */
+export function sharedUrlOf(plugin, path) {
+    return `${env.publicUrl}/api/public/plugins/${plugin}/${SHARED}${rest(path)}`;
+}
+/** The ref of the current tenant's public address for a plugin, made the first time. */
+export async function publicRefOf(plugin) {
     const tenantId = currentTenant();
     const where = and(eq(control.pluginAddress.tenantId, tenantId), eq(control.pluginAddress.plugin, plugin));
     let row = await controlDb.query.pluginAddress.findFirst({ where });
@@ -19,8 +34,7 @@ export async function publicUrlOf(plugin, path) {
             .onConflictDoNothing();
         row = (await controlDb.query.pluginAddress.findFirst({ where }));
     }
-    const rest = path.startsWith("/") ? path : `/${path}`;
-    return `${env.publicUrl}/api/public/plugins/${plugin}/${row.ref}${rest === "/" ? "" : rest}`;
+    return row.ref;
 }
 /** The tenant a plugin's public address belongs to. */
 export async function tenantOfAddress(plugin, ref) {

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

@@ -19,6 +19,7 @@ export function emptyRecord(source) {
         assistantTools: new Map(),
         assistantPages: [],
         publicRoutes: [],
+        sharedRoutes: [],
         runners: new Map(),
         jobs: new Map(),
         starters: new Map(),

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

@@ -5,6 +5,7 @@ import { and, asc, eq, inArray, isNotNull } from "drizzle-orm";
 import { db, schema, withTenant } from "../db/client.js";
 import { answerAsk } from "../engine/asks.js";
 import { watchRun } from "../engine/events.js";
+import { fieldErrorsIn } from "../engine/input.js";
 import { cancel, createRun, goBack, NoCreditsError, RunInputError, retry, reviewStep, submitPage, } from "../engine/runner.js";
 import { saveAsset } from "../files/storage.js";
 import { wizardUnavailable } from "../limits.js";
@@ -81,7 +82,7 @@ export function runsApiFor(pluginId) {
                     if (!(err instanceof RunInputError)) {
                         throw err;
                     }
-                    refused = err.errors;
+                    refused = fieldErrorsIn(err.errors, "en");
                 }
             }
             return { runId, ticket: runTicket(runId), refused };