@jokerized/decksmith 0.9.4 → 0.9.5

package/dist/cli.js

@@ -13788,9 +13788,9 @@ function number(flag, value) {
 
 // src/plan/arc.ts
 var ARC_ROLES = ["intro", "background", "limitations", "conclusion"];
-function requiredRoles(beatCount) {
-  if (beatCount >= 8) return ARC_ROLES;
-  if (beatCount >= 5) return ["limitations", "conclusion"];
+function requiredRoles(beatCount2) {
+  if (beatCount2 >= 8) return ARC_ROLES;
+  if (beatCount2 >= 5) return ["limitations", "conclusion"];
   return [];
 }
 function paperArcRequested(prefs) {
@@ -14043,7 +14043,8 @@ DRAWING ARCHETYPES \u2014 reach here first
                  repeat. Leave it off only when the figure's whole layout is the
                  argument.
 
-  grid           A cols\xD7rows lattice with up to four regions lit in turn. The
+  grid           A cols\xD7rows lattice (cols 2\u201324, rows 1\u201316) with one to four
+                 regions lit in turn \u2014 never a fifth. The
                  tell: A FIELD WITH NO ORDER \u2014 patches, windows, tokens, tiles,
                  receptive fields, masks, strides, a neighbourhood, a block-sparse
                  pattern. Regions are cell coordinates, so the lattice IS the
@@ -14935,6 +14936,10 @@ function stripNulls(node) {
 var PLANNER_INVISIBLE = /* @__PURE__ */ new Set(["tilt"]);
 function plannerInvisible(prefs) {
   const hidden = new Set(PLANNER_INVISIBLE);
+  if (prefs.images && !prefs.images.enabled) {
+    hidden.add("illustration");
+    hidden.add("backdrop");
+  }
   if (!paperArcRequested(prefs)) hidden.add("role");
   if (!bespokeFor(prefs, designFor(prefs))) hidden.add("bespoke");
   return hidden;
@@ -14966,7 +14971,7 @@ function schemaFor(prefs) {
     plannerInvisible(prefs)
   );
 }
-var SCHEMA = schemaFor({ genre: "general" });
+var SCHEMA = schemaFor(prefsSchema.parse({}));
 async function codexPlanner(source, opts = {}) {
   const prefs = opts.prefs ?? prefsSchema.parse({});
   const dir = await mkdtemp(join6(tmpdir(), "decksmith-plan-"));
@@ -14986,14 +14991,29 @@ async function codexPlanner(source, opts = {}) {
       return readPlan(outPath, source, prefs);
     };
     const prompt = buildPrompt(source, prefs);
-    const first = await ask(prompt);
-    const broken = varietyFindings(first, prefs.images, prefs.design);
-    if (broken.length === 0) return first;
+    let first;
+    let firstJson;
+    let broken;
+    try {
+      first = await ask(prompt);
+      firstJson = first;
+      broken = varietyFindings(first, prefs.images, prefs.design);
+    } catch (err) {
+      if (!(err instanceof PlanRejected)) throw err;
+      firstJson = err.plan;
+      broken = err.problems;
+    }
+    if (first && broken.length === 0) return first;
     opts.onRepair?.(broken);
-    const second = await ask(repairPrompt(prompt, first, broken));
+    const second = await ask(repairPrompt(prompt, firstJson, broken, prefs.images.enabled)).catch(
+      (err) => {
+        throw err instanceof PlanRejected ? new Error(`Codex's plan is still refused after one repair. ${err.message}`) : err;
+      }
+    );
+    const firstBeats = beatCount(firstJson);
     const still = [
-      ...second.beats.length < first.beats.length ? [
-        `the repair returned ${second.beats.length} beats for a plan of ${first.beats.length}; a repair changes shapes and may not drop beats.`
+      ...second.beats.length < firstBeats ? [
+        `the repair returned ${second.beats.length} beats for a plan of ${firstBeats}; a repair changes shapes and may not drop beats.`
       ] : [],
       ...varietyFindings(second, prefs.images, prefs.design)
     ];
@@ -15008,21 +15028,32 @@ ${still.map((m) => `  ${m}`).join("\n")}`
     await rm2(dir, { recursive: true, force: true });
   }
 }
-function repairPrompt(prompt, plan, broken) {
+function repairPrompt(prompt, plan, broken, images) {
+  const moves = images ? "change archetypes, add stage beats with illustration briefs, give diagram beats a backdrop brief, redraw a panel as a hero-number or a kinetic claim where its point is a number or a claim," : "change archetypes, redraw a panel as a hero-number or a kinetic claim where its point is a number or a claim, cite only ids the source lists,";
   return `${prompt}
 
-YOUR PREVIOUS STORYBOARD, BELOW, BREAKS THE VARIETY RULES:
+YOUR PREVIOUS STORYBOARD, BELOW, IS REFUSED FOR:
 ${broken.map((m) => `  - ${m}`).join("\n")}
 
-Return the whole storyboard again with these fixed. Keep every beat whose shape
-is not named above as it is; change archetypes, add stage beats with
-illustration briefs, give diagram beats a backdrop brief, redraw a panel as a
-hero-number or a kinetic claim where its point is a number or a claim, or
-reorder neighbours only as far as the fix needs. Never
-drop or merge beats: a repair with fewer beats than the plan below is refused.
+Return the whole storyboard again with these fixed. Keep every beat that is not
+named above as it is; ${moves} or reorder neighbours only as far as the fix
+needs. Never drop or merge beats: a repair with fewer beats than the plan below
+is refused.
 
 ${JSON.stringify(plan)}`;
 }
+function beatCount(plan) {
+  const beats = plan?.beats;
+  return Array.isArray(beats) ? beats.length : 0;
+}
+var PlanRejected = class extends Error {
+  constructor(message2, problems, plan) {
+    super(message2);
+    this.problems = problems;
+    this.plan = plan;
+    this.name = "PlanRejected";
+  }
+};
 async function readPlan(outPath, source, prefs) {
   const raw2 = await readFile7(outPath, "utf8").catch(() => "");
   if (raw2.trim() === "") {
@@ -15037,22 +15068,41 @@ async function readPlan(outPath, source, prefs) {
 ${raw2.slice(0, 200)}`
     );
   }
-  const result = storyboardSchema.safeParse(stripNulls(parsed));
+  const plan = stripNulls(parsed);
+  const result = storyboardSchema.safeParse(plan);
   if (!result.success) {
-    const issues = result.error.issues.map((i) => `  ${i.path.join(".") || "(root)"}: ${i.message}`).join("\n");
-    throw new Error(`Codex returned a storyboard that does not validate:
-${issues}`);
+    const issues = result.error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`);
+    throw new PlanRejected(
+      `Codex returned a storyboard that does not validate:
+${issues.map((i) => `  ${i}`).join("\n")}`,
+      issues,
+      plan
+    );
   }
   if (!prefs.images.enabled) {
     const pending = pendingIllustrations(result.data);
     if (pending.length) {
       const beats = [...new Set(pending.map((p) => p.beatId))].join(", ");
-      throw new Error(
-        `Codex asked for ${pending.length} illustration${pending.length === 1 ? "" : "s"} (${beats}) with images off. Pass --images to let the plan request pictures, or re-run without it.`
+      const msg = `Codex asked for ${pending.length} illustration${pending.length === 1 ? "" : "s"} (${beats}) with images off. Pass --images to let the plan request pictures, or re-run without it.`;
+      throw new PlanRejected(
+        msg,
+        [
+          `${beats} asked for a picture with images off: remove every illustration and backdrop brief`
+        ],
+        plan
       );
     }
   }
-  assertRefsResolve(result.data, source, { pending: prefs.images.enabled ? "allow" : "refuse" });
+  try {
+    assertRefsResolve(result.data, source, { pending: prefs.images.enabled ? "allow" : "refuse" });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new PlanRejected(
+      msg,
+      msg.split("\n").map((l) => l.trim()).filter(Boolean),
+      plan
+    );
+  }
   return result.data;
 }
 function buildPrompt(source, prefs) {
@@ -27501,7 +27551,10 @@ program.command("ingest").description("Parse a document or a web page into sourc
 imageFlags(
   lookFlags(
     planFlags(
-      lengthFlags(program.command("plan")).description("Ask Codex for a storyboard. Read and edit the result before building.").argument("<source>", "source.json from ingest").requiredOption("-o, --out <file>", "where to write storyboard.json").option("--bespoke", "let the planner mark the beats a generated scene should draw")
+      lengthFlags(program.command("plan")).description("Ask Codex for a storyboard. Read and edit the result before building.").argument("<source>", "source.json from ingest").requiredOption("-o, --out <file>", "where to write storyboard.json").option("--bespoke", "let the planner mark the beats a generated scene should draw").option(
+        "--no-bespoke",
+        "v2: plan for a build run with --no-bespoke (no bespoke hints in the prompt or schema)"
+      )
     )
   )
 ).action(async (src, o) => {
@@ -27513,7 +27566,7 @@ imageFlags(
   const planned = await codexPlanner(source, {
     prefs,
     onRepair: (broken) => {
-      step("plan: the first plan broke the variety rule, asking Codex to repair it \u2014");
+      step("plan: the first plan was refused, asking Codex to repair it \u2014");
       for (const m of broken) step(`plan:   ${m}`);
     }
   });

package/dist/index.js

@@ -16720,9 +16720,9 @@ ${issues}`);
 
 // src/plan/arc.ts
 var ARC_ROLES = ["intro", "background", "limitations", "conclusion"];
-function requiredRoles(beatCount) {
-  if (beatCount >= 8) return ARC_ROLES;
-  if (beatCount >= 5) return ["limitations", "conclusion"];
+function requiredRoles(beatCount2) {
+  if (beatCount2 >= 8) return ARC_ROLES;
+  if (beatCount2 >= 5) return ["limitations", "conclusion"];
   return [];
 }
 function paperArcRequested(prefs) {
@@ -16975,7 +16975,8 @@ DRAWING ARCHETYPES \u2014 reach here first
                  repeat. Leave it off only when the figure's whole layout is the
                  argument.
 
-  grid           A cols\xD7rows lattice with up to four regions lit in turn. The
+  grid           A cols\xD7rows lattice (cols 2\u201324, rows 1\u201316) with one to four
+                 regions lit in turn \u2014 never a fifth. The
                  tell: A FIELD WITH NO ORDER \u2014 patches, windows, tokens, tiles,
                  receptive fields, masks, strides, a neighbourhood, a block-sparse
                  pattern. Regions are cell coordinates, so the lattice IS the
@@ -17867,6 +17868,10 @@ function stripNulls(node) {
 var PLANNER_INVISIBLE = /* @__PURE__ */ new Set(["tilt"]);
 function plannerInvisible(prefs) {
   const hidden = new Set(PLANNER_INVISIBLE);
+  if (prefs.images && !prefs.images.enabled) {
+    hidden.add("illustration");
+    hidden.add("backdrop");
+  }
   if (!paperArcRequested(prefs)) hidden.add("role");
   if (!bespokeFor(prefs, designFor(prefs))) hidden.add("bespoke");
   return hidden;
@@ -17898,7 +17903,7 @@ function schemaFor(prefs) {
     plannerInvisible(prefs)
   );
 }
-var SCHEMA = schemaFor({ genre: "general" });
+var SCHEMA = schemaFor(prefsSchema.parse({}));
 async function codexPlanner(source, opts = {}) {
   const prefs = opts.prefs ?? prefsSchema.parse({});
   const dir = await mkdtemp(join10(tmpdir(), "decksmith-plan-"));
@@ -17918,14 +17923,29 @@ async function codexPlanner(source, opts = {}) {
       return readPlan(outPath, source, prefs);
     };
     const prompt = buildPrompt(source, prefs);
-    const first = await ask(prompt);
-    const broken = varietyFindings(first, prefs.images, prefs.design);
-    if (broken.length === 0) return first;
+    let first;
+    let firstJson;
+    let broken;
+    try {
+      first = await ask(prompt);
+      firstJson = first;
+      broken = varietyFindings(first, prefs.images, prefs.design);
+    } catch (err) {
+      if (!(err instanceof PlanRejected)) throw err;
+      firstJson = err.plan;
+      broken = err.problems;
+    }
+    if (first && broken.length === 0) return first;
     opts.onRepair?.(broken);
-    const second = await ask(repairPrompt(prompt, first, broken));
+    const second = await ask(repairPrompt(prompt, firstJson, broken, prefs.images.enabled)).catch(
+      (err) => {
+        throw err instanceof PlanRejected ? new Error(`Codex's plan is still refused after one repair. ${err.message}`) : err;
+      }
+    );
+    const firstBeats = beatCount(firstJson);
     const still = [
-      ...second.beats.length < first.beats.length ? [
-        `the repair returned ${second.beats.length} beats for a plan of ${first.beats.length}; a repair changes shapes and may not drop beats.`
+      ...second.beats.length < firstBeats ? [
+        `the repair returned ${second.beats.length} beats for a plan of ${firstBeats}; a repair changes shapes and may not drop beats.`
       ] : [],
       ...varietyFindings(second, prefs.images, prefs.design)
     ];
@@ -17940,21 +17960,32 @@ ${still.map((m) => `  ${m}`).join("\n")}`
     await rm4(dir, { recursive: true, force: true });
   }
 }
-function repairPrompt(prompt, plan, broken) {
+function repairPrompt(prompt, plan, broken, images) {
+  const moves = images ? "change archetypes, add stage beats with illustration briefs, give diagram beats a backdrop brief, redraw a panel as a hero-number or a kinetic claim where its point is a number or a claim," : "change archetypes, redraw a panel as a hero-number or a kinetic claim where its point is a number or a claim, cite only ids the source lists,";
   return `${prompt}
 
-YOUR PREVIOUS STORYBOARD, BELOW, BREAKS THE VARIETY RULES:
+YOUR PREVIOUS STORYBOARD, BELOW, IS REFUSED FOR:
 ${broken.map((m) => `  - ${m}`).join("\n")}
 
-Return the whole storyboard again with these fixed. Keep every beat whose shape
-is not named above as it is; change archetypes, add stage beats with
-illustration briefs, give diagram beats a backdrop brief, redraw a panel as a
-hero-number or a kinetic claim where its point is a number or a claim, or
-reorder neighbours only as far as the fix needs. Never
-drop or merge beats: a repair with fewer beats than the plan below is refused.
+Return the whole storyboard again with these fixed. Keep every beat that is not
+named above as it is; ${moves} or reorder neighbours only as far as the fix
+needs. Never drop or merge beats: a repair with fewer beats than the plan below
+is refused.
 
 ${JSON.stringify(plan)}`;
 }
+function beatCount(plan) {
+  const beats = plan?.beats;
+  return Array.isArray(beats) ? beats.length : 0;
+}
+var PlanRejected = class extends Error {
+  constructor(message2, problems, plan) {
+    super(message2);
+    this.problems = problems;
+    this.plan = plan;
+    this.name = "PlanRejected";
+  }
+};
 async function readPlan(outPath, source, prefs) {
   const raw2 = await readFile12(outPath, "utf8").catch(() => "");
   if (raw2.trim() === "") {
@@ -17969,22 +18000,41 @@ async function readPlan(outPath, source, prefs) {
 ${raw2.slice(0, 200)}`
     );
   }
-  const result = storyboardSchema.safeParse(stripNulls(parsed));
+  const plan = stripNulls(parsed);
+  const result = storyboardSchema.safeParse(plan);
   if (!result.success) {
-    const issues = result.error.issues.map((i) => `  ${i.path.join(".") || "(root)"}: ${i.message}`).join("\n");
-    throw new Error(`Codex returned a storyboard that does not validate:
-${issues}`);
+    const issues = result.error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`);
+    throw new PlanRejected(
+      `Codex returned a storyboard that does not validate:
+${issues.map((i) => `  ${i}`).join("\n")}`,
+      issues,
+      plan
+    );
   }
   if (!prefs.images.enabled) {
     const pending = pendingIllustrations(result.data);
     if (pending.length) {
       const beats = [...new Set(pending.map((p) => p.beatId))].join(", ");
-      throw new Error(
-        `Codex asked for ${pending.length} illustration${pending.length === 1 ? "" : "s"} (${beats}) with images off. Pass --images to let the plan request pictures, or re-run without it.`
+      const msg = `Codex asked for ${pending.length} illustration${pending.length === 1 ? "" : "s"} (${beats}) with images off. Pass --images to let the plan request pictures, or re-run without it.`;
+      throw new PlanRejected(
+        msg,
+        [
+          `${beats} asked for a picture with images off: remove every illustration and backdrop brief`
+        ],
+        plan
       );
     }
   }
-  assertRefsResolve(result.data, source, { pending: prefs.images.enabled ? "allow" : "refuse" });
+  try {
+    assertRefsResolve(result.data, source, { pending: prefs.images.enabled ? "allow" : "refuse" });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new PlanRejected(
+      msg,
+      msg.split("\n").map((l) => l.trim()).filter(Boolean),
+      plan
+    );
+  }
   return result.data;
 }
 function buildPrompt(source, prefs) {

package/dist/mcp.js

@@ -15277,9 +15277,9 @@ function bespokeFor(prefs, design2) {
 
 // src/plan/arc.ts
 var ARC_ROLES = ["intro", "background", "limitations", "conclusion"];
-function requiredRoles(beatCount) {
-  if (beatCount >= 8) return ARC_ROLES;
-  if (beatCount >= 5) return ["limitations", "conclusion"];
+function requiredRoles(beatCount2) {
+  if (beatCount2 >= 8) return ARC_ROLES;
+  if (beatCount2 >= 5) return ["limitations", "conclusion"];
   return [];
 }
 function paperArcRequested(prefs) {
@@ -15473,7 +15473,8 @@ DRAWING ARCHETYPES \u2014 reach here first
                  repeat. Leave it off only when the figure's whole layout is the
                  argument.
 
-  grid           A cols\xD7rows lattice with up to four regions lit in turn. The
+  grid           A cols\xD7rows lattice (cols 2\u201324, rows 1\u201316) with one to four
+                 regions lit in turn \u2014 never a fifth. The
                  tell: A FIELD WITH NO ORDER \u2014 patches, windows, tokens, tiles,
                  receptive fields, masks, strides, a neighbourhood, a block-sparse
                  pattern. Regions are cell coordinates, so the lattice IS the
@@ -16323,6 +16324,10 @@ function stripNulls(node) {
 var PLANNER_INVISIBLE = /* @__PURE__ */ new Set(["tilt"]);
 function plannerInvisible(prefs) {
   const hidden = new Set(PLANNER_INVISIBLE);
+  if (prefs.images && !prefs.images.enabled) {
+    hidden.add("illustration");
+    hidden.add("backdrop");
+  }
   if (!paperArcRequested(prefs)) hidden.add("role");
   if (!bespokeFor(prefs, designFor(prefs))) hidden.add("bespoke");
   return hidden;
@@ -16354,7 +16359,7 @@ function schemaFor(prefs) {
     plannerInvisible(prefs)
   );
 }
-var SCHEMA = schemaFor({ genre: "general" });
+var SCHEMA = schemaFor(prefsSchema.parse({}));
 async function codexPlanner(source, opts = {}) {
   const prefs = opts.prefs ?? prefsSchema.parse({});
   const dir = await mkdtemp(join9(tmpdir2(), "decksmith-plan-"));
@@ -16374,14 +16379,29 @@ async function codexPlanner(source, opts = {}) {
       return readPlan(outPath, source, prefs);
     };
     const prompt = buildPrompt(source, prefs);
-    const first = await ask(prompt);
-    const broken = varietyFindings(first, prefs.images, prefs.design);
-    if (broken.length === 0) return first;
+    let first;
+    let firstJson;
+    let broken;
+    try {
+      first = await ask(prompt);
+      firstJson = first;
+      broken = varietyFindings(first, prefs.images, prefs.design);
+    } catch (err) {
+      if (!(err instanceof PlanRejected)) throw err;
+      firstJson = err.plan;
+      broken = err.problems;
+    }
+    if (first && broken.length === 0) return first;
     opts.onRepair?.(broken);
-    const second = await ask(repairPrompt(prompt, first, broken));
+    const second = await ask(repairPrompt(prompt, firstJson, broken, prefs.images.enabled)).catch(
+      (err) => {
+        throw err instanceof PlanRejected ? new Error(`Codex's plan is still refused after one repair. ${err.message}`) : err;
+      }
+    );
+    const firstBeats = beatCount(firstJson);
     const still = [
-      ...second.beats.length < first.beats.length ? [
-        `the repair returned ${second.beats.length} beats for a plan of ${first.beats.length}; a repair changes shapes and may not drop beats.`
+      ...second.beats.length < firstBeats ? [
+        `the repair returned ${second.beats.length} beats for a plan of ${firstBeats}; a repair changes shapes and may not drop beats.`
       ] : [],
       ...varietyFindings(second, prefs.images, prefs.design)
     ];
@@ -16396,21 +16416,32 @@ ${still.map((m) => `  ${m}`).join("\n")}`
     await rm4(dir, { recursive: true, force: true });
   }
 }
-function repairPrompt(prompt, plan, broken) {
+function repairPrompt(prompt, plan, broken, images) {
+  const moves = images ? "change archetypes, add stage beats with illustration briefs, give diagram beats a backdrop brief, redraw a panel as a hero-number or a kinetic claim where its point is a number or a claim," : "change archetypes, redraw a panel as a hero-number or a kinetic claim where its point is a number or a claim, cite only ids the source lists,";
   return `${prompt}
 
-YOUR PREVIOUS STORYBOARD, BELOW, BREAKS THE VARIETY RULES:
+YOUR PREVIOUS STORYBOARD, BELOW, IS REFUSED FOR:
 ${broken.map((m) => `  - ${m}`).join("\n")}
 
-Return the whole storyboard again with these fixed. Keep every beat whose shape
-is not named above as it is; change archetypes, add stage beats with
-illustration briefs, give diagram beats a backdrop brief, redraw a panel as a
-hero-number or a kinetic claim where its point is a number or a claim, or
-reorder neighbours only as far as the fix needs. Never
-drop or merge beats: a repair with fewer beats than the plan below is refused.
+Return the whole storyboard again with these fixed. Keep every beat that is not
+named above as it is; ${moves} or reorder neighbours only as far as the fix
+needs. Never drop or merge beats: a repair with fewer beats than the plan below
+is refused.
 
 ${JSON.stringify(plan)}`;
 }
+function beatCount(plan) {
+  const beats = plan?.beats;
+  return Array.isArray(beats) ? beats.length : 0;
+}
+var PlanRejected = class extends Error {
+  constructor(message2, problems, plan) {
+    super(message2);
+    this.problems = problems;
+    this.plan = plan;
+    this.name = "PlanRejected";
+  }
+};
 async function readPlan(outPath, source, prefs) {
   const raw2 = await readFile9(outPath, "utf8").catch(() => "");
   if (raw2.trim() === "") {
@@ -16425,22 +16456,41 @@ async function readPlan(outPath, source, prefs) {
 ${raw2.slice(0, 200)}`
     );
   }
-  const result = storyboardSchema.safeParse(stripNulls(parsed));
+  const plan = stripNulls(parsed);
+  const result = storyboardSchema.safeParse(plan);
   if (!result.success) {
-    const issues = result.error.issues.map((i) => `  ${i.path.join(".") || "(root)"}: ${i.message}`).join("\n");
-    throw new Error(`Codex returned a storyboard that does not validate:
-${issues}`);
+    const issues = result.error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`);
+    throw new PlanRejected(
+      `Codex returned a storyboard that does not validate:
+${issues.map((i) => `  ${i}`).join("\n")}`,
+      issues,
+      plan
+    );
   }
   if (!prefs.images.enabled) {
     const pending = pendingIllustrations(result.data);
     if (pending.length) {
       const beats = [...new Set(pending.map((p) => p.beatId))].join(", ");
-      throw new Error(
-        `Codex asked for ${pending.length} illustration${pending.length === 1 ? "" : "s"} (${beats}) with images off. Pass --images to let the plan request pictures, or re-run without it.`
+      const msg = `Codex asked for ${pending.length} illustration${pending.length === 1 ? "" : "s"} (${beats}) with images off. Pass --images to let the plan request pictures, or re-run without it.`;
+      throw new PlanRejected(
+        msg,
+        [
+          `${beats} asked for a picture with images off: remove every illustration and backdrop brief`
+        ],
+        plan
       );
     }
   }
-  assertRefsResolve(result.data, source, { pending: prefs.images.enabled ? "allow" : "refuse" });
+  try {
+    assertRefsResolve(result.data, source, { pending: prefs.images.enabled ? "allow" : "refuse" });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new PlanRejected(
+      msg,
+      msg.split("\n").map((l) => l.trim()).filter(Boolean),
+      plan
+    );
+  }
   return result.data;
 }
 function buildPrompt(source, prefs) {

package/dist/types/plan/codex.d.ts

@@ -1,10 +1,12 @@
 import { type Prefs } from "../prefs.js";
 import { type Source, type Storyboard } from "../types.js";
 /** The schema for one run. `role` is present only when the paper arc was asked for. */
-export declare function schemaFor(prefs: Pick<Prefs, "genre" | "bespoke" | "design">): unknown;
+export declare function schemaFor(prefs: Pick<Prefs, "genre" | "bespoke" | "design"> & {
+    images?: Prefs["images"];
+}): unknown;
 /**
- * The default-preferences schema, unchanged and still exported: `general` hides
- * `role`, so these bytes are what they have always been.
+ * The default-preferences schema, still exported: `general` hides `role`, and
+ * images default off, so it hides the picture briefs too (0.9.5).
  */
 export declare const SCHEMA: unknown;
 export interface CodexOptions {
@@ -47,6 +49,16 @@ export interface RunnerArgs {
 /** What the planner needs from the outside world: a prompt in, a final message out. */
 export type Runner = (args: RunnerArgs) => Promise<void>;
 export declare function codexPlanner(source: Source, opts?: CodexOptions): Promise<Storyboard>;
+/**
+ * A plan Codex answered that this source cannot build — out of the schema's
+ * bounds, a picture brief with images off, an id the source lacks — with what
+ * is wrong and the JSON it came as, for the one repair round.
+ */
+export declare class PlanRejected extends Error {
+    readonly problems: string[];
+    readonly plan: unknown;
+    constructor(message: string, problems: string[], plan: unknown);
+}
 /**
  * The `codex` command line for a run, and the environment it needs.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jokerized/decksmith",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Turn a source document into an animated explanation deck.",
   "type": "module",
   "license": "MIT",