wizards 0.4.7 → 0.5.1

package/README.md

@@ -10,32 +10,28 @@
   Let AI do the work.
 </p>
 
-<p align="center">
-  <img src="docs/assets/setup.png" alt="The first start of engenty wizards: choose the engine it thinks with — Codex, Claude Code, Gemini CLI, Cursor Agent or your own keys">
-</p>
-
 ## What it does
 
-- **Describe it, get a wizard.** Say in plain words what you do again and again — a post with
-  an image, a research briefing, an invoice, a quote, a damage report — and engenty builds a
+- **Describe it, get a wizard.** Say in plain words what you do again and again – a post with
+  an image, a research briefing, an invoice, a quote, a damage report – and engenty builds a
   wizard for it: pages that ask what it needs, AI steps that do the work.
 - **AI steps do the work.** They research the web, write, draw images, render video, read PDFs,
-  scans and mails, build documents and dashboards, and write into other services over MCP, HTTP
+  scans and emails, build documents and dashboards, and write into other services over MCP, HTTP
   or a browser. Anything that changes an account asks first.
 - **Share it with a link.** Anyone can run a wizard in the browser, on a phone too: camera,
   code scan, voice notes, location and a drawn signature included. Results download as PDF,
-  Word, HTML, Markdown, PNG, MP4, CSV, Excel or JSON, or go out as a link.
-- **Runs on your machine, on your subscription.** It thinks with Codex, Claude Code, Gemini CLI
+  Word, HTML, Markdown, PNG, MP4, MP3, CSV, Excel or JSON, or go out as a link.
+- **Runs on your machine, on your subscription.** It uses Codex, Claude Code, Gemini CLI
   or Cursor Agent when one is installed and signed in, so no API key is needed. Or bring a key
   (Vercel AI Gateway, OpenAI, Anthropic), or a local model through Ollama. Your wizards and
   results stay in a folder on your machine.
 
 ## How it looks
 
-The studio: a wizard's steps as a flow with its branches, next to the conversation that changes them.
+The studio: a wizard’s steps as a flow with its branches, next to the conversation that changes them.
 
 <p align="center">
-  <img src="docs/assets/studio.png" alt="The studio of engenty wizards: the flow of a wizard that collects a month's receipts for bookkeeping — two pages of questions, AI steps that branch to the inbox and to customer portals, a review and the result — with the conversation beside it">
+  <img src="docs/assets/studio.png" alt="The studio of engenty wizards: the flow of a wizard that collects a month's receipts for bookkeeping – two pages of questions, AI steps that branch to the inbox and to customer portals, a review and the result – with the conversation beside it">
 </p>
 
 A wizard in use: it asks on one page, then on the next, and ends with the result to download or share.
@@ -46,14 +42,14 @@ A wizard in use: it asks on one page, then on the next, and ends with the result
 
 ## Get started
 
