@engenty/wizards-runtime 0.7.11 → 0.9.0

package/apps/runtime/dist/docs/dev/wizard-format/wizard-file.md

@@ -0,0 +1,147 @@
+---
+title: The .wizard file
+description: The zip a wizard travels in, its folders and manifest, how to make one by hand, and what the import does with it.
+version: 0.7.10
+---
+
+A `.wizard` file is a zip with the wizard’s definition and its workspace. The studio exports
+one, imports one back, and `wizards validate` checks one. Its media type is
+`application/vnd.engenty.wizard+zip`. The file is named after the wizard’s title, such as
+`create-an-invoice.wizard`.
+
+## What is in the zip
+
+```text
+create-an-invoice.wizard
+├── wizard.json                 the manifest, with the definition in it
+└── files/                      the wizard's workspace
+    ├── invoice/
+    │   ├── index.html          a widget step's entry
+    │   ├── app.js
+    │   └── sample.json         its example data
+    ├── lib/
+    │   └── chart.min.js        libraries the widgets load
+    ├── prices.csv              reference data AI steps read
+    ├── kits/explainer.zip      a film step's style kit
+    ├── skills/brand/SKILL.md   a skill package a film step reads
+    └── knowledge/              only in a website package
+        └── services/pricing.md
+```
+
+| Path | What it holds |
+|---|---|
+| `wizard.json` | The manifest. See [The manifest](#the-manifest) |
+| `files/` | The workspace: every file the wizard’s steps name by path |
+| `files/knowledge/` | The space’s Knowledge pages, only when the export was asked for them. See [Knowledge](#knowledge) |
+
+Only `wizard.json` is required. A wizard without widgets, kits or files has an empty `files/`
+or none.
+
+## The workspace
+
+The paths under `files/` are the paths the definition uses. A widget step with
+`"entry": "invoice/index.html"` reads `files/invoice/index.html`, and a film step with
+`"kit": "kits/explainer.zip"` reads `files/kits/explainer.zip`. Apart from `knowledge/`, no
+folder has a fixed meaning. The ones above are what the studio and its assistant write.
+
+| Limit | Value |
+|---|---|
+| Files | 200 |
+| One file | 5 MB |
+| All files | 25 MB |
+| The whole zip | 30 MB, with room for the manifest |
+| A path | 200 characters: letters, digits, `_`, `-` and `.`, with `/` between folders |
+
+A path starts with a letter, a digit, `_` or `-`. So hidden files such as `.env` and paths with
+`..` are not allowed. The import refuses a file that breaks a limit, and names it.
+
+## The manifest
+
+```json
+{
+  "$schema": "https://engenty.ai/schema/v1/wizard-package.json",
+  "format": "engenty-wizard",
+  "version": 1,
+  "exportedAt": "2026-10-18T09:12:00.000Z",
+  "definition": { "version": 1, "title": "Create an invoice", "steps": [ … ] },
+  "connectors": [
+    { "id": "billomat", "name": "Billomat", "domain": "billomat.com", "sourceKind": "openapi" }
+  ],
+  "mcpServers": [{ "id": "notion", "name": "Notion" }],
+  "knowledge": { "pages": 12, "truncated": false }
+}
+```
+
+| Key | What it holds |
+|---|---|
+| `$schema` | The JSON Schema for editors. The app does not read it |
+| `format` | Always `engenty-wizard`. It tells a manifest from a bare definition |
+| `version` | The manifest’s version, `1` |
+| `exportedAt` | When the file was made |
+| `definition` | The wizard. See [The wizard format](./index.md) |
+| `connectors` | Imported connectors the wizard’s connections name: `id`, `name`, `domain` and `sourceKind` (`openapi` or `mcp`), at most 50 |
+| `mcpServers` | The space’s connected systems its agent steps name: `id` and `name`, at most 10 |
+| `knowledge` | Only with Knowledge: how many pages, and whether the cap left some out |
+
+`connectors` and `mcpServers` hold names, never addresses, headers or credentials. They let the
+import tell you what the space you import into still needs.
+
+## Knowledge
+
+A website runs a wizard without its space. For that, the share dialog’s website package has
+“Take the knowledge along”. The space’s Knowledge pages then come along as Markdown, one file per
+page, at their path under `files/knowledge/`:
+
+```markdown
+---
+title: "Pricing"
+path: pages/services/pricing
+---
+
+Our hourly rate is …
+```
+
+A page is cut after 60,000 characters. The pages stop at about 2 MB in all, and `truncated` in the
+manifest then says so.
+
+## What stays out
+
+A `.wizard` file holds the wizard, not what it collected or what the space owns:
+
+- runs, results and uploads
+- the rows of its lists and the accounts people connected
+- the space’s brand, facts and Knowledge, unless Knowledge was asked for
+- the addresses and credentials of connectors and connected systems
+- translations and the wizard’s published versions
+
+The studio’s export holds the draft. The website package and the export over the API hold the
+published version.
+
+## Making one by hand
+
+Zip a folder that holds `wizard.json` and `files/`:
+
+```bash
+cd create-an-invoice && zip -r ../create-an-invoice.wizard wizard.json files
+```
+
+The zip may also hold that folder itself, as a zip made in the Finder does. The import takes the
+`wizard.json` closest to the top, and the `files/` beside it. It leaves out folders, `__MACOSX/`
+and `.DS_Store`.
+
+`wizards validate` reads the unpacked folder as it is, without zipping it. See
+[JSON Schema and validation](./validate.md).
+
+## What the import does
+
+The import takes a `.wizard` file, a `wizard.json` on its own, or a definition on its own. A JSON
+file without `"format": "engenty-wizard"` is read as a definition.
+
+1. It checks the zip against the limits before it unpacks anything.
+2. It checks the definition and that every path it names is in the workspace.
+3. It makes a new wizard in the space: a draft, not published, with the workspace’s files.
+4. It tells you which connectors and connected systems the space still lacks.
+
+What belongs to the space is checked only here, because only the space has it: its connectors
+and their actions, its connected systems and its plugins’ tools. A manifest of a newer version
+is refused, with a note that the file comes from a newer version of engenty wizards.

package/apps/runtime/dist/docs/user/build-a-wizard.md

@@ -1,12 +1,12 @@
 ---
 title: Build a wizard
 description: Describe what the wizard should do, or start from a template. Then change it in the chat or step by step.
-version: 0.5.0
+version: 0.8.0
 ---
 
 ## Start one
 
-“New wizard” on the list of your wizards, or in the sidebar, opens the page “What should your
+“New wizard” on the list of your wizards, or in the space’s menu, opens the page “What should your
 wizard do?”. It gives you three ways in:
 
 | Way | How |

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

@@ -1,7 +1,7 @@
 ---
 title: Run a wizard
 description: What you see when you open a wizard's link, on a computer or a phone.
-version: 0.5.0
+version: 0.7.11
 ---
 
 ## From the link to the result
@@ -90,9 +90,26 @@ everything” deletes it. Anything nobody used for 400 days is deleted by itself
 
 ## Share a result
 
-“Share” on the result page makes a link to the result. You can copy it, send it by email or hand
-it to another app. When you ran the wizard over its link, the result and its link are kept for 7
-days. “Withdraw link” ends the link earlier.
+“Share” on the result page opens the ways to pass the result on. “Link” makes a link to the
+result: copy it, send it by email or hand it to another app. When you ran the wizard over its
+link, the result and its link are kept for 7 days. “Withdraw link” ends the link earlier.
+
+The other tiles send or publish the result itself. Each one walks you through its steps: the
+account it sends with (“Account”), what goes along and where it goes (“What & where”), then
+“Send”. What happens shows in the same window, and “Recent” lists what was sent before. An
+account you connect is kept for your next run, encrypted. “What this wizard remembers” lists it.
+
+| Tile | Does | Needs |
+|---|---|---|
+| “Email” | Sends the files you pick as attachments to one or more addresses | Your mailbox: Gmail, Outlook or any mailbox over SMTP. Where the server sends from an address of its own, no account |
+| Google Drive, OneDrive, S3 | Saves the files into a folder, which is created if it doesn’t exist yet | The account |
+| “Slack” | Posts your message with the link to the result in a channel | Your Slack account |
+| A connected service | An AI agent does what you describe in the service, with its actions, and asks before every change | The account, and a few minutes |
+| “Website” | The wizard opens the site in its browser, and an AI agent posts there what you describe. You sign in yourself, and it asks for your leave before anything goes public | A few minutes. LinkedIn, X, Facebook, Instagram and Meta Ads are ready as presets |
+
+Which tiles a result offers is the wizard’s choice, see [The result](./steps.md#the-result).
+Without one, every tile that needs no AI agent is there for everyone with the link. The agent
+tiles are there for the wizard’s owner in the studio, as they spend the wizard’s credits.
 
 Media made by a model carries an “AI-generated” label. Whoever publishes it has to label it as
 AI-generated. The file already carries the marking.

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

@@ -1,29 +1,33 @@
 ---
 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.5.0
+version: 0.8.0
 ---
 
 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.
 
-You open it in two ways:
+The app bar holds its places, below the space’s tile in its corner:
 
-- 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 house opens the space’s wizards: the list and “New wizard”.
+- The layers below it open the space’s page.
+- The tray below them opens the space’s results.
 
-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.
+On a phone the bar floats along the bottom with the house, the layers and “More” (⋯), which
+holds the results, the settings and the rest. The space’s tile and name sit at the top left, your
+picture at the top right.
+
+On the space’s page, the menu on the left shows its three parts. A part opens its own sections,
+and the arrow at the top leads back. On a phone, the parts, a part’s sections and the page take
+turns.
+
+Results have no menu: the list above them picks one wizard or all of them.
 
 | Part | Sections | Used for |
 |---|---|---|
 | Info & brand | Basics, Facts, Logos, Colours, Brand assets | Who you are and how you look |
 | 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
 

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.5.0
+version: 0.7.11
 ---
 
 A wizard runs its steps from top to bottom. The last step is always the result.
@@ -179,6 +179,31 @@ Each entry of the result page names a step and the formats the person can downlo
 | AI step, collected files | ZIP |
 | List | Excel, CSV, JSON, Markdown; ZIP with the files its rows name |
 
+Under “Send & publish” the step says where a person can send or publish the result with one
+button, besides the link and the downloads (see [Share a result](./run.md#share-a-result)). Each
+target is a row with a switch and its state: “Ready”, “AI agent · only you”, or “Not set up”.
+A sentence above the rows says what visitors get and what only you get.
+
+| Label | Means |
+|---|---|
+| “Default” | Every target that is set up and needs no AI agent. Targets with an agent only you get |
+| “Own list” | You switched a target off, prefilled one or added one: only the targets switched on, in this order. An agent target then runs for everyone with the link, on your credits |
+| “Off” | Every target switched off: the result has only the link and the downloads |
+
+“Reset” brings the default back. Targets that are not set up on this server are listed under
+“not set up”, with “Set up” to the connectors.
+
+The arrow on a row opens its form: the name on the result page and what each field starts with.
+“Insert” puts a placeholder where the cursor is: an answer, a written result or the brand name.
+In the wizard file they read `{{email}}`, `{{steps.offer}}` and `{{brand.name}}`.
+
+While the result step is chosen, the studio shows its result page beside the flow, filled from
+the last test run. “Visitor” and “You” switch between what each of them gets. A target opens to
+its form as the visitor sees it, with the test run’s answers in it; nothing is sent from there.
+On a tablet or a phone, “Result page” switches the view, and “See the result page” opens it from
+the step. The result node on the flow shows the targets too: filled for visitors, a ring for
+you only.
+
 ## Branches
 
 A step can send the run somewhere else when a condition holds: a field is or is not a value, is

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

@@ -1,7 +1,7 @@
 ---
 title: Test and share
 description: Try the wizard, publish it, and hand out its link or put it on a website.
-version: 0.5.0
+version: 0.7.11
 ---
 
 ## Test
@@ -216,7 +216,8 @@ On WordPress the plugin writes this code for you, and its results show the page:
 
 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.
+earlier. “Share” also sends the result on – by email, into a cloud folder, to Slack or onto a
+website: see [Share a result](./run.md#share-a-result).
 
 ## Move a wizard
 

package/apps/runtime/dist/documents/parse.js

@@ -2,7 +2,7 @@ import { createHash } from "node:crypto";
 import { existsSync, mkdirSync } from "node:fs";
 import { readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { note } from "@engenty-wizards/shared/run";
+import { note } from "@engenty/wizards-shared/run";
 import { generateText, Output } from "ai";
 import PostalMime from "postal-mime";
 import { z } from "zod";

package/apps/runtime/dist/engine/decide.js

@@ -1,4 +1,4 @@
-import { decisionSchema, readObject, readSystemOne, } from "@engenty-wizards/shared/decision";
+import { decisionSchema, readObject, readSystemOne, } from "@engenty/wizards-shared/decision";
 import { generateText, Output } from "ai";
 import { costOf, systemOneAccess, textModel } from "../models.js";
 export class DecisionError extends Error {

package/apps/runtime/dist/engine/events.js

@@ -1,6 +1,6 @@
 import { AsyncResource } from "node:async_hooks";
 import { EventEmitter } from "node:events";
-import { noteText } from "@engenty-wizards/shared/run";
+import { noteText } from "@engenty/wizards-shared/run";
 import { and, desc, eq, gt, sql } from "drizzle-orm";
 import { db, schema } from "../db/client.js";
 const bus = new EventEmitter();

package/apps/runtime/dist/engine/input.js

@@ -1,6 +1,6 @@
-import { isDecidedField, isLang, isLocationValue, MAX_FILES, offeredSlot, shownFields, } from "@engenty-wizards/shared/definition";
-import { readNumber } from "@engenty-wizards/shared/numbers";
-import { note, saidText } from "@engenty-wizards/shared/run";
+import { isDecidedField, isLang, isLocationValue, MAX_FILES, offeredSlot, shownFields, } from "@engenty/wizards-shared/definition";
+import { readNumber } from "@engenty/wizards-shared/numbers";
+import { note, saidText } from "@engenty/wizards-shared/run";
 /** The field errors in a language, for whoever reads them. */
 export function fieldErrorsIn(errors, lang) {
     return errors.map((e) => ({ field: e.field, message: saidText(e.message, lang) }));

package/apps/runtime/dist/engine/prepare.js

@@ -1,4 +1,4 @@
-import { allFields, isAudioValue } from "@engenty-wizards/shared/definition";
+import { allFields, isAudioValue } from "@engenty/wizards-shared/definition";
 import { extFor, loadAsset } from "../files/storage.js";
 import { listenPieces, transcribeAudio } from "../media/transcribe.js";
 /**

package/apps/runtime/dist/engine/requirements.js

@@ -1,6 +1,6 @@
-import { conditionMatches, conditionsOf, isDecidedField, isDecisionStep, isOtherwise, MODEL_CLASSES, } from "@engenty-wizards/shared/definition";
-import { closedChoicesFor, openValue, otherwiseIndex, unavoidableFrom, unavoidableSteps, } from "@engenty-wizards/shared/fit";
-import { note, saidText } from "@engenty-wizards/shared/run";
+import { conditionMatches, conditionsOf, isDecidedField, isDecisionStep, isOtherwise, MODEL_CLASSES, } from "@engenty/wizards-shared/definition";
+import { closedChoicesFor, openValue, otherwiseIndex, unavoidableFrom, unavoidableSteps, } from "@engenty/wizards-shared/fit";
+import { note, saidText } from "@engenty/wizards-shared/run";
 import { classProblem, filmClient } from "../models.js";
 // The steps every run passes through, and the choices that lead around a missing model, are
 // pure and shared (packages/shared/src/fit.ts): the standalone check uses the same.
@@ -267,16 +267,31 @@ export async function missingModelsSaid(def) {
     }
     return missing;
 }
-/** The message a run that cannot start gives, naming the steps and why. */
+/**
+ * The message a run that cannot start gives, naming the steps and why. Classes with the same
+ * problem (a step that thinks and writes on one client that is not installed) say it once, and
+ * name each of their steps once.
+ */
 export function blockingMessage(missing) {
-    const blocking = missing.filter((m) => m.blocking);
-    if (!blocking.length) {
+    const byProblem = new Map();
+    for (const m of missing) {
+        if (!m.blocking) {
+            continue;
+        }
+        const key = JSON.stringify(m.problem);
+        const entry = byProblem.get(key) ?? { problem: m.problem, steps: new Map() };
+        for (const s of m.steps) {
+            entry.steps.set(s.id, s.title);
+        }
+        byProblem.set(key, entry);
+    }
+    if (!byProblem.size) {
         return null;
     }
-    return blocking
-        .map((m) => note("blockedSteps", {
-        steps: m.steps.map((s) => note("quoted", { text: s.title })),
-        problem: m.problem,
+    return [...byProblem.values()]
+        .map(({ problem, steps }) => note("blockedSteps", {
+        steps: [...steps.values()].map((text) => note("quoted", { text })),
+        problem,
     }))
         .reduce((first, second) => note("joined", { first, second }));
 }

package/apps/runtime/dist/engine/runner.js

@@ -1,9 +1,9 @@
-import { marginOf, } from "@engenty-wizards/shared/decision";
-import { branchValues, cardsFromData, conditionsOf, dataRef, followRules, formatsFor, isDecidedField, LIST_FORMATS, listRef, loopKey, MAX_SHOWN_FIELDS, optionsFromData, otherwiseOf, pageNeeds, textLang, whenHolds, wizardLang, } from "@engenty-wizards/shared/definition";
-import { note, saidText, } from "@engenty-wizards/shared/run";
-import { CONVERSATION_RUNNERS, DEFAULT_RUNNER_SETTINGS } from "@engenty-wizards/shared/runners";
-import { fitData } from "@engenty-wizards/shared/shape";
-import { machineTranslated, translateDefinition } from "@engenty-wizards/shared/translation";
+import { marginOf, } from "@engenty/wizards-shared/decision";
+import { branchValues, cardsFromData, conditionsOf, dataRef, followRules, formatsFor, isDecidedField, LIST_FORMATS, listRef, loopKey, MAX_SHOWN_FIELDS, optionsFromData, otherwiseOf, pageNeeds, textLang, whenHolds, wizardLang, } from "@engenty/wizards-shared/definition";
+import { note, saidText, } from "@engenty/wizards-shared/run";
+import { CONVERSATION_RUNNERS, DEFAULT_RUNNER_SETTINGS } from "@engenty/wizards-shared/runners";
+import { fitData } from "@engenty/wizards-shared/shape";
+import { machineTranslated, translateDefinition } from "@engenty/wizards-shared/translation";
 import { eq } from "drizzle-orm";
 import { nanoid } from "nanoid";
 import { connectionViews } from "../connectors/index.js";
@@ -20,7 +20,8 @@ import { runEnded } from "../plugins/events.js";
 import { projectFiles } from "../services/project-files.js";
 import { projectProfile } from "../services/projects.js";
 import { storedTranslation } from "../services/translations.js";
-import { listRows, scopeOf } from "../store/index.js";
+import { latestShareJob } from "../sharing/state.js";
+import { listRows, listSecrets, scopeOf } from "../store/index.js";
 import { claimRun, disownRuns, heartbeatRuns, indexRun, restRun, waitingRuns, wakeRun, } from "../tenants/control.js";
 import { currentTenant } from "../tenants/tenant.js";
 import { askPerson, clearStaleAsk } from "./asks.js";
@@ -77,7 +78,7 @@ export async function projectIdOf(run) {
     const w = await db.query.wizard.findFirst({ where: eq(schema.wizard.id, run.wizardId) });
     return w?.projectId ?? "";
 }
-async function loadProject(run) {
+export async function loadProject(run) {
     const w = await db.query.wizard.findFirst({ where: eq(schema.wizard.id, run.wizardId) });
     const p = w && (await db.query.project.findFirst({ where: eq(schema.project.id, w.projectId) }));
     if (!p) {
@@ -340,11 +341,15 @@ async function storedLists(run) {
     }
     return out;
 }
-async function makeContext(run, project, state, signal) {
+/**
+ * What a step works with. A share job works with the same — the run's browser, store and
+ * answers — under a step id, progress lines and questions of its own.
+ */
+export async function makeContext(run, project, state, signal, own = {}) {
     const store = scopeOf(run);
     const resources = resourcesFor(run.id);
     resources.bind(store);
-    const stepId = run.cursor ?? "";
+    const stepId = own.stepId ?? run.cursor ?? "";
     return {
         runId: run.id,
         tenantId: run.tenantId,
@@ -365,14 +370,15 @@ async function makeContext(run, project, state, signal) {
         projectFiles: (await projectFiles(project.id)).filter((f) => f.status === "ready"),
         signal,
         resources,
-        ask: (ask) => run.unattended ? Promise.resolve(null) : askPerson(run.id, { ...ask, stepId }, signal),
-        emit: (type, message, asset) => emitEvent(run.id, run.cursor, type, message, asset),
+        ask: own.ask ??
+            ((ask) => run.unattended ? Promise.resolve(null) : askPerson(run.id, { ...ask, stepId }, signal)),
+        emit: own.emit ?? ((type, message, asset) => emitEvent(run.id, run.cursor, type, message, asset)),
         call: { runId: run.id, stepId },
         chargeUsd: (usd) => addLocalCost(run.id, stepId, usd),
         saveAsset: (input) => saveAsset({
             ...input,
             runId: run.id,
-            stepId: input.stepId ?? run.cursor,
+            stepId: input.stepId ?? own.stepId ?? run.cursor,
         }),
     };
 }
@@ -964,8 +970,11 @@ export async function runView(run, brand) {
         connections: step?.type === "page" && step.fields.some((f) => f.kind === "connection")
             ? await connectionViews(def.connections ?? [], scopeOf(run), await projectIdOf(run), textLang(wizardLang(def)))
             : [],
-        keeps: Boolean(def.lists?.length || def.connections?.length),
+        keeps: Boolean(def.lists?.length || def.connections?.length) ||
+            // An account connected for sharing is kept too, and can be deleted the same way.
+            (run.status === "done" && (await listSecrets(scopeOf(run))).length > 0),
         shareUrl: run.shareToken ? `${env.publicUrl}/s/${run.shareToken}` : null,
         expiresAt: run.expiresAt?.toISOString() ?? null,
+        shareJob: run.status === "done" ? await latestShareJob(run.id) : null,
     };
 }

package/apps/runtime/dist/engine/steps.js

@@ -1,9 +1,9 @@
-import { pOf } from "@engenty-wizards/shared/decision";
-import { allFields, dataRef, isDecisionStep, langNameEn, localeOf, stepShape, templateRefs, wizardLang, } from "@engenty-wizards/shared/definition";
-import { mainLogo, ruleLines, runTheme } from "@engenty-wizards/shared/projects";
-import { note as runNote } from "@engenty-wizards/shared/run";
-import { fitData, labelOf, recordsOf, shapeJsonSchema, shapeLines, shapeZod, titleKey, } from "@engenty-wizards/shared/shape";
-import { SURFACE_GUIDE, validateSurface, } from "@engenty-wizards/shared/surface";
+import { pOf } from "@engenty/wizards-shared/decision";
+import { allFields, dataRef, isDecisionStep, langNameEn, localeOf, stepShape, templateRefs, wizardLang, } from "@engenty/wizards-shared/definition";
+import { mainLogo, ruleLines, runTheme } from "@engenty/wizards-shared/projects";
+import { note as runNote } from "@engenty/wizards-shared/run";
+import { fitData, labelOf, recordsOf, shapeJsonSchema, shapeLines, shapeZod, titleKey, } from "@engenty/wizards-shared/shape";
+import { SURFACE_GUIDE, validateSurface, } from "@engenty/wizards-shared/surface";
 import { Agent } from "@mastra/core/agent";
 import { generateText, jsonSchema, Output, parsePartialJson } from "ai";
 import { extFor, loadAsset, loadAssetText } from "../files/storage.js";

package/apps/runtime/dist/engine/surface.js

@@ -1,6 +1,6 @@
-import { assembleSurface, dataRef, listRef, } from "@engenty-wizards/shared/definition";
-import { note } from "@engenty-wizards/shared/run";
-import { validateSurface } from "@engenty-wizards/shared/surface";
+import { assembleSurface, dataRef, listRef, } from "@engenty/wizards-shared/definition";
+import { note } from "@engenty/wizards-shared/run";
+import { validateSurface } from "@engenty/wizards-shared/surface";
 import { decide } from "./decide.js";
 import { answersAsText, resolveRef } from "./template.js";
 import { StepError } from "./types.js";

package/apps/runtime/dist/engine/template.js

@@ -1,7 +1,7 @@
-import { allFields, isAudioValue, isLocationValue, itemsTotals, localeOf, locationText, wizardLang, } from "@engenty-wizards/shared/definition";
-import { formatMoney } from "@engenty-wizards/shared/numbers";
-import { fontLicenseWords, gradientCss, textStyleLine, } from "@engenty-wizards/shared/projects";
-import { listAsMarkdown } from "@engenty-wizards/shared/store";
+import { allFields, isAudioValue, isLocationValue, itemsTotals, localeOf, locationText, wizardLang, } from "@engenty/wizards-shared/definition";
+import { formatMoney } from "@engenty/wizards-shared/numbers";
+import { fontLicenseWords, gradientCss, textStyleLine, } from "@engenty/wizards-shared/projects";
+import { listAsMarkdown } from "@engenty/wizards-shared/store";
 const TEMPLATE_RE = /\{\{\s*([^}]+?)\s*\}\}/g;
 /** Line items as a Markdown table with their totals — what a model needs to write a document. */
 export function itemsAsMarkdown(field, value, values, lang = "en") {

package/apps/runtime/dist/env.js

@@ -212,6 +212,11 @@ export const env = {
         accessKeyId: str("S3_ACCESS_KEY_ID"),
         secretAccessKey: str("S3_SECRET_ACCESS_KEY"),
     },
+    /**
+     * An address of the server's own to send results from: with it, sharing by e-mail needs no
+     * mailbox of the person. `smtps://user:password@host:465`; empty = people send as themselves.
+     */
+    mail: { smtpUrl: str("SMTP_URL"), from: str("MAIL_FROM") },
     turnstile: { siteKey: str("TURNSTILE_SITE_KEY"), secret: str("TURNSTILE_SECRET_KEY") },
     /**
      * The mobile app (the apps repo engenty-wizards-apps, mobile/): a phone opens this runtime's `/w/` and `/s/` links in it.

package/apps/runtime/dist/features.js

@@ -1,6 +1,6 @@
 import { mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
-import { declaredByPlugin, defaultFeatures, FEATURES, featureOn, parseFeatures, resolveFeatures, } from "@engenty-wizards/shared/features";
+import { declaredByPlugin, defaultFeatures, FEATURES, featureOn, parseFeatures, resolveFeatures, } from "@engenty/wizards-shared/features";
 import { accountOverview } from "./auth/account.js";
 import { isCheckout, layout, packageRoot } from "./cli/home.js";
 import { env } from "./env.js";

package/apps/runtime/dist/film/project.js

@@ -2,8 +2,8 @@ import { createHash } from "node:crypto";
 import { existsSync } from "node:fs";
 import { cp, mkdir, readdir, readFile, rm, writeFile } from "node:fs/promises";
 import { dirname, join, normalize } from "node:path";
-import { dataRef, FILM_SIZES } from "@engenty-wizards/shared/definition";
-import { gradientCss, ruleLines, textStyleLine } from "@engenty-wizards/shared/projects";
+import { dataRef, FILM_SIZES } from "@engenty/wizards-shared/definition";
+import { gradientCss, ruleLines, textStyleLine } from "@engenty/wizards-shared/projects";
 import { unzipSync } from "fflate";
 import { logoSectionLine, renderTemplate, resolveRef } from "../engine/template.js";
 import { env } from "../env.js";

package/apps/runtime/dist/film/step.js

@@ -2,8 +2,8 @@ import { spawn } from "node:child_process";
 import { existsSync } from "node:fs";
 import { readFile, rm, stat } from "node:fs/promises";
 import { isAbsolute, join, normalize } from "node:path";
-import { FILM_SIZES } from "@engenty-wizards/shared/definition";
-import { note as runNote } from "@engenty-wizards/shared/run";
+import { FILM_SIZES } from "@engenty/wizards-shared/definition";
+import { note as runNote } from "@engenty/wizards-shared/run";
 import { StepError } from "../engine/types.js";
 import { CLAUDE_BIN, claudeEnv } from "../harness/claude.js";
 import { failureOf } from "../harness/model.js";

package/apps/runtime/dist/harness/antigravity.js

@@ -1,6 +1,6 @@
 import { writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { resolveEnv, run } from "./env.js";
+import { probeVersion, resolveEnv, run } from "./env.js";
 import { failureOf, HarnessModel, runClient, } from "./model.js";
 /**
  * Antigravity CLI: `agy` answers on the Google sign-in it cached — the Google AI subscription,
@@ -114,15 +114,7 @@ export const antigravity = {
     name: "Antigravity",
     bin: AGY_BIN,
     classes: CLASSES,
-    async version(env) {
-        try {
-            const { stdout } = await run(AGY_BIN, ["--version"], { timeout: 10_000, env });
-            return stdout.trim().split("\n").pop()?.trim() || null;
-        }
-        catch {
-            return null;
-        }
-    },
+    version: (env) => probeVersion(AGY_BIN, env, (stdout) => stdout.trim().split("\n").pop()?.trim() || null),
     // No login command: the client asks for the Google sign-in when it starts without one.
     login: { args: [], interactive: true },
     model: (alias, effort) => new AntigravityModel(antigravity, alias || CLASSES.standard, effort),

package/apps/runtime/dist/harness/apple.js

@@ -2,7 +2,7 @@ import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { release } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { langOf, SPEECH_LOCALES } from "@engenty-wizards/shared/definition";
+import { langOf, SPEECH_LOCALES } from "@engenty/wizards-shared/definition";
 import { nanoid } from "nanoid";
 import { env } from "../env.js";
 import { ffmpeg, hasFfmpeg } from "../media/ffmpeg.js";