@engenty/wizards-runtime 0.7.7 → 0.7.9

package/node_modules/@engenty/wizards/package.json

@@ -6,9 +6,6 @@
   "exports": {
     "./plugin": "./dist/plugin/index.js",
     "./plugin/studio": "./dist/plugin/studio.js",
-    "./plugin/thread": "./dist/plugin/thread.js",
-    "./openui": "./dist/openui/index.js",
-    "./openui/server": "./dist/openui/server.js",
-    "./openui/styles.css": "./src/openui/styles.css"
+    "./plugin/thread": "./dist/plugin/thread.js"
   }
 }

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

@@ -0,0 +1,7 @@
+/**
+ * The Claude Code plugin `wizards` comes from two marketplaces: `engenty`, the GitHub repository
+ * engenty/wizards, and one each deployment serves with its own server bundled. The served one is
+ * named after the deployment's host, so a person can add both: `wizards@engenty` and
+ * `wizards@wizards-example-com`.
+ */
+export declare const marketplaceNameOf: (appUrl: string) => string;

package/node_modules/@engenty-wizards/shared/dist/claude-plugin.js

@@ -0,0 +1,10 @@
+/**
+ * The Claude Code plugin `wizards` comes from two marketplaces: `engenty`, the GitHub repository
+ * engenty/wizards, and one each deployment serves with its own server bundled. The served one is
+ * named after the deployment's host, so a person can add both: `wizards@engenty` and
+ * `wizards@wizards-example-com`.
+ */
+export const marketplaceNameOf = (appUrl) => new URL(appUrl).host
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "");

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

@@ -805,6 +805,7 @@ export declare const filmStepSchema: z.ZodObject<{
         "1:1": "1:1";
         "9:16": "9:16";
     }>>;
+    from: z.ZodOptional<z.ZodString>;
     seconds: z.ZodOptional<z.ZodNumber>;
     model: z.ZodOptional<z.ZodEnum<{
         classifier: "classifier";
@@ -1653,6 +1654,7 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "1:1": "1:1";
         "9:16": "9:16";
     }>>;
