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

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;