wizards 0.5.0 → 0.5.1

package/apps/runtime/dist/cli/setup.js

@@ -10,12 +10,12 @@ import { runLogged } from "./exec.js";
 import { command, installedByScript, isCheckout, packageVersion, readInstallNote, writeInstallNote, } from "./home.js";
 import { CLIENTS, detectClients, findChrome, findFfmpeg, findOnPath, suggestedClient, vendorApp, } from "./machine.js";
 import { runningRuntime, settings } from "./start.js";
-import { badge, busy, cyan, dim, tilde } from "./ui.js";
+import { badge, busy, cmd, cyan, dim, tilde } from "./ui.js";
 /** The studio as an app of its own: Chrome (or Edge) installs it from the page. */
-const CHROME_APP = "Tip: in Chrome or Edge the studio installs as an app, in a window of its own with its own icon. The studio offers it at the top; or use the install icon in the address bar.";
+const CHROME_APP = "Tip: in Chrome or Edge you can install the studio as an app, with its own window and icon. Use the offer at the top of the studio, or the install icon in the address bar.";
 function cancelled(value) {
     if (p.isCancel(value)) {
-        p.cancel(`Setup stopped. Run it again with \`${command()} setup\`.`);
+        p.cancel(`Setup stopped. To run it again: ${cmd("setup")}`);
         return true;
     }
     return false;
@@ -29,19 +29,19 @@ async function install(client, paths) {
         task.success(`${client.name} ${installed.version ?? ""} installed`.trim());
         return true;
     }
-    task.error(`${client.name} was not installed${code === 0 ? ": its command is not on the PATH" : ""}. ${tail.split("\n").pop() ?? ""}`);
+    task.error(`${client.name} didn’t install${code === 0 ? ": its command isn’t on the PATH" : ""}. ${tail.split("\n").pop() ?? ""}`);
     return false;
 }
 async function clientsStep(paths, options, interactive) {
-    const spinner = busy("Looking for AI clients on this machine");
+    const spinner = busy("Looking for AI clients on this computer…");
     const found = await detectClients(paths);
     const installed = found.filter((state) => state.path);
     const missing = found.filter((state) => !state.path);
     spinner.stop(installed.length
-        ? `Thinks with: ${installed.map((s) => `${s.client.name} ${s.version}`).join(", ")}`
-        : "No AI client on this machine yet");
+        ? `Found AI clients: ${installed.map((s) => `${s.client.name} ${s.version}`).join(", ")}.`
+        : "No AI client on this computer yet.");
     if (!installed.length) {
-        p.log.message(dim("engenty wizards thinks with one, on the subscription you already have."));
+        p.log.message(dim("engenty wizards uses an AI client to think, on a subscription you already have."));
     }
     let wanted = missing.filter((s) => options.clients.includes(s.client.id));
     if (interactive && missing.length && !wanted.length) {
@@ -50,8 +50,8 @@ async function clientsStep(paths, options, interactive) {
         const offered = [...missing].sort((a, b) => Number(!vendorApp(a.client)) - Number(!vendorApp(b.client)));
         const answer = await p.multiselect({
             message: installed.length
-                ? "Install another AI client? (space to pick, enter to go on)"
-                : "Which one shall I install?",
+                ? "Install another AI client? (space to choose, enter to continue)"
+                : "Which AI client should be installed?",
             options: offered.map(({ client }) => {
                 const app = vendorApp(client);
                 return {
@@ -79,10 +79,10 @@ async function clientsStep(paths, options, interactive) {
         any = (await install(client, paths)) || any;
     }
     if (any) {
-        p.log.info("You sign the client in on the first page of the studio.");
+        p.log.info("Sign in to the AI client on the first page of the studio.");
     }
     else {
-        p.log.warn(`No AI client yet: the first page of the studio installs one, or takes an API key (Vercel AI Gateway, OpenAI, Anthropic) or a local model (Ollama).\n${dim(`Or here, later: ${CLIENTS.map((c) => c.name).join(", ")} with \`${command()} setup\`.`)}`);
+        p.log.warn(`No AI client yet. The first page of the studio can install one, or you can use an API key (Vercel AI Gateway, OpenAI, Anthropic) or a local model (Ollama).\n${dim(`To install ${CLIENTS.map((c) => c.name).join(", ")} here later: ${cmd("setup")}`)}`);
     }
     return any;
 }
@@ -92,7 +92,7 @@ async function toolsStep(interactive) {
         p.log.success(`Browser for PDF and PNG: ${dim(tilde(chrome))}`);
     }
     else {
-        p.log.warn("No Chrome, Edge or Chromium: PDF and PNG exports and browser steps need one.\nhttps://www.google.com/chrome");
+        p.log.warn("No Chrome, Edge or Chromium found. PDF and PNG exports and browser steps need one.\nhttps://www.google.com/chrome");
     }
     const ffmpeg = await findFfmpeg();
     if (ffmpeg.path) {
@@ -101,7 +101,7 @@ async function toolsStep(interactive) {
     }
     const brew = findOnPath("brew", process.env.PATH ?? "");
     if (!interactive || !brew) {
-        p.log.warn(`No ffmpeg: MP4 videos of animated widgets need it.${brew ? `\n${dim("brew install ffmpeg")}` : ""}`);
+        p.log.warn(`No ffmpeg found. MP4 videos of animated widgets need it.${brew ? `\n${dim(`To install it: ${cyan("brew install ffmpeg")}`)}` : ""}`);
         return;
     }
     const answer = await p.confirm({
@@ -120,7 +120,7 @@ async function toolsStep(interactive) {
             task.success("ffmpeg installed");
         }
         else {
-            task.error(`ffmpeg was not installed. ${tail.split("\n").pop() ?? ""}`);
+            task.error(`ffmpeg didn’t install. ${tail.split("\n").pop() ?? ""}`);
         }
     }
 }
@@ -138,18 +138,18 @@ async function autostartStep(paths, interactive) {
         return;
     }
     if (!interactive) {
-        p.log.info(dim(`To start it at login: \`${command()} autostart on\``));
+        p.log.info(dim(`To start it when you log in: ${cmd("autostart on")}`));
         return;
     }
     const answer = await p.confirm({
-        message: "Start engenty wizards when you log in? It keeps running in the background, so links and AI clients always reach it.",
+        message: "Start engenty wizards when you log in? It keeps running in the background, so links and your AI apps can always reach it.",
         initialValue: true,
     });
     if (cancelled(answer)) {
         return "cancelled";
     }
     if (!answer) {
-        p.log.info(dim(`Later: \`${command()} autostart on\``));
+        p.log.info(dim(`To do it later: ${cmd("autostart on")}`));
         return;
     }
     try {
@@ -158,11 +158,11 @@ async function autostartStep(paths, interactive) {
             p.log.success(`Starts at login: ${dim(after.how)}`);
         }
         else {
-            p.log.warn("Starting at login could not be switched on.");
+            p.log.warn("Couldn’t turn on start at login.");
         }
     }
     catch (error) {
-        p.log.warn(`Starting at login could not be switched on. ${error.message}`);
+        p.log.warn(`Couldn’t turn on start at login. ${error.message}`);
     }
 }
 /**
@@ -180,15 +180,15 @@ async function appsStep(paths, interactive) {
         return;
     }
     if (!interactive) {
-        p.log.info(dim(`To use your wizards in ${offered.map((s) => s.name).join(", ")}: \`${command()} connect\``));
+        p.log.info(dim(`To use your wizards in ${offered.map((s) => s.name).join(", ")}: ${cmd("connect")}`));
         return;
     }
     const answer = await p.multiselect({
-        message: "Use your wizards in these AI apps? (space to pick, enter to go on)",
+        message: "Use your wizards in these AI apps? (space to choose, enter to continue)",
         options: offered.map((s) => ({
             value: s.id,
             label: s.name,
-            hint: s.widgets ? "shows runs as a widget" : "as text",
+            hint: s.widgets ? "shows runs as a widget" : "shows runs as text",
         })),
         initialValues: offered.map((s) => s.id),
         required: false,
@@ -197,12 +197,12 @@ async function appsStep(paths, interactive) {
         return "cancelled";
     }
     if (!answer.length) {
-        p.log.info(dim(`Later: \`${command()} connect\``));
+        p.log.info(dim(`To do it later: ${cmd("connect")}`));
         return;
     }
     for (const { app, outcome } of await connectApps(paths, answer)) {
         if (outcome.ok) {
-            p.log.success(`${app.name}: ${dim(tilde(outcome.message))}`);
+            p.log.success(`${app.name}: ${dim(outcome.message)}`);
         }
         else {
             p.log.warn(`${app.name}: ${outcome.message}${outcome.snippet ? `\n${outcome.snippet}` : ""}`);
@@ -234,16 +234,16 @@ async function pathStep(interactive) {
     }
     const { file, line } = pathLine();
     if (existsSync(file) && readFileSync(file, "utf8").includes(".local/bin")) {
-        p.log.info(`Open a new terminal to use the \`wizards\` command.`);
+        p.log.info(`Open a new terminal to use the ${cyan("wizards")} command.`);
         return;
     }
-    const hint = `Until then: ${tilde(join(local, "wizards"))}`;
+    const hint = `Until then, use ${cyan(tilde(join(local, "wizards")))}`;
     if (!interactive) {
-        p.log.warn(`~/.local/bin is not on your PATH. Add to ${tilde(file)}:\n${line}\n${dim(hint)}`);
+        p.log.warn(`~/.local/bin isn’t on your PATH. Add this to ${tilde(file)}:\n${line}\n${dim(hint)}`);
         return;
     }
     const answer = await p.confirm({
-        message: `The \`wizards\` command is in ~/.local/bin, which is not on your PATH. Add it in ${tilde(file)}?`,
+        message: `The wizards command is in ~/.local/bin, which isn’t on your PATH. Add it in ${tilde(file)}?`,
         initialValue: true,
     });
     if (cancelled(answer)) {
@@ -251,7 +251,7 @@ async function pathStep(interactive) {
     }
     if (answer) {
         appendFileSync(file, `\n# engenty wizards\n${line}\n`);
-        p.log.success(`Added to ${tilde(file)}. It works in a new terminal.\n${dim(hint)}`);
+        p.log.success(`Added to ${tilde(file)}. Open a new terminal to use it.\n${dim(hint)}`);
     }
     else {
         p.log.info(hint);
@@ -266,8 +266,12 @@ async function howToUse(paths) {
     const wizards = command();
     const row = (what, cmd, note = "") => `${what.padEnd(9)}${cyan(cmd.padEnd(wizards.length + 12))}${note ? dim(note) : ""}`;
     p.log.message([
-        running ? `It runs now: ${cyan(running.url)}` : "It does not run yet. Nothing was started.",
-        "unavailable" in atLogin || !atLogin.on ? "" : dim("It starts by itself when you log in."),
+        running
+            ? `engenty wizards is running: ${cyan(running.url)}`
+            : "engenty wizards isn’t running yet.",
+        "unavailable" in atLogin || !atLogin.on
+            ? ""
+            : dim("It starts automatically when you log in."),
     ]
         .filter(Boolean)
         .join("\n"));
@@ -275,15 +279,15 @@ async function howToUse(paths) {
         "From now on, in a terminal:",
         "",
         row("Start", `${wizards} start`, "runs in this terminal; Ctrl-C stops it"),
-        row("", `${wizards} start -s`, "runs as a service; the terminal stays free"),
-        row("Studio", `${wizards} studio`, "opens the studio; starts it first if needed"),
+        row("", `${wizards} start -s`, "runs in the background; the terminal stays free"),
+        row("Studio", `${wizards} studio`, "opens the studio, starting it first if needed"),
         row("Stop", `${wizards} stop`, "your data is kept"),
-        row("Check", `${wizards} status`, "what runs and where"),
+        row("Check", `${wizards} status`, "shows what’s running and where"),
         row("Restart", `${wizards} restart`),
-        row("All", wizards, "a menu with all of it"),
+        row("Menu", wizards, "everything in one menu"),
         "",
-        dim("No need to run the installer again: it is installed. To update: ") +
-            cyan(`${wizards} update`),
+        dim("It’s installed, so there’s no need to run the installer again. To update: ") +
+            cmd("update"),
     ].join("\n"));
 }
 /**

package/apps/runtime/dist/cli/start.js

@@ -3,13 +3,13 @@ import { randomBytes } from "node:crypto";
 import { existsSync, mkdirSync, openSync, readFileSync } from "node:fs";
 import { createServer } from "node:net";
 import { join, resolve } from "node:path";
-import { styleText } from "node:util";
 import { mintLocalTicket } from "../auth/local-ticket.js";
 import { readRunning } from "../running.js";
 import { RESTART_EXIT } from "../update.js";
 import { runtimeEnv } from "./environment.js";
-import { command, packageRoot, readEnvFile } from "./home.js";
+import { packageRoot, readEnvFile } from "./home.js";
 import { findOnPath } from "./machine.js";
+import { cmd, cyan, dim, live, tilde } from "./ui.js";
 const DEFAULT_PORT = 24368;
 const START_TIMEOUT_MS = 60_000;
 /** The settings this install starts with: its `.env`, overridden by the terminal's variables. */
@@ -87,13 +87,13 @@ export function openBrowser(url) {
 function show(url, entry, open) {
     const opened = open && openBrowser(entry);
     console.log("");
-    console.log(`  ${styleText("green", "●")} engenty wizards is running: ${styleText("cyan", url)}`);
+    console.log(`  ${live} engenty wizards is running: ${cyan(url)}`);
     if (opened) {
-        console.log(styleText("dim", "    The studio opens in your browser."));
+        console.log(dim("    The studio opens in your browser."));
     }
     else {
-        console.log(`    Open the studio: ${entry}`);
-        console.log(styleText("dim", "    The link lets one browser in and works once."));
+        console.log(`    Open the studio: ${cyan(entry)}`);
+        console.log(dim("    The link signs in one browser and works only once."));
     }
 }
 /** The command of this install, as it is on disk now: `wizards <args>`. */
@@ -146,22 +146,23 @@ export async function start(paths, options) {
     const running = await runningRuntime(dataDir);
     if (running) {
         show(running.url, entryUrl(running, dataDir), options.open);
-        console.log(styleText("dim", `    It was already running; stop it with \`${command()} stop\`.`));
+        console.log(dim(`    It was already running. To stop it: ${cmd("stop")}`));
         return 0;
     }
     if (options.background) {
         const started = await startInBackground(paths);
         if (!started) {
-            console.error(`engenty wizards did not start; see ${join(paths.logs, "runtime.log")}.`);
+            console.error(`engenty wizards didn’t start. Its log is in ${tilde(join(paths.logs, "runtime.log"))}.`);
             return 1;
         }
         show(started.url, entryUrl(started, dataDir), options.open);
-        console.log(styleText("dim", `    It runs in the background; stop it with \`${command()} stop\`. Its log: ${join(paths.logs, "runtime.log")}`));
+        console.log(dim(`    It’s running in the background. To stop it: ${cmd("stop")}`));
+        console.log(dim(`    Its log is in ${tilde(join(paths.logs, "runtime.log"))}.`));
         return 0;
     }
     const port = wanted ?? (await freePort());
     if (!wanted && port !== DEFAULT_PORT) {
-        console.log(styleText("dim", `  Port ${DEFAULT_PORT} is taken, using ${port}.`));
+        console.log(dim(`  Port ${DEFAULT_PORT} is taken, so it uses ${port}.`));
     }
     const accessKey = randomBytes(24).toString("hex");
     const url = appUrl || `http://localhost:${port}`;
@@ -178,7 +179,7 @@ export async function start(paths, options) {
     let exited = null;
     const ended = new Promise((done) => {
         child.on("error", (error) => {
-            console.error(`The runtime did not start: ${error.message}`);
+            console.error(`engenty wizards didn’t start: ${error.message}`);
             exited = 1;
             done(1);
         });
@@ -194,7 +195,7 @@ export async function start(paths, options) {
     while (exited === null && !(await healthy(port))) {
         if (Date.now() - began > START_TIMEOUT_MS) {
             child.kill("SIGTERM");
-            console.error("The runtime did not answer within 60 seconds.");
+            console.error("engenty wizards didn’t respond within 60 seconds.");
             return 1;
         }
         await new Promise((wait) => setTimeout(wait, 150));
@@ -203,7 +204,7 @@ export async function start(paths, options) {
         return exited || 1;
     }
     show(url, `${url}/api/local/enter?k=${accessKey}`, options.open);
-    console.log(styleText("dim", "    Stop it with Ctrl-C."));
+    console.log(dim("    To stop it, press Ctrl-C."));
     console.log("");
     const code = await ended;
     if (code !== RESTART_EXIT) {
@@ -211,7 +212,7 @@ export async function start(paths, options) {
     }
     // Updated or `wizards restart`: the command as it is on disk now starts it again, in this
     // terminal or under the login item, which keeps waiting on this process.
-    console.log(styleText("dim", "  Starting it again."));
+    console.log(dim("  Restarting…"));
     current = spawnCommand(paths, ["start", "--no-open"], { stdio: "inherit" });
     return new Promise((done) => {
         current.on("error", () => done(1));
@@ -233,7 +234,7 @@ export async function open(paths, print) {
     const { dataDir } = settings(paths);
     const running = await runningRuntime(dataDir);
     if (!running) {
-        console.error(`engenty wizards is not running. Start it with \`${command()} start\`.`);
+        console.error(`engenty wizards isn’t running. To start it: ${cmd("start")}`);
         return 1;
     }
     const entry = entryUrl(running, dataDir);

package/apps/runtime/dist/cli/status.js

@@ -5,7 +5,7 @@ import { autostartState, setAutostart } from "./autostart.js";
 import { installedByScript, isCheckout, packageRoot, packageVersion } from "./home.js";
 import { detectClients, findChrome, findFfmpeg, nodeIsCurrent } from "./machine.js";
 import { entryUrl, runningRuntime, settings, startInBackground } from "./start.js";
-import { bad, badge, cyan, dim, no, ok, tilde } from "./ui.js";
+import { bad, badge, cmd, cyan, dim, no, ok, tilde } from "./ui.js";
 /**
  * What is installed and what runs. With `checks` (`doctor`) it also says what is wrong and
  * returns 1 when something is.
@@ -28,24 +28,24 @@ export async function status(paths, checks) {
     row("Data", tilde(dataDir));
     row("Node", `${process.version} ${dim(tilde(process.execPath))}`);
     row("Running", running
-        ? `${ok} ${cyan(running.url)} ${dim(`pid ${running.pid}, since ${running.startedAt}`)}`
+        ? `${ok} ${cyan(running.url)} ${dim(`pid ${running.pid}, since ${new Date(running.startedAt).toLocaleString()}`)}`
         : `${no} not running`);
     if (!("unavailable" in atLogin)) {
-        row("At login", atLogin.on ? `${ok} starts ${dim(`(${atLogin.how})`)}` : `${no} does not start`);
+        row("At login", atLogin.on ? `${ok} starts ${dim(`(${atLogin.how})`)}` : `${no} doesn’t start`);
     }
     row("Account", `${account.kind === "linked" ? ok : no} ${describeAccount(account)}`);
     for (const { client, path, version } of clients) {
         row(client.name.split(" ")[0], path ? `${ok} ${version} ${dim(tilde(path))}` : `${no} not installed`);
     }
-    row("Browser", chrome ? `${ok} ${dim(tilde(chrome))}` : `${no} none for PDF and PNG`);
-    row("ffmpeg", ffmpeg.path ? `${ok} ${ffmpeg.version ?? ""}` : `${no} none for MP4`);
+    row("Browser", chrome ? `${ok} ${dim(tilde(chrome))}` : `${no} not found (needed for PDF and PNG)`);
+    row("ffmpeg", ffmpeg.path ? `${ok} ${ffmpeg.version ?? ""}` : `${no} not found (needed for MP4)`);
     console.log("");
     if (!checks) {
         return 0;
     }
     const problems = [];
     if (!nodeIsCurrent()) {
-        problems.push(`Node ${process.version} is too old: 24.11 or newer is needed.`);
+        problems.push(`Node ${process.version} is too old. engenty wizards needs 24.11 or newer.`);
     }
     for (const part of ["apps/runtime/dist/index.js", "apps/web/dist/index.html", "plugin"]) {
         if (!existsSync(join(packageRoot, part))) {
@@ -57,16 +57,16 @@ export async function status(paths, checks) {
         accessSync(paths.home, constants.W_OK);
     }
     catch {
-        problems.push(`${tilde(paths.home)} cannot be written to.`);
+        problems.push(`${tilde(paths.home)} can’t be written to.`);
     }
     if (!clients.some((state) => state.path)) {
-        console.log(`  ${no} No AI client: the studio needs an API key, Ollama or Apple Intelligence (a Mac) instead. ${dim("`setup` installs one.")}`);
+        console.log(`  ${no} No AI client. The studio needs an API key, Ollama or Apple Intelligence (Mac only) instead. ${dim(`To install one: ${cmd("setup")}`)}`);
     }
     for (const problem of problems) {
         console.log(`  ${bad} ${problem}`);
     }
     if (!problems.length) {
-        console.log(`  ${ok} Nothing wrong with this install.`);
+        console.log(`  ${ok} No problems found.`);
     }
     console.log("");
     return problems.length ? 1 : 0;
@@ -89,7 +89,7 @@ export async function stop(paths) {
     const { dataDir } = settings(paths);
     const running = await runningRuntime(dataDir);
     if (!running) {
-        console.log("engenty wizards is not running.");
+        console.log("engenty wizards isn’t running.");
         return 0;
     }
     process.kill(running.pid, "SIGTERM");
@@ -97,7 +97,7 @@ export async function stop(paths) {
         console.log(`Stopped (pid ${running.pid}). Your data is kept.`);
         return 0;
     }
-    console.error(`The runtime (pid ${running.pid}) did not stop within 8 seconds.`);
+    console.error(`engenty wizards (pid ${running.pid}) didn’t stop within 8 seconds.`);
     return 1;
 }
 /**
@@ -118,31 +118,31 @@ export async function restart(paths) {
                 return 0;
             }
         }
-        console.error("engenty wizards did not start again within a minute.");
+        console.error("engenty wizards didn’t restart within a minute.");
         return 1;
     }
     if (running) {
         process.kill(running.pid, "SIGTERM");
         if (!(await ended(running.pid, 8000))) {
-            console.error(`The runtime (pid ${running.pid}) did not stop within 8 seconds.`);
+            console.error(`engenty wizards (pid ${running.pid}) didn’t stop within 8 seconds.`);
             return 1;
         }
     }
     const started = await startInBackground(paths);
     if (!started) {
-        console.error(`engenty wizards did not start; see ${join(paths.logs, "runtime.log")}.`);
+        console.error(`engenty wizards didn’t start. Its log is in ${tilde(join(paths.logs, "runtime.log"))}.`);
         return 1;
     }
     console.log(`${ok} ${running ? "Restarted" : "Started"}: ${cyan(started.url)} ${dim(`pid ${started.pid}, in the background`)}`);
     if (!running) {
-        console.log(`  Open the studio: ${entryUrl(started, dataDir)}`);
+        console.log(`  Open the studio: ${cyan(entryUrl(started, dataDir))}`);
     }
     return 0;
 }
 /** `autostart [on|off]`: whether it starts at login, and the switch. */
 export async function autostart(paths, value) {
     if (value && value !== "on" && value !== "off") {
-        console.error("autostart takes on or off.");
+        console.error(`Use ${cmd("autostart on")} or ${cmd("autostart off")}.`);
         return 2;
     }
     let state = await autostartState(paths);
@@ -151,19 +151,19 @@ export async function autostart(paths, value) {
             state = await setAutostart(paths, value === "on");
         }
         catch (error) {
-            console.error(`Starting at login could not be switched ${value}: ${error.message}`);
+            console.error(`Couldn’t turn start at login ${value}: ${error.message}`);
             return 1;
         }
     }
     if ("unavailable" in state) {
-        console.error(`Starting at login is not possible here: ${state.unavailable}.`);
+        console.error(`Start at login isn’t available here: ${state.unavailable}.`);
         return value ? 1 : 0;
     }
     console.log(state.on
         ? `${ok} engenty wizards starts at login: ${state.how}.`
-        : `${no} engenty wizards does not start at login. ${dim("`autostart on` switches it on.")}`);
+        : `${no} engenty wizards doesn’t start at login. ${dim(`To turn it on: ${cmd("autostart on")}`)}`);
     if (state.on && process.platform === "linux") {
-        console.log(dim("  Before anybody logs in, too: loginctl enable-linger"));
+        console.log(dim(`  To start it even before anyone logs in: ${cyan("loginctl enable-linger")}`));
     }
     return value && state.on !== (value === "on") ? 1 : 0;
 }

package/apps/runtime/dist/cli/ui.js

@@ -1,6 +1,7 @@
 import { homedir } from "node:os";
 import { styleText } from "node:util";
 import * as p from "@clack/prompts";
+import { command } from "./home.js";
 const colours = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
 /** The name on engenty's orange. */
 export const badge = (text) => colours ? `\x1b[48;2;224;83;27m\x1b[97m\x1b[1m ${text} \x1b[0m` : text;
@@ -10,15 +11,21 @@ export const cyan = (text) => styleText("cyan", text);
 export const ok = styleText("green", "✓");
 export const no = styleText("yellow", "–");
 export const bad = styleText("red", "✗");
+export const live = styleText("green", "●");
 /** A path as the person would write it. */
 export const tilde = (path) => path.startsWith(homedir()) ? `~${path.slice(homedir().length)}` : path;
-/** A spinner on a terminal; where nobody watches, only what came of it. */
+/** A command as the person types it, with this install's prefix: `cmd("stop")` → wizards stop. */
+export const cmd = (args = "") => cyan(args ? `${command()} ${args}` : command());
+/**
+ * A spinner on a terminal; where nobody watches, only what came of it. The message ends in "…"
+ * ("Checking status…"); clack animates its own dots in its place.
+ */
 export function busy(message) {
     if (!process.stdout.isTTY) {
         return { stop: (text) => p.log.step(text), fail: (text) => p.log.warn(text) };
     }
     const spinner = p.spinner();
-    spinner.start(message);
+    spinner.start(message.replace(/…$/, ""));
     return {
         stop: (text) => spinner.stop(text),
         fail: (text) => spinner.error(text),

package/apps/runtime/dist/cli/update.js

@@ -1,10 +1,10 @@
 import { spawn } from "node:child_process";
 import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { command, installedByScript, isCheckout } from "./home.js";
+import { installedByScript, isCheckout } from "./home.js";
 import { runningRuntime, settings } from "./start.js";
 import { restart } from "./status.js";
-import { cyan } from "./ui.js";
+import { cmd, cyan } from "./ui.js";
 /** The installer this install was made with; it also updates one. */
 const INSTALLER = "https://engenty.ai/install.sh";
 async function installer(into) {
@@ -16,7 +16,7 @@ async function installer(into) {
     const text = response.ok ? await response.text() : "";
     // The address answers with the studio's page while a server has no installer yet.
     if (!text.startsWith("#!")) {
-        throw new Error(`${source} did not answer with the installer.`);
+        throw new Error(`${source} didn’t return the installer.`);
     }
     const file = join(into, "install.sh");
     writeFileSync(file, text, { mode: 0o700 });
@@ -30,8 +30,8 @@ async function installer(into) {
 export async function update(paths, options = {}) {
     if (!installedByScript(paths)) {
         console.log(isCheckout()
-            ? `This copy is a checkout. The newest version: ${cyan("git pull && pnpm install && pnpm build")}`
-            : `This copy runs from npm. The newest version: ${cyan("npx wizards@latest")}`);
+            ? `This is a source checkout. To update: ${cyan("git pull && pnpm install && pnpm build")}`
+            : `This copy runs from npm. To update: ${cyan("npx wizards@latest")}`);
         return 0;
     }
     const tmp = mkdtempSync(join(paths.home, "update-"));
@@ -57,7 +57,7 @@ export async function update(paths, options = {}) {
         if (options.restart) {
             return restart(paths);
         }
-        console.log(`  The runtime that is running is still the old one. Restart it: ${cyan(`${command()} restart`)}`);
+        console.log(`  Installed. Restart engenty wizards to use the new version: ${cmd("restart")}`);
     }
     return 0;
 }

package/apps/runtime/dist/cli/validate.js

@@ -51,7 +51,7 @@ export function validatePath(path) {
 }
 export function validateCommand(paths, asJson) {
     if (!paths.length) {
-        console.error("Name a .wizard file, an unpacked package or a wizard's JSON.");
+        console.error("Give a path: a .wizard file, an unpacked package or a wizard JSON file.");
         return 2;
     }
     const results = paths.map(validatePath);

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

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

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

@@ -170,7 +170,7 @@ export function oauthStateRun(rawState) {
 export async function finishOAuth(answer, rawState) {
     const state = unseal(rawState);
     if (!state || state.exp < Date.now()) {
-        throw new Error("The sign-in has expired. Please connect again.");
+        throw new Error("The sign-in has expired. Connect again.");
     }
     const run = await db.query.run.findFirst({ where: eq(schema.run.id, state.runId) });
     const connection = run?.definition.connections?.find((c) => c.id === state.connectionId);
@@ -244,16 +244,16 @@ function connectFailure(err) {
     const host = e.imapHost ? ` (${e.imapHost})` : "";
     if (e.authenticationFailed) {
         const answer = e.responseText?.slice(0, 160);
-        return bilingual(`Anmeldung abgelehnt${host}. Stimmen Adresse und (App-)Passwort? Bei Gmail und Google Workspace braucht es ein App-Passwort und aktiviertes IMAP.${answer ? ` Antwort des Servers: ${answer}` : ""}`, `Sign-in refused${host}. Are the address and (app) password right? Gmail and Google Workspace need an app password and IMAP switched on.${answer ? ` The server answered: ${answer}` : ""}`);
+        return bilingual(`Anmeldung abgelehnt${host}. Stimmen Adresse und (App-)Passwort? Gmail und Google Workspace brauchen ein App-Passwort und eingeschaltetes IMAP.${answer ? ` Antwort des Servers: ${answer}` : ""}`, `The sign-in was refused${host}. Are the address and (app) password right? Gmail and Google Workspace need an app password and IMAP turned on.${answer ? ` The server said: ${answer}` : ""}`);
     }
     if (e.code === "ENOTFOUND") {
-        return bilingual(`Den Mail-Server${host} gibt es nicht. Bitte den IMAP-Server eintragen, bei Gmail und Google Workspace imap.gmail.com.`, `The mail server${host} does not exist. Please enter the IMAP server; for Gmail and Google Workspace it is imap.gmail.com.`);
+        return bilingual(`Den Mail-Server${host} gibt es nicht. Trag den IMAP-Server ein, bei Gmail und Google Workspace imap.gmail.com.`, `The mail server${host} doesn’t exist. Enter the IMAP server. For Gmail and Google Workspace, it’s imap.gmail.com.`);
     }
     if (e.code === "ETIMEDOUT" || e.code === "ETIMEOUT" || e.code === "ECONNREFUSED") {
-        return bilingual(`Der Mail-Server${host} antwortet nicht. Bitte IMAP-Server und Port prüfen.`, `The mail server${host} does not answer. Please check the IMAP server and port.`);
+        return bilingual(`Der Mail-Server${host} antwortet nicht. Prüf IMAP-Server und Port.`, `The mail server${host} isn’t responding. Check the IMAP server and port.`);
     }
     const detail = String(e.message ?? err).slice(0, 200);
-    return bilingual(`Verbinden hat nicht geklappt${host}: ${detail}`, `Connecting did not work${host}: ${detail}`);
+    return bilingual(`Verbinden hat nicht geklappt${host}: ${detail}`, `Connecting didn’t work${host}: ${detail}`);
 }
 export function disconnect(scope, connectionId) {
     return deleteSecret(scope, slot(connectionId));

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

@@ -37,7 +37,7 @@ async function spaceExists(space) {
         columns: { id: true },
     });
     if (!project) {
-        throw new Error(`There is no space "${space}".`);
+        throw new Error(`There’s no space “${space}”.`);
     }
 }
 /** Keeps a connection: the same account for the same space again replaces the first one. */
@@ -101,7 +101,7 @@ export function pluginStateTenant(rawState) {
 export async function finishPluginOAuth(answer, rawState) {
     const state = unseal(rawState);
     if (!state?.plugin || state.exp < Date.now()) {
-        throw new Error("The sign-in has expired. Please connect again.");
+        throw new Error("The sign-in has expired. Connect again.");
     }
     const connector = oauthConnector(state.connectorId);
     if (connector.auth.kind !== "oauth2") {