@mccaskie-labs/workbench-config 0.2.3 → 0.2.5

package/dist/capabilities.gen.d.ts

@@ -1,4 +1,4 @@
-export declare const MANIFEST_VERSION: "0a5f38e30870";
+export declare const MANIFEST_VERSION: "b74fc43c59b7";
 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: {
@@ -271,10 +413,45 @@ export declare const capabilities: {
             readonly cost_hint_usd: 0;
             readonly note: "Create the site, drive page views, query them back (cf_analytics_query, later)";
         }];
+        readonly offer: {
+            readonly pattern: "switch_on";
+            readonly when: "The client wants to know how many people visit, which pages they open, or to count an action such as a sign-up or an order.";
+            readonly say: "The project already has Workbench visitor counts: page views counted by Cloudflare without cookies, and the actions you choose counted in the app's own database. I'll switch on what you want.";
+            readonly answers_file: "workbench/analytics.json";
+            readonly answers_format: "`{ \"format\": 1, \"page_views\": true, \"events\": [{ \"name\": \"order.placed\", \"when\": \"a customer sends an order\", \"details\": [\"items\", \"total_band\"] }] }`. For page views, create the Web Analytics site with Workbench Control (`cf_web_analytics_site_create`), write its beacon token onto staging and production (`cf_worker_secret_put source=web_analytics`), and put `beacon(env)` on every page customers see. For each event, call `eventsFor(db).track(name, details)` where the action happens.";
+            readonly questions: readonly [{
+                readonly id: "analytics.page-views";
+                readonly sets: "page_views";
+                readonly ask: "Should the site count its page views?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Yes";
+                    readonly value: true;
+                    readonly means: "How many people visit and which pages they open, counted by Cloudflare. No cookies, and no personal details kept.";
+                }, {
+                    readonly label: "No";
+                    readonly value: false;
+                    readonly means: "Nothing is counted on the site's pages.";
+                }];
+                readonly note: "Only pages customers see; never the owner's or admins' pages.";
+            }, {
+                readonly id: "analytics.actions";
+                readonly sets: "events";
+                readonly ask: "Which actions should be counted?";
+                readonly style: "table";
+                readonly note: "Propose the few actions that show whether the site is working for the business (a sign-up, an order, a booking, a form sent), each with a name (`thing.past_verb`, lower case: `order.placed`), when it happens in the client's words, and its details. Details are counts, choices and bands (`items`, `plan`, `total_band`), never an email address, a name, a phone number or free text someone typed. The client accepts, removes or adds; an empty list is fine.";
+            }];
+            readonly not_asked: readonly [{
+                readonly sets: "consent";
+                readonly why: "The page-view counter sets no cookies and keeps no personal details, and events hold none either, so they add nothing that a cookie notice would need to cover.";
+            }, {
+                readonly sets: "reports";
+                readonly why: "Page views are seen in Cloudflare's Web Analytics, and events are rows in the app's own `events` table; ask what the owner wants to see when they ask for a report.";
+            }];
+        };
         readonly delivery: {
             readonly choice: "optional";
             readonly intro: "Counting page views and the things visitors do on the site.";
-            readonly when: "The client wants to know how many people visit, which pages they open, or to count an action such as a sign-up or an order.";
         };
     };
     readonly config: {
@@ -423,10 +600,137 @@ export declare const capabilities: {
             readonly cost_hint_usd: 0;
             readonly note: "Every pack's spelling is one the Gateway accepts (en-PH, en-AU, en-GB, en-US), checked against the ai manifest's spellings; no Gateway call";
         }];
