wizards 0.5.0 → 0.5.1

package/apps/runtime/dist/docs/user/test-and-share.md

@@ -1,168 +1,189 @@
 ---
 title: Test and share
 description: Try the wizard, publish it, and hand out its link or put it on a website.
-version: 0.4.0
+version: 0.5.0
 ---
 
 ## Test
 
-"Test" in the editor starts a run of the draft, as a person would see it. Test runs are listed
-under "Runs". A test spends what a real run spends: your model's usage, or credits. A test run
-reads the wizard's memory but writes into a copy of its own, which goes with the run.
+“Test” in the editor starts a run of the draft, just as a person would see it. Test runs are
+listed under “Runs”. A test spends what a real run spends: your model’s usage, or credits. A test
+run reads the wizard’s memory, but it writes into a copy of its own, which goes with the run.
 
-Where runs spend credits, each AI step shows an estimate. It is a formula at first and is
-measured from the latest runs after five of them.
+Where runs spend credits, each AI step shows an estimate. At first it is a formula. After five
+runs it is measured from the latest ones.
 
 ## Publish
 
-A wizard goes live the first time you share it: "Share" publishes the draft as version 1 as the
-dialog opens (nobody has the link yet, and "Only you" under Access keeps it closed). A draft with
-issues is not published; the dialog lists what to fix first, with "Let the assistant fix it".
+A wizard goes live the first time you share it. “Share” publishes the draft as version 1 as the
+dialog opens, and the dialog says “Published when you shared it”. Nobody has the link yet, and
+“Only you” under “Access” keeps it closed. A draft with issues is not published: the dialog lists
+what to fix first, with “Let the assistant fix it”.
 
-After that the editor's top bar has "Make changes live" whenever the draft differs from the
-version people run. It opens a dialog that says:
+After that, the editor’s top bar shows “Publish changes” whenever the draft differs from the
+version people run. It opens a dialog with these parts:
 
 | Part | Says |
 |---|---|
-| What changed | The wizard's own settings, each step by its title (new, removed, or which of its parts: fields, instructions, result …), the steps' order, the files |
-| Tested | Whether a test run used exactly this draft: "Tested 4 minutes ago – with these changes" and "See the run", or "Not tested with these changes yet" with "Test now" |
-| Notes | Anyone in the middle of a run carries on with the version they started; what a run costs now where that changed; with an account, that the version goes to the cloud too |
+| What changed | The wizard’s own settings, each step by its title (new, removed, or which of its parts changed: fields, instructions, result …), the order of the steps and the files |
+| Tested | Whether a test run used exactly this draft: “Tested 4 minutes ago – with these changes” with “See the run”, or “Not tested with these changes yet.” with “Test now” |
+| Notes | Anyone in the middle of a run carries on with the version they started. Where the cost changed, it says what a run costs now. With an account, it says that the version also arrives in your account’s cloud |
 
-"Go live" makes the draft the next version; the link stays the same. Issues stop it, as on the
-first share. The editor's top bar and the wizard's card on the start page say where it runs:
+“Publish” makes the draft the next version, and the link stays the same. Issues stop it, as on
+the first share. The editor’s top bar and the wizard’s card on the start page say where it runs:
 
 | It says | Means |
 |---|---|
-| Not published yet · Draft | Only you can run it, as a test. Sharing it publishes it |
-| Live · version 3 | The link runs this version. With a cloud icon: on engenty.ai, for everyone with the link |
-| Live · 1 note | It runs in the cloud, one step there with less (see "Share") |
-| Local | Published on an install without an account: the link answers only on this computer |
-| Being sent | The version did not reach engenty.ai yet; the studio tries again by itself |
-| Not in the cloud | engenty.ai does not run this version. "Share" says why and what helps |
+| “Not published yet” in the editor, “Draft” on the card | Only you can run it, as a test. Sharing it publishes it |
+| “Live · version 3” in the editor, “Live” on the card | The link runs this version. With a cloud icon, it runs on engenty.ai for everyone with the link |
+| “Live · 1 note” | It runs in the cloud, but one step does less there (see “Share”) |
+| “Local” | It is published on your computer without an account. The link only answers on this computer, while engenty wizards is running |
+| “On its way to the cloud” | The version hasn’t arrived on engenty.ai yet. The studio tries again by itself |
+| “Not in the cloud” | engenty.ai doesn’t run this version. “Share” says why and what helps |
 
