wizards 0.4.7 → 0.5.1

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

@@ -1,104 +1,126 @@
 ---
 title: Space
-description: What your wizards share and produce — who you are, what they look things up in, and the results of their runs.
-version: 0.3.7
+description: What your wizards share and produce – who you are, what they look things up in, and the results of their runs.
+version: 0.5.0
 ---
 
-The house in the app bar, after the space's tile, opens your space: what all your wizards share,
-and what they produce.
-Every AI step knows it, so a wizard never has to ask for your company's name or address.
+Your space holds what all your wizards share, and what they produce. Every AI step knows it, so a
+wizard never has to ask for your company’s name or address.
 
-The menu on the left shows the space's four parts; a part opens its own sections, the arrow at
-the top leads back. On a phone the parts, a part's sections and the page take turns.
+You open it in two ways:
+
+- The house in the app bar, after the space’s tile, opens the space’s page.
+- The button left of the space’s name in the top bar (“Space menu”) opens the sidebar. It lists “Wizards”,
+  “New wizard” and, under “Space”, the space’s four parts. On a narrow window the sidebar stays
+  closed.
+
+The menu on the left shows the space’s four parts. A part opens its own sections, and the arrow
+at the top leads back. While the sidebar is open, the menu stands in it. On a phone, the parts,
+a part’s sections and the page take turns.
 
 | Part | Sections | Used for |
 |---|---|---|
 | Info & brand | Basics, Facts, Logos, Colours, Brand assets | Who you are and how you look |
-| Knowledge | All, then each Kategorie, then the sections plugins add | What every AI step looks things up in |
-| Data | All data, then each wizard | Tables and pages the wizards keep |
+| Knowledge | All, then each category, then the sections plugins add | What every AI step looks things up in |
+| Data | All data, General, then each wizard | Tables and pages the wizards keep |
 | Results | All results, then each wizard | The runs that reached their result |
 
 ## Info & brand
 
+Logos, Colours and Brand assets each have an “Add” menu in their head.
+
 | Section | Holds | Used for |
 |---|---|---|
-| Basics | Title and "About": what you do, for whom, and the tone you write in | Texts sound like you. People who run a wizard see the title too |
-| Facts | Labelled values: address, VAT id, opening hours | Steps use them as written |
-| Logos | One or several, each with a description of what it is for | People see the main logo. The description tells a step what a variant is for |
-| Colours | Named colours, each with a note on its use | The first colour is the accent of documents, dashboards and public pages |
-| Brand assets | Images, graphics, videos, sound, PDFs, fonts, Lottie and 3D files, in tabs | AI steps place pictures in documents and choose by the description |
+| Basics | “Title” and “About”: what you do, for whom, and the tone you write in | Texts sound like you. People who run a wizard see the title too |
+| Facts | Labelled values: address, VAT ID, opening hours | Steps use them as written |
+| Logos | One or several, each with a description of what it is for. Upload one, or take it from a web address (“Logo from URL”) | People see the main logo. The description tells a step what a variant is for |
+| Colours | Named colours, each with a note on its use. Add one, or read them off a web page (“Colours from URL”) | The first colour is the accent of documents, dashboards and public pages |
+| Brand assets | Images, videos, audio, PDFs, fonts, Lottie and 3D files, in tabs you can search | AI steps place pictures in documents and choose them by their description |
 
 ## Knowledge
 
-The ground truth your wizards' steps look things up in: pages, tables and files. You see here
-exactly what a step can find. Drop documents on the page, or add a page or a table yourself
-("New page", "New table"; a table can be an FAQ, a question and its answer per row).
+Knowledge is the ground truth your wizards’ steps look things up in: pages, tables and files. You
+see here exactly what a step can find. Drop documents on the page, or add a page or a table
+yourself (“New page”, “New table”). A table can be an FAQ, with a question and its answer per row.
 
 - **Documents become pages and tables when they arrive.** A PDF, a Word file or a scan becomes a