+    from: z.ZodOptional<z.ZodString>;
     seconds: z.ZodOptional<z.ZodNumber>;
     model: z.ZodOptional<z.ZodEnum<{
         classifier: "classifier";
@@ -2653,6 +2655,7 @@ export declare const wizardSchema: z.ZodObject<{
             "1:1": "1:1";
             "9:16": "9:16";
         }>>;
+        from: z.ZodOptional<z.ZodString>;
         seconds: z.ZodOptional<z.ZodNumber>;
         model: z.ZodOptional<z.ZodEnum<{
             classifier: "classifier";

package/node_modules/@engenty-wizards/shared/dist/definition.js

@@ -663,6 +663,12 @@ export const filmStepSchema = z.object({
      */
     inputs: z.record(z.string(), z.string()).default({}),
     format: z.enum(FILM_FORMATS).default("16:9"),
+    /**
+     * "steps.<id>" of an earlier film step: this film starts from that one's finished code and
+     * lays it out for its own format — scenes, timing and sound stay. Made from scratch when that
+     * step did not run.
+     */
+    from: z.string().optional(),
     /** About how long the film runs, in seconds. */
     seconds: z.number().int().min(3).max(600).optional(),
     /** The kind of model; default `standard` — the kit carries the craft. */
@@ -1427,6 +1433,15 @@ export function validateWizard(def, files) {
                         });
                     }
                 }
+                if (step.from) {
+                    const id = dataRef(step.from).replace(/^steps\./, "");
+                    if (!seenSteps.has(id) || def.steps.find((s) => s.id === id)?.type !== "film") {
+                        issues.push({
+                            stepId: step.id,
+                            message: `Film from "${step.from}" is not an earlier film step ("steps.<id>").`,
+                        });
+                    }
+                }
                 if (step.kit && !step.kit.endsWith(".zip")) {
                     issues.push({ stepId: step.id, message: `Film kit "${step.kit}" is a .zip.` });
                 }

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

@@ -243,6 +243,8 @@ declare const NOTES_EN: {
     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 clientRefused: "This app may not start runs here.";
+    readonly clientLimit: "This app has started a lot of runs just now. Try again later.";
     readonly runOver: "The run is over.";
     readonly runBusy: "The wizard is working right now.";
     readonly pageOutdated: "This page is out of date.";

package/node_modules/@engenty-wizards/shared/dist/run.js

@@ -76,6 +76,8 @@ const NOTES_EN = {
     wizardLimit: "This wizard has reached its limit for today. Try again tomorrow.",
     confirmHuman: "Confirm that you’re a person.",
     tooManyRuns: "You’ve started a lot of runs just now. Try again in an hour.",
+    clientRefused: "This app may not start runs here.",
+    clientLimit: "This app has started a lot of runs just now. Try again later.",
     runOver: "The run is over.",
     runBusy: "The wizard is working right now.",
     pageOutdated: "This page is out of date.",
@@ -367,6 +369,8 @@ const NOTES_DE = {
     wizardLimit: "Für heute ist das Limit dieses Wizards erreicht. Versuch es morgen wieder.",
     confirmHuman: "Bestätige kurz, dass du ein Mensch bist.",
     tooManyRuns: "Du hast gerade viele Läufe gestartet. Versuch es in einer Stunde wieder.",
+    clientRefused: "Diese App darf hier keine Läufe starten.",
+    clientLimit: "Diese App hat gerade viele Läufe gestartet. Versuch es später wieder.",
     runOver: "Der Lauf ist beendet.",
     runBusy: "Der Wizard arbeitet gerade.",
     pageOutdated: "Diese Seite ist nicht mehr aktuell.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@engenty/wizards-runtime",
-  "version": "0.7.7",
+  "version": "0.7.9",
   "description": "Make a wish. Get your wizard. It guides you step by step. Let AI do the work. Runs on your machine, on the AI subscription you already have. The runtime, which `npx wizards` installs.",
   "license": "FSL-1.1-MIT",
   "homepage": "https://engenty.ai",

package/plugin/.claude-plugin/plugin.json

@@ -1,9 +1,31 @@
 {
-  "name": "engenty-wizards",
+  "name": "wizards",
   "displayName": "engenty wizards",
-  "version": "{{VERSION}}",
-  "description": "Build page-by-page AI wizards that people open on a shared link — designed, tested and published from Claude Code — and run your published ones right in the chat.",
-  "author": { "name": "engenty" },
-  "homepage": "{{APP_URL}}",
-  "keywords": ["wizards", "forms", "ai-workflows", "mcp"]
+  "version": "0.7.9",
+  "description": "Build page-by-page AI wizards that people open on a shared link — designed, tested and published from Claude Code — run your published ones in the chat, and keep them in a pane beside it.",
+  "author": {
+    "name": "engenty"
+  },
+  "homepage": "https://engenty.ai",
+  "keywords": [
+    "wizards",
+    "forms",
+    "ai-workflows",
+    "mcp"
+  ],
+  "types": "./types/index.d.ts",
+  "userConfig": {
+    "server": {
+      "type": "string",
+      "title": "Wizards server",
+      "description": "The MCP server of the wizards runtime, as /mcp lists it. The plugin's own (engenty-wizards) when left as is.",
+      "default": "engenty-wizards"
+    },
+    "browser": {
+      "type": "string",
+      "title": "Browser pane",
+      "description": "The MCP server of the app's browser pane, whose navigate tool opens a wizard beside the chat.",
+      "default": "Claude_Browser"
+    }
+  }
 }

package/plugin/README.md

@@ -0,0 +1,58 @@
+# wizards, the Claude Code plugin
+
+The plugin a running engenty wizards serves at `<APP_URL>/api/claude-plugin/marketplace.json`,
+with its own address filled in. It holds:
+
+- **`/wizard <what it should do>`** builds a wizard from a description, with the `build-wizard`
+  skill: authoring guide, closest starter, issues fixed, one test run, the studio link.
+- **`use-wizard`**, the skill that runs one of your published wizards here in the chat.
+- **`/wizards`**, a pane beside the chat with your wizards: each one's engenty, name and
+  description. **Run** opens the wizard's own page in the app's browser pane, beside the chat,
+  where you fill it as any person would. **Edit** puts a change request into the chat for you to
+  finish. The pane opens by itself when the plugin loads; `/wizards close` closes it. A run the
+  model drives through the server's tools opens its page beside the chat once it waits for you.
+
+The pane is a mod: a hooks module in `hooks/register.tsx` drawing with the engine's elements,
+its state declared in `types/index.d.ts`. `claude plugin validate plugin` checks it,
+`claude plugin test plugin` runs `hooks/pane.test.tsx` against the engine.
+
+## Install
+
+From GitHub, for the `engenty-wizards` MCP server you already have (the local install writes it
+into your AI apps; `claude mcp add --transport http engenty-wizards <APP_URL>/api/mcp` adds a
+hosted one):
+
+```bash
+claude plugin marketplace add engenty/wizards
+claude plugin install wizards@engenty
+```
+
+From a running engenty wizards with a public https address, which bundles its own server:
+
+```bash
+claude plugin marketplace add <APP_URL>/api/claude-plugin/marketplace.json
+claude plugin install wizards@<host-with-dashes>   # wizards.example.com → wizards-example-com
+```
+
+`claude plugin update wizards` brings the next version.
+
+## Permissions in auto mode
+
+The pane calls the server itself, from a button press, not from a model request. In auto mode
+such a call has no classifier verdict and is refused unless an allow rule names the tool. Put
+these in `permissions.allow` of `.claude/settings.local.json` or your user settings:
+
+```json
+["mcp__plugin_wizards_engenty-wizards", "mcp__Claude_Browser__navigate"]
+```
+
+A server you configured yourself under the name `engenty-wizards` is `mcp__engenty-wizards`
+instead. The browser pane's `navigate` may still ask you; the pane then shows a plain link to
+the same page.
+
+## Options
+
+| Option    | Default           | What it names                                              |
+| --------- | ----------------- | ---------------------------------------------------------- |
+| `server`  | `engenty-wizards` | the wizards runtime's MCP server, as `/mcp` lists it        |
+| `browser` | `Claude_Browser`  | the app's browser pane, whose `navigate` opens a page       |

package/plugin/hooks/engenty.ts

@@ -0,0 +1,140 @@
+/**
+ * The flat engenties of the studio (apps/web/src/engenty/engenty.tsx) at rest, as one SVG
+ * string per kind: the same bodies, the one eye, no animation. The fills are the studio's
+ * defaults (ENGENTY_FILL in apps/web/src/engenty/colors.ts).
+ */
+
+const FILL = {
+  cobalt: "oklch(60% 0.23 262)",
+  amber: "oklch(82% 0.17 78)",
+  moss: "oklch(72% 0.22 145)",
+  rose: "oklch(64% 0.25 18)",
+  ember: "oklch(70% 0.21 42)",
+  teal: "oklch(74% 0.16 192)",
+  violet: "oklch(60% 0.25 300)",
+  magenta: "oklch(65% 0.28 345)",
+  citron: "oklch(89% 0.2 118)",
+  slate: "oklch(66% 0.13 235)",
+} as const;
+
+type Eye = { ex: number; ey: number; r: number; ink: string };
+
+type Kind = {
+  fill: string;
+  body: string;
+  eye: Eye;
+  shadow: { cy: number; rx: number };
+  /** Marks drawn before the body (a sprout's leaves). */
+  under?: string;
+  /** Marks drawn over the body, before the eye. */
+  over?: string;
+  /** Marks drawn after the eye (a mouth, a dot). */
+  after?: string;
+};
+
+const stroke = (d: string, color: string, width: number, opacity: number) =>
+  `<path d="${d}" fill="none" stroke="${color}" stroke-width="${width}" stroke-linecap="round" opacity="${opacity}"/>`;
+
+const KINDS: Record<string, Kind> = {
+  round: {
+    fill: FILL.cobalt,
+    body: "M60 22 Q96 26 96 62 Q96 96 60 100 Q24 96 24 62 Q24 26 60 22 Z",
+    over: `<circle cx="97" cy="34" r="6" fill="${FILL.cobalt}" opacity="0.5"/><circle cx="106" cy="24" r="3.5" fill="${FILL.cobalt}" opacity="0.35"/>`,
+    eye: { ex: 68, ey: 58, r: 8, ink: "oklch(18% 0.08 260)" },
+    shadow: { cy: 108, rx: 26 },
+  },
+  drop: {
+    fill: FILL.amber,
+    body: "M60 16 Q90 34 90 66 Q90 96 60 98 Q30 96 30 66 Q30 34 60 16 Z",
+    eye: { ex: 60, ey: 56, r: 8, ink: "oklch(30% 0.10 60)" },
+    after: stroke("M48 76 Q54 72 60 76 Q66 80 72 76", "oklch(30% 0.10 55)", 2.6, 1),
+    shadow: { cy: 106, rx: 24 },
+  },
+  dome: {
+    fill: FILL.moss,
+    body: "M60 20 Q92 30 92 70 Q92 96 60 96 Q28 96 28 70 Q28 30 60 20 Z",
+    over: `${stroke("M46 90 L46 80 M60 92 L60 82 M74 90 L74 80", "oklch(28% 0.10 155)", 2.4, 0.5)}<circle cx="60" cy="6" r="3" fill="${FILL.moss}"/>`,
+    eye: { ex: 60, ey: 54, r: 8.5, ink: "oklch(16% 0.08 160)" },
+    shadow: { cy: 104, rx: 27 },
+  },
+  flame: {
+    fill: FILL.rose,
+    body: "M60 14 Q84 44 80 76 Q78 98 60 98 Q42 98 40 76 Q36 44 60 14 Z",
+    over: stroke("M40 20 Q60 6 80 20", FILL.rose, 3, 0.55),
+    eye: { ex: 60, ey: 62, r: 8, ink: "oklch(22% 0.10 18)" },
+    after: '<circle cx="60" cy="82" r="2.6" fill="oklch(22% 0.10 18)"/>',
+    shadow: { cy: 106, rx: 22 },
+  },
+  oval: {
+    fill: FILL.ember,
+    body: "M60 34 Q100 38 100 64 Q100 92 60 94 Q20 92 20 64 Q20 38 60 34 Z",
+    over:
+      stroke("M28 54 Q60 48 92 54", "oklch(40% 0.16 30)", 2.2, 0.45) +
+      stroke("M26 70 Q60 64 94 70", "oklch(40% 0.16 30)", 2.2, 0.45),
+    eye: { ex: 66, ey: 58, r: 8, ink: "oklch(24% 0.10 30)" },
+    shadow: { cy: 102, rx: 32 },
+  },
+  bean: {
+    fill: FILL.teal,
+    body: "M48 96 Q24 92 26 68 Q28 44 52 38 Q78 32 88 50 Q98 66 84 84 Q70 100 48 96 Z",
+    over: `<circle cx="32" cy="94" r="4" fill="${FILL.teal}" opacity="0.4"/>`,
+    eye: { ex: 70, ey: 58, r: 8, ink: "oklch(18% 0.08 200)" },
+    shadow: { cy: 102, rx: 26 },
+  },
+  pebble: {
+    fill: FILL.slate,
+    body: "M60 96 Q20 96 18 78 Q16 60 46 56 Q78 52 98 62 Q110 72 104 86 Q98 96 60 96 Z",
+    over: '<g fill="oklch(30% 0.05 244)" opacity="0.32"><circle cx="42" cy="76" r="3"/><circle cx="56" cy="86" r="2.2"/><circle cx="86" cy="80" r="2.6"/></g>',
+    eye: { ex: 68, ey: 72, r: 7.5, ink: "oklch(20% 0.06 244)" },
+    shadow: { cy: 102, rx: 34 },
+  },
+  sprout: {
+    fill: FILL.citron,
+    under: `<g fill="${FILL.citron}"><ellipse cx="48" cy="34" rx="6" ry="10"/><ellipse cx="72" cy="32" rx="5.5" ry="9"/></g>`,
+    body: "M60 100 Q28 98 28 72 Q28 46 60 44 Q92 46 92 72 Q92 98 60 100 Z",
+    eye: { ex: 60, ey: 68, r: 8.5, ink: "oklch(24% 0.09 108)" },
+    shadow: { cy: 106, rx: 26 },
+  },
+  tower: {
+    fill: FILL.violet,
+    body: "M60 102 Q36 100 38 78 Q40 58 42 44 Q44 26 60 24 Q76 26 78 44 Q80 58 82 78 Q84 100 60 102 Z",
+    over:
+      stroke("M42 74 Q60 70 78 74", "oklch(28% 0.10 308)", 2.2, 0.4) +
+      stroke("M40 88 Q60 84 80 88", "oklch(28% 0.10 308)", 2.2, 0.4),
+    eye: { ex: 60, ey: 52, r: 8, ink: "oklch(20% 0.09 308)" },
+    shadow: { cy: 108, rx: 20 },
+  },
+  wedge: {
+    fill: FILL.magenta,
+    body: "M60 30 Q74 40 86 70 Q96 92 78 98 Q60 102 42 98 Q24 92 34 70 Q46 40 60 30 Z",
+    over: stroke("M52 22 Q60 14 68 22", FILL.magenta, 3, 0.5),
+    eye: { ex: 60, ey: 70, r: 8, ink: "oklch(22% 0.10 345)" },
+    shadow: { cy: 106, rx: 28 },
+  },
+};
+
+const kindOf = (kind: string | undefined): Kind => KINDS[kind ?? "round"] ?? KINDS.round!;
+
+/** The one eye: white, a pupil, a glint. */
+const eye = ({ ex, ey, r, ink }: Eye) =>
+  `<ellipse cx="${ex}" cy="${ey}" rx="${r}" ry="${r * 1.15}" fill="#fff"/>` +
+  `<circle cx="${ex}" cy="${ey + 1}" r="${r * 0.48}" fill="${ink}"/>` +
+  `<circle cx="${ex - r * 0.25}" cy="${ey - r * 0.3}" r="${r * 0.18}" fill="#fff"/>`;
+
+/** The engenty of a kind at rest, `size` pixels square. */
+export function engentySvg(kind: string | undefined, size: number): string {
+  const k = kindOf(kind);
+  return (
+    `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 120 120" width="${size}" height="${size}" overflow="visible">` +
+    `<ellipse cx="60" cy="${k.shadow.cy}" rx="${k.shadow.rx}" ry="4.5" fill="#000" opacity="0.14"/>` +
+    (k.under ?? "") +
+    `<path d="${k.body}" fill="${k.fill}"/>` +
+    (k.over ?? "") +
+    eye(k.eye) +
+    (k.after ?? "") +
+    "</svg>"
+  );
+}
+
+/** The body colour of a kind, for a surface that draws no SVG. */
+export const engentyColor = (kind: string | undefined) => kindOf(kind).fill;

package/plugin/hooks/hooks.json

@@ -0,0 +1 @@
+{ "modules": ["./register.tsx"] }

package/plugin/hooks/pane.test.tsx

@@ -0,0 +1,177 @@
+import type { McpToolResult } from "claude-code";
+import { expect, test } from "claude-code/testing";
+
+const PANE_PROPS = {
+  title: "engenty.wizards",
+  isFocused: true,
+  bodyColumns: 80,
+  placement: "dock",
+  scroll: { offset: 0, bodyRows: 40 },
+  view: {},
+} as const;
+
+const answer = (value: unknown): McpToolResult => ({
+  content: [{ type: "text", text: JSON.stringify(value) }],
+  isError: false,
+});
+
+const BASE = "http://localhost:24368";
+
+const wizard = (id: string, title: string, published: boolean, shared = published) => ({
+  wizardId: id,
+  draft: {
+    title,
+    description: `${title} macht etwas.`,
+    avatar: "round",
+    steps: [
+      { id: "first", type: "page", title: "Thema" },
+      { id: "write", type: "result", title: "Fertig" },
+    ],
+  },
+  shareEnabled: shared,
+  shareUrl: `${BASE}/w/t-${id}`,
+  studioUrl: `${BASE}/studio/edit/${id}`,
+});
+
+const waiting = {
+  runId: "r1",
+  wizardId: "w2",
+  mode: "live",
+  status: "waiting_input",
+  waitingFor: { page: "first", title: "Thema", fields: [] },
+  browserUrl: `${BASE}/w/t-w2/r1`,
+};
+
+test("lists the wizards; Run opens the page beside the chat, Edit asks the chat", async ($, on) => {
+  const calls: string[] = [];
+  const opened: string[] = [];
+  const filled: string[] = [];
+  on("prompt.fill", async (_, e) => {
+    filled.push(e.text);
+    return { isFilled: true };
+  });
+  on("mcp.call", { server: "engenty-wizards" }, async (_, e) => {
+    calls.push(e.tool);
+    if (e.tool === "list_wizards") {
+      return {
+        value: answer([
+          { id: "w1", title: "Brot", published: true, studioUrl: `${BASE}/studio/edit/w1` },
+          { id: "w2", title: "Ohne Link", published: true, studioUrl: `${BASE}/studio/edit/w2` },
+          { id: "w0", title: "Entwurf", published: false, studioUrl: `${BASE}/studio/edit/w0` },
+        ]),
+      };
+    }
+    if (e.tool === "get_wizard") {
+      const id = String(e.args.wizardId);
+      if (id === "w1") return { value: answer(wizard("w1", "Brot", true)) };
+      if (id === "w2") return { value: answer(wizard("w2", "Ohne Link", true, false)) };
+      return { value: answer(wizard("w0", "Entwurf", false)) };
+    }
+    if (e.tool === "run_wizard") return { value: answer(waiting) };
+    return { deny: `unexpected ${e.tool}` };
+  });
+  on("mcp.call", { server: "Claude_Browser" }, async (_, e) => {
+    opened.push(String(e.args.url));
+    return { value: { content: [], isError: false } };
+  });
+
+  for (const surface of ["terminal", "desktop"] as const) {
+    calls.length = 0;
+    opened.length = 0;
+    const ui = await $.ui.mount({
+      plugin: "wizards",
+      surface,
+      component: "Pane",
+      requestId: "wizards",
+      props: PANE_PROPS,
+    });
+    await ui.press({ key: "Reload" });
+    // Details are fetched once per wizard; the second surface finds them in the session's state.
+    expect(calls).toEqual(
+      surface === "terminal"
+        ? ["list_wizards", "get_wizard", "get_wizard", "get_wizard"]
+        : ["list_wizards"],
+    );
+    expect(await ui.find({ type: "Text", text: "Brot" })).toBeDefined();
+    expect(await ui.find({ type: "Text", text: /Entwurf · draft/ })).toBeDefined();
+    expect(await ui.find({ key: "run:w1" })).toBeDefined();
+    expect(await ui.find({ key: "run:w0" })).toBeUndefined();
+    expect(await ui.find({ key: "edit:w0" })).toBeDefined();
+    expect(await ui.find({ type: "Text", text: "localhost:24368" })).toBeDefined();
+
+    // A wizard with a page of its own opens there.
+    await ui.press({ key: "run:w1" });
+    expect(opened).toEqual([`${BASE}/w/t-w1`]);
+    // One without is started here, and its run's page opens.
+    await ui.press({ key: "run:w2" });
+    expect(calls.at(-1)).toBe("run_wizard");
+    expect(opened.at(-1)).toBe(`${BASE}/w/t-w2/r1`);
+
+    await ui.press({ key: "edit:w0" });
+    expect(filled.at(-1)).toBe('For my engenty wizard "Entwurf" I need the following changes: ');
+    await ui.press({ key: "Studio" });
+    expect(opened.at(-1)).toBe(`${BASE}/studio`);
+    await ui.unmount();
+  }
+});
+
+test("a run the model drives opens beside the chat once", async ($, on) => {
+  const opened: string[] = [];
+  on("mcp.call", { server: "Claude_Browser" }, async (_, e) => {
+    opened.push(String(e.args.url));
+    return { value: { content: [], isError: false } };
+  });
+  on("mcp.call", { server: "engenty-wizards" }, () => ({ deny: "not in this test" }));
+  on("tool.call", { tool: "mcp__engenty-wizards__get_run" }, async () => ({
+    result: { content: [{ type: "text", text: JSON.stringify(waiting) }] },
+  }));
+
+  const ui = await $.ui.mount({
+    plugin: "wizards",
+    surface: "desktop",
+    component: "Pane",
+    requestId: "wizards",
+    props: PANE_PROPS,
+  });
+  await $.tool.call({ tool: "mcp__engenty-wizards__get_run", tool_use_id: "t1", runId: "r1" });
+  await $.tool.call({ tool: "mcp__engenty-wizards__get_run", tool_use_id: "t2", runId: "r1" });
+  expect(opened).toEqual([`${BASE}/w/t-w2/r1`]);
+  await ui.unmount();
+});
+
+test("offers a plain link when the browser pane refuses", async ($, on) => {
+  on("mcp.call", { server: "engenty-wizards" }, async (_, e) => {
+    if (e.tool === "list_wizards") {
+      return { value: answer([{ id: "w1", title: "Brot", published: true }]) };
+    }
+    if (e.tool === "get_wizard") return { value: answer(wizard("w1", "Brot", true)) };
+    return { deny: `unexpected ${e.tool}` };
+  });
+  on("mcp.call", { server: "Claude_Browser" }, () => ({ deny: "no verdict for navigate" }));
+  const ui = await $.ui.mount({
+    plugin: "wizards",
+    surface: "desktop",
+    component: "Pane",
+    requestId: "wizards",
+    props: PANE_PROPS,
+  });
+  await ui.press({ key: "Reload" });
+  await ui.press({ key: "run:w1" });
+  expect(await ui.find({ type: "Text", text: /did not open/ })).toBeDefined();
+  expect((await ui.find({ type: "Link" }))?.props.href).toBe(`${BASE}/w/t-w1`);
+  await ui.unmount();
+});
+
+test("says why when the runtime cannot be reached", async ($, on) => {
+  on("mcp.call", { server: "engenty-wizards" }, () => ({ deny: "ECONNREFUSED" }));
+  const ui = await $.ui.mount({
+    plugin: "wizards",
+    surface: "terminal",
+    component: "Pane",
+    requestId: "wizards",
+    props: PANE_PROPS,
+  });
+  await ui.press({ key: "Reload" });
+  expect(await ui.find({ type: "Text", text: /ECONNREFUSED/ })).toBeDefined();
+  await ui.unmount();
+});