@mccaskie-labs/workbench-config 0.3.1 → 0.4.0

package/dist/capabilities.gen.d.ts

@@ -1,4 +1,4 @@
-export declare const MANIFEST_VERSION: "9aae488ad117";
+export declare const MANIFEST_VERSION: "7ad8cef4de58";
 export declare const capabilities: {
     readonly ai: {
         readonly $schema: "./schema.json";
@@ -9,7 +9,7 @@ export declare const capabilities: {
         readonly status: "built";
         readonly surfaces: {
             readonly gateway: readonly ["POST /anthropic/v1/messages", "POST /anthropic/v1/messages/count_tokens"];
-            readonly package: readonly ["createAi", "Ai.text", "Ai.structured", "Ai.stream", "Ai.countTokens", "Ai.budget", "createFakeAi", "checkWriting", "writingStops", "writingNotes", "writingFixNote"];
+            readonly package: readonly ["createAi", "Ai.text", "Ai.structured", "Ai.stream", "Ai.countTokens", "Ai.budget", "createFakeAi", "checkWriting", "writingStops", "writingNotes", "writingFixNote", "Ai.reply", "checkGuide"];
         };
         readonly config: readonly [{
             readonly name: "WORKBENCH_GATEWAY_KEY";
@@ -114,6 +114,12 @@ export declare const capabilities: {
             readonly text: "Name a Workbench voice and spelling with the voice and spelling options, so the Gateway adds the text, or bring the app's own voice. Never paste Workbench's voice text into a prompt.";
             readonly enforced_by: "gateway";
             readonly probe: "ai.voice";
+        }, {
+            readonly id: "ai.reply-facts-from-code";
+            readonly kind: "must";
+            readonly text: "Draft replies with ai.reply from facts worked out by code (prices and dates from quote(), never from the AI), and show the draft in renderReplyBox for a person to check and copy. Never send a draft automatically, and never let a draft with needs_human_check go out unread.";
+            readonly enforced_by: "review";
+            readonly probe: "ai.reply";
         }];
         readonly examples: readonly [{
             readonly id: "ai.example.text";
@@ -127,6 +133,12 @@ export declare const capabilities: {
             readonly lang: "ts";
             readonly code: "const r = await ai.text({ model: 'claude-default', job: 'article.write', voice: 'conversational', spelling: 'en-AU', prompt })\nconst issues = checkWriting(r.text, { voice: 'conversational' })\nif (writingStops(issues).length > 0) await retryWith(prompt + writingFixNote(issues))";
             readonly probe: "ai.voice";
+        }, {
+            readonly id: "ai.example.reply";
+            readonly title: "Draft a reply to an enquiry";
+            readonly lang: "ts";
+            readonly code: "import { REPLY_GUIDES } from './replies.generated'\nconst ai = createAi({ key: env.WORKBENCH_GATEWAY_KEY, env: workbenchEnv(env), url: env.WORKBENCH_GATEWAY_URL, replyGuides: REPLY_GUIDES })\nconst q = quote(settings, ask)\nconst draft = await ai.reply({\n  guide: 'venue-quote',\n  facts: { venue_name: venue.name, date: ask.date, available: q.available, packages: q.options.map((o) => ({ name: o.package, price: o.total.amount })), alternatives: q.alternatives.map((a) => a.date) },\n  incoming: { text, intake: read },\n  language: account.reply_language,\n})\nreturn html(renderReplyBox(draft, { againAction: `/enquiries/${id}/reply` }))";
+            readonly probe: "ai.reply";
         }];
         readonly probes: readonly [{
             readonly id: "ai.text.claude-default";
@@ -193,18 +205,23 @@ export declare const capabilities: {
             readonly half: "runtime";
             readonly expect: "pass";
             readonly cost_hint_usd: 0.008;
+        }, {
+            readonly id: "ai.reply";
+            readonly half: "runtime";
+            readonly expect: "pass";
+            readonly cost_hint_usd: 0.005;
         }];
         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 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, or wants ready-to-paste replies to the messages the business gets (quote requests, booking questions).";
             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 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. For replies: write the guide itself to `workbench/replies/<name>.json` (format 1: `name`, `version`, `voice`, `spelling`, `max_words`, `max_questions`, `facts` as a small JSON Schema with `x-money` on amounts and `format: date` on dates, `ask_order`, `guide` lines, `examples`, `never`), then run `npx workbench-ai replies generate`, which checks it and writes `src/replies.generated.ts`; never edit that file. Offer samples with `npx workbench-ai replies drafts <name> --languages <the client's languages>` (two to four, with the development key; tell the client the cost it prints) and keep the one the client picks with `npx workbench-ai replies pick <name> <round>-<draft>`, which makes it the guide's first example.";
             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 ask: "Is this something visitors use on the site, something made once for the site, or replies to the messages you get?";
                 readonly style: "cards";
                 readonly answers: readonly [{
                     readonly label: "Visitors use it";
@@ -214,9 +231,13 @@ export declare const capabilities: {
                     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 label: "Replies to messages";
+                    readonly value: "reply";
+                    readonly means: "A ready-to-paste reply to a customer's message, with your prices and dates filled in from your own details. A person checks it and copies it; nothing is sent by itself.";
                 }];
                 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 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. Replies are their own route: the facts (prices, dates) come from the app's own code, so ask where those facts come from before anything else.";
             }, {
                 readonly id: "ai.who";
                 readonly sets: "feature.who";
@@ -319,6 +340,156 @@ export declare const capabilities: {
                     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 id: "ai.reply.purpose";
+                readonly sets: "reply.purpose";
+                readonly ask: "What are these replies answering?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Quote and price requests";
+                    readonly value: "quote";
+                    readonly means: "\"How much for Dec 12, 15 pax?\": the reply gives the price and asks only for what's missing.";
+                }, {
+                    readonly label: "Availability questions";
+                    readonly value: "availability";
+                    readonly means: "\"Available pa po ba sa Sabado?\": the reply says yes or offers other dates.";
+                }, {
+                    readonly label: "Booking or appointment requests";
+                    readonly value: "booking";
+                    readonly means: "\"May slot po ba bukas?\": the reply lists the free times and asks which one.";
+                }];
+                readonly other: {
+                    readonly kind: "text";
+                    readonly min: 3;
+                    readonly max: 200;
+                    readonly description: "What the messages are, in a few words.";
+                };
+                readonly must_ask: true;
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["reply"];
+                };
+                readonly note: "Name the guide after it (venue-quote, appointment-slots): lower case and dashes. Say that prices and dates always come from the app's own details (workbench-availability's quote() where it's a booking), never from the AI.";
+            }, {
+                readonly id: "ai.reply.facts";
+                readonly sets: "reply.facts";
+                readonly ask: "Here are the details a reply can use. Keep, change or add?";
+                readonly style: "table";
+                readonly must_ask: true;
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["reply"];
+                };
+                readonly note: "Propose one row per fact from the client's words and what the app already holds: its name, what it is, where the app gets it, and whether it is money (x-money with the currency) or a date. Only these can appear in a reply; a fact the app doesn't have can't be quoted. Then ask which details a reply may ask the customer for, most important first (ask_order); intake's missing fields are asked from that list only.";
+            }, {
+                readonly id: "ai.reply.language";
+                readonly sets: "reply.language";
+                readonly ask: "Which language should replies use?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Match the message";
+                    readonly value: "match";
+                    readonly means: "English gets English, Taglish gets Taglish, Tagalog gets Tagalog. When it can't tell, it uses your fallback and asks you to check.";
+                }, {
+                    readonly label: "Always Taglish";
+                    readonly value: "taglish";
+                }, {
+                    readonly label: "Always English";
+                    readonly value: "en";
+                }, {
+                    readonly label: "Always Tagalog";
+                    readonly value: "tl";
+                }];
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["reply"];
+                };
+                readonly note: "This is the default. Where the app has accounts (a venue each), make it each account's own setting in its portal, defaulting to this, and pass it to ai.reply as language; with match, pass the account's fallback as fallbackLanguage.";
+            }, {
+                readonly id: "ai.reply.voice";
+                readonly sets: "reply.voice";
+                readonly ask: "Which tone?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Conversational";
+                    readonly value: "conversational";
+                    readonly means: "Warm and natural, like a helpful person at the front desk.";
+                }, {
+                    readonly label: "Casual";
+                    readonly value: "casual";
+                    readonly means: "Relaxed and friendly, like chatting with a regular.";
+                }, {
+                    readonly label: "Plain";
+                    readonly value: "plain";
+                    readonly means: "Short and clear, nothing extra.";
+                }, {
+                    readonly label: "Formal";
+                    readonly value: "formal";
+                    readonly means: "Polite and proper, for a business that keeps a formal tone.";
+                }];
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["reply"];
+                };
+            }, {
+                readonly id: "ai.reply.length";
+                readonly sets: "reply.max_words";
+                readonly ask: "How long can a reply be, at most?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "About 90 words";
+                    readonly value: 90;
+                    readonly means: "Room for a price or two and one question.";
+                }, {
+                    readonly label: "About 50 words";
+                    readonly value: 50;
+                    readonly means: "A quick chat reply.";
+                }, {
+                    readonly label: "About 150 words";
+                    readonly value: 150;
+                    readonly means: "Room for several packages or options.";
+                }];
+                readonly other: {
+                    readonly kind: "whole";
+                    readonly min: 20;
+                    readonly max: 300;
+                    readonly description: "Words, from 20 to 300.";
+                };
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["reply"];
+                };
+                readonly note: "A reply up to a quarter over passes quietly; one over twice as long is sent back to be written again, then flagged for a person to check.";
+            }, {
+                readonly id: "ai.reply.never";
+                readonly sets: "reply.never";
+                readonly ask: "Is there anything a reply must never say?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "The usual three";
+                    readonly value: "usual";
+                    readonly means: "Never promise a discount, confirm a booking, or ask for payment details. Code checks these as well as telling the AI.";
+                }, {
+                    readonly label: "The usual three, and more";
+                    readonly value: "usual_and_more";
+                    readonly means: "Those three plus things of your own (type them in Other).";
+                }, {
+                    readonly label: "Nothing";
+                    readonly value: "none";
+                    readonly means: "No rules beyond Workbench's own content rules.";
+                }];
+                readonly other: {
+                    readonly kind: "list";
+                    readonly min: 1;
+                    readonly max: 10;
+                    readonly description: "Each thing a reply must never do, in a few words (give medical advice, mention the pool).";
+                };
+                readonly must_ask: true;
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["reply"];
+                };
+                readonly note: "Write each as a never line in the guide. Lines about payment details, discounts and confirming bookings are also checked by code; others go into the prompt only, so say so if the client's line matters a lot.";
             }];
             readonly not_asked: readonly [{
                 readonly sets: "model";
@@ -337,6 +508,9 @@ export declare const capabilities: {
                 readonly command: "npx workbench-ai drafts text <name> --about \"<what it is for, with the client's facts>\"";
             };
         };
+        readonly styles: {
+            readonly prefix: "wb-reply-";
+        };
         readonly delivery: {
             readonly choice: "built_in";
             readonly intro: "Writing, summarising and answering questions with Claude, with a monthly spending cap.";
@@ -2721,6 +2895,297 @@ export declare const capabilities: {
             readonly intro: "Pictures made by AI from a description.";
         };
     };
+    readonly intake: {
+        readonly $schema: "./schema.json";
+        readonly format: 1;
+        readonly component: "intake";
+        readonly title: "Message intake through the Gateway";
+        readonly summary: "Reads one social media message (a Messenger chat, a group post or a comment), as a screenshot, pasted text or both, into one of the project's own intake types: the type, its fields, what is missing or reads two ways, and whether a person should check it. The types are files in the project's repo, sent with every call. Workbench keeps only the call's facts, never the image or the text; the project can keep them in its own bucket.";
+        readonly status: "built";
+        readonly surfaces: {
+            readonly gateway: readonly ["POST /v1/intake/read"];
+            readonly package: readonly ["Ai.intake", "defineIntakeTypes", "IntakeTypes", "IntakeResult"];
+        };
+        readonly config: readonly [{
+            readonly name: "WORKBENCH_GATEWAY_KEY";
+            readonly required: true;
+            readonly secret: true;
+            readonly environments: readonly ["staging", "production"];
+            readonly description: "Project key with the ai scope, delivered as a Worker secret by gw_key_issue";
+        }];
+        readonly limits: readonly [{
+            readonly id: "intake.types-per-call";
+            readonly value: 20;
+            readonly unit: "types";
+            readonly per: "request";
+            readonly enforced_by: "gateway";
+            readonly refusal: "invalid_request";
+        }, {
+            readonly id: "intake.properties-per-type";
+            readonly value: 40;
+            readonly unit: "properties";
+            readonly per: "type";
+            readonly enforced_by: "gateway";
+            readonly refusal: "invalid_request";
+        }, {
+            readonly id: "intake.definition-size";
+            readonly value: 16384;
+            readonly unit: "bytes";
+            readonly per: "type";
+            readonly enforced_by: "gateway";
+            readonly refusal: "invalid_request";
+        }, {
+            readonly id: "intake.types-size";
+            readonly value: 65536;
+            readonly unit: "bytes";
+            readonly per: "request";
+            readonly enforced_by: "gateway";
+            readonly refusal: "invalid_request";
+        }, {
+            readonly id: "intake.text-length";
+            readonly value: 20000;
+            readonly unit: "characters";
+            readonly per: "request";
+            readonly enforced_by: "gateway";
+            readonly refusal: "invalid_request";
+        }, {
+            readonly id: "intake.image-size";
+            readonly value: 5242880;
+            readonly unit: "bytes";
+            readonly per: "request";
+            readonly enforced_by: "gateway";
+            readonly refusal: "invalid_request";
+        }, {
+            readonly id: "intake.images-per-call";
+            readonly value: 1;
+            readonly unit: "images";
+            readonly per: "request";
+            readonly enforced_by: "gateway";
+            readonly refusal: "invalid_request";
+        }];
+        readonly errors: readonly [{
+            readonly code: "invalid_request";
+            readonly http: 400;
+            readonly retryable: false;
+            readonly meaning: "No text or image, an image too large or of another kind, or a type definition that breaks the rules (the message names the type and the JSON path)";
+        }, {
+            readonly code: "budget_exceeded";
+            readonly http: 402;
+            readonly retryable: false;
+            readonly meaning: "The project's budget, its intake cap or the global ceiling is reached";
+        }, {
+            readonly code: "content_refused";
+            readonly http: 422;
+            readonly retryable: false;
+            readonly meaning: "The content rules, or Claude itself, refused the message or the reading";
+        }, {
+            readonly code: "content_check_unavailable";
+            readonly http: 503;
+            readonly retryable: true;
+            readonly meaning: "The content checker is down, so nothing was read";
+        }, {
+            readonly code: "upstream_error";
+            readonly http: 502;
+            readonly retryable: true;
+            readonly meaning: "Anthropic failed after the Gateway's retries";
+        }, {
+            readonly code: "upstream_timeout";
+            readonly http: 504;
+            readonly retryable: true;
+            readonly meaning: "Anthropic didn't answer in time";
+        }];
+        readonly rules: readonly [{
+            readonly id: "intake.types-from-files";
+            readonly kind: "must";
+            readonly text: "Keep each intake type as a file, workbench/intake/<name>.json, and pass intakeTypes from src/intake.generated.ts. Run npx workbench-ai intake generate after changing one, and keep npx workbench-ai intake generate --check in the project's Checks. Never write definitions inline.";
+            readonly enforced_by: "types";
+            readonly probe: "intake.read.text";
+        }, {
+            readonly id: "intake.human-check";
+            readonly kind: "must";
+            readonly text: "Act on needsHumanCheck: show the reading to a person (or keep it marked to check) before it becomes a booking, a quote or a reply. It is the Gateway's rule, not the model's score.";
+            readonly enforced_by: "review";
+            readonly probe: "intake.read.unknown";
+        }, {
+            readonly id: "intake.personal-marked";
+            readonly kind: "must";
+            readonly text: "Mark every field that holds a personal detail with x-personal (name, handle, phone, email, address, photo). An unmarked field whose name or format looks personal is refused, and personal details the type doesn't ask for are blanked in rawText.";
+            readonly enforced_by: "gateway";
+            readonly probe: "intake.read.personal-blanked";
+        }, {
+            readonly id: "intake.no-content-kept";
+            readonly kind: "must_not";
+            readonly text: "Expect Workbench to keep the image or the text: it keeps only the call's facts. To keep them, set save_input to project in workbench/intake.json and pass store: env.INTAKE_STORE.";
+            readonly enforced_by: "gateway";
+            readonly probe: "intake.read.text";
+        }, {
+            readonly id: "intake.subject-is-app-user";
+            readonly kind: "must_not";
+            readonly text: "Send the poster's name or number as subject or ref. subject is user:<id> of the app's own user; ref is the app's own record id, such as enquiry:4812.";
+            readonly enforced_by: "review";
+            readonly probe: "intake.read.text";
+        }, {
+            readonly id: "intake.bad-type-refused";
+            readonly kind: "must_not";
+            readonly text: "Send a type that breaks the format: the Gateway refuses it with invalid_request before any spend.";
+            readonly enforced_by: "gateway";
+            readonly probe: "intake.read.bad-type-refused";
+        }];
+        readonly examples: readonly [{
+            readonly id: "intake.example.read";
+            readonly title: "Read a pasted message or a screenshot";
+            readonly lang: "ts";
+            readonly code: "import { intakeTypes } from './intake.generated'\n\nconst r = await ai.intake({ types: intakeTypes, text, image, timeZone: country.timeZone.id, job: 'intake.quote-request', subject: `user:${user.id}`, ref: `enquiry:${enquiry.id}`, store: env.INTAKE_STORE })\nif (r.type === 'venue-quote-request') {\n  await saveEnquiry({ ...r.data, toCheck: r.needsHumanCheck, missing: r.missing })\n}";
+            readonly probe: "intake.read.text";
+        }];
+        readonly probes: readonly [{
+            readonly id: "intake.read.text";
+            readonly half: "runtime";
+            readonly expect: "pass";
+            readonly smoke: true;
+            readonly cost_hint_usd: 0.01;
+            readonly note: "One of HmPo's sample messages as text: the type, the data and no human check";
+        }, {
+            readonly id: "intake.read.unknown";
+            readonly half: "runtime";
+            readonly expect: "pass";
+            readonly cost_hint_usd: 0.01;
+            readonly note: "A thank-you review comes back unknown, with needs_human_check and unknown_type";
+        }, {
+            readonly id: "intake.read.personal-blanked";
+            readonly half: "runtime";
+            readonly expect: "pass";
+            readonly cost_hint_usd: 0.01;
+            readonly note: "A message with a phone number the type doesn't ask for: rawText shows [phone]";
+        }, {
+            readonly id: "intake.read.bad-type-refused";
+            readonly half: "runtime";
+            readonly expect: "refused_as_expected";
+            readonly refusal: "invalid_request";
+            readonly cost_hint_usd: 0;
+            readonly note: "A type with an unmarked contact_phone field is refused before any spend";
+        }];
+        readonly offer: {
+            readonly pattern: "settings";
+            readonly when: "The client gets enquiries, orders or posts as messages (Messenger, a Facebook group, comments) and wants them read into a form or a list instead of typed up by hand.";
+            readonly say: "I'll set this up with Workbench message intake: you paste a message or a screenshot and it fills in the details, and flags the ones a person should check. Workbench never keeps the message. Here are the details I'd pull out; tell me what to change.";
+            readonly answers_file: "workbench/intake/<name>.json";
+            readonly per: "kind of message";
+            readonly generator: "npx workbench-ai intake generate";
+            readonly answers_format: "One type per file, docs/message-intake.md §3: `{ \"format\": 1, \"name\", \"version\": 1, \"description\" (the client's words, made plain), \"not_this\", \"examples\" (1 to 5 real-looking messages with the data each should give), \"glossary\" (the trade's own shorthand), \"schema\" (the fields from intake.fields; required lists what the app can't do without), \"confidence_floor\", \"model\", \"save_input\" }`. The project's own setting is workbench/intake.json, `{ \"format\": 1, \"save_input\": \"none\" | \"project\" }`. Then run the generator and commit src/intake.generated.ts.";
+            readonly questions: readonly [{
+                readonly id: "intake.kind";
+                readonly sets: readonly ["name", "description"];
+                readonly ask: "What kind of message do you want read?";
+                readonly style: "table";
+                readonly other: {
+                    readonly kind: "text";
+                    readonly min: 3;
+                    readonly max: 200;
+                    readonly description: "In the client's words, such as \"quote requests on Messenger\" or \"orders in comments under our posts\".";
+                };
+                readonly must_ask: true;
+                readonly note: "Only the client knows. Name the type after it in lower case with hyphens (venue-quote-request). Ask for two or three real messages (names blanked) to use as examples.";
+            }, {
+                readonly id: "intake.fields";
+                readonly sets: readonly ["schema", "examples"];
+                readonly ask: "Here are the details I'd pull out of each message. Keep them, change some, or add or remove?";
+                readonly style: "table";
+                readonly other: {
+                    readonly kind: "list";
+                    readonly min: 1;
+                    readonly max: 40;
+                    readonly description: "Each detail: its name, what it is, whether the app can't do without it, and the choices if it is one of a list.";
+                };
+                readonly must_ask: true;
+                readonly note: "Propose from intake.kind, as a table of field, meaning, kind (text, number, date, one of a list), and needed. For an enquiry: the date, how many people, what for, budget, extras. Mark as needed only what the app can't act without; the rest are optional.";
+            }, {
+                readonly id: "intake.personal";
+                readonly sets: "schema.x-personal";
+                readonly ask: "Should it keep the person's name or contact details?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "No, leave them out";
+                    readonly value: "none";
+                    readonly means: "Names, numbers and handles are blanked in what it reads, and never kept.";
+                }, {
+                    readonly label: "Their display name only";
+                    readonly value: "name";
+                    readonly means: "The name shown on the message, so the owner knows who asked.";
+                }, {
+                    readonly label: "Name and how to reach them";
+                    readonly value: "contact";
+                    readonly means: "The name and a phone number or email when the message gives one.";
+                }];
+                readonly must_ask: true;
+                readonly note: "Each kept detail becomes a field marked x-personal with its kind (name, phone, email). Say that what the app keeps is under its own privacy notice.";
+            }, {
+                readonly id: "intake.save";
+                readonly sets: "save_input";
+                readonly ask: "Should your app keep a copy of each message (the screenshot and its text)?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "No, read it and let it go";
+                    readonly value: "none";
+                    readonly means: "Only the filled-in details are kept, by your app.";
+                }, {
+                    readonly label: "Yes, in your own storage";
+                    readonly value: "project";
+                    readonly means: "Your app keeps the screenshot and text in its own private bucket. Workbench never keeps it.";
+                }];
+                readonly must_ask: true;
+                readonly note: "project sets save_input in workbench/intake.json and needs the INTAKE_STORE bucket bound to the app (a private R2 bucket <id>-intake per environment, in the projects account). Pass store: env.INTAKE_STORE on every call. Say who will be able to see the copies and for how long.";
+            }, {
+                readonly id: "intake.check";
+                readonly sets: "app.when_unsure";
+                readonly ask: "When it isn't sure, what should the app do?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Ask you to check first";
+                    readonly value: "ask";
+                    readonly means: "The details wait for you to confirm before they are saved.";
+                }, {
+                    readonly label: "Save it, marked to check";
+                    readonly value: "mark";
+                    readonly means: "It is saved straight away with a \"to check\" mark.";
+                }, {
+                    readonly label: "Skip it";
+                    readonly value: "skip";
+                    readonly means: "Unsure readings aren't saved; you read the message yourself.";
+                }];
+                readonly note: "This is the app's own behaviour when needsHumanCheck is true; nothing in the type file changes.";
+            }, {
+                readonly id: "intake.model";
+                readonly sets: "model";
+                readonly ask: "How careful should the reading be?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Careful";
+                    readonly value: "claude-default";
+                    readonly means: "About US$0.01 a message.";
+                }, {
+                    readonly label: "Quick and cheap";
+                    readonly value: "claude-fast";
+                    readonly means: "Cheaper, and misses more in long or messy chats.";
+                }];
+                readonly note: "Recommend careful. Leave model out of the file for claude-default.";
+            }];
+            readonly not_asked: readonly [{
+                readonly sets: "confidence_floor";
+                readonly why: "0.75 suits a start; it is tuned from real results, not asked.";
+            }, {
+                readonly sets: "glossary";
+                readonly why: "Claude adds the trade's own shorthand from the client's example messages (DU for day use); the Gateway's built-in Filipino and Taglish glossary covers everyday words.";
+            }, {
+                readonly sets: "budget";
+                readonly why: "Intake has its own monthly cap in the Gateway, set with Control's gw_budget_set (tool intake); offer it only when the client asks about cost.";
+            }];
+        };
+        readonly delivery: {
+            readonly choice: "optional";
+            readonly intro: "Turns a pasted message or a screenshot of a chat into a filled-in form, so enquiries don't have to be typed up by hand.";
+        };
+    };
     readonly pdf: {
         readonly $schema: "./schema.json";
         readonly format: 1;