-  page; the original stays behind it ("Original"), and the page marks where each page of it
-  begins, so a step can quote "p. 2". A long document with headings of its own — a law, a
-  manual — becomes a page with sub-pages, one per section; "§ 281" in the text links to that
-  sub-page. A workbook becomes a table per sheet, a CSV one table. What cannot be read stays a
-  file and is found by its name and description. A scan that read badly is marked "Check".
-- **Kategorien keep things apart.** A Kategorie is a property with a type: a choice
-  (Baustelle, Art der Förderung), a date, a number with its unit, a short text, yes / no. Set
-  them on a page, a table or a file with the chips under its title; when a document arrives, a
-  model fills them from what it reads. A table's column can be one. A step filters by them
-  before it searches: "reports of Graz Süd in March" is a filter first.
-- **Each value of a choice** has its contents — everything that has it — and an overview a model
-  writes on request ("Write the overview"). The search finds the overview like a page.
-- **Two spellings of one value** ("Graz-Süd", "Graz Süd") are offered for merging on the
-  Kategorie's page. A Kategorie a source proposes stands as "Proposed" until you take it.
-- **"Try a search …"** searches the way a step does: the filters first, then words and meaning,
-  then a classifier asks of each hit whether it answers the question and keeps those that do,
-  with how sure it is. Without a classifier the hits stay unchecked; it needs a Vercel AI Gateway
-  or TypeSafe key, or an account. Searching by meaning needs an AI Gateway or OpenAI key, or an
-  account; without one the search finds words only. See [Models and account](./models.md).
-
-A plugin can fill Knowledge from outside, from a website or a folder, say. What it wrote shows
-where it came from ("From …"); once you change it by hand, it stays yours and the plugin no
-longer writes it.
+  page. The original stays behind it (“Original”), and the page marks where each page of it
+  begins, so a step can quote “p. 2”. A long document with headings of its own, such as a law or
+  a manual, becomes a page with sub-pages, one per section; “§ 281” in the text links to that
+  sub-page. A workbook becomes a table per sheet, and a CSV becomes one table. What can’t be read
+  stays a file, and steps find it by its name and description. A scan that read badly is marked
+  “Check”.
+- **Categories keep things apart.** A category is a property with a type: a choice (building
+  site, type of funding), a date, a number with its unit, a text, or yes/no. You set them on a
+  page, a table or a file with the chips under its title. When a document arrives, a model fills
+  them in from what it reads. A table’s column can be one. A step filters by them before it
+  searches: “reports of Graz Süd in March” is a filter first.
+- **Each value of a choice** has its contents (everything that has this value) and an overview.
+  A model writes the overview when you ask for it (“Write the overview”). The search finds the
+  overview like a page.
+- **Two spellings of one value** (“Graz-Süd”, “Graz Süd”) are offered for merging on the
+  category’s page. A category that a source proposes stands as “Proposed” until you accept it.
+- **“Try a search…”** searches the way a step does: the filters first, then words and meaning.
+  Then a model asks of each hit whether it answers the question, keeps those that do and says how
+  sure it is. That check is quickest with a decision model, which needs an AI Gateway or TypeSafe
+  key, or an account. Searching by meaning needs an AI Gateway or OpenAI key, or an account;
+  without one, the search finds words only. See [Models and account](./models.md).
+
+A plugin can fill Knowledge from outside, from a website or a folder, for example. What it wrote
+shows where it came from (“From …”). Once you change it by hand, it stays yours, and the plugin
+no longer updates it.
 
 ## Data
 
-Tables and pages the space's wizards keep, under the wizard they belong to. A wizard fills its
-own: a shared list becomes one of its tables, and a step with the "Pages" tool writes its pages.
-The columns of a shared list come from the wizard.
+Data holds the tables and pages of the space and its wizards. Those of the space itself stand
+under “General”, a wizard’s under its name. A wizard fills its own: a shared list becomes one of
+its tables, and a step with the “Pages” tool writes its pages. The columns of a shared list come
+from the wizard. The buttons “Table” and “Page” add one, for the space or for one of its
+wizards.
 
-- **Table**: columns of a type (text, number, date, duration, choice, yes / no) and a row per
-  line. Type into a cell; it is saved when you leave it. A value that does not fit the column is
-  marked and not saved. The heading of a column changes its name and type, the plus beside the
-  headings adds one.
-- **Page**: a title and text in Markdown. "Write" edits it, "Preview" shows it; it is saved as
-  you type.
+- **Table**: columns of a type (text, number, date, duration, choice, yes/no) and a row per
+  line. Type into a cell; it is saved when you leave it. A value that doesn’t fit the column is
+  marked and not saved. The heading of a column changes its name and type, and the plus beside
+  the headings adds a column.
+- **Page**: a title and text in Markdown. “Write” edits it, and “Preview” shows it. It is saved
+  as you type.
 
