wizards 0.3.7 → 0.4.0

package/apps/runtime/dist/docs/user/create-account.md

@@ -0,0 +1,47 @@
+---
+title: Create an account
+description: Your team, its space and your wizards live in your account at engenty.ai. Sign up with an invitation code, answer four questions, build.
+version: 0.3.4
+---
+
+engenty wizards is in a closed beta: a new account needs an invitation code. "Get started" on
+[engenty.ai](https://engenty.ai) takes your e-mail and puts you on the list; the code comes by
+mail as soon as a seat is free. With a code, the same step opens the sign-up.
+
+## Sign up
+
+1. Type the code at [account.engenty.ai/sign-up](https://account.engenty.ai/sign-up). The link
+   in the invitation mail has it filled in.
+2. Sign in with Google, GitHub, or a link by mail. There is no password.
+3. The studio opens at [engenty.ai/studio](https://engenty.ai/studio).
+
+Your account is a **team**: it holds your credits, your spaces and, on the Team plan, your
+colleagues. It starts with credits, some of which end on a date; the account pages at
+[account.engenty.ai](https://account.engenty.ai) show them.
+
+## The first visit
+
+The studio asks four things, one per page. Each but the first can be skipped and changed later.
+
+| Page | Asks | Goes to |
+|---|---|---|
+| Who you are | What your team is called: your company, your club, or just your name | The team's name at account.engenty.ai |
+| About you & your brand | Your website. engenty reads your name, what you do, your logo and colours from it; or you write a line about yourself | [Space → Info & brand](./space.md#info--brand) |
+| Knowledge | Documents the wizards may look things up in: price lists, your terms, an FAQ | [Space → Knowledge](./space.md#knowledge) |
+| Your space | Nothing: it explains the space that holds all of this, "Meine Wizards" | — |
+
+Then "Build your first wizard" opens the studio's start: describe a task in a sentence, or pick
+a template. See [Build a wizard](./build-a-wizard.md).
+
+## What the cloud does
+
+- Wizards built here run behind a link that works day and night, on the team's credits.
+- Share links, the tag for your website, QR codes and the channels of [Test and share](./test-and-share.md) work as on an install.
+- What the wizards think with is the team's: [Models and account](./models.md).
+
+## Also on your computer
+
+The same account works on your own computer: [install](./install.md) engenty wizards there and
+sign in during the setup. It thinks with your Claude, ChatGPT, Gemini or Cursor subscription,
+reads your local files and browses for you; what you publish there runs in the cloud too, behind
+the same links. "Also on your computer" on the studio's start page mails you the command.

package/apps/runtime/dist/docs/user/first-start.md

@@ -1,7 +1,7 @@
 ---
 title: First start
 description: Choose what engenty wizards thinks with. The studio opens once a test call works.
-version: 0.3.2
+version: 0.3.4
 ---
 
 The first page of the studio is the setup, "Choose your Engine". It asks one thing: what should
@@ -9,10 +9,18 @@ engenty think with?
 
 ![The setup: choose the engine, an installed AI client or your own keys](../../assets/setup.png)
 
+## Your account
+
+Above the engines stands your account: signed in during the [install](./install.md), it shows
+your name, your team and your credits, and your team's space is on this computer. Not signed in
+yet, "Sign in" opens your browser for it; an install that is [local only](./local-only.md)
+shows nothing here.
+
 ## Choose your engine
 
 | Engine | Runs on | Needs |
 |---|---|---|
+| engenty credits | Your account's credits, like in the cloud | An account signed in. Shown only then |
 | Claude Code | Your Claude subscription | The client installed and signed in |
 | Codex | Your ChatGPT subscription | The client installed and signed in |
 | Gemini CLI | Your Google account | The client installed and signed in |

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

@@ -1,7 +1,7 @@
 ---
 title: User Guide
 description: Install engenty wizards, build a wizard, run and share it.
-version: 0.3.2
+version: 0.3.4
 ---
 
 engenty wizards turns something you do again and again into a wizard: pages that ask what it
@@ -17,30 +17,34 @@ briefing, an invoice, a quote, a damage report.
 | **Describe it** | Say in plain words what the wizard should do. The assistant builds the flow; you see it as a diagram and change any step. |
 | **Let AI steps work** | They research the web, write, draw images, render video, read PDFs, scans and mails, build documents and dashboards, and write into other services. Anything that changes an account asks first. |
 | **Share a link** | Anyone runs the wizard in a browser, on a phone too. Results download as PDF, Word, HTML, Markdown, PNG, MP4, MP3, CSV, Excel or JSON, or go out as a link. |
-| **Keep it on your machine** | It thinks with Codex, Claude Code, Gemini CLI or Cursor Agent on your own subscription, with your own keys, or with a local model. Wizards and results stay in a folder on your computer. |
+| **In the cloud, or on your computer** | Sign up and build in the browser; links run on your team's credits. Or install it on your computer: it thinks with Codex, Claude Code, Gemini CLI or Cursor Agent on your own subscription, with your own keys, or with a local model, and your files stay with you. |
 
 ## Where to start
 
-1. [Install](./install.md) it: one command on macOS or Linux.
-2. At the [first start](./first-start.md), choose what it thinks with.
-3. [Build a wizard](./build-a-wizard.md) from a sentence or a template.
-4. [Test and share](./test-and-share.md) it.
+1. [Create an account](./create-account.md) at engenty.ai, with an invitation code.
+2. [Build a wizard](./build-a-wizard.md) from a sentence or a template.
+3. [Test and share](./test-and-share.md) it.
+4. Also on your computer: [install](./install.md) it there, signed in to the same account, and at the [first start](./first-start.md) choose what it thinks with.
 5. Use it from your [AI apps](./ai-apps.md): Claude Desktop, Cursor, Codex and others.
 
 ## Words used here
 
 | Word | Means |
 |---|---|
-| Studio | Where you build wizards: `/studio` of your install |
+| Account | You, signed in at engenty.ai with Google, GitHub or a link by mail |
+| Team | What the sign-up creates: it holds your credits, your spaces and, on the Team plan, your colleagues |
+| Space | What all your wizards know and produce: name, logo, colours, facts, documents, data, results. A team's first one is "Meine Wizards" |
+| Studio | Where you build wizards: engenty.ai/studio, or `/studio` of your install |
 | Wizard | A flow of steps a person walks through on a link |
 | Step | One part of the flow: a page, an AI step, a review, the result |
 | Run | One person going through a wizard once |
-| Space | What all your wizards know: name, logo, colours, facts, documents |
 | Model class | The kind of model a step needs. Which model serves a class is a setting, not part of the wizard |
 
 ## Two places it runs
 
-This guide describes the install on your own computer: there you build. engenty.ai is the cloud:
-with an account, what you publish on your computer also runs there, behind a link that works
-while your computer is off, on the account's credits. The studio at engenty.ai shows those
-wizards and their runs and changes nothing ([Test and share](./test-and-share.md#in-the-cloud)).
+Your team, its space and your wizards live in your account. engenty.ai is the cloud: you build
+there in the browser, and links run day and night on the team's credits. Your computer can join:
+[install](./install.md) engenty wizards there, signed in to the same account, and it thinks with
+the AI clients and keys on that machine; what you publish there runs in the cloud as well
+([Test and share](./test-and-share.md#in-the-cloud)). An install without an account is
+[local only](./local-only.md).

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

@@ -1,7 +1,7 @@
 ---
 title: Install
 description: One command on macOS or Linux. It brings its own Node.js and asks for no password.
-version: 0.3.2
+version: 0.3.4
 ---
 
 ## Install
@@ -18,6 +18,7 @@ command into `~/.local/bin` and then walks you through the rest:
 
 | Step | What it does |
 |---|---|
+| Your engenty account | Shows a code and opens the browser for the sign-in at account.engenty.ai (no account yet? the page takes an invitation code). Signed in, your team's space comes down to this computer, and what you publish here runs in the cloud too. "Later" skips it: `wizards account sign-in` does it any time. `--local` leaves the account out altogether: [Local only](./local-only.md) |
 | Something to think with | Looks for Codex, Claude Code, Gemini CLI and Cursor Agent and offers to install the ones that are missing. It proposes the one whose app (ChatGPT, Claude, Cursor) is on your Mac first, as that subscription is most likely yours already. You can also use an API key, [Ollama](https://ollama.com) or, on a Mac with Apple silicon and macOS 26, Apple Intelligence: the studio's [first page](./first-start.md) offers them |
 | A browser and ffmpeg | Names the browser for PDF and PNG exports and steps on websites: the first of Chrome, Edge and Chromium it finds (on a Mac also Brave). The app uses that one; [`CHROME_PATH`](./command-line.md#settings) picks another. Says whether there is ffmpeg for MP4 videos of animated widgets; with Homebrew it offers to install it |
 | Start at login (optional) | engenty wizards starts in the background when you log in, so links and AI clients always reach it. A LaunchAgent on a Mac, a systemd user service on Linux |
@@ -37,6 +38,7 @@ You install once; from then on you use the `wizards` command.
 | `wizards stop` | Stops it. Your data is kept |
 | `wizards status` | Whether it runs, and where |
 | `wizards restart` | Stops it and starts it again |
+| `wizards account` | How the install stands to your account; `sign-in` and `sign-out` |
 | `wizards` | A menu with all of it |
 
 The studio is at

package/apps/runtime/dist/docs/user/local-only.md

@@ -0,0 +1,38 @@
+---
+title: Local only
+description: An install without an account. Nothing leaves the computer; links answer on it only. The flag, what it means, and how to connect an account later.
+version: 0.3.4
+---
+
+An install normally signs in to your account during the setup: your team's space comes down to
+the computer, and what you publish runs in the cloud too. An install can also stay alone.
+
+## The flag
+
+```bash
+curl -fsSL https://engenty.ai/install.sh | bash -s -- --local
+```
+
+`--local` skips the account step of the setup and switches the account off for this install.
+On an install that is there already: `wizards setup --local`.
+
+## What it means
+
+- No account, nothing leaves this computer. Wizards, the space and results stay in
+  `~/.engenty/wizards/data` ([Your data](./data.md)).
+- Links answer on this computer only: `http://localhost:24368/w/…`. For others to open them,
+  run it [on a server](./server.md) of your own.
+- It thinks with your AI clients, your own keys, Ollama or Apple Intelligence
+  ([First start](./first-start.md)). Without an account, video and voice need a key of your own.
+- The studio shows no account surfaces: no sign-in offer, no credits, no cloud copy. The feature
+  switch `account` is off in the install's `.features` file; `wizards features` lists it.
+
+## Connect an account later
+
+```bash
+wizards account sign-in
+```
+
+The command shows a code and opens the browser for the sign-in; afterwards the install is
+connected, and the switch is on again. `wizards account` says how the install stands,
+`wizards account sign-out` disconnects it. Settings → Account in the studio does the same.

package/apps/runtime/dist/docs/user/meta.json

@@ -1,11 +1,12 @@
 {
   "title": "User Guide",
-  "description": "Install engenty wizards, build a wizard, run and share it.",
+  "description": "Create an account, build a wizard, run and share it, install it on your computer.",
   "root": true,
   "icon": "LifeBuoy",
   "pages": [
     "index",
     "---Start---",
+    "create-account",
     "install",
     "first-start",
     "---Wizards---",
@@ -24,6 +25,7 @@
     "---Your install---",
     "command-line",
     "data",
+    "local-only",
     "server",
     "troubleshooting"
   ]

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

@@ -1,7 +1,7 @@
 ---
 title: Models and account
 description: Who does what your wizards ask for — an installed AI client, your own API keys, a local model, or credits.
-version: 0.3.2
+version: 0.3.4
 ---
 
 Settings → Models decides who does what your wizards ask for. On your computer it is yours; on
@@ -125,7 +125,8 @@ Text & reasoning) picks what builds your wizards in the editor's conversation:
 
 ## Account
 
-An account is optional. With it you
+An install normally signs in to your account during the setup ([Install](./install.md)); one
+without an account is [local only](./local-only.md). With an account you
 
 - use credits instead of your own keys (the editor's note about missing models says so where
   text, image or video models are missing),

package/apps/runtime/dist/env.js

@@ -152,6 +152,11 @@ export const env = {
     /** Encrypts connected accounts and kept browser sessions; falls back to the app secret. */
     storeKey: str("STORE_ENC_KEY"),
     devLogin: process.env.NODE_ENV !== "production" && str("DEV_LOGIN") === "1",
+    /**
+     * `1`: the studio assistant's developer mode may be switched on here (steps, tools, prompt,
+     * the turns' events). A managed runtime offers it to the platform's admins instead.
+     */
+    assistantDev: str("ASSISTANT_DEV") === "1",
     /**
      * The Manage-App this runtime belongs to. Set = people sign in there, tenants come from its
      * tokens and model calls go through its gateway. Empty = the runtime runs alone with one tenant.

package/apps/runtime/dist/manage.js

@@ -110,15 +110,15 @@ export function tenantMembers(id) {
     return call("GET", `/v1/tenants/${encodeURIComponent(id)}/members`);
 }
 const users = new Map();
-/** A person's own feature switches, as an admin set them at the Manage-App; cached a minute. */
-export async function userFeatures(userId) {
+/** What the Manage-App says of a person beyond their token; cached a minute. */
+export async function userInfo(userId) {
     const hit = users.get(userId);
     if (hit && Date.now() - hit.at < 60_000) {
         return hit.value;
     }
     const value = await call("GET", `/v1/users/${encodeURIComponent(userId)}`)
-        .then((u) => u.features ?? {})
-        .catch(() => hit?.value ?? {});
+        .then((u) => ({ features: u.features ?? {}, admin: u.admin === true }))
+        .catch(() => hit?.value ?? { features: {}, admin: false });
     users.set(userId, { at: Date.now(), value });
     return value;
 }
@@ -145,6 +145,18 @@ export async function tenantInfo(id, fresh = false) {
 export function forgetTenant(id) {
     tenants.delete(id);
 }
+/** Renames the team at the Manage-App; what it answers is the tenant as it stands now. */
+export async function renameTenant(id, name) {
+    const value = await call("PATCH", `/v1/tenants/${encodeURIComponent(id)}`, {
+        name,
+    });
+    tenants.set(id, { at: Date.now(), value });
+    return value;
+}
+/** The Manage-App mails the install command and the first steps to one of the team's people. */
+export function installMail(email, lang) {
+    return call("POST", "/v1/install-mail", { email, lang });
+}
 export function verifyKey(key) {
     return call("POST", "/v1/keys/verify", { key });
 }

package/apps/runtime/dist/models.js

@@ -1013,6 +1013,12 @@ function priceOf(ref) {
     return (catalog.get(provider === null || provider === "gateway" ? id : `${provider}/${id}`)?.pricing ??
         {});
 }
+/** A model's context window in tokens, as the AI Gateway's catalog gives it; null where unknown. */
+export function contextWindowOf(ref) {
+    const { provider, id } = parse(ref);
+    const entry = catalog.get(provider === null || provider === "gateway" ? id : `${provider}/${id}`);
+    return typeof entry?.context_window === "number" ? entry.context_window : null;
+}
 const n = (v, fallback) => {
     const x = Number(v);
     return Number.isFinite(x) ? x : fallback;

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

@@ -84,7 +84,7 @@ async function call(path, token) {
         signal: AbortSignal.timeout(60_000),
     }).catch(() => null);
     if (!res) {
-        throw new ProModuleError("Dein engenty-Konto ist gerade nicht erreichbar.", 502, "offline");
+        throw new ProModuleError("Your engenty account is not reachable right now.", 502, "offline");
     }
     return res;
 }
@@ -109,19 +109,19 @@ export async function refreshPro() {
     try {
         const token = await accountToken();
         if (!token) {
-            throw new ProModuleError("Dein engenty-Konto ist gerade nicht erreichbar.", 502, "offline");
+            throw new ProModuleError("Your engenty account is not reachable right now.", 502, "offline");
         }
         const res = await call("", token);
         if (res.status === 401) {
-            throw new ProModuleError("Das engenty-Konto nimmt diese Anmeldung nicht mehr an.", 403);
+            throw new ProModuleError("The engenty account no longer accepts this sign-in.", 403);
         }
         if (!res.ok) {
-            throw new ProModuleError(`Das Konto antwortet nicht wie erwartet (${res.status}).`, 502);
+            throw new ProModuleError(`The account did not answer as expected (${res.status}).`, 502);
         }
         const answer = (await res.json());
         const claims = await verifySigned(answer.entitlement?.token ?? "", [AUDIENCE], env.local.accountUrl);
         if (!claims || claims.sub !== account.tenantId || !Array.isArray(claims.modules)) {
-            throw new ProModuleError("Die Bestätigung des Pakets ließ sich nicht prüfen.", 502);
+            throw new ProModuleError("The package's confirmation could not be checked.", 502);
         }
         listing = answer;
         lastError = null;
@@ -177,7 +177,7 @@ function filesOf(zip) {
         files = unzipSync(zip);
     }
     catch {
-        throw new ProModuleError("Das Paket ist beschädigt.", 502);
+        throw new ProModuleError("The package is damaged.", 502);
     }
     const out = {};
     for (const [name, data] of Object.entries(files)) {
@@ -188,7 +188,7 @@ function filesOf(zip) {
         const safe = parts.every((p) => p && p !== "." && p !== ".." && !p.includes("\\"));
         const allowed = name === MANIFEST_FILE || PARTS.some((part) => name.startsWith(part));
         if (!(safe && allowed)) {
-            throw new ProModuleError(`Das Paket enthält eine unerlaubte Datei: ${name}`, 502);
+            throw new ProModuleError(`The package holds a file it may not: ${name}`, 502);
         }
         out[name] = data;
     }
@@ -197,28 +197,28 @@ function filesOf(zip) {
 /** Fetches one module of the plan, checks it and puts it in place; then it loads. */
 export async function installPro(id) {
     if (managed) {
-        throw new ProModuleError("Hier nicht verfügbar.", 404, "not_found");
+        throw new ProModuleError("Not available here.", 404, "not_found");
     }
     const token = await accountToken();
     if (!token) {
-        throw new ProModuleError("Verbinde zuerst dein engenty-Konto (Einstellungen → Konto).", 409);
+        throw new ProModuleError("Sign in to your engenty account first (Settings → Account).", 409);
     }
     if (!listing) {
         await refreshPro();
     }
     const entry = listing?.modules.find((m) => m.id === id);
     if (!entry) {
-        throw new ProModuleError(`Für ${runtimeTag()} gibt es dieses Modul nicht.`, 404, "not_found");
+        throw new ProModuleError(`There is no build of this module for ${runtimeTag()}.`, 404, "not_found");
     }
     if (!entry.included) {
-        throw new ProModuleError("Dieses Modul ist nicht Teil deines Pakets.", 403, "plan");
+        throw new ProModuleError("This module is not part of your plan.", 403, "plan");
     }
     const res = await call(`/${encodeURIComponent(id)}/package`, token);
     if (!res.ok) {
-        throw new ProModuleError(`Das Modul ließ sich nicht laden (${res.status}).`, 502);
+        throw new ProModuleError(`The module could not be fetched (${res.status}).`, 502);
     }
     if (Number(res.headers.get("content-length") ?? 0) > MAX_PACKAGE) {
-        throw new ProModuleError("Das Paket ist zu groß.", 502);
+        throw new ProModuleError("The package is too large.", 502);
     }
     const zip = new Uint8Array(await res.arrayBuffer());
     const sha256 = createHash("sha256").update(zip).digest("hex");
@@ -231,12 +231,12 @@ export async function installPro(id) {
             signature: entry.signature,
         });
     if (zip.length > MAX_PACKAGE || !genuine) {
-        throw new ProModuleError("Das Paket ist nicht von engenty signiert und wurde verworfen.", 502);
+        throw new ProModuleError("The package is not signed by engenty and was discarded.", 502);
     }
     const files = filesOf(zip);
     const manifest = JSON.parse(new TextDecoder().decode(files[MANIFEST_FILE] ?? new Uint8Array()));
     if (manifest?.id !== id) {
-        throw new ProModuleError("Das Paket passt nicht zu diesem Modul.", 502);
+        throw new ProModuleError("The package does not belong to this module.", 502);
     }
     const dir = proModulesDir();
     const target = join(dir, id);
@@ -270,7 +270,7 @@ export async function installPro(id) {
 /** Removes an installed module; its tables and what is in them stay. */
 export async function removePro(id) {
     if (managed || !(await installedIds()).includes(id)) {
-        throw new ProModuleError("Dieses Modul ist nicht installiert.", 404, "not_found");
+        throw new ProModuleError("This module is not installed.", 404, "not_found");
     }
     await rm(join(proModulesDir(), id), { recursive: true, force: true });
     await findNewPlugins();