@mccaskie-labs/workbench-config 0.2.2 → 0.2.4

package/capabilities/pdf.json

@@ -7,13 +7,14 @@
   "status": "built",
   "delivery": {
     "choice": "optional",
-    "intro": "PDFs such as invoices and receipts, printed with the project's logo and colours.",
-    "when": "The client wants a PDF: an invoice, receipt, quote, certificate, report or anything else to download or print."
+    "intro": "PDFs such as invoices and receipts, printed with the project's logo and colours."
   },
   "surfaces": {
     "package": [
       "createPdfMaker",
-      "WorkbenchPdfError"
+      "WorkbenchPdfError",
+      "checkLayout",
+      "fillLayout"
     ]
   },
   "limits": [
@@ -95,6 +96,89 @@
       "note": "Prints the app's own HTML holding an image from a host not in allowOrigins; the PDF is made and the browser reports that image's request as blocked"
     }
   ],
+  "offer": {
+    "pattern": "drafts",
+    "when": "The client wants a PDF: an invoice, receipt, quote, certificate, report or anything else to download or print.",
+    "say": "I'll make this with Workbench PDFs, printed with your logo and colours. I'll show you a few layouts to pick from. The one you pick is saved, so every one looks the same from then on.",
+    "answers_file": "workbench/pdf/<name>.json",
+    "per": "document",
+    "generator": "npx workbench-pdf generate",
+    "answers_format": "the saved layout. `npx workbench-pdf pick <name> <round>-<draft>` writes it from the draft the client picked, with the draft's request id, model and cost; never write one from nothing. It holds the document's `fields` (each value is text the app formats first, money and dates through the country pack), its `blocks` with `{field}` placeholders, and made-up `sample` values. To change a saved layout in the client's words (move a block, rename a heading, add a field), edit the file and run the generator, which refuses a layout that doesn't check. In the app, print with `pdfMakerFor(env).document(PDF_LAYOUTS.<name>.document(data), { size: PDF_LAYOUTS.<name>.size })`. Drafts and their previews stay in `workbench/pdf/drafts/`, which isn't committed.",
+    "questions": [
+      {
+        "id": "pdf.what",
+        "sets": [
+          "layout.name",
+          "layout.about"
+        ],
+        "ask": "What is this document, and what is it for?",
+        "style": "cards",
+        "answers": [
+          {
+            "label": "An invoice",
+            "value": "invoice",
+            "means": "What a customer owes, with the items and the total."
+          },
+          {
+            "label": "A receipt",
+            "value": "receipt",
+            "means": "Proof a customer paid."
+          },
+          {
+            "label": "A quote",
+            "value": "quote",
+            "means": "What a job would cost, before the customer agrees."
+          }
+        ],
+        "other": {
+          "kind": "text",
+          "min": 3,
+          "max": 200,
+          "description": "What the document is, in a few words: a certificate, a run sheet, a booking confirmation."
+        },
+        "note": "The answer's value is the layout's name (lower case and underscores: run_sheet). The client's own words, with anything they add about who reads it, go in --about.",
+        "must_ask": true
+      },
+      {
+        "id": "pdf.size",
+        "sets": "layout.size",
+        "ask": "Which paper size?",
+        "style": "cards",
+        "answers": [
+          {
+            "label": "A4",
+            "value": "A4",
+            "means": "Used almost everywhere outside North America."
+          },
+          {
+            "label": "US Letter",
+            "value": "Letter",
+            "means": "Used in the United States and Canada."
+          }
+        ],
+        "note": "Recommend US Letter only when the readers are in the United States or Canada. Pass it to the drafts command as --size."
+      }
+    ],
+    "not_asked": [
+      {
+        "sets": "layout.colours",
+        "why": "The logo, colours and fonts come from the brand (brand.json and the admins' brand page), so every document matches the rest of the app. To restyle a part of the layout, use project.css (see Restyling)."
+      },
+      {
+        "sets": "layout.contents",
+        "why": "The drafts propose what each layout shows. The client changes a picked layout in plain words, and you edit the saved file."
+      }
+    ],
+    "drafts": {
+      "of": "layouts for this document",
+      "surface": "ai",
+      "alias": "claude-default",
+      "count": 3,
+      "max_rounds": 3,
+      "job": "pdf.drafts",
+      "command": "npx workbench-pdf drafts <name> --about \"<what it is for, in the client's words>\" --size <A4 or Letter>"
+    }
+  },
   "styles": {
     "prefix": "wb-pdf-"
   }