-### On a local install and in the cloud
+### On your computer and in the cloud
 
-Data stays where it was written. A wizard's tables and pages are filled where it runs: on this
-computer by its runs here, in the cloud by the runs over its link. The pages and tables of
-Knowledge, with their Kategorien, go to the cloud with every wizard you publish there, and are
-shown there without being changed. Files stay on this computer.
+Data stays where it was written. A wizard’s tables and pages are filled where it runs: on your
+computer by its runs there, in the cloud by the runs over its link. The pages and tables of
+Knowledge, with their categories, go to the cloud with every wizard you publish there. The cloud
+shows them without changing them. Files stay on your computer.
 
 ## Results
 
-Every run that reached its result, newest first: of all wizards, or of the one picked in the
-menu, where the wizard with the latest result stands first. Search finds words in the wizard's
-name, in what was answered and in what the run produced; the filters keep live or test runs and
-the last 24 hours, 7 or 30 days. A run opens beside the list as the person saw it, with its
-files.
+Results lists every run that reached its result, newest first: of all wizards, or of the one you
+choose in the menu, where the wizard with the latest result stands first. The search finds words
+in the wizard’s name, in what was answered and in what the run produced. The filters keep live or
+test runs, and the last 24 hours, 7 or 30 days. A run opens beside the list as the person saw it,
+with its files.
 
 ## Have it filled in
 
-The [assistant](./assistant.md) at the bottom of the page fills the space for you. Tell it about
-yourselves, name your website or give it files:
+[Goose](./assistant.md), at the bottom of the page, fills in the space for you where it is
+switched on. Tell it about yourselves, name your website or give it files:
 
 > Read our website example.com
 
 It enters what it finds: title, description, logo, colours and facts. You correct the rest.
 
+In the cloud, the first visit to the studio does the same: it asks for your website and your
+first documents. See [Create an account](./create-account.md).
+
 ## One space
 
-A local install has one space. On engenty.ai the team's plan says how many it may have: the
-space's name in the top bar switches between them, and "Add space" adds one. Each space has its
-own wizards, Info & brand, Knowledge, Data, connectors and results; the account, the models and
-the plugins are the same for every space.
+engenty wizards on your computer has one space, called “My computer” at first (“Mein Computer” in German). On engenty.ai the
+team’s plan says how many spaces it may have. The space’s name in the top bar opens a menu: it
+switches between spaces, “Rename space” renames this one, and “Add space” adds one while the plan
+has room. Each space
+has its own wizards, Info & brand, Knowledge, Data, connectors and results. The account, the
+models and the plugins are the same for every space.
+
+When you publish wizards from your computer with an account signed in, their space shows up in
+the cloud too, marked with a laptop. You can only look at it there: you edit it in engenty
+wizards on your computer, and changes show up in the cloud the next time you publish a wizard.

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

@@ -1,7 +1,7 @@
 ---
 title: Steps
-description: What a wizard is made of — pages, AI steps, generated media, widgets, reviews and the result.
-version: 0.3.2
+description: What a wizard is made of – pages, AI steps, generated media, widgets, reviews and the result.
+version: 0.5.0
 ---
 
 A wizard runs its steps from top to bottom. The last step is always the result.
@@ -12,7 +12,7 @@ A wizard runs its steps from top to bottom. The last step is always the result.
 | AI step | Does a task with tools: research, read documents, call an API, work in a connected service |
 | Generate | Makes one thing: an image, a video, a voice-over, a document or a dashboard |
 | Widget | Shows an interactive view built once for this wizard: a map, a timeline, a calculator, a film |
-| View | Shows the results in the wizard's own look: key figures, facts, a list, a chart |
+| View | Shows the results in the wizard’s own look: key figures, facts, a list, a chart |
 | Film | Has the AI client on your computer make a film as code, rendered to an MP4 |
 | Review | Shows what earlier steps made. The person accepts it, edits it or asks for a new version |
 | Result | The last page: what the person can download or share |