-Create an account at [engenty.ai](https://engenty.ai): it is in a closed beta, so "Get started"
-takes your e-mail for an invitation, or your invitation code. Signed in, the studio asks who
+Create an account at [engenty.ai](https://engenty.ai): it is in a closed beta, so “Get started”
+takes your email for an invitation, or your invitation code. Signed in, the studio asks who
 your team is, reads your website into your space, takes first documents, and you build your
-first wizard in the browser. Links run day and night on the team's credits.
+first wizard in the browser. Links run day and night on the team’s credits.
 
 ## Install it on your computer
 
-The same account on your own machine: it thinks with your Claude, ChatGPT, Gemini or Cursor
+The same account on your own machine: it runs on your Claude, ChatGPT, Gemini or Cursor
 subscription, reads your local files and browses for you, and what you publish keeps running in
 the cloud behind the same links. On macOS or Linux, in a terminal:
 
@@ -65,19 +61,23 @@ It needs nothing but `curl` and `tar` and asks for no password. It brings its ow
 Node you already have is left alone), installs engenty wizards into `~/.engenty/wizards` and
 then walks you through the rest:
 
-- **Your engenty account.** A code and the browser for the sign-in; your team's space comes
-  down to this computer. "Later" skips it, `wizards account sign-in` does it any time.
+- **Your engenty account.** “Sign in now?”: a code and the browser for the sign-in; what you
+  publish on this computer then runs in the cloud too. Say no, and `wizards account sign-in`
+  does it any time.
   `--local` leaves the account out: nothing leaves the computer, links answer on it only
   ([local only](https://engenty.ai/docs/user/local-only)).
-- **Something to think with.** It looks for Codex, Claude Code, Gemini CLI and Cursor Agent and
-  offers to install one if there is none — first the one whose app (Claude, ChatGPT, Cursor) is
+- **An AI client.** It looks for Codex, Claude Code, Gemini CLI and Cursor Agent and
+  offers to install the missing ones – first the one whose app (Claude, ChatGPT, Cursor) is
   on your Mac, as its subscription is most likely yours already. The first page of the studio
-  installs them too. Or use your account's credits, an API key or [Ollama](https://ollama.com).
-- **Google Chrome and ffmpeg** (optional): Chrome for PDF and PNG exports and for steps that use
-  a browser, ffmpeg for MP4 videos of animated widgets.
+  installs them too. Or use your account’s credits, an API key, [Ollama](https://ollama.com) or,
+  on a Mac with Apple silicon and macOS 26, Apple Intelligence.
+- **A browser and ffmpeg** (optional): Chrome, Edge or Chromium (on a Mac also Brave) for PDF
+  and PNG exports and for steps that use a browser, ffmpeg for MP4 videos of animated widgets.
 - **Start at login** (optional): engenty wizards starts in the background when you log in (a
   LaunchAgent on a Mac, a systemd user service on Linux). Links and AI clients then always
   reach it. `wizards autostart on` or `off` switches it later.
+- **Your AI apps** (optional): adds your wizards to the AI apps it finds, such as Claude
+  Desktop, Cursor or Codex. `wizards connect` and `wizards disconnect` do it later.
 
 It starts nothing. Afterwards:
 
@@ -86,6 +86,7 @@ wizards start
 ```
 
 starts it and opens the studio; it runs while that terminal is open, Ctrl-C stops it.
+`wizards start -s` starts it in the background instead.
 `wizards` opens a menu with all of it, `wizards status` says what is installed and what runs,
 `wizards setup` runs the guided setup again, and `wizards --help` lists the rest.
 
@@ -99,29 +100,30 @@ You need Node.js 24.11 or newer and pnpm 10 (`corepack enable`).
 
 ```bash
 git clone https://github.com/engenty/wizards.git
-cd engenty-wizards
+cd wizards
 pnpm install
 pnpm build
 pnpm wizards
 ```
 
-pnpm may list "Ignored build scripts" — that's expected, nothing to do.
+pnpm may list “Ignored build scripts” – that’s expected, nothing to do.
 
 Code steps (shell, Node, Python) run in a sandbox when Docker and the sandbox image are on the
 machine; a checkout brings its own sandbox, the installed version has none yet.
 
 ## First start
 
-The setup shows your account at the top and asks what engenty should think with. Pick an AI
-client that is installed on your computer — engenty uses your existing subscription and signs
-it in for you in a terminal right on the page — your account's credits, or enter your own keys.
+The setup shows your account at the top and asks how the AI should run. Pick an AI
+client that is installed on your computer – engenty uses your existing subscription and signs
+it in for you in a terminal right on the page – your account’s credits, Apple Intelligence on a
+Mac that has it, or your own keys.
 It stays until a test call works, then the studio opens.
 
-Change it later under Settings.
+Change it later under Settings → Models.
 
 ## Using it
 
-- **Make a wizard:** describe it in the studio's chat, or start from one of the starters.
+- **Make a wizard:** describe it in the studio’s chat, or start from one of the templates.
   You see the steps as a diagram and can change any of them.
 - **Run and share:** try it yourself, then share the link. Shared results are kept for 7 days
   for people without an account.
@@ -129,8 +131,9 @@ Change it later under Settings.
   GitHub, HubSpot and S3 are built in; any other service can be added from its API description
   or MCP server through the [integrations.sh](https://integrations.sh) registry. Services that
   sign in with OAuth need a few settings first: [Connectors](docs/development.md#connectors).
-- **Build from Claude Code or Codex:** Settings → "Build with Claude Code & co." creates a key
-  and shows the command to add engenty wizards to your AI client.
+- **Build from Claude Code or Codex:** Settings → Integrate adds engenty wizards to your AI
+  apps (Claude Desktop, Claude Code, Codex, Cursor and others), or `wizards connect` from a
+  terminal.
 
 Your machine only answers on `localhost`. To let others open shared wizards, run it on a server.
 
@@ -149,12 +152,12 @@ Back up the folder; delete it to start over. Settings go into `~/.engenty/wizard
 wizards update
 ```
 
-This runs the installer again without its questions. The studio says when a newer release is
-out and can run the same update from its footer.
+This runs the installer again without its questions. The studio says in a banner at the top
+when a newer release is out and can run the same update from there or from its About dialog.
 From source: `git pull`, `pnpm install`, `pnpm build`. Your data is brought up to date at the
 next start.
 
-To remove engenty wizards, run `wizards autostart off`, then delete `~/.engenty/wizards` (your data is in its `data` folder) and
+To remove engenty wizards, run `wizards stop`, `wizards autostart off` and `wizards disconnect`, then delete `~/.engenty/wizards` (your data is in its `data` folder) and
 `~/.local/bin/wizards`.
 
 ## Run it on a server
@@ -163,24 +166,24 @@ With Docker, behind an https proxy (Caddy, Traefik, Coolify):
 
 ```bash
 git clone https://github.com/engenty/wizards.git
-cd engenty-wizards
+cd wizards
 cp .env.example .env    # set APP_URL to your https address and add a model key
 docker compose up -d --build
 docker compose logs     # shows the link to open once
 ```
 
-Point the proxy at port 8891. On a server, engenty thinks with your keys or Ollama; the
-AI clients' subscriptions live on your own computer. The code sandbox is off in this image.
+Point the proxy at port 8891. On a server, engenty uses your keys or Ollama; the
+AI clients’ subscriptions live on your own computer. The code sandbox is off in this image.
 
 ## Troubleshooting
 
 | | |
 |---|---|
-| "This link is no longer valid" | The link works once. `wizards open` gives this browser a new one. |
+| “This link is no longer valid” | The link works once. `wizards open` gives this browser a new one. |
 | `wizards`: command not found | Open a new terminal, or run `~/.local/bin/wizards`. |
 | You open it under another address | Set `APP_URL` in `~/.engenty/wizards/.env` to the address you open. |
-| An AI client shows as not signed in | Sign it in on the setup page, or in your own terminal (e.g. `claude`, `codex login`), then "Check again". |
-| PDF or PNG export fails | Install Google Chrome, or set `CHROME_PATH` to Chrome or Chromium. |
+| An AI client shows as not signed in | Sign it in on the setup page, or in your own terminal (e.g. `claude`, `codex login`), then “Check again”. |
+| PDF or PNG export fails | Install Chrome, Edge or Chromium (on a Mac also Brave), or set `CHROME_PATH` to one. |
 | Port 24368 is taken | The next free port is used. To fix one, set `API_PORT` in `~/.engenty/wizards/.env`. |
 | Something else | `wizards doctor` checks the install. |
 
@@ -194,12 +197,12 @@ Development server, checks, how it is built, the managed mode:
 Plugins add tools for steps, routes with their own tables and pages in the studio, without
 changing the runtime: [docs/content/dev/plugins](docs/content/dev/plugins/index.md).
 
-The documentation — a user guide and the developer docs — is in [docs/content](docs/content)
+The documentation – a user guide and the developer docs – is in [docs/content](docs/content)
 and is a site of its own: `pnpm dev:docs`.
 
 ## License
 
-[FSL-1.1-MIT](LICENSE): use it for yourself and your company, run it, change it — just don't
+[FSL-1.1-MIT](LICENSE): use it for yourself and your company, run it, change it – just don’t
 offer it to others as a competing product or service. Each release becomes MIT two years
 after it is published. [COPYRIGHTS.md](COPYRIGHTS.md) names the owner, the marks, what is not ours and the
 third-party software with its licences.

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

@@ -24,7 +24,7 @@ export function signalText(taken) {
 const MAX_STEPS = 24;
 const SYSTEM = `You are Goose, the assistant of the engenty wizards studio. You stand on every page of the studio except the wizard editor, which has a chat of its own: the space's pages, the settings, the plugins' pages. You help the person who works here understand the app, set it up and find their way.
 
-You talk to the person. Answer in their language, briefly and warmly: a few sentences, a short list where it helps. Never mention JSON, ids, keys or tool names. Call it a space (German „Space“), never a project: the tools say project, the app says space.
+You talk to the person. Answer in their language, briefly and warmly: a few sentences, a short list where it helps. Never mention JSON, ids, keys or tool names. Call it a space, never a project: the tools say project, the app says space. Name the studio's parts and pages as the studio shows them in the person's language.
 
 ${PRIMER}
 
@@ -42,9 +42,9 @@ THE PAGE
 - fill_field never saves: say that the person checks and saves. You never press buttons for the person.
 
 THE SPACE
-- Where a space's tools are there, you also fill the space in: what every wizard of the space draws on — who they are (title, about), the brand (logos, colours), assets (images, graphics, videos), documents, and facts (label → value: address, VAT id, phone, opening hours — anything). The space as it is now comes with every message then; you change it ONLY through tools.
-- A website: read_website it first. You get the page's text, colours from its stylesheet, logo candidates and the links to imprint / contact / about. Read those pages too (at most four more) for address, VAT id, register number, phone, email, bank details, who runs it.
-- Facts: one fact per thing, a short label in the person's language ("Adresse", "UID", "Telefon"), the value on one line where it fits. Only what a source or the person states — never guess, never invent. Keep the facts that are there; a fact with a known label is updated.
+- Where a space's tools are there, you also fill the space in: what every wizard of the space draws on — who they are (title, about), the brand (logos, colours), assets (images, graphics, videos), documents, and facts (label → value: address, VAT ID, phone, opening hours — anything). The space as it is now comes with every message then; you change it ONLY through tools.
+- A website: read_website it first. You get the page's text, colours from its stylesheet, logo candidates and the links to imprint / contact / about. Read those pages too (at most four more) for address, VAT ID, register number, phone, email, bank details, who runs it.
+- Facts: one fact per thing, a short label in the person's language ("Adresse", "USt-IdNr.", "Telefon"), the value on one line where it fits. Only what a source or the person states — never guess, never invent. Keep the facts that are there; a fact with a known label is updated.
 - About: two to five sentences — what they do, for whom, what sets them apart, the tone they write in. Rewrite it only when you learned something new or the person asks.
 - Colours: two to six, the main one first, each with a name that says what it is for ("Primär", "Hintergrund", "Text"). Take them from the stylesheet's variables or its most used colours, never from photos. set_colors replaces the list: pass all colours that should remain. Colours in no section are the standard ones; the first of them is the accent. Colour sections are optional like logo sections: only for a further palette a brand guide or the person names for its own use ("Illustration – drawings and charts"), never for the standard colours. A brand's gradients (set_gradients, as CSS) only where a brand guide or the site's stylesheet has them; patterns and background fills are pictures the person uploads.
 - Logos: save the best candidate (an SVG or a large PNG rather than a favicon); a second one only if it truly differs (for dark ground, a signet). A few images that show the business (header, team, products) may be saved as assets — a handful, never everything.
@@ -52,7 +52,7 @@ THE SPACE
 - Typography: the brand's fonts (set_typography), each with what it is for ("Headings", "Body text") and the weights it uses — from the website's stylesheet (read_website lists its fonts) or a brand guide; system and generic faces are no brand fonts. A font's licence and what it may be used for (web, documents, print, images, video) only where a brand guide, the font's own page or the person says so; the wizards keep to it. A type scale (text styles: name, size, weight, line height, letter spacing) only when a brand guide gives one.
 - Asset sections are optional too: tabs of one kind each ("Icons", "Background images"), made with set_asset_sections only when the space holds enough assets of clearly different kinds or the person asks; a handful of pictures stay in the general tab.
 - Files the person attached are stored already; the message names them. look_at_file shows you a picture or a document's text. Give a file a description with describe_file when it has none or the person says what it is. Take facts from a document when asked.
-- Wissen (German „Wissen“) is what the wizards' steps look things up in: pages, tables and files, kept apart by typed Kategorien. Documents the person attaches are read into Wissen by themselves: say so; do not copy their text into facts unless asked. A website, a sitemap or a folder whose entries should go into Wissen is a source: where a tool proposes sources, use it (the person takes the proposal on its card); where there is none, say that sources need the Sources plugin.
+- Knowledge is what the wizards' steps look things up in: pages, tables and files, kept apart by typed categories. Documents the person attaches are read into Knowledge by themselves: say so; do not copy their text into facts unless asked. A website, a sitemap or a folder whose entries should go into Knowledge is a source: where a tool proposes sources, use it (the person takes the proposal on its card); where there is none, say that sources need the Sources plugin.
 - Talking from another page than Info & brand, change title, about, logos, colours and facts only when the person asks.
 - A space that is read-only (synced from a local install, or a team that builds elsewhere) has no tools: say where it is changed.
 
@@ -113,9 +113,9 @@ async function projectState(userId, projectId) {
     const files = await projectFiles(projectId);
     const categories = await categoryRows(projectId);
     return {
-        wissen: {
+        knowledge: {
             ...(await knowledgeCounts(projectId)),
-            kategorien: categories.map((c) => `${c.name} (${c.type}${c.proposed ? ", proposed" : ""})`),
+            categories: categories.map((c) => `${c.name} (${c.type}${c.proposed ? ", proposed" : ""})`),
         },
         title: p.brand.name ?? "",
         about: p.brand.about ?? "",
@@ -799,7 +799,7 @@ export async function runStudioAssistant(input) {
                 ? `The space "${project.name}" is read-only here: nothing of it can be changed in this studio.`
                 : "No space is open.",
         part === "knowledge"
-            ? "The person talks to you from Wissen: they want the wizards to know something."
+            ? "The person talks to you from Knowledge: they want the wizards to know something."
             : "",
         space && !(brandOn.brandSections && brandOn.brandRules && brandOn.typography)
             ? `Not in this studio (no tools for it; never offer it): ${[

package/apps/runtime/dist/app.js

@@ -23,7 +23,7 @@ import { PLUGIN_NAME, pluginArchive, pluginMarketplace } from "./plugin.js";
 import { apiRoutes } from "./routes/api.js";
 import { browserReport, localDebugRoutes } from "./routes/debug.js";
 import { internalRoutes } from "./routes/internal.js";
-import { inLang, requestLang } from "./routes/lang.js";
+import { inLang, notFoundAnswer, requestLang } from "./routes/lang.js";
 import { marketplaceStudio } from "./routes/marketplace.js";
 import { publicPluginRoutes } from "./routes/plugin-public.js";
 import { pluginRoutes } from "./routes/plugins.js";
@@ -67,7 +67,7 @@ const ticketedRun = /^\/api\/runs\/([^/]+)(\/|$)/;
 app.use("*", async (c, next) => {
     if (!managed && !hostAllowed(c.req.header("host") ?? new URL(c.req.url).host)) {
         // Says where it does answer: the studio opened under another name shows the way there.
-        return c.json({ error: "Forbidden host", code: "host", appUrl: env.appUrl }, 403);
+        return c.json({ error: "This address isn’t allowed.", code: "host", appUrl: env.appUrl }, 403);
     }
     const origin = c.req.header("origin");
     const path = c.req.path.startsWith(`${basePath}/`)
@@ -201,7 +201,10 @@ if (serves.studio) {
     app.use("/api/studio/*", async (c, next) => {
         const user = await principalOf(c);
         if (!user) {
-            return c.json({ error: "unauthorized" }, 401);
+            return c.json({
+                error: inLang(c, "Du bist nicht angemeldet.", "You’re not signed in."),
+                code: "unauthorized",
+            }, 401);
         }
         if ((await tenantStatus(user.tenantId)) === "suspended") {
             return c.json({
@@ -257,7 +260,7 @@ if (serves.studio) {
         return c.body(new Uint8Array(zip), 200, { "content-type": "application/zip" });
     });
 }
-app.all("/api/*", (c) => c.json({ error: "not found" }, 404));
+app.all("/api/*", (c) => c.json(notFoundAnswer(c), 404));
 /**
  * `/w/<token>/<runner>`: a plugin's page runner, where the tenant has it and the wizard offers
  * it; otherwise the next handler (the app's page, which knows `steps`, `chat` and run ids).

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

@@ -10,7 +10,7 @@ Words
 - Studio: where wizards are built. Home lists the space's wizards; the editor (/edit/<id>) shows a wizard's flow as a diagram with its own chat (the architect) that builds and changes it.
 - Wizard: a flow of steps a person walks through on a link. Step kinds: a page (fields to fill in), an AI step (an agent with tools: web search, reading files, writing documents, images, video, pages, other services), a review, and the result.
 - Run: one person going through a wizard once. Results lists every run that reached its result.
-- Space: what all wizards of a team know. Its page has four parts: Info & brand (title, about, logos, colours, assets, facts), Wissen / Knowledge (pages, tables and files the AI steps look things up in, kept apart by typed Kategorien), Data (tables and pages the wizards keep) and Results (finished runs).
+- Space: what all wizards of a team know. Its page has four parts: Info & brand (title, about, logos, colours, assets, facts), Knowledge (pages, tables and files the AI steps look things up in, kept apart by typed categories), Data (tables and pages the wizards keep) and Results (finished runs).
 - Model class: the kind of model a step needs (Classifier, Standard, High, Highest for text; Image, Video, Speech, Audio). Which model serves a class is a setting (Settings › Models), not part of the wizard.
 
 Thinking: an installed AI client on the person's subscription (Claude Code, Codex, Gemini CLI, Cursor Agent), own API keys (OpenAI, Anthropic, Google, fal.ai, ElevenLabs, Replicate, Vercel AI Gateway), a local model (Ollama), or engenty credits from an account. Settings › Models shows which way serves each class and what is missing.

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

@@ -184,7 +184,7 @@ export const authRoutes = new Hono()
         usedTickets.set(ticket, expires);
     }
     else if (managed || !accessKey || !sameValue(given, accessKey)) {
-        return c.text("This link is no longer valid. Start the app again.", 403);
+        return c.text("This link is no longer valid. Run wizards open to get a new one.", 403);
     }
     else {
         accessKey = null;
@@ -285,7 +285,7 @@ export const authRoutes = new Hono()
         }
         catch (err) {
             console.error("[account]", err);
-            return c.html(closePage("The sign-in did not work. Please try again."), 400);
+            return c.html(closePage("The sign-in didn’t work. Try again."), 400);
         }
     }
     const state = unseal(getCookie(c, STATE_COOKIE) ?? "");

package/apps/runtime/dist/authoring/guide.js

@@ -24,7 +24,7 @@ type List = {
   key?: columnId                // rows are matched on this column: saving a row with a known key updates that row
   shared?: true                 // ONE list for every run (leads, sign-ups, bookings, a log) instead of one per person.
                                 //   The person running the wizard never sees it: no list field, review or deliverable of it;
-                                //   the admin sees and edits it in the studio under Space → Daten
+                                //   the admin sees and edits it in the studio under Space → Data
   check?: { file?: columnId, status?: columnId }
                                 // a review that shows the list lets the person go through it ROW BY ROW on a split screen:
                                 //   "file" = a text column holding the path of a kept file (PDF, photo), previewed beside the row;
@@ -151,10 +151,10 @@ type AgentStep = {
 // Every agent step also has, without listing them: list_read / list_write (the wizard's lists), files_list,
 //   read_document (PDF, scans and photos, Word, Excel, CSV, saved mails) and scan_documents (invoice / receipt fields, many at once)
 //   — on an installed client only where there is something to read: tools or connections, uploads, lists or kept files;
-//   and where the space has Wissen: project_search (a question, "where" on its typed Kategorien, hits checked for relevance),
-//   project_list (by Kategorien), page_read / table_read / project_document (an item whole, by its path).
+//   and where the space has Knowledge: project_search (a question, "where" on its typed categories, hits checked for relevance),
+//   project_list (by categories), page_read / table_read / project_document (an item whole, by its path).
 // "pages" brings: page_read / page_write — Markdown pages of the space the wizard keeps for every run (notes, a log
-//   that grows with append), shown to the admin under Space → Daten; page_read also reads Wissen by path.
+//   that grows with append), shown to the admin under Space → Data; page_read also reads Knowledge by path.
 // "browser" brings: browser_open/read/click/type/select/scroll/press/back/wait, browser_screenshot (the model looks at the page),
 //   browser_run_fast (a decision model clicks through a page's mechanical part, where one is reached),
 //   browser_request_credentials (the PERSON types a login into the page — the model never sees it; sign-ins can be remembered),
@@ -243,9 +243,9 @@ type ResultStep = { type: "result", message?: string, deliverables: { from: step
 
 Templates (in instructions/prompt): {{fieldId}} · {{steps.stepId}} (whole output) · {{steps.stepId.key}} (json key)
   · {{itemsField}} (line items as a table WITH computed net/VAT/total) · {{itemsField.net|vat|gross}} · {{today}}
-  · the project (its settings): {{brand.name}} {{brand.about}} {{brand.colors}} · {{facts.key}} (one fact: address, VAT id, …) · {{facts}} (all facts)
-    — every AI step already knows them, name one only where the text must carry it; agent steps also search the space's Wissen
-      and are told its Kategorien: say in a step's instructions which Kategorie to filter by when the task names one
+  · the project (its settings): {{brand.name}} {{brand.about}} {{brand.colors}} · {{facts.key}} (one fact: address, VAT ID, …) · {{facts}} (all facts)
+    — every AI step already knows them, name one only where the text must carry it; agent steps also search the space's Knowledge
+      and are told its categories: say in a step's instructions which category to filter by when the task names one
   · {{lists.listId}} (the stored list as a table, as it is when the step starts) · {{fileField}} (the names of the uploads, for read_document)
   · {{locationField}} {{locationField.lat|lng|accuracy|label|map}} · {{audioField}} (the transcript) · {{signatureField}} (asset://ID)
 A template may only use fields asked and steps run EARLIER.`;
@@ -261,7 +261,7 @@ How good wizards look:
 - Writing into other systems (CRM, database, spreadsheet, website): an agent step with the matching mcp server, http, or browser tool, preceded by a review step.
 ${sandboxGuideLine()}
 - Remembering between runs ("merke dir", "führe eine Liste"): declare a list and let an agent step save into it with list_write; a later run reads it as {{lists.id}} or list_read. Give it a key column so known rows are updated, not duplicated. Never make the person re-upload last time's result.
-- Collecting from everyone who runs the wizard (requests, leads, sign-ups, feedback): a list with "shared": true, saved with list_write. It is the admin's, under Space → Daten; never show one person's rows to another. Longer text for every run (a running summary, a log): the "pages" tool.
+- Collecting from everyone who runs the wizard (requests, leads, sign-ups, feedback): a list with "shared": true, saved with list_write. It is the admin's, under Space → Data; never show one person's rows to another. Longer text for every run (a running summary, a log): the "pages" tool.
 - The person's mail: one connection of kind "mail", a page field of kind "connection" early in the wizard, and the agent step lists it in "connections". Do not ask for the provider or the address in other fields — the connect field does that.
 - Working in a service for the person (read their Notion, create an issue, look up a customer): import the service as a connector, declare a connection with "connector", put a page field of kind "connection" before the step, and list the connection in the step's "connections". Prefer a connector over the browser whenever the service has one.
 - Logins on websites: never ask for passwords in page fields. An agent step with the browser tool asks the person at the moment it meets the login (browser_request_credentials); write that into its instructions, and that it must go on without the site when the person skips.

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

@@ -4,9 +4,9 @@ import { DeviceSignInError, requestDeviceCode, waitForDeviceSignIn } from "../au
 import { migrateControlDb } from "../db/client.js";
 import { env } from "../env.js";
 import { featuresFile, fileFeatures, writeFeature } from "../features.js";
-import { command, readInstallNote, writeInstallNote } from "./home.js";
+import { readInstallNote, writeInstallNote } from "./home.js";
 import { openBrowser, runningRuntime, settings } from "./start.js";
-import { bold, busy, cyan, dim, tilde } from "./ui.js";
+import { bold, busy, cmd, cyan, dim, tilde } from "./ui.js";
 /**
  * The account of this install, from the terminal. `wizards account` says where it stands,
  * `sign-in` runs the device flow (auth/device.ts), `sign-out` ends the link the way the
@@ -73,7 +73,7 @@ export function described(account, team, credits = true) {
 export function describeAccount(state) {
     switch (state.kind) {
         case "local":
-            return "local only";
+            return "only on this computer, no account";
         case "none":
             return "not signed in";
         default:
@@ -86,16 +86,18 @@ const host = () => new URL(env.local.accountUrl).host.replace(/^account\./, "");
 async function status() {
     const state = await accountState();
     if (state.kind === "local") {
-        console.log(`Local only (no account). ${dim(`\`${command()} account sign-in\` connects one.`)}`);
+        console.log(`Only on this computer, no account. ${dim(`To connect one: ${cmd("account sign-in")}`)}`);
         return 0;
     }
     if (state.kind === "none") {
-        console.log(`Not signed in. ${dim(`\`${command()} account sign-in\``)}`);
+        console.log(`Not signed in. ${dim(`To sign in: ${cmd("account sign-in")}`)}`);
         return 0;
     }
     const overview = await accountOverview();
     const team = overview?.tenant ?? state.team;
-    console.log(`Signed in as ${described(state.account, team)} · ${host()}${overview ? "" : dim(`  (${host()} did not answer${team ? "; this is from last time" : ""})`)}`);
+    console.log(`Signed in as ${described(state.account, team)} · ${host()}${overview
+        ? ""
+        : dim(`  (${host()} didn’t respond${team ? ", so this is from last time" : ""})`)}`);
     return 0;
 }
 /**
@@ -112,21 +114,21 @@ async function deviceSignIn() {
         return null;
     }
     const link = code.verificationUriComplete ?? code.verificationUri;
-    p.log.message(`Open ${cyan(link)} and type ${bold(code.userCode)}`);
+    p.log.message(`Open ${cyan(link)} and enter the code ${bold(code.userCode)}.`);
     if (openBrowser(link)) {
         p.log.message(dim("The page opens in your browser."));
     }
-    const spinner = busy("Waiting for you to allow it in the browser");
+    const spinner = busy("Waiting for you to confirm in the browser…");
     try {
         const account = await waitForDeviceSignIn(code);
         const overview = await accountOverview();
-        spinner.stop(`Signed in as ${described(account, overview?.tenant ?? null)}`);
+        spinner.stop(`Signed in as ${described(account, overview?.tenant ?? null)}.`);
         return account;
     }
     catch (err) {
         spinner.fail(err instanceof DeviceSignInError
             ? err.message
-            : `The sign-in did not work. ${err.message}`);
+            : `The sign-in didn’t work. ${err.message}`);
         return null;
     }
 }
@@ -139,29 +141,28 @@ async function pickUp(paths, interactive, why) {
     if (!(await runningRuntime(settings(paths).dataDir))) {
         return;
     }
-    const how = `${command()} restart`;
     if (!interactive) {
-        p.log.info(`The studio that runs ${why} after ${cyan(how)}.`);
+        p.log.info(`Run ${cmd("restart")} so ${why}.`);
         return;
     }
     const answer = await p.confirm({
-        message: `Restart the studio that runs, so it ${why}?`,
+        message: `Restart engenty wizards now, so ${why}?`,
         initialValue: true,
     });
     if (p.isCancel(answer) || !answer) {
-        p.log.info(dim(`Later: ${how}`));
+        p.log.info(dim(`To do it later: ${cmd("restart")}`));
         return;
     }
     // status.ts shows the account; loaded here when needed, so neither module waits on the other.
     const { restart } = await import("./status.js");
     await restart(paths);
 }
-const SIGNED_IN = "fetches the Pro modules of your plan and sends what is published to the cloud";
+const SIGNED_IN = "your plan’s Pro modules load and your published wizards arrive in the cloud";
 async function signIn(paths, interactive) {
     await ready();
     const linked = await linkedAccount();
     if (linked) {
-        p.log.info(`Already signed in as ${described(linked, await knownTeam(), false)}. ${dim(`To switch: \`${command()} account sign-out\` first.`)}`);
+        p.log.info(`Already signed in as ${described(linked, await knownTeam(), false)}. ${dim(`To switch accounts, run ${cmd("account sign-out")} first.`)}`);
         return 0;
     }
     const account = await deviceSignIn();
@@ -176,10 +177,12 @@ async function signIn(paths, interactive) {
 async function signOut(paths, interactive) {
     const state = await accountState();
     if (state.kind !== "linked") {
-        console.log(state.kind === "local" ? "Local only: there is no account to sign out." : "Not signed in.");
+        console.log(state.kind === "local"
+            ? "No account is connected, so there’s nothing to sign out of."
+            : "Not signed in.");
         return 0;
     }
-    const spinner = busy(`Signing out ${state.account.name || state.account.email}`);
+    const spinner = busy(`Signing out ${state.account.name || state.account.email}…`);
     await unlink();
     // The same as the studio's sign-out (DELETE /api/studio/account): what was sent to the cloud
     // is forgotten, the entitlement goes with the account's plan, and models that ran on its
@@ -197,7 +200,7 @@ async function signOut(paths, interactive) {
         await models.saveLocalModels({ source: "own" });
     }
     spinner.stop("Signed out. Your wizards and results stay on this computer.");
-    await pickUp(paths, interactive, "lets go of the account");
+    await pickUp(paths, interactive, "it disconnects from the account");
     return 0;
 }
 /** `wizards account [sign-in|sign-out]`. */
@@ -215,7 +218,7 @@ export async function accountCommand(paths, value, options) {
         case "logout":
             return signOut(paths, interactive);
         default:
-            console.error(`${command()} account [sign-in|sign-out]`);
+            console.error(`Usage: ${cmd("account [sign-in|sign-out]")}`);
             return 2;
     }
 }
@@ -250,37 +253,37 @@ export async function accountMenu(paths) {
 export async function accountStep(paths, options, interactive) {
     if (options.local) {
         localOnly(paths);
-        p.log.warn(`Local only. No account, nothing leaves this computer. Wizards, the space and results stay in ${tilde(settings(paths).dataDir)}. Links answer on this computer only.`);
-        p.log.message(dim(`Connect an account any time: ${command()} account`));
+        p.log.warn(`No account: nothing leaves this computer. Your wizards, your space and results stay in ${tilde(settings(paths).dataDir)}. Links work only on this computer.`);
+        p.log.message(dim(`To connect an account any time: ${cmd("account sign-in")}`));
         return;
     }
     const state = await accountState();
     if (state.kind === "local") {
-        p.log.info(`Local only (no account). ${dim(`\`${command()} account sign-in\` connects one.`)}`);
+        p.log.info(`Only on this computer, no account. ${dim(`To connect one: ${cmd("account sign-in")}`)}`);
         return;
     }
     if (state.kind === "linked") {
         const overview = await accountOverview();
-        p.log.success(`Signed in as ${described(state.account, overview?.tenant ?? state.team)}`);
+        p.log.success(`Signed in as ${described(state.account, overview?.tenant ?? state.team)}.`);
         return;
     }
     p.note(INTRO, "Your engenty account");
     if (!interactive) {
-        p.log.info(dim(`Sign in later: ${command()} account sign-in`));
+        p.log.info(dim(`To sign in later: ${cmd("account sign-in")}`));
         return;
     }
     const answer = await p.confirm({ message: "Sign in now?", initialValue: true });
     if (p.isCancel(answer)) {
-        p.cancel(`Setup stopped. Run it again with \`${command()} setup\`.`);
+        p.cancel(`Setup stopped. To run it again: ${cmd("setup")}`);
         return "cancelled";
     }
     if (!answer) {
-        p.log.info(dim(`Later: ${command()} account`));
+        p.log.info(dim(`To sign in later: ${cmd("account sign-in")}`));
         return;
     }
     const account = await deviceSignIn();
     if (!account) {
-        p.log.info(dim(`Later: ${command()} account sign-in`));
+        p.log.info(dim(`To sign in later: ${cmd("account sign-in")}`));
         return;
     }
     joinedAccount(paths);

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

@@ -82,16 +82,18 @@ async function systemdHere() {
 }
 export async function autostartState(paths) {
     if (process.platform !== "darwin" && process.platform !== "linux") {
-        return { unavailable: `not on ${process.platform}` };
+        return {
+            unavailable: process.platform === "win32" ? "not on Windows" : `not on ${process.platform}`,
+        };
     }
     if (!installedByScript(paths)) {
-        return { unavailable: "only for an install made by install.sh" };
+        return { unavailable: "only for installs made with the install script" };
     }
     if (process.platform === "darwin") {
         return { on: existsSync(LOGIN_ITEM), how: MAC_HOW };
     }
     if (!(await systemdHere())) {
-        return { unavailable: "this Linux has no systemd user session" };
+        return { unavailable: "this system has no systemd user session" };
     }
     try {
         await run("systemctl", ["--user", "is-enabled", "--quiet", UNIT], { timeout: 10_000 });

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

@@ -28,7 +28,7 @@ export function installClient(client, paths, onLine) {
     }
     const npm = findOnPath("npm", [dirname(process.execPath), process.env.PATH ?? ""].join(delimiter));
     if (!npm) {
-        return Promise.resolve({ code: 127, tail: "npm was not found next to this Node." });
+        return Promise.resolve({ code: 127, tail: "npm wasn’t found next to this Node.js." });
     }
     mkdirSync(paths.clients, { recursive: true });
     return runLogged(npm, [