@aglyn/plugins-ai 1.0.0-beta.261 → 1.0.0-beta.263

package/src/lib/layout-language/ai-layout-promised-copy.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { NodesMap } from '@aglyn/aglyn/types/nodes';
+import type { AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+/**
+ * No section that promises its own content later (AGL-3887). A guided start
+ * publishes what it builds, so a section whose words say it is still being
+ * filled — "We are building this space for the words of families we have
+ * worked with", the live Whitmore Lane Family Law home of 2026-10-16 — is a
+ * stand-in a visitor reads as an unfinished site. A page answer holding one
+ * is asked again; the last answer a generation takes has the section taken
+ * out instead (`aiLayoutPageCheck`), its first section aside.
+ *
+ * Scoped to the page speaking of itself: "this space", "this section", the
+ * site's own reviews, photos or portfolio promised for later. "Coming soon"
+ * alone is never one: an event, a menu item or a new location is genuinely
+ * coming soon on a dated list. A coming-soon site, whose whole point is what
+ * is coming, is not held to it.
+ */
+/** The violation code a section that promises its content later is named by. */
+export declare const AI_LAYOUT_PROMISED_COPY_CODE = "layout-promised-copy";
+/** Whether a line promises the page's own content later, rather than saying it. */
+export declare function aiLayoutPromisesContent(text: string): boolean;
+/**
+ * The plan indices of a built page's sections that promise their content
+ * later, each with the line that does, in page order.
+ */
+export declare function aiLayoutPromisedSections(nodes: NodesMap, sectionIds: readonly string[]): Array<{
+    index: number;
+    line: string;
+}>;
+/** The violation that asks again for the sections that promise their content later. */
+export declare function aiLayoutPromisedCopyViolations(screen: {
+    sections: ReadonlyArray<{
+        name: string;
+    }>;
+}, found: ReadonlyArray<{
+    index: number;
+    line: string;
+}>): AiDoctrineViolation[];

package/src/lib/layout-language/ai-layout-promised-copy.js

@@ -0,0 +1,104 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * No section that promises its own content later (AGL-3887). A guided start
+ * publishes what it builds, so a section whose words say it is still being
+ * filled — "We are building this space for the words of families we have
+ * worked with", the live Whitmore Lane Family Law home of 2026-10-16 — is a
+ * stand-in a visitor reads as an unfinished site. A page answer holding one
+ * is asked again; the last answer a generation takes has the section taken
+ * out instead (`aiLayoutPageCheck`), its first section aside.
+ *
+ * Scoped to the page speaking of itself: "this space", "this section", the
+ * site's own reviews, photos or portfolio promised for later. "Coming soon"
+ * alone is never one: an event, a menu item or a new location is genuinely
+ * coming soon on a dated list. A coming-soon site, whose whole point is what
+ * is coming, is not held to it.
+ */ /** The violation code a section that promises its content later is named by. */ export const AI_LAYOUT_PROMISED_COPY_CODE = 'layout-promised-copy';
+/** What a site owes and may promise later: its customers' words, its pictures, its work. */ const OWED = '(?:testimonials?|reviews?|kind words|feedback|client stories|success stories|stories from (?:our )?\\w+|words from (?:our )?\\w+|photos|pictures|gallery|portfolio|case studies)';
+const PROMISED_COPY = [
+    // The page building itself: "We are building this space", "we're putting together this section".
+    /\b(?:we(?:['’]re| are)|we(?:['’]ll| will) be)\s+(?:still\s+)?(?:building|growing|gathering|collecting|putting together|working on|filling|adding to)\s+(?:this|the)\s+(?:space|section|page|area|corner)\b/i,
+    // "This space will soon…", "This section is being built", "This page is under construction".
+    /\bthis\s+(?:space|section|area|corner|page)\s+will\s+soon\b/i,
+    /\bthis\s+(?:space|section|area|corner|page)\s+is\s+(?:being\s+(?:built|filled|prepared)|(?:currently\s+)?under\s+construction|reserved\s+for|still\s+(?:empty|growing|being))\b/i,
+    /\bthis\s+(?:space|section|area|corner)\s+will\s+(?:hold|feature|carry|fill with|share|be filled|be home to)\b/i,
+    /\b(?:page|site|section|space|website)\s+(?:is\s+)?(?:currently\s+)?under\s+construction\b/i,
+    // What the site owes, promised for later: "Reviews coming soon", "photos are on their way".
+    new RegExp(`\\b${OWED}\\b[^.!?]{0,50}\\b(?:coming soon|on (?:the|its|their) way|to come|being (?:gathered|collected|added))\\b`, 'i'),
+    new RegExp(`\\b(?:coming soon|check back|stay tuned)\\b[^.!?]{0,60}\\b(?:${OWED}|this (?:space|section|page))\\b`, 'i'),
+    new RegExp(`\\b${OWED}\\b[^.!?]{0,60}\\b(?:check back|stay tuned)\\b`, 'i')
+];
+/** Whether a line promises the page's own content later, rather than saying it. */ export function aiLayoutPromisesContent(text) {
+    return PROMISED_COPY.some((pattern)=>pattern.test(text));
+}
+/** The props a node's own words are in, as a visitor reads them. */ const WORD_PROPS = [
+    'children',
+    'primary',
+    'secondary',
+    'label'
+];
+/** Every line a node and everything under it says. */ function linesUnder(nodes, id) {
+    const lines = [];
+    const seen = new Set();
+    const stack = [
+        id
+    ];
+    while(stack.length){
+        var _node_nodes;
+        const next = stack.pop();
+        const node = nodes[next];
+        if (!node || seen.has(next)) continue;
+        seen.add(next);
+        for (const prop of WORD_PROPS){
+            var _node_props;
+            const value = (_node_props = node.props) == null ? void 0 : _node_props[prop];
+            if (typeof value === 'string' && value.trim()) lines.push(value.trim());
+        }
+        stack.push(...(_node_nodes = node.nodes) != null ? _node_nodes : []);
+    }
+    return lines;
+}
+/**
+ * The plan indices of a built page's sections that promise their content
+ * later, each with the line that does, in page order.
+ */ export function aiLayoutPromisedSections(nodes, sectionIds) {
+    const map = nodes;
+    return sectionIds.flatMap((id, index)=>{
+        if (!id || !map[id]) return [];
+        const line = linesUnder(map, id).find(aiLayoutPromisesContent);
+        return line ? [
+            {
+                index,
+                line
+            }
+        ] : [];
+    });
+}
+/** The violation that asks again for the sections that promise their content later. */ export function aiLayoutPromisedCopyViolations(screen, found) {
+    return found.map(({ index, line })=>{
+        var _ref;
+        var _screen_sections_index;
+        return {
+            rule: 14,
+            code: AI_LAYOUT_PROMISED_COPY_CODE,
+            message: `Section ${index + 1} ("${(_ref = (_screen_sections_index = screen.sections[index]) == null ? void 0 : _screen_sections_index.name) != null ? _ref : ''}") promises content that is not there: "${line}". This site is published exactly as written.`,
+            detail: `Write section ${index + 1} about what is true now, in the site's voice: what working together is like, how the work goes, what a visitor can expect. Never say a space is being built or something is coming soon, and never write a review, testimonial or quote nobody gave.`
+        };
+    });
+}
+
+//# sourceMappingURL=ai-layout-promised-copy.js.map

package/src/lib/layout-language/ai-layout-promised-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-promised-copy.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { NodesMap } from '@aglyn/aglyn/types/nodes'\nimport type { AiDoctrineViolation } from '../runtime/ai-doctrine-validators'\n\n/**\n * No section that promises its own content later (AGL-3887). A guided start\n * publishes what it builds, so a section whose words say it is still being\n * filled — \"We are building this space for the words of families we have\n * worked with\", the live Whitmore Lane Family Law home of 2026-10-16 — is a\n * stand-in a visitor reads as an unfinished site. A page answer holding one\n * is asked again; the last answer a generation takes has the section taken\n * out instead (`aiLayoutPageCheck`), its first section aside.\n *\n * Scoped to the page speaking of itself: \"this space\", \"this section\", the\n * site's own reviews, photos or portfolio promised for later. \"Coming soon\"\n * alone is never one: an event, a menu item or a new location is genuinely\n * coming soon on a dated list. A coming-soon site, whose whole point is what\n * is coming, is not held to it.\n */\n\n/** The violation code a section that promises its content later is named by. */\nexport const AI_LAYOUT_PROMISED_COPY_CODE = 'layout-promised-copy'\n\n/** What a site owes and may promise later: its customers' words, its pictures, its work. */\nconst OWED =\n  '(?:testimonials?|reviews?|kind words|feedback|client stories|success stories|stories from (?:our )?\\\\w+|words from (?:our )?\\\\w+|photos|pictures|gallery|portfolio|case studies)'\n\nconst PROMISED_COPY: readonly RegExp[] = [\n  // The page building itself: \"We are building this space\", \"we're putting together this section\".\n  /\\b(?:we(?:['’]re| are)|we(?:['’]ll| will) be)\\s+(?:still\\s+)?(?:building|growing|gathering|collecting|putting together|working on|filling|adding to)\\s+(?:this|the)\\s+(?:space|section|page|area|corner)\\b/i,\n  // \"This space will soon…\", \"This section is being built\", \"This page is under construction\".\n  /\\bthis\\s+(?:space|section|area|corner|page)\\s+will\\s+soon\\b/i,\n  /\\bthis\\s+(?:space|section|area|corner|page)\\s+is\\s+(?:being\\s+(?:built|filled|prepared)|(?:currently\\s+)?under\\s+construction|reserved\\s+for|still\\s+(?:empty|growing|being))\\b/i,\n  /\\bthis\\s+(?:space|section|area|corner)\\s+will\\s+(?:hold|feature|carry|fill with|share|be filled|be home to)\\b/i,\n  /\\b(?:page|site|section|space|website)\\s+(?:is\\s+)?(?:currently\\s+)?under\\s+construction\\b/i,\n  // What the site owes, promised for later: \"Reviews coming soon\", \"photos are on their way\".\n  new RegExp(`\\\\b${OWED}\\\\b[^.!?]{0,50}\\\\b(?:coming soon|on (?:the|its|their) way|to come|being (?:gathered|collected|added))\\\\b`, 'i'),\n  new RegExp(`\\\\b(?:coming soon|check back|stay tuned)\\\\b[^.!?]{0,60}\\\\b(?:${OWED}|this (?:space|section|page))\\\\b`, 'i'),\n  new RegExp(`\\\\b${OWED}\\\\b[^.!?]{0,60}\\\\b(?:check back|stay tuned)\\\\b`, 'i'),\n]\n\n/** Whether a line promises the page's own content later, rather than saying it. */\nexport function aiLayoutPromisesContent(text: string): boolean {\n  return PROMISED_COPY.some((pattern) => pattern.test(text))\n}\n\ninterface WordNode {\n  componentId?: string\n  props?: Record<string, unknown>\n  nodes?: string[]\n}\n\n/** The props a node's own words are in, as a visitor reads them. */\nconst WORD_PROPS = ['children', 'primary', 'secondary', 'label'] as const\n\n/** Every line a node and everything under it says. */\nfunction linesUnder(nodes: Readonly<Record<string, WordNode>>, id: string): string[] {\n  const lines: string[] = []\n  const seen = new Set<string>()\n  const stack = [id]\n  while (stack.length) {\n    const next = stack.pop() as string\n    const node = nodes[next]\n    if (!node || seen.has(next)) continue\n    seen.add(next)\n    for (const prop of WORD_PROPS) {\n      const value = node.props?.[prop]\n      if (typeof value === 'string' && value.trim()) lines.push(value.trim())\n    }\n    stack.push(...(node.nodes ?? []))\n  }\n  return lines\n}\n\n/**\n * The plan indices of a built page's sections that promise their content\n * later, each with the line that does, in page order.\n */\nexport function aiLayoutPromisedSections(\n  nodes: NodesMap,\n  sectionIds: readonly string[],\n): Array<{ index: number; line: string }> {\n  const map = nodes as unknown as Readonly<Record<string, WordNode>>\n  return sectionIds.flatMap((id, index) => {\n    if (!id || !map[id]) return []\n    const line = linesUnder(map, id).find(aiLayoutPromisesContent)\n    return line ? [{ index, line }] : []\n  })\n}\n\n/** The violation that asks again for the sections that promise their content later. */\nexport function aiLayoutPromisedCopyViolations(\n  screen: { sections: ReadonlyArray<{ name: string }> },\n  found: ReadonlyArray<{ index: number; line: string }>,\n): AiDoctrineViolation[] {\n  return found.map(({ index, line }) => ({\n    rule: 14,\n    code: AI_LAYOUT_PROMISED_COPY_CODE,\n    message: `Section ${index + 1} (\"${screen.sections[index]?.name ?? ''}\") promises content that is not there: \"${line}\". This site is published exactly as written.`,\n    detail: `Write section ${index + 1} about what is true now, in the site's voice: what working together is like, how the work goes, what a visitor can expect. Never say a space is being built or something is coming soon, and never write a review, testimonial or quote nobody gave.`,\n  }))\n}\n"],"names":["AI_LAYOUT_PROMISED_COPY_CODE","OWED","PROMISED_COPY","RegExp","aiLayoutPromisesContent","text","some","pattern","test","WORD_PROPS","linesUnder","nodes","id","lines","seen","Set","stack","length","node","next","pop","has","add","prop","value","props","trim","push","aiLayoutPromisedSections","sectionIds","map","flatMap","index","line","find","aiLayoutPromisedCopyViolations","screen","found","rule","code","message","sections","name","detail"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAKD;;;;;;;;;;;;;;CAcC,GAED,8EAA8E,GAC9E,OAAO,MAAMA,+BAA+B,uBAAsB;AAElE,0FAA0F,GAC1F,MAAMC,OACJ;AAEF,MAAMC,gBAAmC;IACvC,iGAAiG;IACjG;IACA,6FAA6F;IAC7F;IACA;IACA;IACA;IACA,4FAA4F;IAC5F,IAAIC,OAAO,CAAC,GAAG,EAAEF,KAAK,wGAAwG,CAAC,EAAE;IACjI,IAAIE,OAAO,CAAC,6DAA6D,EAAEF,KAAK,gCAAgC,CAAC,EAAE;IACnH,IAAIE,OAAO,CAAC,GAAG,EAAEF,KAAK,8CAA8C,CAAC,EAAE;CACxE;AAED,iFAAiF,GACjF,OAAO,SAASG,wBAAwBC,IAAY;IAClD,OAAOH,cAAcI,IAAI,CAAC,CAACC,UAAYA,QAAQC,IAAI,CAACH;AACtD;AAQA,kEAAkE,GAClE,MAAMI,aAAa;IAAC;IAAY;IAAW;IAAa;CAAQ;AAEhE,oDAAoD,GACpD,SAASC,WAAWC,KAAyC,EAAEC,EAAU;IACvE,MAAMC,QAAkB,EAAE;IAC1B,MAAMC,OAAO,IAAIC;IACjB,MAAMC,QAAQ;QAACJ;KAAG;IAClB,MAAOI,MAAMC,MAAM,CAAE;YASJC;QARf,MAAMC,OAAOH,MAAMI,GAAG;QACtB,MAAMF,OAAOP,KAAK,CAACQ,KAAK;QACxB,IAAI,CAACD,QAAQJ,KAAKO,GAAG,CAACF,OAAO;QAC7BL,KAAKQ,GAAG,CAACH;QACT,KAAK,MAAMI,QAAQd,WAAY;gBACfS;YAAd,MAAMM,SAAQN,cAAAA,KAAKO,KAAK,qBAAVP,WAAY,CAACK,KAAK;YAChC,IAAI,OAAOC,UAAU,YAAYA,MAAME,IAAI,IAAIb,MAAMc,IAAI,CAACH,MAAME,IAAI;QACtE;QACAV,MAAMW,IAAI,KAAKT,cAAAA,KAAKP,KAAK,YAAVO,cAAc,EAAE;IACjC;IACA,OAAOL;AACT;AAEA;;;CAGC,GACD,OAAO,SAASe,yBACdjB,KAAe,EACfkB,UAA6B;IAE7B,MAAMC,MAAMnB;IACZ,OAAOkB,WAAWE,OAAO,CAAC,CAACnB,IAAIoB;QAC7B,IAAI,CAACpB,MAAM,CAACkB,GAAG,CAAClB,GAAG,EAAE,OAAO,EAAE;QAC9B,MAAMqB,OAAOvB,WAAWoB,KAAKlB,IAAIsB,IAAI,CAAC9B;QACtC,OAAO6B,OAAO;YAAC;gBAAED;gBAAOC;YAAK;SAAE,GAAG,EAAE;IACtC;AACF;AAEA,qFAAqF,GACrF,OAAO,SAASE,+BACdC,MAAqD,EACrDC,KAAqD;IAErD,OAAOA,MAAMP,GAAG,CAAC,CAAC,EAAEE,KAAK,EAAEC,IAAI,EAAE;;YAGIG;eAHE;YACrCE,MAAM;YACNC,MAAMvC;YACNwC,SAAS,CAAC,QAAQ,EAAER,QAAQ,EAAE,GAAG,WAAEI,yBAAAA,OAAOK,QAAQ,CAACT,MAAM,qBAAtBI,uBAAwBM,IAAI,mBAAI,GAAG,wCAAwC,EAAET,KAAK,6CAA6C,CAAC;YACnKU,QAAQ,CAAC,cAAc,EAAEX,QAAQ,EAAE,oPAAoP,CAAC;QAC1R;;AACF"}

package/src/lib/model/ai-brief-copy.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { AiEmailType } from '../jobs/ai-job-email-step';
+import type { AiJobKind } from './ai-jobs.types';
+import type { AiPageType } from './ai-page-job';
+import { type AiTemplateSubject } from './ai-template-subjects';
+/**
+ * WHAT EVERY "CREATE WITH AI" BRIEF SAYS AND SENDS (AGL-2907, AGL-3043,
+ * AGL-3051, AGL-3596): each kind's words, the choices beside the brief, and
+ * the job and inputs they start. Pure, so the console's brief dialog and the
+ * door the native apps read (AGL-3854) say the same thing from one place.
+ */
+/** The longest brief a job admits. */
+export declare const AI_BRIEF_MAX_CHARS = 4000;
+/** The job kinds a member describes from a console page. */
+export type AiBriefKind = Extract<AiJobKind, 'page' | 'template' | 'layout' | 'form' | 'component' | 'email' | 'campaign'>;
+/** What the dialog says for one kind. */
+export interface AiBriefCopy {
+    title: string;
+    /** The brief box's label. */
+    briefLabel: string;
+    placeholder: string;
+    /** What happens after the member starts the job, under the fields. */
+    next: string;
+    /** The action that starts the job. */
+    submit: string;
+    /** What the dialog says once the job exists, above its live status. */
+    started: string;
+    /** What it says when the door gave no reason, or could not be reached. */
+    failed: string;
+}
+export declare const AI_BRIEF_COPY: Readonly<Record<AiBriefKind, AiBriefCopy>>;
+/**
+ * The kinds of email a member picks from, as their chips name them. The jobs'
+ * own catalog (`AI_EMAIL_TYPES`) also holds `reply`, which only a job the
+ * platform composes sets, so it is not offered here.
+ */
+export declare const AI_EMAIL_TYPE_LABELS: Readonly<Record<Exclude<AiEmailType, 'reply'>, string>>;
+/** Each template subject as its chip names it: what one page is drawn for. */
+export declare const AI_TEMPLATE_SUBJECT_LABELS: Readonly<Record<AiTemplateSubject, string>>;
+/** What a member picked beside the brief; each kind reads only its own. */
+export interface AiBriefChoice {
+    /** A page's type, or `null` for none. */
+    pageType: AiPageType | null;
+    /** What a template's pages are drawn for, or `null` until one is picked. */
+    subject: AiTemplateSubject | null;
+    /** A collection entry template's collection, or `null` until one is picked. */
+    collectionId: string | null;
+    /** An email's or a campaign's kind of email; `null` or absent for none. */
+    emailType?: Exclude<AiEmailType, 'reply'> | null;
+    /** An email's door only: also draft the campaign that would send it. */
+    withCampaign?: boolean;
+}
+export declare const AI_BRIEF_NO_CHOICE: AiBriefChoice;
+/**
+ * The job the door starts: its own kind, except an email that also asked for
+ * its campaign, which is a `campaign` job — the campaign step writes the same
+ * design and drafts the campaign around it.
+ */
+export declare function aiBriefJobKind(kind: AiBriefKind, choice: AiBriefChoice): AiBriefKind;
+/**
+ * The job's `inputs` for what the member picked, or `null` while the kind's
+ * door would refuse them.
+ *
+ * A template's are read by the parser its door reads, so the dialog cannot
+ * send a subject the door does not know or an entry page with no collection.
+ * A page's type is optional, and so is an email's or a campaign's kind of
+ * email (`inputs.emailType`, which both steps read). A layout, a form and a component read no inputs
+ * at all (AGL-2909, AGL-2913, AGL-2908), so theirs are empty.
+ */
+export declare function aiBriefJobInputs(kind: AiBriefKind, choice: AiBriefChoice): Record<string, string> | null;

package/src/lib/model/ai-brief-copy.js

@@ -0,0 +1,152 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { parseAiTemplateJobInputs } from "./ai-template-subjects.js";
+/**
+ * WHAT EVERY "CREATE WITH AI" BRIEF SAYS AND SENDS (AGL-2907, AGL-3043,
+ * AGL-3051, AGL-3596): each kind's words, the choices beside the brief, and
+ * the job and inputs they start. Pure, so the console's brief dialog and the
+ * door the native apps read (AGL-3854) say the same thing from one place.
+ */ /** The longest brief a job admits. */ export const AI_BRIEF_MAX_CHARS = 4000;
+export const AI_BRIEF_COPY = {
+    page: {
+        title: 'Describe a page',
+        briefLabel: 'What is the page for?',
+        placeholder: 'A landing page for our spring roof inspection offer, with the quote request form',
+        next: 'A plan comes first, and nothing is built until you confirm it. The page uses your ' + 'theme and what the site already has, and the plan lists anything the job builds first.',
+        submit: 'Plan the page',
+        started: 'The page is being planned. Review the plan here or in AI jobs, and confirm it to ' + 'build. The page is built as an unpublished draft.',
+        failed: 'The page could not be started. Try again.'
+    },
+    template: {
+        title: 'Describe a page template',
+        briefLabel: 'What should each page show?',
+        placeholder: 'A page for each of our team members: their name and photo, their role, a short ' + 'biography and a way to get in touch',
+        next: 'A plan comes first, and nothing is built until you confirm it. What changes from one ' + 'page to the next, such as a name or a photo, is filled in from each record rather ' + 'than typed.',
+        submit: 'Plan the template',
+        started: 'The template is being planned. Review the plan here or in AI jobs, and confirm it ' + 'to build. The template is built as a draft in your library, and nothing on your ' + 'site uses it until you do.',
+        failed: 'The template could not be started. Try again.'
+    },
+    layout: {
+        title: 'Describe a layout',
+        briefLabel: 'What should the layout hold?',
+        placeholder: 'A header with our name and links to Services, About and Contact, and a footer with ' + 'our address and opening hours',
+        next: 'A plan comes first, and nothing is built until you confirm it. The layout links your ' + 'pages, and places your navigation or menu component when the site has one.',
+        submit: 'Plan the layout',
+        started: 'The layout is being planned. Review the plan here or in AI jobs, and confirm it to ' + 'build. The layout is built as a draft, and no page uses it until you assign it.',
+        failed: 'The layout could not be started. Try again.'
+    },
+    form: {
+        title: 'Describe a form',
+        briefLabel: 'What is the form for?',
+        placeholder: 'A quote request form for a roofing company, asking what needs fixing and the best ' + 'time to call',
+        next: 'A plan comes first, and nothing is built until you confirm it. The form’s fields, its ' + 'marketing consent and where each submission goes are planned together.',
+        submit: 'Plan the form',
+        started: 'The form is being planned. Review the plan here or in AI jobs, and confirm it to ' + 'build. The form is built as a draft, and it collects nothing until you place it on ' + 'a page.',
+        failed: 'The form could not be started. Try again.'
+    },
+    component: {
+        title: 'Describe a reusable component',
+        briefLabel: 'What should the component show?',
+        placeholder: 'A testimonial card with the customer’s name, their role, their quote and a photo',
+        next: 'A plan comes first, and nothing is built until you confirm it. What each page can ' + 'change, such as a name or a photo, becomes a property of the component.',
+        submit: 'Plan the component',
+        started: 'The component is being planned. Review the plan here or in AI jobs, and confirm it ' + 'to build. The component is built as a draft, and no page shows it until you insert ' + 'it.',
+        failed: 'The component could not be started. Try again.'
+    },
+    email: {
+        title: 'Describe an email',
+        briefLabel: 'What is the email for?',
+        placeholder: 'Announce the autumn menu to our regulars, and point them at the class page to book ' + 'the Tuesday bread class',
+        next: 'A plan comes first, and nothing is built until you confirm it. The email is built ' + 'from email blocks, with three subject lines and three preheaders to choose from. ' + 'Nothing is sent or scheduled.',
+        submit: 'Plan the email',
+        started: 'The email is being planned. Review the plan here or in AI jobs, and confirm it to ' + 'build. The email is saved as a draft template, and nothing sends it until a ' + 'campaign does.',
+        failed: 'The email could not be started. Try again.'
+    },
+    campaign: {
+        title: 'Describe a campaign',
+        briefLabel: 'What is the campaign’s email for?',
+        placeholder: 'Announce the autumn menu to our regulars, and point them at the class page to book ' + 'the Tuesday bread class',
+        next: 'A plan comes first, and nothing is built until you confirm it. The job writes the ' + 'email and a draft campaign that would send it. The campaign is aimed at nobody and ' + 'sends nothing until you pick who receives it and schedule it.',
+        submit: 'Plan the campaign',
+        started: 'The campaign is being planned. Review the plan here or in AI jobs, and confirm it ' + 'to build. The email and the campaign are saved as drafts, and nothing is sent.',
+        failed: 'The campaign could not be started. Try again.'
+    }
+};
+/**
+ * The kinds of email a member picks from, as their chips name them. The jobs'
+ * own catalog (`AI_EMAIL_TYPES`) also holds `reply`, which only a job the
+ * platform composes sets, so it is not offered here.
+ */ export const AI_EMAIL_TYPE_LABELS = {
+    welcome: 'Welcome',
+    newsletter: 'Newsletter',
+    launch: 'Launch',
+    abandonedCart: 'Cart reminder',
+    eventReminder: 'Event reminder'
+};
+/** Each template subject as its chip names it: what one page is drawn for. */ export const AI_TEMPLATE_SUBJECT_LABELS = {
+    entry: 'Collection entry',
+    product: 'Product',
+    author: 'Author'
+};
+export const AI_BRIEF_NO_CHOICE = {
+    pageType: null,
+    subject: null,
+    collectionId: null,
+    emailType: null,
+    withCampaign: false
+};
+/**
+ * The job the door starts: its own kind, except an email that also asked for
+ * its campaign, which is a `campaign` job — the campaign step writes the same
+ * design and drafts the campaign around it.
+ */ export function aiBriefJobKind(kind, choice) {
+    return kind === 'email' && choice.withCampaign ? 'campaign' : kind;
+}
+/**
+ * The job's `inputs` for what the member picked, or `null` while the kind's
+ * door would refuse them.
+ *
+ * A template's are read by the parser its door reads, so the dialog cannot
+ * send a subject the door does not know or an entry page with no collection.
+ * A page's type is optional, and so is an email's or a campaign's kind of
+ * email (`inputs.emailType`, which both steps read). A layout, a form and a component read no inputs
+ * at all (AGL-2909, AGL-2913, AGL-2908), so theirs are empty.
+ */ export function aiBriefJobInputs(kind, choice) {
+    if (kind === 'page') return choice.pageType ? {
+        pageType: choice.pageType
+    } : {};
+    if (kind === 'email' || kind === 'campaign') {
+        return choice.emailType ? {
+            emailType: choice.emailType
+        } : {};
+    }
+    if (kind === 'template') {
+        const inputs = parseAiTemplateJobInputs({
+            subject: choice.subject,
+            collectionId: choice.collectionId
+        });
+        if (typeof inputs === 'string') return null;
+        return inputs.collectionId ? {
+            subject: inputs.subject,
+            collectionId: inputs.collectionId
+        } : {
+            subject: inputs.subject
+        };
+    }
+    return {};
+}
+
+//# sourceMappingURL=ai-brief-copy.js.map

package/src/lib/model/ai-brief-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-brief-copy.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { AiEmailType } from '../jobs/ai-job-email-step'\nimport type { AiJobKind } from './ai-jobs.types'\nimport type { AiPageType } from './ai-page-job'\nimport { parseAiTemplateJobInputs, type AiTemplateSubject } from './ai-template-subjects'\n\n/**\n * WHAT EVERY \"CREATE WITH AI\" BRIEF SAYS AND SENDS (AGL-2907, AGL-3043,\n * AGL-3051, AGL-3596): each kind's words, the choices beside the brief, and\n * the job and inputs they start. Pure, so the console's brief dialog and the\n * door the native apps read (AGL-3854) say the same thing from one place.\n */\n\n/** The longest brief a job admits. */\nexport const AI_BRIEF_MAX_CHARS = 4_000\n\n/** The job kinds a member describes from a console page. */\nexport type AiBriefKind = Extract<\n  AiJobKind,\n  'page' | 'template' | 'layout' | 'form' | 'component' | 'email' | 'campaign'\n>\n\n/** What the dialog says for one kind. */\nexport interface AiBriefCopy {\n  title: string\n  /** The brief box's label. */\n  briefLabel: string\n  placeholder: string\n  /** What happens after the member starts the job, under the fields. */\n  next: string\n  /** The action that starts the job. */\n  submit: string\n  /** What the dialog says once the job exists, above its live status. */\n  started: string\n  /** What it says when the door gave no reason, or could not be reached. */\n  failed: string\n}\n\nexport const AI_BRIEF_COPY: Readonly<Record<AiBriefKind, AiBriefCopy>> = {\n  page: {\n    title: 'Describe a page',\n    briefLabel: 'What is the page for?',\n    placeholder:\n      'A landing page for our spring roof inspection offer, with the quote request form',\n    next:\n      'A plan comes first, and nothing is built until you confirm it. The page uses your ' +\n      'theme and what the site already has, and the plan lists anything the job builds first.',\n    submit: 'Plan the page',\n    started:\n      'The page is being planned. Review the plan here or in AI jobs, and confirm it to ' +\n      'build. The page is built as an unpublished draft.',\n    failed: 'The page could not be started. Try again.',\n  },\n  template: {\n    title: 'Describe a page template',\n    briefLabel: 'What should each page show?',\n    placeholder:\n      'A page for each of our team members: their name and photo, their role, a short ' +\n      'biography and a way to get in touch',\n    next:\n      'A plan comes first, and nothing is built until you confirm it. What changes from one ' +\n      'page to the next, such as a name or a photo, is filled in from each record rather ' +\n      'than typed.',\n    submit: 'Plan the template',\n    started:\n      'The template is being planned. Review the plan here or in AI jobs, and confirm it ' +\n      'to build. The template is built as a draft in your library, and nothing on your ' +\n      'site uses it until you do.',\n    failed: 'The template could not be started. Try again.',\n  },\n  layout: {\n    title: 'Describe a layout',\n    briefLabel: 'What should the layout hold?',\n    placeholder:\n      'A header with our name and links to Services, About and Contact, and a footer with ' +\n      'our address and opening hours',\n    next:\n      'A plan comes first, and nothing is built until you confirm it. The layout links your ' +\n      'pages, and places your navigation or menu component when the site has one.',\n    submit: 'Plan the layout',\n    started:\n      'The layout is being planned. Review the plan here or in AI jobs, and confirm it to ' +\n      'build. The layout is built as a draft, and no page uses it until you assign it.',\n    failed: 'The layout could not be started. Try again.',\n  },\n  form: {\n    title: 'Describe a form',\n    briefLabel: 'What is the form for?',\n    placeholder:\n      'A quote request form for a roofing company, asking what needs fixing and the best ' +\n      'time to call',\n    next:\n      'A plan comes first, and nothing is built until you confirm it. The form’s fields, its ' +\n      'marketing consent and where each submission goes are planned together.',\n    submit: 'Plan the form',\n    started:\n      'The form is being planned. Review the plan here or in AI jobs, and confirm it to ' +\n      'build. The form is built as a draft, and it collects nothing until you place it on ' +\n      'a page.',\n    failed: 'The form could not be started. Try again.',\n  },\n  component: {\n    title: 'Describe a reusable component',\n    briefLabel: 'What should the component show?',\n    placeholder:\n      'A testimonial card with the customer’s name, their role, their quote and a photo',\n    next:\n      'A plan comes first, and nothing is built until you confirm it. What each page can ' +\n      'change, such as a name or a photo, becomes a property of the component.',\n    submit: 'Plan the component',\n    started:\n      'The component is being planned. Review the plan here or in AI jobs, and confirm it ' +\n      'to build. The component is built as a draft, and no page shows it until you insert ' +\n      'it.',\n    failed: 'The component could not be started. Try again.',\n  },\n  email: {\n    title: 'Describe an email',\n    briefLabel: 'What is the email for?',\n    placeholder:\n      'Announce the autumn menu to our regulars, and point them at the class page to book ' +\n      'the Tuesday bread class',\n    next:\n      'A plan comes first, and nothing is built until you confirm it. The email is built ' +\n      'from email blocks, with three subject lines and three preheaders to choose from. ' +\n      'Nothing is sent or scheduled.',\n    submit: 'Plan the email',\n    started:\n      'The email is being planned. Review the plan here or in AI jobs, and confirm it to ' +\n      'build. The email is saved as a draft template, and nothing sends it until a ' +\n      'campaign does.',\n    failed: 'The email could not be started. Try again.',\n  },\n  campaign: {\n    title: 'Describe a campaign',\n    briefLabel: 'What is the campaign’s email for?',\n    placeholder:\n      'Announce the autumn menu to our regulars, and point them at the class page to book ' +\n      'the Tuesday bread class',\n    next:\n      'A plan comes first, and nothing is built until you confirm it. The job writes the ' +\n      'email and a draft campaign that would send it. The campaign is aimed at nobody and ' +\n      'sends nothing until you pick who receives it and schedule it.',\n    submit: 'Plan the campaign',\n    started:\n      'The campaign is being planned. Review the plan here or in AI jobs, and confirm it ' +\n      'to build. The email and the campaign are saved as drafts, and nothing is sent.',\n    failed: 'The campaign could not be started. Try again.',\n  },\n}\n\n/**\n * The kinds of email a member picks from, as their chips name them. The jobs'\n * own catalog (`AI_EMAIL_TYPES`) also holds `reply`, which only a job the\n * platform composes sets, so it is not offered here.\n */\nexport const AI_EMAIL_TYPE_LABELS: Readonly<Record<Exclude<AiEmailType, 'reply'>, string>> = {\n  welcome: 'Welcome',\n  newsletter: 'Newsletter',\n  launch: 'Launch',\n  abandonedCart: 'Cart reminder',\n  eventReminder: 'Event reminder',\n}\n\n/** Each template subject as its chip names it: what one page is drawn for. */\nexport const AI_TEMPLATE_SUBJECT_LABELS: Readonly<Record<AiTemplateSubject, string>> = {\n  entry: 'Collection entry',\n  product: 'Product',\n  author: 'Author',\n}\n\n/** What a member picked beside the brief; each kind reads only its own. */\nexport interface AiBriefChoice {\n  /** A page's type, or `null` for none. */\n  pageType: AiPageType | null\n  /** What a template's pages are drawn for, or `null` until one is picked. */\n  subject: AiTemplateSubject | null\n  /** A collection entry template's collection, or `null` until one is picked. */\n  collectionId: string | null\n  /** An email's or a campaign's kind of email; `null` or absent for none. */\n  emailType?: Exclude<AiEmailType, 'reply'> | null\n  /** An email's door only: also draft the campaign that would send it. */\n  withCampaign?: boolean\n}\n\nexport const AI_BRIEF_NO_CHOICE: AiBriefChoice = {\n  pageType: null,\n  subject: null,\n  collectionId: null,\n  emailType: null,\n  withCampaign: false,\n}\n\n/**\n * The job the door starts: its own kind, except an email that also asked for\n * its campaign, which is a `campaign` job — the campaign step writes the same\n * design and drafts the campaign around it.\n */\nexport function aiBriefJobKind(kind: AiBriefKind, choice: AiBriefChoice): AiBriefKind {\n  return kind === 'email' && choice.withCampaign ? 'campaign' : kind\n}\n\n/**\n * The job's `inputs` for what the member picked, or `null` while the kind's\n * door would refuse them.\n *\n * A template's are read by the parser its door reads, so the dialog cannot\n * send a subject the door does not know or an entry page with no collection.\n * A page's type is optional, and so is an email's or a campaign's kind of\n * email (`inputs.emailType`, which both steps read). A layout, a form and a component read no inputs\n * at all (AGL-2909, AGL-2913, AGL-2908), so theirs are empty.\n */\nexport function aiBriefJobInputs(\n  kind: AiBriefKind,\n  choice: AiBriefChoice,\n): Record<string, string> | null {\n  if (kind === 'page') return choice.pageType ? { pageType: choice.pageType } : {}\n  if (kind === 'email' || kind === 'campaign') {\n    return choice.emailType ? { emailType: choice.emailType } : {}\n  }\n  if (kind === 'template') {\n    const inputs = parseAiTemplateJobInputs({\n      subject: choice.subject,\n      collectionId: choice.collectionId,\n    })\n    if (typeof inputs === 'string') return null\n    return inputs.collectionId\n      ? { subject: inputs.subject, collectionId: inputs.collectionId }\n      : { subject: inputs.subject }\n  }\n  return {}\n}\n"],"names":["parseAiTemplateJobInputs","AI_BRIEF_MAX_CHARS","AI_BRIEF_COPY","page","title","briefLabel","placeholder","next","submit","started","failed","template","layout","form","component","email","campaign","AI_EMAIL_TYPE_LABELS","welcome","newsletter","launch","abandonedCart","eventReminder","AI_TEMPLATE_SUBJECT_LABELS","entry","product","author","AI_BRIEF_NO_CHOICE","pageType","subject","collectionId","emailType","withCampaign","aiBriefJobKind","kind","choice","aiBriefJobInputs","inputs"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAKD,SAASA,wBAAwB,QAAgC,4BAAwB;AAEzF;;;;;CAKC,GAED,oCAAoC,GACpC,OAAO,MAAMC,qBAAqB,KAAK;AAwBvC,OAAO,MAAMC,gBAA4D;IACvEC,MAAM;QACJC,OAAO;QACPC,YAAY;QACZC,aACE;QACFC,MACE,uFACA;QACFC,QAAQ;QACRC,SACE,sFACA;QACFC,QAAQ;IACV;IACAC,UAAU;QACRP,OAAO;QACPC,YAAY;QACZC,aACE,oFACA;QACFC,MACE,0FACA,uFACA;QACFC,QAAQ;QACRC,SACE,uFACA,qFACA;QACFC,QAAQ;IACV;IACAE,QAAQ;QACNR,OAAO;QACPC,YAAY;QACZC,aACE,wFACA;QACFC,MACE,0FACA;QACFC,QAAQ;QACRC,SACE,wFACA;QACFC,QAAQ;IACV;IACAG,MAAM;QACJT,OAAO;QACPC,YAAY;QACZC,aACE,uFACA;QACFC,MACE,2FACA;QACFC,QAAQ;QACRC,SACE,sFACA,wFACA;QACFC,QAAQ;IACV;IACAI,WAAW;QACTV,OAAO;QACPC,YAAY;QACZC,aACE;QACFC,MACE,uFACA;QACFC,QAAQ;QACRC,SACE,wFACA,wFACA;QACFC,QAAQ;IACV;IACAK,OAAO;QACLX,OAAO;QACPC,YAAY;QACZC,aACE,wFACA;QACFC,MACE,uFACA,sFACA;QACFC,QAAQ;QACRC,SACE,uFACA,iFACA;QACFC,QAAQ;IACV;IACAM,UAAU;QACRZ,OAAO;QACPC,YAAY;QACZC,aACE,wFACA;QACFC,MACE,uFACA,wFACA;QACFC,QAAQ;QACRC,SACE,uFACA;QACFC,QAAQ;IACV;AACF,EAAC;AAED;;;;CAIC,GACD,OAAO,MAAMO,uBAAgF;IAC3FC,SAAS;IACTC,YAAY;IACZC,QAAQ;IACRC,eAAe;IACfC,eAAe;AACjB,EAAC;AAED,4EAA4E,GAC5E,OAAO,MAAMC,6BAA0E;IACrFC,OAAO;IACPC,SAAS;IACTC,QAAQ;AACV,EAAC;AAgBD,OAAO,MAAMC,qBAAoC;IAC/CC,UAAU;IACVC,SAAS;IACTC,cAAc;IACdC,WAAW;IACXC,cAAc;AAChB,EAAC;AAED;;;;CAIC,GACD,OAAO,SAASC,eAAeC,IAAiB,EAAEC,MAAqB;IACrE,OAAOD,SAAS,WAAWC,OAAOH,YAAY,GAAG,aAAaE;AAChE;AAEA;;;;;;;;;CASC,GACD,OAAO,SAASE,iBACdF,IAAiB,EACjBC,MAAqB;IAErB,IAAID,SAAS,QAAQ,OAAOC,OAAOP,QAAQ,GAAG;QAAEA,UAAUO,OAAOP,QAAQ;IAAC,IAAI,CAAC;IAC/E,IAAIM,SAAS,WAAWA,SAAS,YAAY;QAC3C,OAAOC,OAAOJ,SAAS,GAAG;YAAEA,WAAWI,OAAOJ,SAAS;QAAC,IAAI,CAAC;IAC/D;IACA,IAAIG,SAAS,YAAY;QACvB,MAAMG,SAASrC,yBAAyB;YACtC6B,SAASM,OAAON,OAAO;YACvBC,cAAcK,OAAOL,YAAY;QACnC;QACA,IAAI,OAAOO,WAAW,UAAU,OAAO;QACvC,OAAOA,OAAOP,YAAY,GACtB;YAAED,SAASQ,OAAOR,OAAO;YAAEC,cAAcO,OAAOP,YAAY;QAAC,IAC7D;YAAED,SAASQ,OAAOR,OAAO;QAAC;IAChC;IACA,OAAO,CAAC;AACV"}

package/src/lib/model/ai-create-view.d.ts

@@ -0,0 +1,200 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type AiBriefCopy } from './ai-brief-copy';
+import { AI_JOB_FOLLOW_PHASE_LINES, type AiFollowTone, type AiJobPhase } from './ai-job-activity';
+import { type AiJobOutput, type AiJobSummary } from './ai-jobs.types';
+import { type AiFreeCreditsLeft } from './ai-site-job';
+import type { AiTemplateCollectionOption } from './ai-template-collections';
+/**
+ * "CREATE WITH AI" AS THE NATIVE APPS DRAW IT (AGL-3854): the door a list's
+ * Create with AI button reads, and the follow view of the job it starts.
+ *
+ * The console decides each entry from gates its shell already resolved — the
+ * plan and the add-on it could buy, `ai.generate`, the release flag and the
+ * site's AI switch — and draws the brief and the job from the plugin's own
+ * components. An app has neither the shell nor the components, so the AI
+ * plugin's `/api/ai/create` door answers both as data: whether the entry is
+ * drawn and as what, every word the brief dialog says, and the job as the
+ * dialog's follow card reads it, in sentences built here from the same models
+ * the console's components read. Nothing here decides what a request may do:
+ * the jobs route's own ladder still decides each start, confirm and cancel.
+ */
+/** The lists the apps offer Create with AI on, beside their own create action. */
+export declare const AI_CREATE_KINDS: readonly ["page", "template", "layout", "form", "component"];
+export type AiCreateKind = (typeof AI_CREATE_KINDS)[number];
+export declare function isAiCreateKind(value: unknown): value is AiCreateKind;
+/** One row of chips beside the brief, and the input the pick is sent as. */
+export interface AiCreateChoiceView {
+    /** The `inputs` key the pick is sent under. */
+    key: 'pageType' | 'subject';
+    label: string;
+    /** A required pick keeps the start disabled until one is made; an optional one clears when pressed again. */
+    required: boolean;
+    options: Array<{
+        id: string;
+        label: string;
+    }>;
+}
+/** A template's collection field, shown once "Collection entry" is picked. */
+export interface AiCreateCollectionsView {
+    /** The subject the field belongs to. */
+    when: 'entry';
+    label: string;
+    options: AiTemplateCollectionOption[];
+    helper: string;
+}
+/** What is left of the month's AI credits, said before a brief is sent. */
+export interface AiCreateCreditsView {
+    text: string;
+    /** Nothing is left and the workspace stops at its band, so a start is refused until credits return. */
+    exhausted: boolean;
+}
+/** The add-on's offer, on a plan that could buy it and has not (AGL-3601). */
+export interface AiCreateUpsellView {
+    title: string;
+    does: string;
+    offer: string;
+    /** The reader may add the add-on (`billing.manage`); the action is drawn only then. */
+    canManageBilling: boolean;
+    /** "Add Aglyn AI", or `null` for a reader who cannot. */
+    action: string | null;
+    dismiss: string;
+}
+export interface AiCreateDoorView {
+    kind: AiCreateKind;
+    /** `create`: the brief; `upsell`: the add-on's offer; `hidden`: the entry is not drawn. */
+    door: 'create' | 'upsell' | 'hidden';
+    /** The entry's label, "Create with AI". */
+    label: string;
+    copy: AiBriefCopy | null;
+    briefMaxChars: number;
+    choices: AiCreateChoiceView[];
+    collections: AiCreateCollectionsView | null;
+    credits: AiCreateCreditsView | null;
+    /** Another page already being built on this site (AGL-3765): a warning, not a stop. */
+    building: string | null;
+    upsell: AiCreateUpsellView | null;
+}
+/** What the door knows about the month's credits. */
+export type AiCreateCreditsFacts = {
+    kind: 'free';
+    left: AiFreeCreditsLeft;
+} | {
+    kind: 'band';
+    used: number;
+    limit: number;
+    remaining: number;
+    stopsAtBand: boolean;
+} | {
+    kind: 'unlimited';
+} | {
+    kind: 'none';
+};
+/** The credits line above the brief, or `null` where the workspace has no band to read. */
+export declare function aiCreateCreditsView(facts: AiCreateCreditsFacts): AiCreateCreditsView | null;
+/** The chips each kind offers beside its brief, as the console's dialog draws them. */
+export declare function aiCreateChoices(kind: AiCreateKind): AiCreateChoiceView[];
+export interface AiCreateDoorInput {
+    kind: AiCreateKind;
+    /** The gates that draw no entry at all: `ai.generate`, the release flag, the site's AI switch. */
+    shown: boolean;
+    /** The plan carries `aiGenerative`. */
+    entitled: boolean;
+    /** The workspace could buy the add-on that grants it, and the add-on store is open to it. */
+    purchasable: boolean;
+    canManageBilling: boolean;
+    credits: AiCreateCreditsFacts;
+    /** The site's content collections, read only for a template's door. */
+    collections?: {
+        status: 'success' | 'error';
+        options: AiTemplateCollectionOption[];
+    } | null;
+    /** Another page build in flight on the site, for a page's door. */
+    buildInFlight?: boolean;
+    addonName: string;
+}
+/** The door one list's Create with AI reads. */
+export declare function aiCreateDoorView(input: AiCreateDoorInput): AiCreateDoorView;
+export { AI_JOB_FOLLOW_PHASE_LINES, type AiFollowTone };
+/**
+ * Where one output opens in an app, as the console addresses the apps' link
+ * resolver answers natively: a page opens its page (the console's preview
+ * address, which the apps' Pages claims), a component, layout or template its
+ * details, and anything else the page its owner publishes through the
+ * record-route seam (a form's own page). `besigner` is the version the job
+ * wrote, opened in the Besigner. `null` where the output has no page of its own,
+ * names no site, or its owner is not loaded.
+ */
+export declare function aiJobOutputAppLinks(output: Pick<AiJobOutput, 'resource' | 'id' | 'versionId' | 'hostSubdomain'>, orgSlug: string): {
+    detail: string;
+    besigner: string | null;
+} | null;
+/** The one thing a finished job leads with, as the console's `aiJobPrimaryLink` picks it. */
+export interface AiJobFollowOpen {
+    label: string;
+    detail: string;
+    besigner: string | null;
+}
+export declare function aiJobFollowOpen(job: Pick<AiJobSummary, 'status' | 'outputs'>, orgSlug: string): AiJobFollowOpen | null;
+export interface AiJobFollowView {
+    id: string;
+    kind: string;
+    status: string;
+    hostId: string | null;
+    phase: AiJobPhase;
+    phaseLabel: string;
+    line: {
+        tone: AiFollowTone;
+        text: string;
+    };
+    /** Still moving, so the apps read it again shortly. */
+    moving: boolean;
+    /** Finished, failed or canceled: nothing more happens to it. */
+    settled: boolean;
+    /** "2 of 3 steps", for a job of more than one step. */
+    steps: string | null;
+    plan: {
+        heading: string;
+        lines: string[];
+    } | null;
+    /** The building rules a refused answer broke, as a member reads them. */
+    findings: string[];
+    /** The checks' own sentence on a refused answer, for staff. */
+    detail: string | null;
+    /** The plan's estimated cost, read before it is confirmed. */
+    estimate: string | null;
+    retryRefusal: string | null;
+    /** "Confirm plan" or "Try again" while the job waits for the person. */
+    confirm: {
+        label: string;
+        enabled: boolean;
+    } | null;
+    /** Another page build in flight on the site, said beside Confirm (AGL-3765). */
+    building: string | null;
+    /** Why a stopped job has nothing to show. */
+    problem: string | null;
+    /** What the job spent so far. */
+    spent: string | null;
+    open: AiJobFollowOpen | null;
+}
+/** The follow card's view of one job, for the apps (the console's `AiJobFollow` and `AiJobPlan`). */
+export declare function aiJobFollowView(job: AiJobSummary, options?: {
+    orgSlug?: string | null;
+    staff?: boolean;
+    buildInFlight?: boolean;
+    now?: number;
+}): AiJobFollowView;