+        readonly offer: {
+            readonly pattern: "project";
+            readonly when: "The app shows a date, a time, a number, a phone number or an amount of money to its readers, or the client says where their readers are.";
+            readonly say: "I'll write dates, times and money with Workbench country formats, the way your readers expect them. That needs to know where they are, once for the whole site.";
+            readonly answers_file: "workbench/country.json";
+            readonly answers_format: "`{ \"format\": 1, \"country\": \"AU\", \"time_zone\": null, \"currency\": null }`: the country code (or `ZZ`, the package's WORLDWIDE, for readers everywhere), and an IANA time zone or `{ \"code\", \"symbol\" }` currency only when they differ from the country's own (the Australian and US time questions both fill `time_zone`). Then set `READERS` in `src/lib/country.ts` to match: `audiencePack({ country, timeZone, currency })`, leaving out what is null. Every page, email, PDF and form reads `READERS`, so nothing else changes.";
+            readonly questions: readonly [{
+                readonly id: "country.where";
+                readonly sets: "audience.country";
+                readonly ask: "Where are most of the site's readers?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Australia";
+                    readonly value: "AU";
+                    readonly means: "26 September 2026, A$1,400, Sydney time, Australian spelling.";
+                }, {
+                    readonly label: "The Philippines";
+                    readonly value: "PH";
+                    readonly means: "September 26, 2026, ₱1,400, Manila time.";
+                }, {
+                    readonly label: "The United Kingdom";
+                    readonly value: "GB";
+                    readonly means: "26 September 2026, £1,400, UK time, British spelling.";
+                }, {
+                    readonly label: "The United States";
+                    readonly value: "US";
+                    readonly means: "September 26, 2026, US$1,400, Eastern time, American spelling.";
+                }];
+                readonly other: {
+                    readonly kind: "text";
+                    readonly min: 2;
+                    readonly max: 60;
+                    readonly description: "Another country, or readers all over the world.";
+                };
+                readonly note: "Recommend Australia unless the client's words say otherwise. A country with no pack yet, or readers everywhere, gets the neutral one (`ZZ`: 26 September 2026, 24-hour clock, UTC, US$): say so, and ask for the currency.";
+            }, {
+                readonly id: "country.au-time";
+                readonly sets: "audience.time_zone.au";
+                readonly ask: "Which Australian time should the site show?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Sydney, Melbourne, Canberra";
+                    readonly value: null;
+                    readonly means: "The pack's own (Australia/Sydney), with daylight saving.";
+                }, {
+                    readonly label: "Brisbane";
+                    readonly value: "Australia/Brisbane";
+                    readonly means: "Queensland, no daylight saving.";
+                }, {
+                    readonly label: "Adelaide";
+                    readonly value: "Australia/Adelaide";
+                    readonly means: "South Australia, half an hour behind Sydney.";
+                }, {
+                    readonly label: "Perth";
+                    readonly value: "Australia/Perth";
+                    readonly means: "Western Australia.";
+                }];
+                readonly other: {
+                    readonly kind: "text";
+                    readonly min: 5;
+                    readonly max: 40;
+                    readonly description: "Another Australian time zone, such as Australia/Darwin or Australia/Hobart.";
+                };
+                readonly when: {
+                    readonly id: "country.where";
+                    readonly is: readonly ["AU"];
+                };
+                readonly note: "The time zone of the business, where bookings and opening hours happen. Hobart follows Sydney; Darwin is Australia/Darwin.";
+            }, {
+                readonly id: "country.us-time";
+                readonly sets: "audience.time_zone.us";
+                readonly ask: "Which US time should the site show?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Eastern";
+                    readonly value: null;
+                    readonly means: "The pack's own (America/New_York).";
+                }, {
+                    readonly label: "Central";
+                    readonly value: "America/Chicago";
+                }, {
+                    readonly label: "Mountain";
+                    readonly value: "America/Denver";
+                }, {
+                    readonly label: "Pacific";
+                    readonly value: "America/Los_Angeles";
+                }];
+                readonly other: {
+                    readonly kind: "text";
+                    readonly min: 5;
+                    readonly max: 40;
+                    readonly description: "Another US time zone, such as America/Phoenix or Pacific/Honolulu.";
+                };
+                readonly when: {
+                    readonly id: "country.where";
+                    readonly is: readonly ["US"];
+                };
+                readonly note: "The time zone of the business.";
+            }, {
+                readonly id: "country.currency";
+                readonly sets: "audience.currency";
+                readonly ask: "Which money are prices in?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "The country's own";
+                    readonly value: null;
+                    readonly means: "A$ in Australia, ₱ in the Philippines, £ in the UK, US$ in the US.";
+                }, {
+                    readonly label: "US dollars";
+                    readonly value: "USD";
+                    readonly means: "Shown as US$1,400.";
+                }];
+                readonly other: {
+                    readonly kind: "text";
+                    readonly min: 3;
+                    readonly max: 3;
+                    readonly description: "Another currency's three-letter code, such as NZD or EUR.";
+                };
+                readonly note: "Write a currency other than the country's as `{ \"code\", \"symbol\" }` (NZD is NZ$). Ask it only when the client sells something; otherwise record null.";
+            }];
+            readonly not_asked: readonly [{
+                readonly sets: "audience.format";
+                readonly why: "Date order, the clock, number separators, spelling and phone number shapes all come from the country's pack, so they match what readers expect without asking.";
+            }, {
+                readonly sets: "audience.owner_pages";
+                readonly why: "Pages only the owner sees use workbench-ui's own times and money, not the readers'.";
+            }];
+        };
         readonly delivery: {
             readonly choice: "optional";
             readonly intro: "Dates, times, numbers and money written the way readers in your country expect.";
-            readonly when: "The app shows a date, a time, a number, a phone number or an amount of money to its readers, or the client says where their readers are.";
         };
     };
     readonly database: {
@@ -1643,10 +1947,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 +2226,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: {
@@ -2223,13 +2798,33 @@ export declare const capabilities: {
             readonly cost_hint_usd: 0;
             readonly note: "In the Worker itself: compares money (US$0.0042, US$12.50, and an en dash for nothing), duration (640 ms, 2.35 s, 3 min 5 s) and timeLeft against a fixed now (42 minutes left) with the expected text, and checks when and shortWhen write one fixed moment as its Manila day and hour with UTC beside it";
         }];
+        readonly offer: {
+            readonly pattern: "switch_on";
+            readonly when: "The client wants a page only the owner or the app's admins see: a dashboard, a list, a settings page or a status page.";
+            readonly say: "I'll build this with the Workbench owner-page look, the same top bar, cards and pills as the other admin pages, so it's quick to build and consistent. Your customers never see it.";
+            readonly answers_file: "workbench/ui.json";
+            readonly answers_format: "`{ \"format\": 1, \"pages\": [{ \"path\": \"/admin/orders\", \"what\": \"every order this month, newest first\", \"who\": \"admins\" }] }`. Build each page with `shell`, `topBar`, `card` and `pill`. An `admins` page lives under `/admin/` and checks `requireUser` and `app_admins` (the workbench-sign-in skill); an `owner` page lives under `/owner/` and is behind Access in production.";
+            readonly questions: readonly [{
+                readonly id: "ui.pages";
+                readonly sets: "pages";
+                readonly ask: "Which admin pages should the app have?";
+                readonly style: "table";
+                readonly note: "Propose the pages the request needs, each with its path, what it shows or lets them change in the client's words, and who sees it: `admins` (the business's people, who sign in to the app) or `owner` (whoever runs the app's Workbench, through Access). Recommend `admins` unless the page is about running the app itself, such as a status page. The client accepts, removes or adds pages.";
+            }];
+            readonly not_asked: readonly [{
+                readonly sets: "look";
+                readonly why: "Every admin page has the same Workbench look, so the business's people learn it once. Restyle it in project.css (see Restyling) if the client wants their colours.";
+            }, {
+                readonly sets: "formats";
+                readonly why: "Times, amounts and durations on these pages come from workbench-ui's `when`, `money` and `duration`. What customers see uses the readers' formats (the workbench-country skill).";
+            }];
+        };
         readonly styles: {
             readonly prefix: "wb-ui-";
         };
         readonly delivery: {
             readonly choice: "optional";
             readonly intro: "A ready-made look for the pages only you and your admins see.";
-            readonly when: "The client wants a page only the owner or the app's admins see: a dashboard, a list, a settings page or a status page.";
         };
     };
 };