package/dist/capabilities.gen.d.ts

@@ -1,4 +1,4 @@
-export declare const MANIFEST_VERSION: "cfe1c836b884";
+export declare const MANIFEST_VERSION: "15786d683e1e";
 export declare const capabilities: {
     readonly ai: {
         readonly $schema: "./schema.json";
@@ -194,10 +194,152 @@ export declare const capabilities: {
             readonly expect: "pass";
             readonly cost_hint_usd: 0.008;
         }];
+        readonly offer: {
+            readonly pattern: "feature_or_content";
+            readonly when: "The client wants the app to write, summarise, sort, answer questions or pull details out of text with AI, as a feature visitors use, or wants wording for the site written once.";
+            readonly say: "I'll do this with Workbench AI, which uses Claude through Workbench, so the app holds no AI key and spending has a monthly cap.";
+            readonly answers_file: "workbench/ai/<name>.json";
+            readonly per: "feature or piece of wording";
+            readonly answers_format: "For a feature: `{ \"format\": 1, \"route\": \"feature\", \"name\", \"about\" (the client's words), \"who\", \"cap_usd\", \"keep\", \"job\" }`, where `job` is the `X-Workbench-Job` the feature's calls send (`<name>` with dots, such as `quotes.estimate`), so its spending shows on its own line in Control. Write it, then build the feature with the package. For wording made once: `npx workbench-ai pick <name> <round>-<draft>` writes it from the draft the client picked, with the round's request ids and cost; never write one from nothing. Then put the wording into the strings catalogue (the workbench-strings skill), keyed for where it is shown. Drafts and their previews stay in `workbench/ai/drafts/`, which isn't committed.";
+            readonly questions: readonly [{
+                readonly id: "ai.route";
+                readonly sets: "route";
+                readonly ask: "Is this something visitors use on the site, or something made once for the site?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Visitors use it";
+                    readonly value: "feature";
+                    readonly means: "A feature on the site that calls the AI each time someone uses it, such as a question box or a summary of what they paste in.";
+                }, {
+                    readonly label: "Made once for the site";
+                    readonly value: "content";
+                    readonly means: "Wording for a page, written once and kept: an About page, a welcome, product descriptions.";
+                }];
+                readonly must_ask: true;
+                readonly note: "Ask it even when the client's words seem to say, as a quick check: the two routes are built and paid for differently.";
+            }, {
+                readonly id: "ai.who";
+                readonly sets: "feature.who";
+                readonly ask: "Who may use it?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "People who are signed in";
+                    readonly value: "signed_in";
+                    readonly means: "Anyone with an account. Each use is tied to a person, so misuse can be traced and stopped.";
+                }, {
+                    readonly label: "Admins only";
+                    readonly value: "admins";
+                    readonly means: "Only the business's own admins, for example a tool for writing their own posts.";
+                }, {
+                    readonly label: "Anyone visiting";
+                    readonly value: "anyone";
+                    readonly means: "No sign-in. The page checks for bots (Turnstile) and limits how often one visitor can use it.";
+                }];
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["feature"];
+                };
+                readonly note: "Signed in means `requireUser` and admins means `app_admins`, as the workbench-sign-in skill says. For anyone, check Turnstile on every use and keep a per-visitor limit; say plainly that strangers can run up the cost. Pass `subject` on every call so the Gateway can tell people apart: `user:<id>` for a signed-in person, and for anyone a random id kept in a cookie (`visitor:<id>`), never an email address or name.";
+            }, {
+                readonly id: "ai.cap";
+                readonly sets: "feature.cap_usd";
+                readonly ask: "How much may it spend in a month, at most? When it's reached, the feature stops until next month.";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "US$5 a month";
+                    readonly value: 5;
+                    readonly means: "A small trial, or light use.";
+                }, {
+                    readonly label: "US$20 a month";
+                    readonly value: 20;
+                    readonly means: "Steady use by a small business's visitors.";
+                }, {
+                    readonly label: "US$50 a month";
+                    readonly value: 50;
+                    readonly means: "Heavy use. It can be raised later.";
+                }];
+                readonly other: {
+                    readonly kind: "money";
+                    readonly min: 1;
+                    readonly max: 1000;
+                    readonly description: "US dollars a month, whole or with cents.";
+                };
+                readonly must_ask: true;
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["feature"];
+                };
+                readonly note: "Say roughly what one use costs (usually a cent or two with claude-default) so the owner can judge. The cap is the project's production cap for the `ai` tool in the Gateway, shared by every feature that uses it: set it with Workbench Control's `gw_budget_set` (env production, tool ai, monthly_usd). Raising a cap waits for the owner's approval on Control's approval page. When it is reached, calls fail with `budget_exceeded`: the page says the feature is resting until next month, never an error.";
+            }, {
+                readonly id: "ai.sensitive";
+                readonly sets: "feature.keep";
+                readonly ask: "Will people type in sensitive personal details, such as their health, religion, money troubles or someone else's private information?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "No";
+                    readonly value: "no";
+                    readonly means: "Workbench keeps what each call sent and got back, so a problem can be traced.";
+                }, {
+                    readonly label: "Yes";
+                    readonly value: "yes";
+                    readonly means: "This feature's calls are marked not to be kept: Workbench records only that each call happened and what it cost.";
+                }];
+                readonly must_ask: true;
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["feature"];
+                };
+                readonly note: "With yes, pass `keep: false` on this feature's calls. If most of the app handles such details, suggest switching keeping off for the whole project instead (Workbench Control's `gw_keep_set`, env production, on false). Record it as `keep` (true or false) in the answers file.";
+            }, {
+                readonly id: "ai.what";
+                readonly sets: readonly ["content.name", "content.about"];
+                readonly ask: "What wording do you need?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "A page's main text";
+                    readonly value: "page_text";
+                    readonly means: "Such as an About page or a services page.";
+                }, {
+                    readonly label: "A short blurb";
+                    readonly value: "blurb";
+                    readonly means: "A line or two for the top of a page or a card.";
+                }, {
+                    readonly label: "Descriptions";
+                    readonly value: "descriptions";
+                    readonly means: "For products or services.";
+                }];
+                readonly other: {
+                    readonly kind: "text";
+                    readonly min: 3;
+                    readonly max: 200;
+                    readonly description: "What the wording is, in a few words.";
+                };
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["content"];
+                };
+                readonly note: "Name the piece after where it goes (about_us, home_blurb): lower case and underscores. The client's own words, with any facts they give (when they started, where they are), go in --about, because the drafts never invent facts and leave [gaps] for the owner instead.";
+            }];
+            readonly not_asked: readonly [{
+                readonly sets: "model";
+                readonly why: "Features use claude-default unless the work needs more (claude-best) or speed matters more than depth (claude-fast). Choose from what the feature does; the client can't judge models.";
+            }, {
+                readonly sets: "voice";
+                readonly why: "The tone comes from the project's voice and spelling, set once for the whole site.";
+            }];
+            readonly drafts: {
+                readonly of: "wording";
+                readonly surface: "ai";
+                readonly alias: "claude-default";
+                readonly count: 3;
+                readonly max_rounds: 3;
+                readonly job: "ai.drafts";
+                readonly command: "npx workbench-ai drafts text <name> --about \"<what it is for, with the client's facts>\"";
+            };
+        };
         readonly delivery: {
             readonly choice: "built_in";
             readonly intro: "Writing, summarising and answering questions with Claude, with a monthly spending cap.";
-            readonly when: "The client wants the app to write, summarise, sort, answer questions or pull details out of text with AI, as a feature visitors use or as something made once for the site.";
         };
     };
     readonly analytics: {
@@ -1643,10 +1785,132 @@ export declare const capabilities: {
             readonly smoke: true;
             readonly cost_hint_usd: 0.001;
         }];