-On a card, "Link" copies the address others can open, and the arrow opens it. A wizard that
-runs only on this computer has no address for others: its "Link" says so and how an account
-gives it one, and the arrow opens it here.
+On a card, “Link” copies the address others can open, and the arrow opens it. A wizard that
+runs only on this computer has no address for others. Its “Link” says so and explains how an
+account gives it one, and the arrow opens it here.
+
+The ⋯ menu on a card and in the editor has “Duplicate”, “Export as a wizard file (.wizard)” and
+“Delete”.
 
 ## Share
 
-"Share" says who may open the wizard and how others reach it, and copies the link.
+“Share” says who may open the wizard and how others reach it, and it copies the link.
 
 | Part | Does |
 |---|---|
-| Access | "Anyone with the link" can open and fill it in, up to the runs a day set under the gear. "Only you" switches the link off: everyone else sees a notice, you test in the studio |
-| How others reach it | The channels the wizard runs as (see below), by kind: in the browser, on the phone, by message. A browser channel has its own link, a message channel its keyword and number; each row copies its own. "Change" picks the channels, with the same list as a new wizard |
-| QR code | One of the links as a QR code, to download or print, and the wizard's ID for the mobile app |
-| Website | The tag for a website (see below), and for WordPress the plugin or the wizard as a package that runs without an account, with what it lacks there: see [WordPress](./wordpress.md#without-an-account) |
+| Access | With “Anyone with the link”, anyone can open and fill it in, up to the runs a day set under “Settings”. “Only you” switches the link off: everyone else sees a notice, and you test in the studio |
+| How others reach it | The channels the wizard runs as (see below), grouped by kind: in the browser, on the phone, by message. A browser channel has its own link, and a message channel its keyword and number. Each row copies its own. “Change” lets you choose the channels, from the same list as for a new wizard |
+| QR code | One of the links as a QR code to download or print, and the wizard’s ID for the mobile app |
+| Website | The code for a website (see below). For WordPress, it offers the plugin, or the wizard as a package that runs without an account, with what it lacks there: see [WordPress](./wordpress.md#without-an-account) |
 | Copy link | The link people open. It opens the first browser channel, and the wizard offers the others on its first page |
-| The gear | Runs a day (50 unless you change it, with what that costs at most), each message channel's keyword, and "Create a new link": the old link and its QR code stop working, in the cloud too |
+| Settings (the gear) | “Limit per day” (50 runs unless you change it, with what that costs at most), each message channel’s keyword, and “Create a new link”: the old link and its QR code stop working, in the cloud too |
 
-Where the draft has changes, the dialog says so on top and leads to "Make changes live".
+Where the draft has changes, the dialog says so at the top and leads to “Publish changes”.
 
 One visitor can start 6 runs an hour.
 
 ### Channels
 
-A wizard runs page by page, as a chat, as a live conversation on top of the chat, or as a video
-call on a stage with the chat beside it (the person talks, the wizard talks back and sees the
-camera; both need an OpenAI API key under Models for now); a plugin can add further ways, a
-kiosk page or a messenger. A new wizard has the page and the chat switched on; the others are
-switched on when the wizard is made, or later under "Change" in the share dialog. Where a channel
-cannot take a step, the step goes to the wizard's page: the person gets a link for a photo, a
-signature or a sign-in, and comes back after. A step nobody can hand off, for example one that
-takes minutes on a channel that cannot wait, shows "Not possible: …" under the channel's name.
-A channel that is not set up says "Not set up yet", with "Set up" to its settings.
+A wizard can run page by page, as a chat, as a live conversation on top of the chat, or as a
+video call on a stage with the chat beside it. In a conversation or a call, the person talks,
+and the wizard talks back and sees the camera. For now, both need an OpenAI API key under
+Models. A plugin can add further ways, such as a kiosk page or a messenger.
 
-The home's cards show the channels that are on as small icons, the link's door first. A row of
-pills above the cards narrows them to one status (Draft, Local, Live, Not in the cloud) once
-two statuses are in play.
+A wizard you start on the “New wizard” page runs step by step unless you choose more under “How
+should it run?”. A wizard without its own choice, such as one from a template or an import, has
+the step-by-step page and the chat switched on. You can change the channels later under “Change”
+in the share dialog.
 
-The link opens the first browser channel that is on. The others answer under their own address
-(`/steps`, `/chat`, `/talk` for live voice, `/video` for the video call) and are offered on the
-wizard's first page: "Or: Chat". A switched-off address sends people to the link instead.
+Where a channel can’t take a step, the step goes to the wizard’s page. The person gets a link for
+a photo, a signature or a sign-in, and comes back afterwards. If nobody can hand a step off (for
+example, one that takes minutes on a channel that can’t wait), the row shows “Not possible: …”
+under the channel’s name. A channel that still needs something says so in its row:
 
-### WhatsApp, SMS and calls
+| The row says | What you can do |
+|---|---|
+| “Not set up yet” | “Set up” opens the channel’s settings inside the dialog. “Back” returns to the rows |
+| “Waiting” | Nothing for now. The channel is waiting for something, for example a number that was requested |
+| “Not in your plan” | “See {plan}” or “See the plans” shows the plan that has it |
 
-On engenty.ai a wizard can also run in a WhatsApp thread, by text message and as a phone call,
-where the team's plan includes them. These channels are not part of the open runtime: a local
-install has them through its account in the cloud.
+The cards on the start page show the channels that are on as small icons, the link’s channel
+first. Once wizards with two or more statuses are in the space, a row of pills above the cards
+narrows them to one status: “Draft”, “Local”, “Live” or “Not in the cloud”.
 
-Switch one on for a wizard and its row in the share dialog shows the number and the **keyword**:
-whoever sends the keyword to the number starts the wizard. "Link" copies a link that writes it,
-and the QR code view draws it. The keyword is changed under the gear.
+The link opens the first browser channel that is on. The others answer under their own address
+(`/steps`, `/chat`, `/talk` for live voice, `/video` for the video call) and are offered on the
+wizard’s first page, for example “Or: Chat”. An address that is switched off sends people to
+the link instead.
 
-- **WhatsApp**: one field per message, buttons for up to three choices, a list for more, a photo
-  or a file sent in the chat, "send location" for a place, a voice message for a text field. A
-  free message goes out within 24 hours of the person's last one; a wizard that finishes later
-  reaches back with an approved template, or waits for the person's next message.
-- **SMS**: text only, choices as numbered lines answered with the number, a place as a typed
-  address; long texts come as their gist, every picture, document and the whole result as links.
-- **Calls**: the speech model talks, as the chat's live voice does: one field at a time, choices
-  read out, e-mail addresses and numbers read back. With several wizards on for calls, the call
-  asks which one first.
+### WhatsApp, SMS and calls
 
-What a channel cannot take (a signature, a sign-in; by text and on the phone also a photo or a
-file) arrives as a link to the wizard's page, and the conversation goes on once it was filled
-there. "stop" ends a run in a thread, the keyword starts a new one.
+On engenty.ai a wizard can also run in a WhatsApp chat, by text message and as a phone call,
+where the team’s plan includes them. These channels are not part of the open source engenty
+wizards. On your computer, you get them through your account in the cloud.
+
+When you switch one on for a wizard, its row in the share dialog shows the number and the
+**keyword**. Whoever sends the keyword to the number starts the wizard. “Link” copies a link that
+writes the message, and the QR code view draws it. You change the keyword under “Settings”.
+
+- **WhatsApp**: one field per message, buttons for up to three choices and a list for more. The
+  person sends a photo or a file in the chat, “send location” for a place, and a voice message
+  for a text field. A free message can go out within 24 hours of the person’s last one. A wizard
+  that finishes later reaches back with an approved template, or waits for the person’s next
+  message.
+- **SMS**: text only. Choices come as numbered lines, answered with the number, and a place as a
+  typed address. Long texts come as their gist, and every picture, document and the whole result
+  as links.
+- **Calls**: the speech model talks, as the chat’s live voice does. It asks for one field at a
+  time, reads out the choices and reads email addresses and numbers back. If several wizards are
+  on for calls, the call first asks which one.
+
+What a channel can’t take (a signature or a sign-in, and by text or phone also a photo or a
+file) arrives as a link to the wizard’s page. The conversation goes on once it has been filled in
+there. “stop” ends a run in a chat, and the keyword starts a new one.
 
 ### Who can open the link
 
-An install on your computer only answers on `localhost`: the link works on that computer, not
-for anyone else. To let others run the wizard:
+engenty wizards on your computer only answers on `localhost`. The link works on that computer,
+not for anyone else. To let others run the wizard:
 
 | Way | How |
 |---|---|
-| The cloud | With an [account](./models.md#account) signed in, every version that goes live (the first share, and each "Go live") also goes to engenty.ai. Its link there runs on the account's credits, also while your computer is off |
+| The cloud | Sign in with an [account](./create-account.md). Every version that goes live (the first share, and each “Publish”) then also goes to engenty.ai. Its link there runs on the account’s credits, even while your computer is off |
 | Your own server | [Run engenty wizards on a server](./server.md) with a public https address |
 
 ### In the cloud
 
-Once an account is signed in under Settings → Account, every version that goes live is sent to
-engenty.ai too. The avatar then carries a small cloud, and its menu says "Connected to
-engenty.ai" with the credits. The share dialog gives the wizard's address at engenty.ai, which
-stays the same when you publish again. Where the cloud does not run this version, the dialog
-says so on top:
+Once you sign in to an account under Settings → Account, every version that goes live also
+arrives on engenty.ai. Your avatar then carries a small cloud, and its menu says “Connected to
+engenty.ai” with your credits. The share dialog gives the wizard’s address at engenty.ai, which
+stays the same when you publish again. Where the cloud doesn’t run this version, the dialog says
+so at the top:
 
 | It shows | Means |
 |---|---|
-| "Version 3 does not run in the cloud" | Something the wizard needs is missing there. The list says what; the version before keeps running |
-| "Send again" | The last sending did not arrive, or the space changed. When engenty.ai was the trouble, the studio tries again by itself and says when |
+| “Version 3 doesn’t run in the cloud.” | Something the wizard needs is missing there. The list says what, and the version before keeps running |
+| “Send again” | The last version didn’t arrive, or the space changed. When engenty.ai was the problem, the studio tries again by itself and says when |
 
-Without an account the dialog says that the wizard runs only on this computer ("Only on this
-computer" under Access), greys out the ways in and offers to sign in or create an account.
-"Website" still gives the WordPress package.
+Without an account, the dialog says that the wizard runs only on this computer (“Only on this
+computer” under “Access”). It greys out the ways others reach it and offers “Sign in” and “Create
+account”. “Website” still gives you the WordPress package.
 
-What goes and what stays:
+What goes to the cloud and what stays:
 
 | Goes to the cloud | Stays on your computer |
 |---|---|
 | The published version and its files | Drafts and the chat with the assistant |
-| The space's name, what it says about itself, its colours, facts and logo | Runs and results of your computer |
-| The space's own tables and pages | What the wizards keep: their lists and notes |
-| How the link is shared: on or off, runs a day, channels | Connected accounts, keys, the space's documents and MCP servers |
+| The space’s name, what it says about itself, its colours, facts and logo | Runs and results on your computer |
+| The space’s own tables and pages | What the wizards keep: their lists and notes |
+| How the link is shared: on or off, runs a day, channels | Connected accounts, keys, the space’s knowledge and its connected systems |
 
-At engenty.ai/studio you see the space and its runs there. It is changed on your computer:
-the studio there edits nothing. An account holds one space of one computer. On a new computer
-the share dialog offers to replace the space of the old one, which removes its wizards and
-their links from the cloud.
+At engenty.ai/studio you see the space and its runs there. A small laptop icon marks the space,
+and a note says “You edit this space in engenty wizards on your computer.” The studio there
+doesn’t edit it. An account holds one space from one computer. On a new computer, the share
+dialog offers “Replace that space”, which removes the old computer’s wizards and their links from
+the cloud.
 
-Deleting a wizard here removes its copy; switching its link off here switches it off there.
+When you delete a wizard here, its copy in the cloud is deleted too. When you switch its link
+off here, it is switched off there as well.
 
 ### Embed in a website
 
-The share dialog gives a tag to paste into a page's HTML:
+Under “Website”, the share dialog gives you code to paste into a page’s HTML. Where the wizard
+has both the step-by-step page and the chat on, you first choose what the website shows:
 
-| What the website shows | Shows |
+| What does the website show? | Shows |
 |---|---|
 | Step-by-step wizard | The wizard page by page |
 | Chat | The wizard as a chat, 640 px high (`data-height` changes that) |
 
-| Where on the page | Shows |
+| Where on the page? | Shows |
 |---|---|
-| In the page | The wizard in that place of the page, as tall as its content |
-| Behind a button | A button in that place that opens the wizard in a window over the page |
-| As a chat button | The wizard's engenty in the lower right corner; the chat opens above it |
-| As a bubble | Steps only: a round button at the bottom right of the page that opens the wizard in a window over the page, best put in the site's footer |
+| In the page | The wizard in that place on the page, as tall as its content |
+| Behind a button | Step by step only: a button in that place that opens the wizard in a window over the page |
+| As a chat button | Chat only: the wizard’s engenty in the bottom right corner. The chat opens above it |
+| As a bubble | Step by step only: a round button at the bottom right of the page that opens the wizard in a window over the page. It is best put in the site’s footer |
 
 ```html
 <script async src="https://example.com/embed.js" data-wizard="TOKEN"></script>
@@ -172,31 +193,32 @@ The share dialog gives a tag to paste into a page's HTML:
 <script async src="https://example.com/embed.js" data-wizard="TOKEN" data-mode="bubble" data-label="Questions?" data-text="A quote in 2 minutes"></script>
 ```
 
-A chat in the page that is switched off for the wizard shows the page instead; the chat button
+The code only works once the wizard is published and open to anyone with the link. A chat in the
+page that is switched off for the wizard shows the step-by-step page instead. The chat button
 always opens the chat.
 
 | Attribute | Does |
 |---|---|
-| `data-label` | The button's words; beside the chat button; the bubble's name for screen readers |
+| `data-label` | The button’s words. Beside the chat button, a short label. For the bubble, its name for screen readers |
 | `data-text` | A short line beside the bubble |
 | `data-color` | The colour of the chat button and of the bubble |
 | `data-height` | The height of a chat in the page, in px |
-| `data-page` | The page a run is started on, kept with its result; the page's own address when left out |
+| `data-page` | The page a run is started on, kept with its result. Without it, the page’s own address is used |
 
-Your website's own styles reach the button through the class `engenty-wizard-button`, the chat
+Your website’s own styles reach the button through the class `engenty-wizard-button`, the chat
 button through `engenty-wizard-launcher` and the bubble through `engenty-wizard-bubble`. A page
-shows one bubble: a second bubble tag stays silent.
+shows only one bubble: a second bubble tag does nothing.
 
-On WordPress the plugin writes this tag for you, and its results show the page: see
+On WordPress the plugin writes this code for you, and its results show the page: see
 [WordPress](./wordpress.md).
 
 ## Results people share
 
-On the result page a person can share what they got as a link. The result of a run over the
-wizard's link, and the link to it, are deleted after 7 days. The person can withdraw the link
+On the result page, a person can share what they got as a link. The result of a run over the
+wizard’s link, and the link to it, are deleted after 7 days. The person can withdraw the link
 earlier.
 
 ## Move a wizard
 
-Export it as a package (`.wizard`) from the editor and import it in another studio, or in the
-WordPress plugin. See [Build a wizard](./build-a-wizard.md#take-it-with-you).
+Export it as a wizard file (`.wizard`) from its ⋯ menu, and import it in another studio or in
+the WordPress plugin. See [Build a wizard](./build-a-wizard.md#take-it-with-you).

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

@@ -1,65 +1,67 @@
 ---
 title: Troubleshooting
-description: What to do when a link is no longer valid, a client shows as not signed in, or an export fails.
-version: 0.3.4
+description: What to do when a link no longer works, a client shows as not signed in, or an export fails.
+version: 0.5.0
 ---
 
-`wizards doctor` checks the install and says what is wrong. Start there.
+`wizards doctor` checks engenty wizards on your computer and says what is wrong. Start there.
 
 ## Starting and signing in
 
-| What you see | Do |
+| What you see | What to do |
 |---|---|
-| "This link is no longer valid" | The link works once. `wizards open` gives this browser a new one |
-| "The app is not answering" | It stopped or is restarting. `wizards status` says whether it runs; `wizards start` starts it |
+| “This link is no longer valid. Run wizards open to get a new one.” | The link works once. `wizards open` gives this browser a new one |
+| “engenty wizards isn’t answering” | It has stopped or is restarting. `wizards status` says whether it is running; `wizards start` starts it |
 | `wizards`: command not found | Open a new terminal, or run `~/.local/bin/wizards` |
-| "This browser is not signed in" | The browser has no sign-in for the install, for example after clearing cookies. Run `wizards open` |
-| "The studio runs at another address" | Open the address the page names, or set `APP_URL` in `~/.engenty/wizards/.env` to the address you open |
-| Port 24368 is taken | The next free port is used. To fix one, set `API_PORT` in `~/.engenty/wizards/.env` |
+| “This browser isn’t signed in” | The browser has no sign-in for engenty wizards on this computer, for example after you cleared cookies. Run `wizards open` |
+| “The studio runs at another address” | Open the address the page names, or set `APP_URL` in `~/.engenty/wizards/.env` to the address you open |
+| Port 24368 is taken | engenty wizards uses the next free port. To fix the port, set `API_PORT` in `~/.engenty/wizards/.env` |
 
 ## Models
 
-| What you see | Do |
+| What you see | What to do |
 |---|---|
-| An AI client shows as not signed in | Sign it in on the setup page or under Settings → Models, or in your own terminal (`claude`, `codex login`). Then "Check again" |
-| "Signed in with an API key from your shell" | The client runs on that key, not on your subscription. "Sign in here" switches it |
-| The test does not work | The message names the reason. Check the key, or sign the client in again |
-| "Models are missing" in the editor | A step needs a model this install has no way to, often video or audio. Add a key under Settings → Models |
-| A template says "Not set up here" | The same: it needs a model that is not set up |
-| No Apple Intelligence in the setup or under Models | It needs a Mac with Apple silicon on macOS 26 or later, and is offered on your computer only, not on engenty.ai |
-| Apple Intelligence "switched off" or "Apple is still loading the model" | Switch it on under System Settings → Apple Intelligence & Siri, or wait until the Mac has the model. The studio asks again after a minute |
-| A step on Apple Intelligence fails: the text is too long | The model takes 4,096 tokens for prompt and answer. Give the step the class High, or bind its class elsewhere under Settings → Models. See [Apple Intelligence](./models.md#apple-intelligence) |
+| An AI client shows as not signed in | Sign it in on the setup page or under Settings → Models, or in your own terminal (`claude`, `codex login`). Then click “Check again” |
+| “Signed in with an API key from your shell, not the subscription.” | The client runs on that key, not on your subscription. “Sign in here” switches it |
+| “The test didn’t work” | The message names the reason. Check the key, or sign the client in again |
+| “Models are missing” in the editor | A step needs a model that isn’t set up here, often for video or audio. Add a key under Settings → Models |
+| A template says “Not set up here” | It is the same: the template needs a model that isn’t set up |
+| No Apple Intelligence in the setup or under Models | It needs a Mac with Apple silicon on macOS 26 or later. It is offered on your computer only, not on engenty.ai |
+| Apple Intelligence “switched off” or “Apple is still loading the model” | Switch it on under System Settings → Apple Intelligence & Siri, or wait until the Mac has the model. The studio checks again after a minute |
+| A step on Apple Intelligence fails because the text is too long | The model takes 4,096 tokens for prompt and answer together. Give the step the class High, or choose another model for its class under Settings → Models. See [Apple Intelligence](./models.md#apple-intelligence) |
 | A voice note the Mac writes down fails in Chrome or Firefox | Their recordings need ffmpeg on the Mac: install it, or set `FFMPEG_PATH` |
 
 ## Running wizards
 
-| What you see | Do |
+| What you see | What to do |
 |---|---|
-| PDF or PNG export, or a step on a website, fails | `wizards doctor` names the browser the app uses. Install Chrome, Edge or Chromium (on a Mac also Brave), or set `CHROME_PATH` to one; see [Settings](./command-line.md#settings) |
+| PDF or PNG export, or a step on a website, fails | `wizards doctor` names the browser engenty wizards uses. Install Chrome, Edge or Chromium (on a Mac also Brave), or set `CHROME_PATH` to one; see [Settings](./command-line.md#settings) |
 | A widget offers no video | Install ffmpeg, or set `FFMPEG_PATH` |
-| "This wizard is not available right now" | The link is switched off, or the account the wizard runs on has no credits left. See [Test and share](./test-and-share.md) |
-| The wizard says its limit is reached for today | The link's runs for the day are used up; the day starts at midnight UTC. Raise the runs a day under the share dialog's gear |
-| "This wizard does not exist (anymore)" | It is not published, or its link was replaced by a new one |
-| Others cannot open the link | An install on your computer answers on `localhost` only. See [who can open the link](./test-and-share.md#who-can-open-the-link) |
-| The chat has no phone button, or "Join" stays grey | A live conversation needs "Live voice" or "Video call" switched on for the wizard (see [Channels](./test-and-share.md#channels); your own test run always has it) and an OpenAI API key under Settings → Models |
-| The camera, microphone or location does not work | Allow it in the browser's site settings (the lock icon in the address bar) |
-| A connector says "not set up" | The install needs an OAuth client for it. See [Connectors](./connectors.md) |
-| A step stops at a plugin's tool | That plugin is not installed here. See [Plugins](./plugins.md) |
+| “This wizard isn’t available right now.” | The link is switched off, or the account the wizard runs on has no credits left. See [Test and share](./test-and-share.md) |
+| “This wizard has reached its limit for today. Try again tomorrow.” | The link’s runs for the day are used up; the day starts at midnight UTC. Raise “Limit per day” under Settings (the gear) in the share dialog |
+| “You’ve started a lot of runs just now. Try again in an hour.” | One visitor started more runs in an hour than the link allows (`LIMIT_VISITOR_RUNS_PER_HOUR`, see [Settings](./command-line.md#settings)) |
+| “This wizard doesn’t exist or was deleted.” | It is not published, or its link was replaced by a new one |
+| Others can’t open the link | engenty wizards on your computer answers on `localhost` only. See [who can open the link](./test-and-share.md#who-can-open-the-link) |
+| The chat has no phone button, or “Join” stays grey | A live conversation needs “Live voice” or “Video call” switched on for the wizard (see [Channels](./test-and-share.md#channels); your own test run always has it) and an OpenAI API key under Settings → Models |
+| The camera, microphone or location doesn’t work | Allow it in the browser’s site settings (the lock icon in the address bar) |
+| A connector says “not set up” | engenty wizards needs an OAuth client for it. See [Connectors](./connectors.md) |
+| A step stops at a plugin’s tool | That plugin is not installed here. See [Plugins](./plugins.md) |
 
 ## Updating
 
-| What you see | Do |
+| What you see | What to do |
 |---|---|
-| "The update failed" | The reason is in `~/.engenty/wizards/logs/update.log`. Run `wizards update` in a terminal to see it live |
-| A template "Needs a newer app" | Update: `wizards update` |
+| “The update failed. Details are in logs/update.log.” | The reason is in `~/.engenty/wizards/logs/update.log`. Run `wizards update` in a terminal to see it as it happens |
+| A template says “Needs a newer version” | Update with `wizards update` |
 
 ## Still stuck
 
-`wizards logs` shows the last lines the install printed; keys and tokens are taken out. Open an
-issue at [github.com/engenty/wizards](https://github.com/engenty/wizards/issues)
-with what `wizards doctor` prints and the lines that matter.
+`wizards logs` shows the last lines engenty wizards printed, with keys and tokens taken out. Open
+an issue at [github.com/engenty/wizards](https://github.com/engenty/wizards/issues) with what
+`wizards doctor` prints and the lines that matter.
 
-With a [linked account](./models.md#account), `wizards report` sends the status, the model settings
-(never a key) and the last 500 log lines to engenty, and names the report's id: give that id when
-you ask for help. Nothing is sent unless you run the command. Without a linked account it says
-so: link one under Settings → Account.
+If this computer is signed in to an [account](./models.md#account), `wizards report` sends the
+status, the model settings (never a key) and the last 500 log lines to engenty. It names the
+report’s ID: give that ID when you ask for help. Nothing is sent unless you run the command. If
+this computer isn’t signed in, the command tells you so: sign in under Settings → Account or with
+`wizards account sign-in`.