@engenty/wizards

Licence: FSL-1.1-MIT, source available (LICENSE).

What code outside engenty wizards imports, one subpath per use. The runtime and the studio of engenty wizards are not in it.

Wizards in OpenUI chats

The chat's model decides that a wizard runs and what it already knows. The wizard then runs inside the conversation as its author defined it, drawn by the runner (packages/runner) in the chat's own page.

// The browser
import "@engenty/wizards/openui/styles.css";
import { addWizard, configureWizards, Wizard } from "@engenty/wizards/openui";
import { openuiChatLibrary } from "@openuidev/react-ui/genui-lib";

configureWizards({ runtime: "/wizards-runtime" }); // where the runtime answers
const library = addWizard(openuiChatLibrary, Wizard);

// The server that builds the system prompt
import { addWizard, loadWizards, wizardRules } from "@engenty/wizards/openui/server";

const wizards = await loadWizards("http://localhost:24368", ["<token>"]);
const prompt = addWizard(openuiChatLibrary).prompt({
  ...openuiChatPromptOptions,
  additionalRules: [...(openuiChatPromptOptions.additionalRules ?? []), ...wizardRules(wizards)],
});

What the model writes: Wizard("<token>", "<note>", {plate: "W-12345"}). The prefill starts the page's fields, and the person still sees and sends each page. When the run is done, the component sends a continue_conversation action with the result's texts as its context, and the chat goes on with it. A chat to try it with: examples/openui-chat.

The package

Every release publishes it to npm (scripts/npm-package.mjs, .github/workflows/release.yml). pnpm --filter @engenty/wizards build writes dist/ as it ships (scripts/build.mjs): /openui with the runner and the shared modules it uses bundled in, their types inlined, and the runner's runner.css as styles.css; every other package stays an import, the libraries as dependencies, React, OpenUI, zod and drizzle as peers. Inside this repo everything imports the sources.

Licences

FSL-1.1-MIT, like the repository. dist/openui bundles the runner (packages/runner), which is MIT: its licence ships beside it as dist/openui/LICENSE-MIT.