+        readonly offer: {
+            readonly pattern: "feature_or_content";
+            readonly when: "The client wants to find existing pictures on the web, for the site itself or as a search visitors use.";
+            readonly say: "I'll do this with Workbench picture search, which searches the web through Workbench, so the app holds no search key and spending has a monthly cap.";
+            readonly answers_file: "workbench/image-search/<name>.json";
+            readonly per: "feature or picture";
+            readonly answers_format: "For a feature: `{ \"format\": 1, \"route\": \"feature\", \"name\", \"about\" (the client's words), \"who\", \"cap_usd\", \"job\" }`, where `job` is the `X-Workbench-Job` the feature's calls send (`<name>` with dots, such as `quotes.estimate`), so its spending shows on its own line in Control. Write it, then build the feature with the package. For a picture found once: `npx workbench-ai pick <name> <round>-<draft> --licence \"<the owner's words>\"` downloads it to `public/images/<name>.jpg` (or .png) and writes the answers file with where it came from and the licence; never write one from nothing, and never pick one without the licence answer. Show the credit the licence asks for beside the picture. Drafts and their previews stay in `workbench/image-search/drafts/`, which isn't committed.";
+            readonly questions: readonly [{
+                readonly id: "image-search.route";
+                readonly sets: "route";
+                readonly ask: "Is this something visitors use on the site, or something made once for the site?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Visitors use it";
+                    readonly value: "feature";
+                    readonly means: "A search on the site that finds pictures for whoever uses it.";
+                }, {
+                    readonly label: "Made once for the site";
+                    readonly value: "content";
+                    readonly means: "A picture for the site, found once and kept.";
+                }];
+                readonly must_ask: true;
+                readonly note: "Ask it even when the client's words seem to say, as a quick check: the two routes are built and paid for differently.";
+            }, {
+                readonly id: "image-search.who";
+                readonly sets: "feature.who";
+                readonly ask: "Who may use it?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "People who are signed in";
+                    readonly value: "signed_in";
+                    readonly means: "Anyone with an account. Each use is tied to a person, so misuse can be traced and stopped.";
+                }, {
+                    readonly label: "Admins only";
+                    readonly value: "admins";
+                    readonly means: "Only the business's own admins, for example a tool for writing their own posts.";
+                }, {
+                    readonly label: "Anyone visiting";
+                    readonly value: "anyone";
+                    readonly means: "No sign-in. The page checks for bots (Turnstile) and limits how often one visitor can use it.";
+                }];
+                readonly when: {
+                    readonly id: "image-search.route";
+                    readonly is: readonly ["feature"];
+                };
+                readonly note: "Signed in means `requireUser` and admins means `app_admins`, as the workbench-sign-in skill says. For anyone, check Turnstile on every use and keep a per-visitor limit; say plainly that strangers can run up the cost. Pass `subject` on every call so the Gateway can tell people apart: `user:<id>` for a signed-in person, and for anyone a random id kept in a cookie (`visitor:<id>`), never an email address or name.";
+            }, {
+                readonly id: "image-search.cap";
+                readonly sets: "feature.cap_usd";
+                readonly ask: "How much may it spend in a month, at most? When it's reached, the feature stops until next month.";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "US$5 a month";
+                    readonly value: 5;
+                    readonly means: "A small trial, or light use.";
+                }, {
+                    readonly label: "US$20 a month";
+                    readonly value: 20;
+                    readonly means: "Steady use by a small business's visitors.";
+                }, {
+                    readonly label: "US$50 a month";
+                    readonly value: 50;
+                    readonly means: "Heavy use. It can be raised later.";
+                }];
+                readonly other: {
+                    readonly kind: "money";
+                    readonly min: 1;
+                    readonly max: 1000;
+                    readonly description: "US dollars a month, whole or with cents.";
+                };
+                readonly must_ask: true;
+                readonly when: {
+                    readonly id: "image-search.route";
+                    readonly is: readonly ["feature"];
+                };
+                readonly note: "Say roughly what one use costs (about a tenth of a cent a search) so the owner can judge. The cap is the project's production cap for the `search` tool in the Gateway, shared by every feature that uses it: set it with Workbench Control's `gw_budget_set` (env production, tool search, monthly_usd). Raising a cap waits for the owner's approval on Control's approval page. When it is reached, calls fail with `budget_exceeded`: the page says the feature is resting until next month, never an error.";
+            }, {
+                readonly id: "image-search.licence";
+                readonly sets: "content.licence";
+                readonly ask: "Does the site have the right to use this picture?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Yes, it's ours";
+                    readonly value: "own";
+                    readonly means: "The business took it or owns it.";
+                }, {
+                    readonly label: "Yes, it's free to use";
+                    readonly value: "free";
+                    readonly means: "Its page says so, with a licence such as CC BY. Say which.";
+                }, {
+                    readonly label: "No, find another";
+                    readonly value: "none";
+                    readonly means: "Pick another result, or make one with AI pictures instead.";
+                }];
+                readonly other: {
+                    readonly kind: "text";
+                    readonly min: 3;
+                    readonly max: 200;
+                    readonly description: "What gives the site the right to use it.";
+                };
+                readonly must_ask: true;
+                readonly when: {
+                    readonly id: "image-search.route";
+                    readonly is: readonly ["content"];
+                };
+                readonly note: "Ask after the client picks a result, showing its page link. A search result is a lead, not permission. Pass the client's words as --licence; with no, don't pick it.";
+            }];
+            readonly not_asked: readonly [{
+                readonly sets: "query";
+                readonly why: "The client's description is the search: pass it as --about, shortened to the words that matter.";
+            }, {
+                readonly sets: "filters";
+                readonly why: "Results narrower than 600 pixels are dropped; anything finer (shape, site) is for a feature to do in its own code.";
+            }];
+            readonly drafts: {
+                readonly of: "found pictures";
+                readonly surface: "image-search";
+                readonly count: 4;
+                readonly max_rounds: 3;
+                readonly job: "image-search.drafts";
+                readonly command: "npx workbench-ai drafts search <name> --about \"<what to search for>\"";
+            };
+        };
         readonly delivery: {
             readonly choice: "built_in";
             readonly intro: "Finding existing pictures on the web.";
-            readonly when: "The client wants to find existing pictures on the web, for the site itself or as a search visitors use.";
         };
     };
     readonly images: {
@@ -1800,10 +2064,159 @@ export declare const capabilities: {
             readonly refusal: "invalid_request";
             readonly cost_hint_usd: 0;
         }];
