@mccaskie-labs/workbench-config 0.2.3 → 0.2.4

package/dist/capabilities.gen.d.ts

@@ -1,4 +1,4 @@
-export declare const MANIFEST_VERSION: "0a5f38e30870";
+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: {