@@ -23,41 +23,41 @@ A page has a title, up to five fields and a button. Each field has a kind:
 
 | Kind | The person |
 |---|---|
-| Text, long text, number, date, e-mail, link | types a value |
-| Select, multi-select, toggle, colour | picks |
-| Image | takes or uploads photos, one or several, in an order they can change |
-| File | uploads documents; the camera can scan papers and record a short clip |
-| Line items | fills rows with amounts. The wizard computes net, VAT and total |
-| Location | taps "Use my location" or types an address |
-| Voice note | records up to 5 minutes. The wizard writes down what was said before the next step reads it. Who writes it down is set under Voice notes in [Models](./models.md); a Mac can do it itself |
+| Short text, Long text, Number, Date, Email, Link | types a value |
+| Choice, Multiple choice, Yes/no, Colour | chooses |
+| Image upload | takes or uploads photos, one or several, in an order they can change |
+| File upload | uploads documents. The camera can scan papers and record a short clip |
+| Line items (table) | fills rows with amounts. The wizard works out net, VAT and total |
+| Location | taps “Use my location” or types an address |
+| Voice note | records up to 5 minutes. The wizard writes down what was said before the next step reads it. You choose who writes it down under Voice notes in [Models](./models.md); a Mac can do it itself |
 | Signature | signs with a finger |
-| Appointment | picks one of the free times offered, shown by day |
-| Connection | connects their own account of a service, for example their mailbox |
-| List | checks, corrects and extends a list the wizard keeps for them |
+| Appointment | chooses one of the free times offered, shown by day |
+| Connect an account | connects their own account of a service, for example their mailbox |
+| Saved list | checks, corrects and extends a list the wizard keeps for them |
 
-A text field can have a "Scan" button that fills it from a QR code or barcode.
+A text field can have a “Scan” button that fills it from a QR code or barcode.
 
 A field can start with a value an earlier step proposed. A line-items field, for example, shows
 the positions an AI step looked up, for the person to correct.
 
-A field can be shown only under a condition: "Street and town" only when the person chose
-delivery, "Which allergy?" only when they ticked "Allergies". The condition can read another
-field of the same page, and the field then appears as the person answers, or anything known
-before the page. A hidden field is not required and is not kept.
+A field can be shown only under a condition (“Show only when”): “Street and town” only when the
+person chose delivery, “Which allergy?” only when they ticked “Allergies”. The condition can
+read another field of the same page, and the field then appears as the person answers. It can
+also read anything known before the page. A hidden field is not required and is not kept.
 
-The choices of a select can come from earlier data instead of a fixed list: the suppliers a
-research step found, one column of a table it made, or a column of a list the wizard keeps. The
-fixed choices stand in while that data is empty. When the choices are the rows of a table, each
-can show as a card with a picture, a line or two of text and "Details" to open its page.
+The choices of a choice field can come from earlier data (“Choices from earlier data”) instead
+of a fixed list: the suppliers a research step found, one column of a table it made, or a column
+of a list the wizard keeps. The fixed choices stand in while that data is empty. When the choices are the rows of a table, each
+can show as a card with a picture, a line or two of text and “Details” to open its page.
 
 An appointment field takes its times the same way, usually from an AI step that looked up the
-free times in a calendar. The times show in the calendar's own time zone, grouped by day.
+free times in a calendar. The times show in the calendar’s own time zone, grouped by day.
 