+        readonly offer: {
+            readonly pattern: "feature_or_content";
+            readonly when: "The client wants a picture made by AI, such as an illustration, a hero image or a product mock-up, as a feature visitors use or once for the site.";
+            readonly say: "I'll make this with Workbench pictures, made by AI through Workbench, so the app holds no image key and spending has a monthly cap.";
+            readonly answers_file: "workbench/images/<name>.json";
+            readonly per: "feature or picture";
+            readonly answers_format: "For a feature: `{ \"format\": 1, \"route\": \"feature\", \"name\", \"about\" (the client's words), \"who\", \"cap_usd\", \"job\" }`, where `job` is the `X-Workbench-Job` the feature's calls send (`<name>` with dots, such as `quotes.estimate`), so its spending shows on its own line in Control. Write it, then build the feature with the package. For a picture made once: `npx workbench-ai pick <name> <round>-<draft>` copies the picked picture to `public/images/<name>.png` (or .jpg) and writes the answers file with its prompt, model, request id and cost; never write one from nothing. Show it on the page from `/images/<name>.png`, with alt text that says what it shows. Drafts and their previews stay in `workbench/images/drafts/`, which isn't committed.";
+            readonly questions: readonly [{
+                readonly id: "images.route";
+                readonly sets: "route";
+                readonly ask: "Is this something visitors use on the site, or something made once for the site?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Visitors use it";
+                    readonly value: "feature";
+                    readonly means: "A feature that makes a new picture each time someone uses it, such as a mock-up of their own design.";
+                }, {
+                    readonly label: "Made once for the site";
+                    readonly value: "content";
+                    readonly means: "A picture for the site, made once and kept: a hero image, an illustration for a page.";
+                }];
+                readonly must_ask: true;
+                readonly note: "Ask it even when the client's words seem to say, as a quick check: the two routes are built and paid for differently.";
+            }, {
+                readonly id: "images.who";
+                readonly sets: "feature.who";
+                readonly ask: "Who may use it?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "People who are signed in";
+                    readonly value: "signed_in";
+                    readonly means: "Anyone with an account. Each use is tied to a person, so misuse can be traced and stopped.";
+                }, {
+                    readonly label: "Admins only";
+                    readonly value: "admins";
+                    readonly means: "Only the business's own admins, for example a tool for writing their own posts.";
+                }, {
+                    readonly label: "Anyone visiting";
+                    readonly value: "anyone";
+                    readonly means: "No sign-in. The page checks for bots (Turnstile) and limits how often one visitor can use it.";
+                }];
+                readonly when: {
+                    readonly id: "images.route";
+                    readonly is: readonly ["feature"];
+                };
+                readonly note: "Signed in means `requireUser` and admins means `app_admins`, as the workbench-sign-in skill says. For anyone, check Turnstile on every use and keep a per-visitor limit; say plainly that strangers can run up the cost. Pass `subject` on every call so the Gateway can tell people apart: `user:<id>` for a signed-in person, and for anyone a random id kept in a cookie (`visitor:<id>`), never an email address or name.";
+            }, {
+                readonly id: "images.cap";
+                readonly sets: "feature.cap_usd";
+                readonly ask: "How much may it spend in a month, at most? When it's reached, the feature stops until next month.";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "US$5 a month";
+                    readonly value: 5;
+                    readonly means: "A small trial, or light use.";
+                }, {
+                    readonly label: "US$20 a month";
+                    readonly value: 20;
+                    readonly means: "Steady use by a small business's visitors.";
+                }, {
+                    readonly label: "US$50 a month";
+                    readonly value: 50;
+                    readonly means: "Heavy use. It can be raised later.";
+                }];
+                readonly other: {
+                    readonly kind: "money";
+                    readonly min: 1;
+                    readonly max: 1000;
+                    readonly description: "US dollars a month, whole or with cents.";
+                };
+                readonly must_ask: true;
+                readonly when: {
+                    readonly id: "images.route";
+                    readonly is: readonly ["feature"];
+                };
+                readonly note: "Say roughly what one use costs (about US$0.07 a picture with image-default) so the owner can judge. The cap is the project's production cap for the `images` tool in the Gateway, shared by every feature that uses it: set it with Workbench Control's `gw_budget_set` (env production, tool images, monthly_usd). Raising a cap waits for the owner's approval on Control's approval page. When it is reached, calls fail with `budget_exceeded`: the page says the feature is resting until next month, never an error.";
+            }, {
+                readonly id: "images.what";
+                readonly sets: readonly ["content.name", "content.about"];
+                readonly ask: "What picture do you need?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "A hero image";
+                    readonly value: "hero";
+                    readonly means: "The large picture across the top of a page.";
+                }, {
+                    readonly label: "An illustration";
+                    readonly value: "illustration";
+                    readonly means: "A drawing for a page or a section.";
+                }, {
+                    readonly label: "A product mock-up";
+                    readonly value: "mockup";
+                    readonly means: "A product shown in use or in a setting.";
+                }];
+                readonly other: {
+                    readonly kind: "text";
+                    readonly min: 3;
+                    readonly max: 200;
+                    readonly description: "What the picture is, in a few words.";
+                };
+                readonly when: {
+                    readonly id: "images.route";
+                    readonly is: readonly ["content"];
+                };
+                readonly note: "Name the picture after where it goes (home_hero): lower case and underscores. The client's own words about what it shows and the feel they want go in --about.";
+            }, {
+                readonly id: "images.shape";
+                readonly sets: "content.aspect";
+                readonly ask: "What shape should it be?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Landscape (3:2)";
+                    readonly value: "3:2";
+                    readonly means: "Wider than tall, the usual shape for a page.";
+                }, {
+                    readonly label: "Wide banner (16:9)";
+                    readonly value: "16:9";
+                    readonly means: "For a picture across the top of a page.";
+                }, {
+                    readonly label: "Square (1:1)";
+                    readonly value: "1:1";
+                    readonly means: "For cards and social posts.";
+                }, {
+                    readonly label: "Portrait (2:3)";
+                    readonly value: "2:3";
+                    readonly means: "Taller than wide.";
+                }];
+                readonly when: {
+                    readonly id: "images.route";
+                    readonly is: readonly ["content"];
+                };
+                readonly note: "Recommend the banner for a hero image. Pass it to the drafts command as --aspect.";
+            }];
+            readonly not_asked: readonly [{
+                readonly sets: "model";
+                readonly why: "Drafts and features use image-default. image-pro costs about twice as much for finer detail and image-openai is cheapest; suggest one only when the client asks about quality or cost.";
+            }, {
+                readonly sets: "references";
+                readonly why: "A reference picture (to make something like it) is only for a feature that needs one, and works with Google aliases only; offer it when the client mentions one.";
+            }];
+            readonly drafts: {
+                readonly of: "pictures";
+                readonly surface: "images";
+                readonly alias: "image-default";
+                readonly count: 3;
+                readonly max_rounds: 3;
+                readonly job: "images.drafts";
+                readonly command: "npx workbench-ai drafts image <name> --about \"<what it shows, in the client's words>\" --aspect <shape>";
+            };
+        };
         readonly delivery: {
             readonly choice: "built_in";
             readonly intro: "Pictures made by AI from a description.";
-            readonly when: "The client wants a picture made by AI, such as an illustration, a hero image or a product mock-up, as a feature visitors use or once for the site.";
         };
     };
     readonly pdf: {
@@ -1814,7 +2227,7 @@ export declare const capabilities: {
         readonly summary: "workbench-pdf prints an app's content as a PDF with its brand.json logo, colours and fonts, in the app's own Worker through its Browser Rendering binding (BROWSER). Nothing goes through the Gateway and the app holds no Cloudflare token. The standard layout takes plain-text blocks; html() takes the app's own markup.";
         readonly status: "built";
         readonly surfaces: {
-            readonly package: readonly ["createPdfMaker", "WorkbenchPdfError"];
+            readonly package: readonly ["createPdfMaker", "WorkbenchPdfError", "checkLayout", "fillLayout"];
         };
         readonly limits: readonly [{
             readonly id: "pdf.blocks";
@@ -1881,13 +2294,79 @@ export declare const capabilities: {
             readonly cost_hint_usd: 0;
             readonly note: "Prints the app's own HTML holding an image from a host not in allowOrigins; the PDF is made and the browser reports that image's request as blocked";
         }];
+        readonly offer: {
+            readonly pattern: "drafts";
+            readonly when: "The client wants a PDF: an invoice, receipt, quote, certificate, report or anything else to download or print.";
+            readonly say: "I'll make this with Workbench PDFs, printed with your logo and colours. I'll show you a few layouts to pick from. The one you pick is saved, so every one looks the same from then on.";
+            readonly answers_file: "workbench/pdf/<name>.json";
+            readonly per: "document";
+            readonly generator: "npx workbench-pdf generate";
+            readonly answers_format: "the saved layout. `npx workbench-pdf pick <name> <round>-<draft>` writes it from the draft the client picked, with the draft's request id, model and cost; never write one from nothing. It holds the document's `fields` (each value is text the app formats first, money and dates through the country pack), its `blocks` with `{field}` placeholders, and made-up `sample` values. To change a saved layout in the client's words (move a block, rename a heading, add a field), edit the file and run the generator, which refuses a layout that doesn't check. In the app, print with `pdfMakerFor(env).document(PDF_LAYOUTS.<name>.document(data), { size: PDF_LAYOUTS.<name>.size })`. Drafts and their previews stay in `workbench/pdf/drafts/`, which isn't committed.";
+            readonly questions: readonly [{
+                readonly id: "pdf.what";
+                readonly sets: readonly ["layout.name", "layout.about"];
+                readonly ask: "What is this document, and what is it for?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "An invoice";
+                    readonly value: "invoice";
+                    readonly means: "What a customer owes, with the items and the total.";
+                }, {
+                    readonly label: "A receipt";
+                    readonly value: "receipt";
+                    readonly means: "Proof a customer paid.";
+                }, {
+                    readonly label: "A quote";
+                    readonly value: "quote";
+                    readonly means: "What a job would cost, before the customer agrees.";
+                }];
+                readonly other: {
+                    readonly kind: "text";
+                    readonly min: 3;
+                    readonly max: 200;
+                    readonly description: "What the document is, in a few words: a certificate, a run sheet, a booking confirmation.";
+                };
+                readonly must_ask: true;
+                readonly note: "The answer's value is the layout's name (lower case and underscores: run_sheet). The client's own words, with anything they add about who reads it, go in --about.";
+            }, {
+                readonly id: "pdf.size";
+                readonly sets: "layout.size";
+                readonly ask: "Which paper size?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "A4";
+                    readonly value: "A4";
+                    readonly means: "Used almost everywhere outside North America.";
+                }, {
+                    readonly label: "US Letter";
+                    readonly value: "Letter";
+                    readonly means: "Used in the United States and Canada.";
+                }];
+                readonly note: "Recommend US Letter only when the readers are in the United States or Canada. Pass it to the drafts command as --size.";
+            }];
+            readonly not_asked: readonly [{
+                readonly sets: "layout.colours";
+                readonly why: "The logo, colours and fonts come from the brand (brand.json and the admins' brand page), so every document matches the rest of the app. To restyle a part of the layout, use project.css (see Restyling).";
+            }, {
+                readonly sets: "layout.contents";
+                readonly why: "The drafts propose what each layout shows. The client changes a picked layout in plain words, and you edit the saved file.";
+            }];
+            readonly drafts: {
+                readonly of: "layouts for this document";
+                readonly surface: "ai";
+                readonly alias: "claude-default";
+                readonly count: 3;
+                readonly max_rounds: 3;
+                readonly job: "pdf.drafts";
+                readonly command: "npx workbench-pdf drafts <name> --about \"<what it is for, in the client's words>\" --size <A4 or Letter>";
+            };
+        };
         readonly styles: {
             readonly prefix: "wb-pdf-";
         };
         readonly delivery: {
             readonly choice: "optional";
             readonly intro: "PDFs such as invoices and receipts, printed with the project's logo and colours.";
-            readonly when: "The client wants a PDF: an invoice, receipt, quote, certificate, report or anything else to download or print.";
         };
     };
     readonly "sign-in": {