@engenty/wizards-runtime 0.0.0-stage → 0.7.6

package/node_modules/@engenty-wizards/shared/dist/run.d.ts

@@ -0,0 +1,680 @@
+import { type CardOption, type Format, type Lang, type ModelClass, type Step, type WizardDefinition } from "./definition.js";
+import type { ConnectionView, ListDef, ListRow } from "./store.js";
+import type { Surface } from "./surface.js";
+import { type Gap, type Texts, type TextTable } from "./texts.js";
+export type RunStatus = "waiting_input" | "running" | "done" | "failed" | "cancelled";
+export interface AssetRef {
+    id: string;
+    /** image | video | html | text | json */
+    kind: string;
+    mime: string;
+    name: string;
+    /**
+     * Media a model made ("generated") or changed ("edited"). Shown with a label wherever it is
+     * displayed; the file itself carries the marking in its metadata (EU AI Act, Art. 50).
+     */
+    ai?: "generated" | "edited";
+}
+export interface StepOutput {
+    text?: string;
+    json?: unknown;
+    /** A decision step: how probable each answer is (1 or 0 where a language model answered). */
+    decided?: Record<string, number>;
+    /** A view from the surface catalog and the data it is bound to. */
+    surface?: Surface;
+    assets?: AssetRef[];
+    /**
+     * What the person did in the step's view, kept with the run: a checklist's ticks by component
+     * id, a widget's own state (`wizard.save`).
+     */
+    view?: Record<string, unknown>;
+    /** Widgets: what loading it with this run's data showed. */
+    widget?: {
+        /** Seconds of animation the widget registered for video export; null = a still widget. */
+        duration: number | null;
+        errors: string[];
+    };
+    at: string;
+}
+export interface RunState {
+    values: Record<string, unknown>;
+    outputs: Record<string, StepOutput>;
+    /** Interactive steps answered, oldest first — "back" pops this. */
+    history: string[];
+    /** Regenerate notes per step. */
+    notes: Record<string, string>;
+    /** Steps that make several results: the entries (from 0) to make again; the others stay. */
+    redo?: Record<string, number[]>;
+    /** The step whose `ask` branches are being decided; the run waits on that decision. */
+    deciding?: string;
+    /** What decided `ask` branches answered, by step. */
+    decisions?: Record<string, BranchDecision>;
+    /** Pages whose fields a decision chose: the field ids kept, by page. */
+    pages?: Record<string, {
+        shown: string[];
+    }>;
+    /** How often each branch was taken, by "<step>→<goto>": loops stop at the rule's max. */
+    loops?: Record<string, number>;
+    /** File fields with `listen`: what is said in the recording, piece by piece with its times. */
+    heard?: Record<string, {
+        start: number;
+        end: number;
+        text: string;
+    }[]>;
+    /**
+     * A test run's own copy of the wizard's memory: the pages it wrote, by title. The wizard's
+     * pages stay as they are; the copy goes with the run.
+     */
+    memory?: Record<string, string>;
+    /**
+     * Finished results translated on request, by language and step: the text the person reads in
+     * place of the step's own (`StepOutput.text`); the step's output stays as it was made.
+     */
+    translated?: Record<string, Record<string, string>>;
+}
+/** What a decision over a step's `ask` branches found. */
+export interface BranchDecision {
+    /** The index of the rule in the step's `next`, or null: none of them, go on. */
+    rule: number | null;
+    source: "systemone" | "llm";
+    probabilities?: Record<string, number>;
+    at: string;
+}
+/** A branch decision as the studio sees it: with the step's branches it was made over. */
+export interface ShownDecision extends BranchDecision {
+    over: NonNullable<Step["next"]>;
+}
+interface AskBase {
+    id: string;
+    stepId: string;
+    /** Why the wizard asks, in the person's language. */
+    reason: string;
+    at: string;
+}
+/**
+ * A running step asks the person to sign in on a page the wizard's browser has open. What the
+ * person types goes into that page; the model never sees it.
+ */
+export interface LoginAsk extends AskBase {
+    kind: "login";
+    site: {
+        host: string;
+        title: string;
+    };
+    /** Inputs found on the page, to fill here instead of clicking into the picture. */
+    fields: {
+        id: string;
+        label: string;
+        secret: boolean;
+    }[];
+}
+/** A running step wants to change something in one of the person's accounts and asks first. */
+export interface ConfirmAsk extends AskBase {
+    kind: "confirm";
+    /** The connected service, e.g. "Notion". */
+    service: string;
+    action: {
+        id: string;
+        summary: string;
+        destructive: boolean;
+    };
+    /** What would be sent, as readable JSON. */
+    input: string;
+}
+/** What a running step asks the person; the step waits for the answer. */
+export type RunAsk = LoginAsk | ConfirmAsk;
+/** A question as a step puts it; the runner adds id, step and time. */
+export type AskInput = Omit<LoginAsk, "id" | "stepId" | "at"> | Omit<ConfirmAsk, "id" | "stepId" | "at">;
+/**
+ * `fill` and `done` answer a sign-in (remember = keep the sign-in); `done` also allows a change
+ * (remember = allow that action for the rest of the run); `skip` declines either.
+ */
+export type AskAnswer = {
+    type: "fill";
+    values: Record<string, string>;
+    remember?: boolean;
+} | {
+    type: "done";
+    remember?: boolean;
+} | {
+    type: "skip";
+};
+/** One thing the person does in the wizard's browser while it waits for them. */
+export type BrowserAct = 
+/** Where on the picture, as a share of its width and height (0–1). */
+{
+    type: "click";
+    fx: number;
+    fy: number;
+} | {
+    type: "type";
+    text: string;
+} | {
+    type: "key";
+    key: "Enter" | "Tab" | "Backspace" | "Escape";
+} | {
+    type: "scroll";
+    dy: number;
+};
+/** A stored list the current step shows. */
+export interface ShownList {
+    def: ListDef;
+    rows: ListRow[];
+    formats: Format[];
+    label: string | null;
+}
+/**
+ * What a step reports while it works, in words for each language: the runtime writes the English
+ * line into the run's log, a runner shows it in the language the person reads. The runtime's
+ * answers to the person running a shared wizard (a refusal, a failure) are notes too: it answers
+ * them in the wizard's language.
+ */
+declare const NOTES_EN: {
+    readonly entry: "Entry {n} of {total}";
+    readonly deciding: "Deciding what to do next…";
+    readonly choosingFields: "Choosing the right questions…";
+    readonly batchDone: "{done} of {total} done";
+    readonly editing: "Editing {n} of {total}";
+    readonly filming: "Filming {n} of {total}";
+    readonly clipsRendering: {
+        readonly one: "Rendering {count} clip – this takes a few minutes.";
+        readonly other: "Rendering {count} clips – this takes a few minutes.";
+    };
+    readonly videoRendering: "Rendering the video – this usually takes 1–3 minutes.";
+    readonly photo: "Looking at photo {n} of {total}";
+    readonly found: "{label}: {name}";
+    readonly listen: "Listening to “{label}”…";
+    readonly listenFailed: "“{label}” couldn’t be transcribed.";
+    readonly filmCutting: "Cutting the film – this takes about a minute.";
+    readonly filmProgress: "{pct} % cut";
+    readonly filmError: "The film reports: {detail}";
+    readonly widgetError: "The widget reports an error: {detail}";
+    readonly mcpConnected: "Connected to {names}";
+    readonly mcpUnreachable: "MCP server unreachable: {detail}";
+    readonly reads: "Reading {name}";
+    readonly readsMany: {
+        readonly one: "Reading {count} document";
+        readonly other: "Reading {count} documents";
+    };
+    readonly opens: "Opening {name}";
+    readonly clicks: "Clicking in the browser";
+    readonly clicksOn: "Clicking “{name}”";
+    readonly types: "Typing in the browser";
+    readonly typesText: "Typing “{text}”";
+    readonly selects: "Choosing “{option}”";
+    readonly scrolls: "Scrolling";
+    readonly presses: "Pressing {key}";
+    readonly goesBack: "Going back a page";
+    readonly waitsForPage: "Waiting for the page";
+    readonly fastLoop: "Doing in the browser: {goal}";
+    readonly personDrives: "You’re driving the browser – the wizard waits";
+    readonly agentDrives: "The wizard carries on in the browser";
+    readonly looksAtPage: "Looking at the page";
+    readonly waitsForSignIn: "Waiting for you to sign in to {name}";
+    readonly downloads: "Downloading {name}";
+    readonly runs: "Running: {command}";
+    readonly python: "Running Python";
+    readonly drawing: "Drawing an image";
+    readonly writesPage: "Writing the page “{title}”";
+    readonly searchesDocuments: "Searching the documents: {query}";
+    readonly searchesKnowledge: "Searching knowledge: {query} – {relevant} of {candidates} fit";
+    readonly listsKnowledge: "Listing knowledge";
+    readonly searchesMail: "Searching {label}";
+    readonly savesReceipts: {
+        readonly one: "Saving {count} receipt from {label}";
+        readonly other: "Saving {count} receipts from {label}";
+    };
+    readonly remembers: "Remembering {title}";
+    readonly files: {
+        readonly one: "Filing {count} file";
+        readonly other: "Filing {count} files";
+    };
+    readonly filmSetup: "Setting up the folder for the film";
+    readonly filmClient: "{client} is working on the film – this usually takes 10–40 minutes.";
+    readonly filmTask: "On the film: {task}";
+    readonly filmLooks: "Looking at frames of the film";
+    readonly filmFix: "The film didn’t render – Claude Code is fixing it";
+    readonly filmResume: "Picking the film up where it stopped";
+    readonly wizardUnavailable: "This wizard isn’t available right now.";
+    readonly translationFailed: "This wizard can’t be translated right now. It’s shown as it was written.";
+    readonly translationOff: "This wizard is only offered as it was written.";
+    readonly translationPlaceholder: "The translation of “{text}” needs every placeholder in curly brackets the original has.";
+    readonly wizardLimit: "This wizard has reached its limit for today. Try again tomorrow.";
+    readonly confirmHuman: "Confirm that you’re a person.";
+    readonly tooManyRuns: "You’ve started a lot of runs just now. Try again in an hour.";
+    readonly runOver: "The run is over.";
+    readonly runBusy: "The wizard is working right now.";
+    readonly pageOutdated: "This page is out of date.";
+    readonly noStepBefore: "There is no step before this one.";
+    readonly checkFields: "Check the marked fields.";
+    readonly talkOff: "Live conversations aren’t turned on for this wizard.";
+    readonly talkKeyRefused: "The conversation couldn’t start: the OpenAI API key was refused.";
+    readonly talkFailed: "The conversation couldn’t start ({status}).";
+    readonly talkNoSecret: "The conversation couldn’t start: no access key came back.";
+    readonly tryLater: "Try again later.";
+    readonly recordingTooLarge: "The recording can be 10 MB at most.";
+    readonly fileTooLarge: "Choose a file of {mb} MB or less.";
+    readonly askClosed: "This question is no longer open.";
+    readonly noBrowser: "The wizard has no browser open right now.";
+    readonly notWaiting: "The wizard isn’t waiting for you right now.";
+    readonly pageActFailed: "That didn’t work on the page.";
+    readonly linkGone: "This link has expired or was withdrawn.";
+    readonly connected: "Connected. You can close this window.";
+    readonly connectFailed: "Connecting didn’t work. Try again.";
+    readonly connectCancelled: "Connecting was cancelled.";
+    readonly appleOff: "Apple Intelligence is turned off on this Mac. Turn it on in System Settings → Apple Intelligence & Siri.";
+    readonly appleLoading: "Apple is still loading the model for Apple Intelligence onto this Mac. Try again in a moment.";
+    readonly appleMissing: "The helper for Apple Intelligence (wizards-apple) is missing from this install.";
+    readonly appleOs: "Apple Intelligence needs macOS 26 or later.";
+    readonly appleDevice: "Apple Intelligence only works on a Mac with Apple silicon.";
+    readonly appleBusy: "Apple Intelligence isn’t taking more requests right now. Try again in a moment.";
+    readonly appleTooLong: "The text is too long for Apple Intelligence on this Mac (4,096 tokens for question and answer). Choose another model for this class under Settings → Models.";
+    readonly appleRefused: "Apple Intelligence turned the request down: Apple’s content rules don’t allow it.";
+    readonly appleLanguage: "Apple Intelligence doesn’t understand the language of this request.";
+    readonly appleFormat: "Apple Intelligence can’t answer in this format: {detail}";
+    readonly appleFailed: "Apple Intelligence: {detail}";
+    readonly appleNoFfmpeg: "Apple Intelligence can’t read {type}, and without ffmpeg the recording can’t be converted. Install ffmpeg or record as MP4 in the browser.";
+    readonly appleNotConverted: "Apple Intelligence couldn’t convert the recording: {detail}";
+    readonly connectorAlreadyExistsSpace: "The connector “{id}” already exists in this space.";
+    readonly connectorNotExist: "This connector doesn’t exist.";
+    readonly fieldMissing: "“{label}” is missing.";
+    readonly mailServerNotExist: "The mail server{host} doesn’t exist. Enter the IMAP server. For Gmail and Google Workspace, it’s imap.gmail.com.";
+    readonly mailServerNotResponding: "The mail server{host} isn’t responding. Check the IMAP server and port.";
+    readonly connectingNotWork: "Connecting didn’t work{host}: {detail}";
+    readonly connectEngentyAccountFirst: "Connect your engenty account first (Settings → Account). Then you can connect Google here.";
+    readonly engentyAccountNotReached: "Your engenty account can’t be reached right now. Try again later.";
+    readonly googleNoLongerAccepts: "Google no longer accepts this connection. Connect the account again.";
+    readonly googleNotConnectedThrough: "Google can’t be connected through your engenty account right now.";
+    readonly stepNeedsToolPlugin: "This step needs the tool “{id}”. The plugin “{plugin}” isn’t installed here.";
+    readonly clientNotSignedIn: "{name} isn’t signed in on this computer. Sign in under Settings → Models.";
+    readonly clientNotInstalled: "{name} isn’t installed on this computer. Install it under Settings → Models.";
+    readonly clientNoCredit: "The account {name} is signed in with has no credit or quota left.";
+    readonly clientAccountNotServed: "{name} no longer serves the account it is signed in with. Sign it in with another account, or choose another way under Settings → Models.";
+    readonly anthropicAccountClaudeCode: "The Anthropic account Claude Code is signed in with has no credit. Sign Claude Code in with your subscription under Settings → Models.";
+    readonly chatgptAccountCodexSigned: "The ChatGPT account Codex is signed in with has used up its quota. Try again later or choose another client.";
+    readonly builtTerminalNotAvailable: "The built-in terminal isn’t available on this computer. Run the command in your own terminal.";
+    readonly terminalNoLongerExists: "This terminal no longer exists.";
+    readonly imageTypeNotReadable: "Images of type {mime} can’t be read (PNG, JPEG and WebP work).";
+    readonly fileNotReadable: "“{name}” ({mime}) can’t be read.";
+    readonly creditsNotSignedIn: "This is set to run on credits, but you’re not signed in to an account.";
+    readonly accountNoLongerSigned: "The account is no longer signed in. Sign in again under Settings → Account.";
+    readonly modelNotUsedYet: "The model “{ref}” can’t be used yet. Add an API key under Settings → Models, or sign in to an account.";
+    readonly noModelForImages: "No model is set up for images.";
+    readonly noModelForVideos: "No model is set up for videos.";
+    readonly noModelForSpeech: "No model is set up for speech.";
+    readonly noOpenaiApiKey: "No OpenAI API key is set for voice conversations (Settings → Models).";
+    readonly modelNotAvailableAccount: "This model isn’t available with your account.";
+    readonly accountNoModelSet: "Your account has no model set up for this.";
+    readonly claudeCodeMakesFilms: "Claude Code makes films on this computer, using your subscription. Set it up as an AI subscription under Settings → Models.";
+    readonly macNeedsFfmpegTranscribe: "This Mac needs ffmpeg to transcribe recordings from Chrome or Firefox (WebM, Ogg). Safari and the app don’t. Install ffmpeg, e.g. with “brew install ffmpeg”.";
+    readonly fieldRequired: "Required";
+    readonly chooseAtLeast: "Choose at least {min}";
+    readonly chooseAtMost: "At most {max} – remove some";
+    readonly enterNumber: "Enter a number";
+    readonly invalidChoice: "Invalid choice";
+    readonly timeNotOffered: "This time isn’t offered";
+    readonly notValidEmailAddress: "Not a valid email address";
+    readonly notValidUrl: "Not a valid URL";
+    readonly wizardRunOutCredits: "This wizard has run out of credits for now. Try again later.";
+    readonly providerCreditLow: "Your credit with the model provider isn’t enough for this (videos need a minimum balance there). Top up there and try again.";
+    readonly aiServiceBusyRight: "The AI service is busy right now. Try again in a moment.";
+    readonly stepTookTooLong: "The step took too long. Try again.";
+    readonly aiServiceNotReached: "The AI service can’t be reached right now. Try again later.";
+    readonly notAvailableNow: "That isn’t available here right now.";
+    readonly fileNotFound: "File not found";
+    readonly connectFirst: "Connect first";
+    readonly noEntriesStepWork: "There are no entries for this step to work on.";
+    readonly stepNotReturnResult: "The step didn’t return a result.";
+    readonly documentNotCreated: "The document couldn’t be created.";
+    readonly stepMissingSourcesImages: "This step is missing its sources (images or scenes).";
+    readonly noTextReadAloud: "There is no text to read aloud.";
+    readonly wizardStillErrors: "The wizard still has errors.";
+    readonly noLanguageModelSet: "No language model is set up here.";
+    readonly creditsUsedUp: "Your credits are used up.";
+    readonly chooseFile: "Choose a file.";
+    readonly pageNotReached: "The page can’t be reached.";
+    readonly unknownEntry: "Unknown entry.";
+    readonly chooseWizardFileMb: "Choose a wizard file ({PACKAGE_EXTENSION}) of 30 MB or less.";
+    readonly recordingMbMost: "The recording can be 10 MB at most.";
+    readonly onlyFinishedResultsShared: "Only finished results can be shared.";
+    readonly gradientFailed: "Couldn’t make a gradient from that. Try describing it differently.";
+    readonly onlyOneSpaceAllowed: "Only one space is allowed here.";
+    readonly mostSpaces: {
+        readonly one: "You can have at most {count} space here.";
+        readonly other: "You can have at most {count} spaces here.";
+    };
+    readonly twoEntriesSameKey: "Two entries have the same key.";
+    readonly notDeleteLastSpace: "You can’t delete the last space.";
+    readonly notFound: "This doesn’t exist or was deleted.";
+    readonly categoryNeedsName: "A category needs a name.";
+    readonly unknownCategoryType: "Unknown type “{type}”.";
+    readonly spaceMostCategories: {
+        readonly one: "A space can have at most {count} category.";
+        readonly other: "A space can have at most {count} categories.";
+    };
+    readonly categoryAlreadyExists: "The category “{name}” already exists.";
+    readonly onlyChoiceCategoriesValues: "Only choice categories have values.";
+    readonly onlyValuesOneCategory: "Only values of one category can be merged.";
+    readonly templateNeedsNewerVersion: "This template needs a newer version of engenty wizards. Update engenty wizards first.";
+    readonly chatNotExist: "This chat doesn’t exist.";
+    readonly unknownRunner: "There’s no runner “{unknown}” here.";
+    readonly leastOneRunnerStay: "At least one runner has to stay on.";
+    readonly linkOpenRunnerTurned: "The link has to open a runner that’s turned on.";
+    readonly jobNotExistAlready: "This job doesn’t exist or has already finished.";
+    readonly accountAlreadySpace: "This account already has a space here.";
+    readonly accountAlreadySpaces: {
+        readonly one: "This account already has {count} space here.";
+        readonly other: "This account already has {count} spaces here.";
+    };
+    readonly roomMostPublishedWizards: {
+        readonly one: "There’s room for at most {count} published wizard here.";
+        readonly other: "There’s room for at most {count} published wizards here.";
+    };
+    readonly spaceIdAlreadyExists: "A space with this ID already exists here and didn’t come from your computer.";
+    readonly wizardIdAlreadyBelongs: "A wizard with this ID already belongs to another space here.";
+    readonly idAlreadyUse: "This ID is already in use here.";
+    readonly wizardNotSpace: "This wizard isn’t in the space.";
+    readonly invalidColumns: "Invalid columns.";
+    readonly spaceMostTables: {
+        readonly one: "A space can have at most {count} table.";
+        readonly other: "A space can have at most {count} tables.";
+    };
+    readonly tableBelongsOneWizard: "This table belongs to one of the wizard’s lists. Its columns come from the wizard.";
+    readonly entryAlreadyExists: "This entry already exists.";
+    readonly tableMostRows: {
+        readonly one: "A table can have at most {count} row.";
+        readonly other: "A table can have at most {count} rows.";
+    };
+    readonly spaceMostPages: {
+        readonly one: "A space can have at most {count} page.";
+        readonly other: "A space can have at most {count} pages.";
+    };
+    readonly pageNotSubpages: "This page can’t have subpages.";
+    readonly pageNotOwnSubpage: "A page can’t be its own subpage.";
+    readonly pageNeedsTitle: "A page needs a title.";
+    readonly unknownSpace: "There’s no space “{space}”.";
+    readonly noParentPage: "There’s no page with the key “{parent}” to put this page under.";
+    readonly onlyTeamAdmins: "Only team admins can do that. As a member, you can edit the wizards that already exist.";
+    readonly spaceEditedLocally: "You edit this space in engenty wizards on your computer, not here.";
+    readonly wizardsRunOncePublished: "Wizards run here once you publish them in engenty wizards on your computer. You build and edit them there.";
+    readonly logoImagePngSvg: "A logo is an image (PNG, SVG, JPEG, WebP).";
+    readonly patternImageSvgPng: "A pattern is an image (SVG, PNG, JPEG, WebP).";
+    readonly filesGoHere: "Images, videos, audio, PDFs, fonts, Lottie and 3D models go here. Texts to look things up in go under knowledge.";
+    readonly addressNotReached: "The address can’t be reached.";
+    readonly addressResponded: "The address responded with {status}.";
+    readonly addressLeadsWebPage: "The address leads to a web page, not an image.";
+    readonly addressFileTooLarge: "The file is too large.";
+    readonly onlyDocumentsIndex: "Only documents are in the index.";
+    readonly emptyTooLargeDocument: "“{name}” is empty or too large for a document.";
+    readonly spaceMostDocuments: {
+        readonly one: "A space can have at most {count} document.";
+        readonly other: "A space can have at most {count} documents.";
+    };
+    readonly accountSignedOut: "The account is signed out. Sign in again.";
+    readonly cloudNotReachedRight: "The cloud can’t be reached right now.";
+    readonly publishWizardFirst: "Publish the wizard first.";
+    readonly wizardJsonUnreadable: "This isn’t a wizard file: its wizard.json can’t be read.";
+    readonly wizardFileComesNewer: "This wizard file comes from a newer version, or it’s damaged. Update engenty wizards or export the wizard again.";
+    readonly fileOver5Mb: "{name} is larger than 5 MB.";
+    readonly wizardFileTooLarge: "The wizard file is too large: a workspace holds at most 200 files and 25 MB.";
+    readonly wizardFileNotOpened: "The wizard file can’t be opened. Export the wizard again and try once more.";
+    readonly wizardJsonMissing: "This isn’t a wizard file: wizard.json is missing.";
+    readonly notValidFilePath: "“{name}” isn’t a valid file path.";
+    readonly workspaceWizardFileLarger: "The workspace in the wizard file is larger than 25 MB.";
+    readonly unknownTemplate: "There’s no template “{starterId}”.";
+    readonly wizardChangedMeantime: "The wizard was changed in the meantime.";
+    readonly valueNotExist: "This value doesn’t exist.";
+    readonly nothingFiledUnderValue: "Nothing is filed under this value yet.";
+    readonly filmNotRenderedNeeds: "The film couldn’t be rendered. It needs ffmpeg and a timeline in the widget.";
+    readonly signInRefused: "The sign-in was refused{host}. Are the address and (app) password right? Gmail and Google Workspace need an app password and IMAP turned on.{answer}";
+    readonly serverSaid: " The server said: {answer}";
+    readonly viaAccountFailed: "Connecting through your engenty account didn’t work ({code}).";
+    readonly pluginInvalidInput: "“{id}” got invalid input: {path} – {problem}";
+    readonly filmClientStopped: "{name} stopped working on the film: {detail}. The work is saved. A new try carries on from there.";
+    readonly filmWorkSaved: "{problem} The work is saved. A new try carries on from there.";
+    readonly filmRenderFailed: "The film couldn’t be rendered: {detail}";
+    readonly commandNotStarted: "The command couldn’t start: {detail}";
+    readonly providerKeyMissing: "{provider} is chosen for {makes}, but no API key is set.";
+    readonly noModelFor: "No model is set up for {makes}.";
+    readonly noApiKeyFor: "No API key is set for {provider}.";
+    readonly freeTier: "Your AI Gateway key is on Vercel’s free tier, which doesn’t include {model}. Top up at Vercel ({url}) or choose another model under Settings → Models.";
+    readonly thisModel: "this model";
+    readonly quoted: "“{text}”";
+    readonly viewErrors: "The view has errors: {detail}";
+    readonly blockedSteps: "{steps}: {problem}";
+    readonly joined: "{first} {second}";
+    readonly stepFailed: "This step failed: {detail}";
+    readonly answersMissing: "Answers are missing or don’t fit: {answers}";
+    readonly fieldError: "{field} – {message}";
+    readonly templateNeedsPlugins: {
+        readonly one: "This template needs the plugin {plugins}: included with Pro on engenty.ai.";
+        readonly other: "This template needs the plugins {plugins}: included with Pro on engenty.ai.";
+    };
+    readonly pageMostChars: {
+        readonly one: "A page can have at most {count} character.";
+        readonly other: "A page can have at most {count} characters.";
+    };
+    readonly chooseFileUpTo: "Choose a file of {mb} MB or less.";
+    readonly roomMostFiles: {
+        readonly one: "There’s room for at most {count} file here.";
+        readonly other: "There’s room for at most {count} files here.";
+    };
+    readonly makesText: "text";
+    readonly makesImages: "images";
+    readonly makesVideos: "videos";
+    readonly makesSpeech: "speech";
+    readonly makesVoiceNotes: "voice notes";
+};
+export type RunNoteCode = keyof typeof NOTES_EN;
+export declare const RUN_NOTES: Texts<RunNoteCode>;
+/** What fills a note's gaps: words, numbers, other notes (said in the same language), lists. */
+export type NoteGap = Gap | RunNote | readonly NoteGap[];
+/** A line of `RUN_NOTES` with what goes into its gaps. */
+export interface RunNote {
+    code: RunNoteCode;
+    params?: Record<string, NoteGap | undefined>;
+}
+/** What the person reads: plain words, or a note that has a line for each language. */
+export type Said = string | RunNote;
+/** A note: a line of `RUN_NOTES`, said in whichever language the reader reads. */
+export declare function note(code: RunNoteCode, params?: Record<string, NoteGap | undefined>): RunNote;
+/** What is said, in a language. */
+export declare function saidText(said: Said, lang: Lang): string;
+/**
+ * A note in a language, its gaps filled; English where the language lacks the line. A language
+ * outside `LANGS` reads its lines from `table`, the notes translated on request.
+ */
+export declare function noteText(note: RunNote, lang: string, table?: TextTable): string;
+export interface RunEvent {
+    id: number;
+    at: string;
+    stepId: string | null;
+    type: "step_started" | "step_done" | "tool" | "info" | "error";
+    /** In German, as the run's log keeps it. */
+    message: string;
+    /** The same as a note a runner shows in the person's language; null for free text. */
+    note?: RunNote | null;
+    /** A picture of the run this is about (a photo being looked at, an image just made). */
+    asset?: string | null;
+}
+export interface RunView {
+    id: string;
+    status: RunStatus;
+    mode: "test" | "live";
+    wizard: Pick<WizardDefinition, "title" | "description" | "avatar" | "intro">;
+    /** The language the wizard speaks, by its code: what is read aloud, and in which voice. */
+    lang: string;
+    /**
+     * The run in the viewer's language (a wizard translated on request): every text of the view
+     * is written in it, the choices keep their values and show `labels[value]`. Null: the
+     * wizard's own words.
+     */
+    translation: RunTranslation | null;
+    /** A live conversation can be started on this run: the runtime has a model for it and the wizard has live voice or video on (always in a test). */
+    talk: boolean;
+    /** The step the person is on (interactive) or the one running. */
+    step: Step | null;
+    /** Pages and reviews answered before it, oldest first: what a chat shows above the current step. */
+    answered: Step[];
+    values: Record<string, unknown>;
+    /** What fields of the current page start with, from earlier steps (`prefill`). */
+    prefill: Record<string, unknown>;
+    /** What the `when` of the current page's fields read from before the page, by reference. */
+    known?: Record<string, unknown>;
+    /** Choices of the current page's fields that come from earlier data (`optionsFrom`). */
+    options?: Record<string, string[]>;
+    /** The same choices as cards, for fields that have `cards`. */
+    cards?: Record<string, CardOption[]>;
+    /** The decided fields (`ask`, `group`) of the current page that a decision kept. */
+    decidedFields?: string[];
+    /**
+     * What decided branches answered so far, by step, with the branches decided over (test runs:
+     * the studio shows them while the draft's branches are still those).
+     */
+    decisions?: Record<string, ShownDecision>;
+    /** Choices of the current page that lead to a step without a model here, by field id. */
+    closed: Record<string, ClosedChoice>;
+    outputs: Record<string, StepOutput>;
+    /** Steps whose outputs the current step shows, with their definitions. */
+    shown: {
+        step: Step;
+        output: StepOutput | null;
+        formats: Format[];
+        label: string | null;
+    }[];
+    progress: {
+        done: number;
+        total: number;
+    };
+    canBack: boolean;
+    error: string | null;
+    events: RunEvent[];
+    brand: BrandView;
+    /** What the running step asks the person right now. */
+    ask: RunAsk | null;
+    /** Stored lists the current step shows (a page's list fields, a review, the result). */
+    lists: ShownList[];
+    /** The wizard's connections with what the person has connected. */
+    connections: ConnectionView[];
+    /** The wizard keeps things for the person between runs (lists, files, accounts). */
+    keeps: boolean;
+    /** Set once the result is shared. */
+    shareUrl: string | null;
+    /** When the run and its shared link are deleted; null = kept. */
+    expiresAt: string | null;
+}
+/** How a run in the viewer's language shows. */
+export interface RunTranslation {
+    /** The language, by its code ("fr"): any language, not only one of `LANGS`. */
+    lang: string;
+    /** What a choice shows, by its value. */
+    labels: Record<string, string>;
+    /** A model wrote some of it; false where the author wrote every text by hand. */
+    machine: boolean;
+    /** Results shown in this language, by step (`RunState.translated`). */
+    results: Record<string, string>;
+}
+/** A shared result: what `/s/<token>` shows. Never the person's answers. */
+export interface ShareView {
+    token: string;
+    title: string;
+    message: string | null;
+    wizard: Pick<WizardDefinition, "title" | "description" | "avatar">;
+    brand: BrandView;
+    shown: RunView["shown"];
+    createdAt: string;
+    expiresAt: string | null;
+    /** The wizard's public link, to make your own — when it is published and open. */
+    wizardUrl: string | null;
+}
+export interface BrandView {
+    name: string;
+    accent: string | null;
+    logoUrl: string | null;
+    /** How the pages look: the run page sets its tokens from it. */
+    theme: RunTheme;
+}
+/** How a wizard's pages look, taken from its space's brand (`runTheme`). Null: the runner's own. */
+export interface RunTheme {
+    /** Buttons and marks. */
+    accent: string | null;
+    /** What is there, done or good to know: ticks, tips, group headings. */
+    second: string | null;
+    /** The ground the pages stand on; its hue tints paper and ink. */
+    background: string | null;
+    /** Typefaces as CSS names them. */
+    display: string | null;
+    body: string | null;
+    /** The brand stands on a dark ground. */
+    dark: boolean;
+}
+export interface PublicWizard {
+    token: string;
+    title: string;
+    description: string;
+    avatar: string;
+    intro: string | null;
+    brand: BrandView;
+    turnstileSiteKey: string | null;
+    available: boolean;
+    unavailableReason: string | null;
+    /**
+     * The runners switched on for this wizard, the one its link opens first: what the page offers
+     * beside "Let's go". A page runner has an address; a channel (a number, a bot) has none.
+     */
+    runners: {
+        id: string;
+        label: string;
+        kind: "page" | "channel";
+        url: string | null;
+    }[];
+    /** The language the wizard is written in, by its code: the page opens in it. */
+    lang: string;
+    /** The author offers the wizard in the viewer's language, translated on request. */
+    translatable: boolean;
+    /** The page in the viewer's language, where it was asked for (`?lang=`); null: the original. */
+    translation: Omit<RunTranslation, "results"> | null;
+}
+/** The runner's own words in a language outside `LANGS`: `GET /api/public/texts/:lang`. */
+export interface UiTexts {
+    lang: string;
+    /** The runner's table (`packages/shared/src/runner-texts.ts`). */
+    runner: TextTable;
+    /** The run notes (`RUN_NOTES`). */
+    notes: TextTable;
+}
+/** What a step is expected to cost, in credits. `high` is the 90th percentile once measured. */
+export interface StepEstimate {
+    credits: number;
+    high: number;
+    /** From at least five runs of this version; otherwise from a formula. */
+    measured: boolean;
+}
+/** What a run is expected to cost. `available` is false where no credits are involved. */
+/** A model class a wizard needs that this runtime cannot serve, with the steps that call it. */
+export interface MissingModel {
+    cls: ModelClass;
+    /** Why the class cannot run, as the person reads it. */
+    problem: string;
+    steps: {
+        id: string;
+        title: string;
+    }[];
+    /** A step that needs it lies on every path: the run cannot start. */
+    blocking: boolean;
+}
+/** A page's choice whose values lead to a step this runtime has no model for. */
+export interface ClosedChoice {
+    /** The options (or a toggle's true / false) that lead there; empty = the field as a whole. */
+    values: (string | boolean)[];
+    /** What is missing on the way. */
+    classes: ModelClass[];
+}
+export interface RunEstimate {
+    available: boolean;
+    credits: number;
+    /** Credits held when a run starts. */
+    reserve: number;
+    steps: Record<string, StepEstimate>;
+}
+export {};