-A field can also be left to the AI: it is shown when the AI, reading what was answered and found
-so far, finds a statement true ("The complaint is about a damaged article"). Fields that are
-alternatives of each other form a group, and the AI shows the one that fits ("How should we reach
-the person?"). The AI decides once, when the run reaches the page. A page whose fields the AI
-picks holds up to 12 of them and shows at most five.
+A field can also be left to the AI. The AI reads what was answered and found so far, and shows
+the field when it finds a statement true (“The complaint is about a damaged article”). Fields
+that are alternatives of each other form a group, and the AI shows the one that fits (“How
+should we reach the person?”). The AI decides once, when the run reaches the page. A page whose
+fields the AI chooses holds up to 12 of them and shows at most five.
 
 ## AI steps
 
@@ -67,22 +67,24 @@ An AI step has instructions and the tools you allow it:
 |---|---|
 | Web search | search the web |
 | Read web pages | open and read a page |
-| Browser | click and type on websites, take screenshots, download files. A login is typed by the person; the model never sees it |
-| Code & shell | run code in a sandbox, where the install has one |
+| Browser | click and type on websites, take screenshots, download files. The person types a login themselves; the model never sees it |
+| Code & shell | run code in a sandbox, where engenty wizards has one |
 | Images | make images while it works |
 | API | call an HTTP API |
-| Pages | write pages of the wizard in Markdown, kept for every later run, and read them and the space's own pages |
+| Pages | write pages of the wizard in Markdown, kept for every later run, and read them and the pages of the space’s Knowledge |
 
-Every AI step can also read and write the wizard's lists, list its files and read documents:
+Every AI step can also read and write the wizard’s lists, list its files and read documents:
 PDFs, scans and photos, Word, Excel, CSV and saved mails. Where the space has Knowledge, the step
-searches it too.
+searches it too. Every AI step also knows the space’s Info & brand: its title, what it says
+about itself, its facts and colours.
 
 Further tools come from three places:
 
-- **Connections** the wizard declares: the step gets the service's actions as tools. See
-  [Connectors](./connectors.md).
+- **The person’s accounts**: connectors the wizard uses, where the person connects their own
+  account during the run. The step gets the service’s actions as tools. Reading is free; before
+  anything changes in the person’s account, they are asked. See [Connectors](./connectors.md).
 - **Connected systems** (MCP servers) of the space, where you allow them on the step.
-- **Plugins** installed in this app. See [Plugins](./plugins.md).
+- **Plugins** installed in engenty wizards. See [Plugins](./plugins.md).
 
 ### Model class
 
@@ -95,18 +97,19 @@ A step names the kind of model it needs, never a model:
 | High | Research with tools, long documents, weighing many sources. The default |
 | Highest | Hard reasoning or code. Several times the cost of High |
 
-On a Mac, Classifier and Standard can run on [Apple Intelligence](./models.md#apple-intelligence):
-free and on the machine, but for short texts and without tools. There, give a step that calls an
-API or reads documents the class High.
+On a Mac, Classifier and Standard can run on [Apple Intelligence](./models.md#apple-intelligence).
+It is free and stays on your computer, but it handles only short texts and no tools. There, give
+a step that calls an API or reads documents the class High.
 
-Images, video, voice notes and voice-overs have classes of their own. Which model serves a class
-is set under [Models & account](./models.md). "Thinking effort" tells the model how hard to
-think; leave it on "Automatic" unless a step is clearly trivial or clearly hard.
+Images, video, voice notes and voice-overs have classes of their own. You choose which model
+serves a class under [Models and account](./models.md). “Thinking effort” sets how much effort
+the model puts in. Leave it on “Automatic” unless a step is clearly trivial or clearly hard.
 
 ### What a step hands on
 
-A step's output is text, Markdown or structured data with named fields: a text, a number, a
-list, a table, a yes/no answer, a choice or a score on a scale ("low, medium, high"). Later steps use these, and branches decide on them.
+A step’s output is text, Markdown or structured data with named fields: a text, a number, a
+list, a table, a yes/no answer, a choice or a score on a scale (“low, medium, high”). Later
+steps use these, and branches decide on them.
 
 ## Generate
 
@@ -124,10 +127,10 @@ made again.
 
 ## Views
 
-A view shows what the run found in the wizard's own look, on any screen: key figures, a list of
+A view shows what the run found in the wizard’s own look, on any screen: key figures, a list of
 facts, a list of results with pictures, a table or a simple chart (bars, a line, a ring). It is
-built from a fixed set of parts, written once by the assistant, and every run brings new data;
-it costs nothing to show.
+built from a fixed set of parts that the assistant writes once, and every run brings new data.
+It costs nothing to show.
 
 A view can also leave some of its parts to the AI, for example a chart only when there is
 something to compare. And an AI step can lay out a view of its own result, which reviews and the
@@ -137,23 +140,25 @@ For anything the parts cannot show, such as a map or an animation, use a widget.
 
 ## Widgets
 
-A widget is an interactive HTML view written once into the wizard's files. Every run only brings
-new data, so it costs nothing to show and looks the same every time. With "video" switched on it
-is a film: its timeline is rendered to an MP4 with sound.
+A widget is an interactive HTML view written once into the wizard’s files. Every run only brings
+new data, so it costs nothing to show and looks the same every time. A widget can also be a
+film: its timeline is then rendered to an MP4 with sound. Ask the assistant for one in the chat.
 
 ## Films
 
-A film step hands a brief, the run's material (voice-overs, pictures, uploads, texts) and the
-space's brand to the AI client installed on your computer (Claude Code). It writes the film as
-code, looks at its frames and fixes them; the app renders the MP4, 16:9, 9:16 or square. It runs
-only where Claude Code is set up as the AI subscription, never on credits or in the cloud, and
-takes 10 to 40 minutes. Voice comes from a generate step before it.
+A film step hands a brief, the run’s material (voice-overs, pictures, uploads, texts) and the
+space’s brand to the AI client installed on your computer (Claude Code). The client writes the
+film as code, looks at its frames and fixes them. engenty wizards then renders the MP4: 16:9,
+9:16 or square. A film step runs only where Claude Code is set up with your subscription, never
+on credits or in the cloud, and it takes 10 to 40 minutes. The voice comes from a generate step
+before it.
 
 ## Reviews
 
-A review shows earlier outputs. Depending on its settings the person can edit text, or ask for a
-new version with a note on what should change. A list shown in a review is edited in place; a
-list with files is checked row by row, each row beside its document.
+A review shows what earlier steps made. Depending on its settings, the person can edit the text
+(“Text can be edited directly”) or ask for a new version with a note on what should change (“Ask
+for a new variant”). A list shown in a review is edited in place. A list with files is checked
+row by row, each row beside its document.
 
 ## The result
 
@@ -180,37 +185,36 @@ A step can send the run somewhere else when a condition holds: a field is or is
 one of several, is filled in or empty, is greater or less than a number, or contains a value. A
 condition can also read what an AI step found, how sure the AI was of a decision, or how many
 rows a list the wizard keeps has. Several conditions on one branch must all hold. The first
-branch that matches wins; otherwise the step's "otherwise" branch, or else the next step,
-follows. The diagram draws the branches with their conditions.
+branch that matches wins; otherwise the step’s “otherwise” branch, or else the next step,
+follows. The diagram shows the branches with their conditions.
 
-A branch can also be decided by the AI: instead of a condition it has a statement ("The person
-wants a refund, not an exchange"). When no condition matched, the AI reads what was answered and
+A branch can also be decided by the AI: instead of a condition it has a statement (“The person
+wants a refund, not an exchange”). When no condition matched, the AI reads what was answered and
 found so far and takes the branch whose statement is true; if none clearly is, the next step
 follows. All such branches of a step cost one small decision together.
 
-A branch back to an earlier step makes a loop, for example "write, check, write again until the
-check passes". A loop stops after the number of times you allow, at most ten if you set nothing.
+A branch back to an earlier step makes a loop, for example “write, check, write again until the
+check passes”. A loop stops after the number of times you allow, at most ten if you set nothing.
 The step that runs again sees what it made the last time.
 
 An AI step can also work through a list: once per row of a table an earlier step made, or per
 row of a list the wizard keeps, at most 20 rows. Its results come together in one table.
 
-
 ## What a wizard keeps
 
 - **Lists** hold rows between runs, separately for each person who runs the wizard: the
   receipts already booked, the customers already written to.
 - **Shared lists** hold one set of rows for every run: requests, sign-ups, a log. The person
   running the wizard never sees them; you find them under Space → Data, below the wizard, and
-  in the editor under "Memory".
-- **Connected accounts and sign-ins** are kept for the person's next run.
+  in the editor under “Memory”.
+- **Connected accounts and sign-ins** are kept for the person’s next run.
 
-The person sees and deletes all of it under "What this wizard remembers". See
+The person sees and deletes all of it under “What this wizard remembers”. See
 [Run a wizard](./run.md).
 
 ## AI media
 
 Images, clips, voice-overs and films a model made or changed carry a marking in their file, and
-every page lays an "AI generated" or "AI modified" label over them (EU AI Act, Art. 50). Nothing
+every page lays an “AI-generated” or “AI-modified” label over them (EU AI Act, Art. 50). Nothing
 is drawn into an image. A film shows the label in the picture, since it leaves the page as a
 video file.