@aglyn/plugins-ai 1.0.0-beta.230 → 1.0.0-beta.232

package/src/lib/model/ai-site-start.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-start.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 {\n  AI_SITE_INPUT_MAX_CHARS,\n  AI_SITE_SUBMISSIONS,\n  aiSitePagesBand,\n  type AiSiteJobInputs,\n  type AiSiteSubmissions,\n} from './ai-site-job'\n\n/**\n * The guided start (AGL-2918): the questions a person answers on a site they\n * have just made, and the site job those answers become.\n *\n * A scaffold already exists — the `site` job plans four to eight pages, a\n * layout, a contact form, a palette and a welcome email, and builds every one\n * of them as a draft. What it had no way in through was a brief: somebody had\n * to know what to write, on a site where nothing has happened yet. So this\n * module is the QUESTIONS, and nothing else: what is asked, what an answer may\n * be, and how a set of answers becomes the brief and the scalar inputs the\n * `site` door already takes.\n *\n * ── Answering is never the way out ───────────────────────────────────────\n *\n * There is no answer here that means \"not this\". The way past the questions\n * is the `hostFirstRun` zone's own `startBlank`, which is drawn beside them\n * from the first one and creates nothing at all — see the zone in\n * `CONSOLE_WIDGET_SLOTS`. Putting the exit inside the question set would make\n * leaving a thing you answer your way to, and it is not.\n *\n * ── Every answer but the first is optional ───────────────────────────────\n *\n * Only what a site is FOR has no default worth guessing. The audience narrows\n * the copy, the example steers the shape, the page count and the welcome\n * email are defaults a person may change — so a person who types six words\n * and confirms gets a planned site, and the rest of the questions are there\n * for the person who wants to answer them.\n *\n * Pure: shapes, vocabularies and two string builders. No React, no network,\n * and no import of the starter catalog — {@link AI_SITE_START_EXAMPLES} names\n * the starters rather than reading them, so the console does not carry a\n * catalog of node maps to draw five cards. `ai-site-start.spec.ts` holds the\n * two lists to each other.\n */\n\n/** A worked example a person picks to steer what the site should look like. */\nexport interface AiSiteStartExample {\n  /** A `STARTER_TEMPLATES` id, which is a persisted identifier. */\n  id: string\n  /** The starter as its card names it. */\n  label: string\n  /** The starter's category, which is how the examples group. */\n  category: string\n  /** What the example is, in one line a person reads before picking it. */\n  blurb: string\n}\n\n/**\n * The examples the start offers, in the order they are shown. The platform's\n * own starter sites: a person who has no words for what they want has seen\n * these five shapes before, and picking one says more than a sentence would.\n */\nexport const AI_SITE_START_EXAMPLES: readonly AiSiteStartExample[] = [\n  {\n    id: 'business',\n    label: 'Business',\n    category: 'Business',\n    blurb: 'A home page led by what you do, an about page and a contact page',\n  },\n  {\n    id: 'landing',\n    label: 'Landing Page',\n    category: 'Marketing',\n    blurb: 'One page that leads to one action, with the reasons to take it',\n  },\n  {\n    id: 'portfolio',\n    label: 'Portfolio',\n    category: 'Personal',\n    blurb: 'An introduction, a grid of work and a way to get in touch',\n  },\n  {\n    id: 'physical-shop',\n    label: 'Shop (physical products)',\n    category: 'Commerce',\n    blurb: 'Featured products, a shop to browse, and a cart',\n  },\n  {\n    id: 'digital-shop',\n    label: 'Shop (digital products)',\n    category: 'Commerce',\n    blurb: 'Downloads up front, a shop to browse, and a cart',\n  },\n]\n\n/**\n * Kinds of site offered beside the first question's box, so answering it can\n * be a tap. They fill the box rather than replacing it: what somebody is\n * building is theirs to say, and a list of eight is a list somebody is not on.\n */\nexport const AI_SITE_START_TYPES: readonly string[] = [\n  'a local service business',\n  'a restaurant or cafe',\n  'a professional practice',\n  'a trades business',\n  'a shop',\n  'a nonprofit',\n  'a personal portfolio',\n  'an event',\n]\n\n/** What a person answered; the shape the card holds and the brief is built from. */\nexport interface AiSiteStartAnswers {\n  /** What kind of site this is. The one answer with no default. */\n  siteType: string\n  /** Who the site is for; empty when they did not say. */\n  audience: string\n  /** The example they liked, by {@link AiSiteStartExample.id}; `null` for none. */\n  example: string | null\n  /** How many pages to plan. */\n  pages: number\n  /** Where the contact form's submissions go. */\n  submissions: AiSiteSubmissions\n  /** Whether the scaffold also drafts a welcome email. */\n  welcomeEmail: boolean\n}\n\n/**\n * What the questions start on. Five pages because it is the middle of the\n * band the scaffold builds, a welcome email because the scaffold drafts one\n * unless it is told not to, and the Inbox because it is what every submission\n * does anyway — filing a lead as well is the addition, and an addition is the\n * thing a person should have to choose.\n */\nexport const AI_SITE_START_ANSWERS: AiSiteStartAnswers = {\n  siteType: '',\n  audience: '',\n  example: null,\n  pages: 5,\n  submissions: 'inbox',\n  welcomeEmail: true,\n}\n\n/** The example an answer names, or `null` when it names none this list knows. */\nexport function aiSiteStartExample(\n  answers: AiSiteStartAnswers,\n): AiSiteStartExample | null {\n  if (!answers.example) return null\n  return AI_SITE_START_EXAMPLES.find((entry) => entry.id === answers.example) ?? null\n}\n\n/**\n * Why these answers cannot start a site, in a sentence a person reads; `null`\n * when they can. The door's own parser is what actually admits the job — this\n * is what the card says before it asks for one.\n */\nexport function aiSiteStartRefusal(\n  answers: AiSiteStartAnswers,\n  options: { freeTaste?: boolean } = {},\n): string | null {\n  // The workspace's own band (AGL-3594): one or two pages on the Free taste.\n  const band = aiSitePagesBand(options.freeTaste)\n  const siteType = answers.siteType.trim()\n  if (!siteType) return 'Say what kind of site this is.'\n  if (siteType.length > AI_SITE_INPUT_MAX_CHARS) {\n    return `Keep what kind of site this is under ${AI_SITE_INPUT_MAX_CHARS} characters.`\n  }\n  if (answers.audience.trim().length > AI_SITE_INPUT_MAX_CHARS) {\n    return `Keep who the site is for under ${AI_SITE_INPUT_MAX_CHARS} characters.`\n  }\n  if (!Number.isInteger(answers.pages) || answers.pages < band.min || answers.pages > band.max) {\n    return `A site is planned with ${band.min} to ${band.max} pages.`\n  }\n  if (answers.example !== null && !aiSiteStartExample(answers)) {\n    return 'Pick one of the examples, or none of them.'\n  }\n  if (!(AI_SITE_SUBMISSIONS as readonly string[]).includes(answers.submissions)) {\n    return 'Say where the contact form’s submissions go.'\n  }\n  return null\n}\n\n/**\n * The answers as the brief the `site` job is created with: the plan step reads\n * it as the person's own words, so it says what they said and asks for nothing\n * they did not.\n */\nexport function aiSiteStartBrief(answers: AiSiteStartAnswers): string {\n  const siteType = answers.siteType.trim()\n  const audience = answers.audience.trim()\n  const example = aiSiteStartExample(answers)\n  const sentences = [\n    `A ${answers.pages}-page website for ${siteType}.`,\n  ]\n  if (audience) sentences.push(`It is for ${audience}.`)\n  if (example) {\n    sentences.push(\n      `Follow the shape of the ${example.label} starter: ${example.blurb.toLowerCase()}.`,\n    )\n  }\n  sentences.push(\n    'Plan a page for each thing a visitor comes to do, and a contact form on the page that asks to be contacted.',\n  )\n  if (audience) {\n    // Said of the FORM as well as of the copy: who fills a form in is what\n    // decides which fields it asks for, and a brief that named the audience\n    // once, in a sentence about the pages, left the form to guess.\n    sentences.push(`Ask the contact form for what ${audience} would be asked for.`)\n  }\n  return sentences.join(' ')\n}\n\n/**\n * The answers as the `site` job's scalar inputs. Read by the door's\n * {@link parseAiSiteJobInputs}, and put in front of the model one per line by\n * the plan step, which is how the audience and the example reach the plan\n * without a prompt of their own.\n *\n * The per-site variables an agency batch fills — the business name, the city,\n * the brand — are left empty: this is one person's own site, and its name is\n * on the site already.\n */\nexport function aiSiteStartInputs(\n  answers: AiSiteStartAnswers,\n): Omit<AiSiteJobInputs, 'batchId'> {\n  const example = aiSiteStartExample(answers)\n  return {\n    businessType: answers.siteType.trim(),\n    audience: answers.audience.trim(),\n    starter: example?.id ?? '',\n    pages: answers.pages,\n    businessName: '',\n    city: '',\n    brand: '',\n    submissions: answers.submissions,\n    welcomeEmail: answers.welcomeEmail,\n  }\n}\n\n/** The site inputs a guided start's answers become, by name: what a summary carries back (AGL-3596). */\nexport const AI_SITE_START_INPUT_KEYS = [\n  'businessType',\n  'audience',\n  'starter',\n  'pages',\n  'businessName',\n  'city',\n  'brand',\n  'submissions',\n  'welcomeEmail',\n] as const\n\n/** A site job's scalar inputs, and nothing else its inputs carry; `null` when it has none. */\nexport function aiSiteStartInputsOf(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): Record<string, unknown> | null {\n  if (!inputs) return null\n  const kept: Record<string, unknown> = {}\n  for (const key of AI_SITE_START_INPUT_KEYS) {\n    const value = inputs[key]\n    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') kept[key] = value\n  }\n  return Object.keys(kept).length ? kept : null\n}\n\n/**\n * A failed start's answers, back as the questions hold them (AGL-3596), so\n * Try again reopens the guided start filled in for the person to adjust:\n * the inverse of {@link aiSiteStartInputs}. Read defensively — an answer the\n * questions no longer offer goes back to its default — and held to the\n * workspace's page band. `null` when the inputs say no kind of site at all.\n */\nexport function aiSiteStartAnswersFromInputs(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n  options: { freeTaste?: boolean } = {},\n): AiSiteStartAnswers | null {\n  const text = (key: string) => (typeof inputs?.[key] === 'string' ? (inputs[key] as string).trim() : '')\n  const siteType = text('businessType')\n  if (!siteType) return null\n  const band = aiSitePagesBand(options.freeTaste)\n  const pages = typeof inputs?.['pages'] === 'number' ? Math.round(inputs['pages'] as number) : AI_SITE_START_ANSWERS.pages\n  const starter = text('starter')\n  const submissions = text('submissions')\n  return {\n    siteType,\n    audience: text('audience'),\n    example: AI_SITE_START_EXAMPLES.some((entry) => entry.id === starter) ? starter : null,\n    pages: Math.min(band.max, Math.max(band.min, pages)),\n    submissions: (AI_SITE_SUBMISSIONS as readonly string[]).includes(submissions)\n      ? (submissions as AiSiteSubmissions)\n      : AI_SITE_START_ANSWERS.submissions,\n    welcomeEmail: options.freeTaste ? false : inputs?.['welcomeEmail'] !== false,\n  }\n}\n"],"names":["AI_SITE_INPUT_MAX_CHARS","AI_SITE_SUBMISSIONS","aiSitePagesBand","AI_SITE_START_EXAMPLES","id","label","category","blurb","AI_SITE_START_TYPES","AI_SITE_START_ANSWERS","siteType","audience","example","pages","submissions","welcomeEmail","aiSiteStartExample","answers","find","entry","aiSiteStartRefusal","options","band","freeTaste","trim","length","Number","isInteger","min","max","includes","aiSiteStartBrief","sentences","push","toLowerCase","join","aiSiteStartInputs","businessType","starter","businessName","city","brand","AI_SITE_START_INPUT_KEYS","aiSiteStartInputsOf","inputs","kept","key","value","Object","keys","aiSiteStartAnswersFromInputs","text","Math","round","some"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-start.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 { aiSiteKind, aiSiteKindFor, type AiSiteKind } from './ai-site-kinds'\nimport {\n  AI_SITE_INPUT_MAX_CHARS,\n  AI_SITE_SUBMISSIONS,\n  aiSitePagesBand,\n  type AiSiteJobInputs,\n  type AiSiteSubmissions,\n} from './ai-site-job'\n\n/**\n * The guided start (AGL-2918): the questions a person answers on a site they\n * have just made, and the site job those answers become.\n *\n * A scaffold already exists — the `site` job plans four to eight pages, a\n * layout, a contact form, a palette and a welcome email, and builds every one\n * of them as a draft. What it had no way in through was a brief: somebody had\n * to know what to write, on a site where nothing has happened yet. So this\n * module is the QUESTIONS, and nothing else: what is asked, what an answer may\n * be, and how a set of answers becomes the brief and the scalar inputs the\n * `site` door already takes.\n *\n * ── Answering is never the way out ───────────────────────────────────────\n *\n * There is no answer here that means \"not this\". The way past the questions\n * is the `hostFirstRun` zone's own `startBlank`, which is drawn beside them\n * from the first one and creates nothing at all — see the zone in\n * `CONSOLE_WIDGET_SLOTS`. Putting the exit inside the question set would make\n * leaving a thing you answer your way to, and it is not.\n *\n * ── Every answer but the first is optional ───────────────────────────────\n *\n * Only what a site is FOR has no default worth guessing. The audience narrows\n * the copy, the example steers the shape, the page count and the welcome\n * email are defaults a person may change — so a person who types six words\n * and confirms gets a planned site, and the rest of the questions are there\n * for the person who wants to answer them.\n *\n * Pure: shapes, vocabularies and two string builders. No React, no network,\n * and no import of the starter catalog — {@link AI_SITE_START_EXAMPLES} names\n * the starters rather than reading them, so the console does not carry a\n * catalog of node maps to draw five cards. `ai-site-start.spec.ts` holds the\n * two lists to each other.\n */\n\n/** A worked example a person picks to steer what the site should look like. */\nexport interface AiSiteStartExample {\n  /** A `STARTER_TEMPLATES` id, which is a persisted identifier. */\n  id: string\n  /** The starter as its card names it. */\n  label: string\n  /** The starter's category, which is how the examples group. */\n  category: string\n  /** What the example is, in one line a person reads before picking it. */\n  blurb: string\n}\n\n/**\n * The examples the start offers, in the order they are shown. The platform's\n * own starter sites: a person who has no words for what they want has seen\n * these five shapes before, and picking one says more than a sentence would.\n */\nexport const AI_SITE_START_EXAMPLES: readonly AiSiteStartExample[] = [\n  {\n    id: 'business',\n    label: 'Business',\n    category: 'Business',\n    blurb: 'A home page led by what you do, an about page and a contact page',\n  },\n  {\n    id: 'landing',\n    label: 'Landing Page',\n    category: 'Marketing',\n    blurb: 'One page that leads to one action, with the reasons to take it',\n  },\n  {\n    id: 'portfolio',\n    label: 'Portfolio',\n    category: 'Personal',\n    blurb: 'An introduction, a grid of work and a way to get in touch',\n  },\n  {\n    id: 'physical-shop',\n    label: 'Shop (physical products)',\n    category: 'Commerce',\n    blurb: 'Featured products, a shop to browse, and a cart',\n  },\n  {\n    id: 'digital-shop',\n    label: 'Shop (digital products)',\n    category: 'Commerce',\n    blurb: 'Downloads up front, a shop to browse, and a cart',\n  },\n]\n\n/**\n * Kinds of site offered beside the first question's box, so answering it can\n * be a tap. They fill the box rather than replacing it: what somebody is\n * building is theirs to say, and a list of eight is a list somebody is not on.\n */\nexport const AI_SITE_START_TYPES: readonly string[] = [\n  'a local service business',\n  'a restaurant or cafe',\n  'a professional practice',\n  'a trades business',\n  'a shop',\n  'a nonprofit',\n  'a personal portfolio',\n  'an event',\n]\n\n/** What a person answered; the shape the card holds and the brief is built from. */\nexport interface AiSiteStartAnswers {\n  /** What kind of site this is. The one answer with no default. */\n  siteType: string\n  /** Who the site is for; empty when they did not say. */\n  audience: string\n  /** The example they liked, by {@link AiSiteStartExample.id}; `null` for none. */\n  example: string | null\n  /**\n   * The kind of site they picked (AGL-3660), by its `AI_SITE_KINDS` id;\n   * `null` until they pick one, when the kind their first answer suggests is\n   * the one used ({@link aiSiteStartKind}).\n   */\n  kind: string | null\n  /** How many pages to plan. */\n  pages: number\n  /** Where the contact form's submissions go. */\n  submissions: AiSiteSubmissions\n  /** Whether the scaffold also drafts a welcome email. */\n  welcomeEmail: boolean\n}\n\n/**\n * What the questions start on. Five pages because it is the middle of the\n * band the scaffold builds, a welcome email because the scaffold drafts one\n * unless it is told not to, and the Inbox because it is what every submission\n * does anyway — filing a lead as well is the addition, and an addition is the\n * thing a person should have to choose.\n */\nexport const AI_SITE_START_ANSWERS: AiSiteStartAnswers = {\n  siteType: '',\n  audience: '',\n  example: null,\n  kind: null,\n  pages: 5,\n  submissions: 'inbox',\n  welcomeEmail: true,\n}\n\n/** The kind of site the answers pick, else the one what the site is for suggests. */\nexport function aiSiteStartKind(answers: Pick<AiSiteStartAnswers, 'kind' | 'siteType'>): AiSiteKind {\n  return aiSiteKind(answers.kind) ?? aiSiteKindFor(answers.siteType)\n}\n\n/** The example an answer names, or `null` when it names none this list knows. */\nexport function aiSiteStartExample(\n  answers: AiSiteStartAnswers,\n): AiSiteStartExample | null {\n  if (!answers.example) return null\n  return AI_SITE_START_EXAMPLES.find((entry) => entry.id === answers.example) ?? null\n}\n\n/**\n * Why these answers cannot start a site, in a sentence a person reads; `null`\n * when they can. The door's own parser is what actually admits the job — this\n * is what the card says before it asks for one.\n */\nexport function aiSiteStartRefusal(\n  answers: AiSiteStartAnswers,\n  options: { freeTaste?: boolean } = {},\n): string | null {\n  // The workspace's own band (AGL-3594): one or two pages on the Free taste.\n  const band = aiSitePagesBand(options.freeTaste)\n  const siteType = answers.siteType.trim()\n  if (!siteType) return 'Say what kind of site this is.'\n  if (siteType.length > AI_SITE_INPUT_MAX_CHARS) {\n    return `Keep what kind of site this is under ${AI_SITE_INPUT_MAX_CHARS} characters.`\n  }\n  if (answers.audience.trim().length > AI_SITE_INPUT_MAX_CHARS) {\n    return `Keep who the site is for under ${AI_SITE_INPUT_MAX_CHARS} characters.`\n  }\n  if (!Number.isInteger(answers.pages) || answers.pages < band.min || answers.pages > band.max) {\n    return `A site is planned with ${band.min} to ${band.max} pages.`\n  }\n  if (answers.example !== null && !aiSiteStartExample(answers)) {\n    return 'Pick one of the examples, or none of them.'\n  }\n  if (!(AI_SITE_SUBMISSIONS as readonly string[]).includes(answers.submissions)) {\n    return 'Say where the contact form’s submissions go.'\n  }\n  return null\n}\n\n/**\n * The answers as the brief the `site` job is created with: the plan step reads\n * it as the person's own words, so it says what they said and asks for nothing\n * they did not.\n */\nexport function aiSiteStartBrief(answers: AiSiteStartAnswers): string {\n  const siteType = answers.siteType.trim()\n  const audience = answers.audience.trim()\n  const example = aiSiteStartExample(answers)\n  const sentences = [\n    `A ${answers.pages}-page website for ${siteType}.`,\n  ]\n  if (audience) sentences.push(`It is for ${audience}.`)\n  if (example) {\n    sentences.push(\n      `Follow the shape of the ${example.label} starter: ${example.blurb.toLowerCase()}.`,\n    )\n  }\n  // The kind they picked, or the one their answer suggests (AGL-3660).\n  sentences.push(`Make it a ${aiSiteStartKind(answers).label.toLowerCase()} site.`)\n  sentences.push(\n    'Plan a page for each thing a visitor comes to do, and a contact form on the page that asks to be contacted.',\n  )\n  if (audience) {\n    // Said of the FORM as well as of the copy: who fills a form in is what\n    // decides which fields it asks for, and a brief that named the audience\n    // once, in a sentence about the pages, left the form to guess.\n    sentences.push(`Ask the contact form for what ${audience} would be asked for.`)\n  }\n  return sentences.join(' ')\n}\n\n/**\n * The answers as the `site` job's scalar inputs. Read by the door's\n * {@link parseAiSiteJobInputs}, and put in front of the model one per line by\n * the plan step, which is how the audience and the example reach the plan\n * without a prompt of their own.\n *\n * The per-site variables an agency batch fills — the business name, the city,\n * the brand — are left empty here: the questions never ask them. The name is\n * the site's own, and the create door fills it from the site\n * (`aiJobAdmittedInputs`, AGL-3596) when the job is started — a job that\n * reached the model with no name had the model invent one for its header and\n * footer.\n */\nexport function aiSiteStartInputs(\n  answers: AiSiteStartAnswers,\n): Omit<AiSiteJobInputs, 'batchId'> {\n  const example = aiSiteStartExample(answers)\n  const kind = aiSiteStartKind(answers)\n  return {\n    businessType: answers.siteType.trim(),\n    audience: answers.audience.trim(),\n    starter: example?.id ?? kind.starter,\n    siteKind: kind.id,\n    pages: answers.pages,\n    businessName: '',\n    city: '',\n    brand: '',\n    submissions: answers.submissions,\n    welcomeEmail: answers.welcomeEmail,\n  }\n}\n\n/** The site inputs a guided start's answers become, by name: what a summary carries back (AGL-3596). */\nexport const AI_SITE_START_INPUT_KEYS = [\n  'businessType',\n  'audience',\n  'starter',\n  'siteKind',\n  'pages',\n  'businessName',\n  'city',\n  'brand',\n  'submissions',\n  'welcomeEmail',\n] as const\n\n/** A site job's scalar inputs, and nothing else its inputs carry; `null` when it has none. */\nexport function aiSiteStartInputsOf(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): Record<string, unknown> | null {\n  if (!inputs) return null\n  const kept: Record<string, unknown> = {}\n  for (const key of AI_SITE_START_INPUT_KEYS) {\n    const value = inputs[key]\n    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') kept[key] = value\n  }\n  return Object.keys(kept).length ? kept : null\n}\n\n/**\n * A failed start's answers, back as the questions hold them (AGL-3596), so\n * Try again reopens the guided start filled in for the person to adjust:\n * the inverse of {@link aiSiteStartInputs}. Read defensively — an answer the\n * questions no longer offer goes back to its default — and held to the\n * workspace's page band. `null` when the inputs say no kind of site at all.\n */\nexport function aiSiteStartAnswersFromInputs(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n  options: { freeTaste?: boolean } = {},\n): AiSiteStartAnswers | null {\n  const text = (key: string) => (typeof inputs?.[key] === 'string' ? (inputs[key] as string).trim() : '')\n  const siteType = text('businessType')\n  if (!siteType) return null\n  const band = aiSitePagesBand(options.freeTaste)\n  const pages = typeof inputs?.['pages'] === 'number' ? Math.round(inputs['pages'] as number) : AI_SITE_START_ANSWERS.pages\n  const starter = text('starter')\n  const submissions = text('submissions')\n  return {\n    siteType,\n    audience: text('audience'),\n    example: AI_SITE_START_EXAMPLES.some((entry) => entry.id === starter) ? starter : null,\n    kind: aiSiteKind(text('siteKind'))?.id ?? null,\n    pages: Math.min(band.max, Math.max(band.min, pages)),\n    submissions: (AI_SITE_SUBMISSIONS as readonly string[]).includes(submissions)\n      ? (submissions as AiSiteSubmissions)\n      : AI_SITE_START_ANSWERS.submissions,\n    welcomeEmail: options.freeTaste ? false : inputs?.['welcomeEmail'] !== false,\n  }\n}\n"],"names":["aiSiteKind","aiSiteKindFor","AI_SITE_INPUT_MAX_CHARS","AI_SITE_SUBMISSIONS","aiSitePagesBand","AI_SITE_START_EXAMPLES","id","label","category","blurb","AI_SITE_START_TYPES","AI_SITE_START_ANSWERS","siteType","audience","example","kind","pages","submissions","welcomeEmail","aiSiteStartKind","answers","aiSiteStartExample","find","entry","aiSiteStartRefusal","options","band","freeTaste","trim","length","Number","isInteger","min","max","includes","aiSiteStartBrief","sentences","push","toLowerCase","join","aiSiteStartInputs","businessType","starter","siteKind","businessName","city","brand","AI_SITE_START_INPUT_KEYS","aiSiteStartInputsOf","inputs","kept","key","value","Object","keys","aiSiteStartAnswersFromInputs","text","Math","round","some"],"mappings":"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"}

package/src/lib/model/assist-follow-up.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @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 { AiJobOutput } from './ai-jobs.types';
+/**
+ * A follow-up on what a build made (AGL-3616): "make the about page shorter"
+ * after Assist built the About page.
+ *
+ * The edit card works only on the document open in the Besigner. So when a
+ * request is about a draft the build in this chat made, Assist proposes
+ * OPENING that draft's Besigner, and the panel asks the same request again
+ * once the draft's canvas is open — where the edit rung answers it with an
+ * edit card the author applies. Nothing is changed by the proposal itself.
+ *
+ * The panel names the drafts it can open by a short ref (`d1`, `d2`, …) and a
+ * label; the ids and the address stay in the panel, which got them from the
+ * job door. The chat sees only refs and labels, and a proposal it makes is
+ * held to a ref the request listed.
+ *
+ * Shared by the chat door and the panel. Pure: no request, no React.
+ */
+/** The navigation's id, in the proposal channel and the analytics event. */
+export declare const ASSIST_OPEN_DRAFT_ACTION_ID = "open.build.draft";
+/** The one parameter the navigation takes: the ref of the draft to open. */
+export declare const ASSIST_OPEN_DRAFT_PARAM = "draft";
+/** The most drafts one request lists: a build makes at most 16 units. */
+export declare const ASSIST_BUILD_DRAFTS_MAX = 16;
+/** The longest label a request carries for one draft. */
+export declare const ASSIST_BUILD_DRAFT_LABEL_MAX = 80;
+/** How long a follow-up waits for its canvas before it is dropped. */
+export declare const ASSIST_FOLLOW_UP_TTL_MS: number;
+/** A draft the chat may offer to open, as the request names it. */
+export interface AssistBuildDraft {
+    /** `d1`, `d2`, …: what the model chooses from. */
+    ref: string;
+    /** What the draft is called: the page's title, the layout's name. */
+    label: string;
+    /** What kind of thing it is, in a word a person reads. */
+    noun: string;
+}
+/** A draft the panel can open, with the address it opens at. */
+export interface AssistBuildDraftLink extends AssistBuildDraft {
+    href: string;
+}
+/** The Besigner address a job's output opens at, or `null` where it has none. */
+export declare function assistDraftBesignerHref(output: AiJobOutput, orgSlug: string): string | null;
+/**
+ * The drafts the panel can offer, newest build first: every output of the
+ * given jobs that opens in the Besigner on the version the job wrote, once
+ * each, at most {@link ASSIST_BUILD_DRAFTS_MAX}.
+ */
+export declare function assistBuildDraftLinks(jobs: ReadonlyArray<{
+    outputs: readonly AiJobOutput[];
+}>, orgSlug: string): AssistBuildDraftLink[];
+/** A label as it may enter a prompt: one line, no fence, quotes or brackets, bounded. */
+export declare function assistDraftLabel(value: unknown): string;
+/**
+ * The drafts a request lists, as the chat door will use them: well-formed
+ * refs, once each, labels cleaned, nouns from the closed set, bounded. A
+ * malformed entry is dropped, never repaired.
+ */
+export declare function parseAssistBuildDrafts(raw: unknown): AssistBuildDraft[];
+/**
+ * The lines the chat is told about the drafts, after every cache breakpoint:
+ * what each ref is, and that a request to change one is a navigation to it,
+ * not a new build.
+ */
+export declare function assistBuildDraftsBlock(drafts: readonly AssistBuildDraft[]): string;
+/** A follow-up waiting for its canvas: asked again once the panel stands on `path`. */
+export interface AssistPendingFollowUp {
+    path: string;
+    question: string;
+    /** When it was confirmed, in ms; one older than the TTL is dropped. */
+    at: number;
+}
+/** Whether a stored follow-up is still one the panel should ask. */
+export declare function isLiveAssistFollowUp(value: unknown, now: number): value is AssistPendingFollowUp;
+/** The version a Besigner address names, for the open editor to match. */
+export declare function assistBesignerVersionOf(path: string): string | null;

package/src/lib/model/assist-follow-up.js

@@ -0,0 +1,128 @@
+/**
+ * @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 { AI_JOB_BESIGNER_SEGMENT } from "./ai-job-notice.js";
+/**
+ * A follow-up on what a build made (AGL-3616): "make the about page shorter"
+ * after Assist built the About page.
+ *
+ * The edit card works only on the document open in the Besigner. So when a
+ * request is about a draft the build in this chat made, Assist proposes
+ * OPENING that draft's Besigner, and the panel asks the same request again
+ * once the draft's canvas is open — where the edit rung answers it with an
+ * edit card the author applies. Nothing is changed by the proposal itself.
+ *
+ * The panel names the drafts it can open by a short ref (`d1`, `d2`, …) and a
+ * label; the ids and the address stay in the panel, which got them from the
+ * job door. The chat sees only refs and labels, and a proposal it makes is
+ * held to a ref the request listed.
+ *
+ * Shared by the chat door and the panel. Pure: no request, no React.
+ */ /** The navigation's id, in the proposal channel and the analytics event. */ export const ASSIST_OPEN_DRAFT_ACTION_ID = 'open.build.draft';
+/** The one parameter the navigation takes: the ref of the draft to open. */ export const ASSIST_OPEN_DRAFT_PARAM = 'draft';
+/** The most drafts one request lists: a build makes at most 16 units. */ export const ASSIST_BUILD_DRAFTS_MAX = 16;
+/** The longest label a request carries for one draft. */ export const ASSIST_BUILD_DRAFT_LABEL_MAX = 80;
+/** How long a follow-up waits for its canvas before it is dropped. */ export const ASSIST_FOLLOW_UP_TTL_MS = 2 * 60000;
+/** What one Besigner-backed output is called in a sentence. */ const NOUNS = {
+    screen: 'page',
+    reusableComponent: 'component',
+    layout: 'layout',
+    template: 'page template',
+    emailScreen: 'email design'
+};
+/** The Besigner address a job's output opens at, or `null` where it has none. */ export function assistDraftBesignerHref(output, orgSlug) {
+    const segment = AI_JOB_BESIGNER_SEGMENT[output.resource];
+    if (!segment || !orgSlug || !output.hostSubdomain || !output.versionId) return null;
+    return `/${orgSlug}/hosts/${output.hostSubdomain}/${segment}/${output.id}/versions/${output.versionId}/besigner`;
+}
+/**
+ * The drafts the panel can offer, newest build first: every output of the
+ * given jobs that opens in the Besigner on the version the job wrote, once
+ * each, at most {@link ASSIST_BUILD_DRAFTS_MAX}.
+ */ export function assistBuildDraftLinks(jobs, orgSlug) {
+    const links = [];
+    const seen = new Set();
+    for (const job of jobs){
+        for (const output of job.outputs){
+            var _NOUNS_output_resource;
+            if (links.length >= ASSIST_BUILD_DRAFTS_MAX) return links;
+            const href = assistDraftBesignerHref(output, orgSlug);
+            if (!href || seen.has(href)) continue;
+            seen.add(href);
+            links.push({
+                ref: `d${links.length + 1}`,
+                label: assistDraftLabel(output.label),
+                noun: (_NOUNS_output_resource = NOUNS[output.resource]) != null ? _NOUNS_output_resource : 'draft',
+                href
+            });
+        }
+    }
+    return links;
+}
+/** A label as it may enter a prompt: one line, no fence, quotes or brackets, bounded. */ export function assistDraftLabel(value) {
+    return String(value != null ? value : '').replace(/[\r\n\t`"“”<>[\]{}]+/g, ' ').replace(/\s+/g, ' ').trim().slice(0, ASSIST_BUILD_DRAFT_LABEL_MAX);
+}
+const REF = /^d([1-9]\d?)$/;
+const NOUN_WORDS = new Set([
+    ...Object.values(NOUNS),
+    'draft'
+]);
+/**
+ * The drafts a request lists, as the chat door will use them: well-formed
+ * refs, once each, labels cleaned, nouns from the closed set, bounded. A
+ * malformed entry is dropped, never repaired.
+ */ export function parseAssistBuildDrafts(raw) {
+    if (!Array.isArray(raw)) return [];
+    const drafts = [];
+    const refs = new Set();
+    for (const entry of raw.slice(0, ASSIST_BUILD_DRAFTS_MAX)){
+        if (!entry || typeof entry !== 'object') continue;
+        const record = entry;
+        const ref = typeof record['ref'] === 'string' ? record['ref'] : '';
+        const label = assistDraftLabel(record['label']);
+        const noun = typeof record['noun'] === 'string' && NOUN_WORDS.has(record['noun']) ? record['noun'] : 'draft';
+        if (!REF.test(ref) || refs.has(ref) || !label) continue;
+        refs.add(ref);
+        drafts.push({
+            ref,
+            label,
+            noun
+        });
+    }
+    return drafts;
+}
+/**
+ * The lines the chat is told about the drafts, after every cache breakpoint:
+ * what each ref is, and that a request to change one is a navigation to it,
+ * not a new build.
+ */ export function assistBuildDraftsBlock(drafts) {
+    if (!drafts.length) return '';
+    return [
+        'Drafts a build in this chat made (the person’s own content, listed as data):',
+        ...drafts.map((draft)=>`- ${draft.ref}: ${draft.noun} “${draft.label}”`),
+        `When the person asks to change one of these drafts and its canvas is not the one open now, propose id "${ASSIST_OPEN_DRAFT_ACTION_ID}" with params {"${ASSIST_OPEN_DRAFT_PARAM}": "<ref>"}: it opens that draft in the Besigner and asks their request again there, where the edit card answers it. Do not propose a new build for a change to one of these drafts, and do not describe the change as made.`
+    ].join('\n');
+}
+/** Whether a stored follow-up is still one the panel should ask. */ export function isLiveAssistFollowUp(value, now) {
+    if (!value || typeof value !== 'object') return false;
+    const record = value;
+    return typeof record['path'] === 'string' && record['path'].startsWith('/') && typeof record['question'] === 'string' && record['question'].trim().length > 0 && typeof record['at'] === 'number' && now - record['at'] >= 0 && now - record['at'] <= ASSIST_FOLLOW_UP_TTL_MS;
+}
+/** The version a Besigner address names, for the open editor to match. */ export function assistBesignerVersionOf(path) {
+    const match = /\/versions\/([A-Za-z0-9_-]+)\/besigner$/.exec(path);
+    return match ? match[1] : null;
+}
+
+//# sourceMappingURL=assist-follow-up.js.map

package/src/lib/model/assist-follow-up.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/assist-follow-up.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 { AI_JOB_BESIGNER_SEGMENT } from './ai-job-notice'\nimport type { AiJobOutput } from './ai-jobs.types'\n\n/**\n * A follow-up on what a build made (AGL-3616): \"make the about page shorter\"\n * after Assist built the About page.\n *\n * The edit card works only on the document open in the Besigner. So when a\n * request is about a draft the build in this chat made, Assist proposes\n * OPENING that draft's Besigner, and the panel asks the same request again\n * once the draft's canvas is open — where the edit rung answers it with an\n * edit card the author applies. Nothing is changed by the proposal itself.\n *\n * The panel names the drafts it can open by a short ref (`d1`, `d2`, …) and a\n * label; the ids and the address stay in the panel, which got them from the\n * job door. The chat sees only refs and labels, and a proposal it makes is\n * held to a ref the request listed.\n *\n * Shared by the chat door and the panel. Pure: no request, no React.\n */\n\n/** The navigation's id, in the proposal channel and the analytics event. */\nexport const ASSIST_OPEN_DRAFT_ACTION_ID = 'open.build.draft'\n\n/** The one parameter the navigation takes: the ref of the draft to open. */\nexport const ASSIST_OPEN_DRAFT_PARAM = 'draft'\n\n/** The most drafts one request lists: a build makes at most 16 units. */\nexport const ASSIST_BUILD_DRAFTS_MAX = 16\n\n/** The longest label a request carries for one draft. */\nexport const ASSIST_BUILD_DRAFT_LABEL_MAX = 80\n\n/** How long a follow-up waits for its canvas before it is dropped. */\nexport const ASSIST_FOLLOW_UP_TTL_MS = 2 * 60_000\n\n/** A draft the chat may offer to open, as the request names it. */\nexport interface AssistBuildDraft {\n  /** `d1`, `d2`, …: what the model chooses from. */\n  ref: string\n  /** What the draft is called: the page's title, the layout's name. */\n  label: string\n  /** What kind of thing it is, in a word a person reads. */\n  noun: string\n}\n\n/** A draft the panel can open, with the address it opens at. */\nexport interface AssistBuildDraftLink extends AssistBuildDraft {\n  href: string\n}\n\n/** What one Besigner-backed output is called in a sentence. */\nconst NOUNS: Partial<Record<AiJobOutput['resource'], string>> = {\n  screen: 'page',\n  reusableComponent: 'component',\n  layout: 'layout',\n  template: 'page template',\n  emailScreen: 'email design',\n}\n\n/** The Besigner address a job's output opens at, or `null` where it has none. */\nexport function assistDraftBesignerHref(output: AiJobOutput, orgSlug: string): string | null {\n  const segment = AI_JOB_BESIGNER_SEGMENT[output.resource]\n  if (!segment || !orgSlug || !output.hostSubdomain || !output.versionId) return null\n  return `/${orgSlug}/hosts/${output.hostSubdomain}/${segment}/${output.id}/versions/${output.versionId}/besigner`\n}\n\n/**\n * The drafts the panel can offer, newest build first: every output of the\n * given jobs that opens in the Besigner on the version the job wrote, once\n * each, at most {@link ASSIST_BUILD_DRAFTS_MAX}.\n */\nexport function assistBuildDraftLinks(\n  jobs: ReadonlyArray<{ outputs: readonly AiJobOutput[] }>,\n  orgSlug: string,\n): AssistBuildDraftLink[] {\n  const links: AssistBuildDraftLink[] = []\n  const seen = new Set<string>()\n  for (const job of jobs) {\n    for (const output of job.outputs) {\n      if (links.length >= ASSIST_BUILD_DRAFTS_MAX) return links\n      const href = assistDraftBesignerHref(output, orgSlug)\n      if (!href || seen.has(href)) continue\n      seen.add(href)\n      links.push({\n        ref: `d${links.length + 1}`,\n        label: assistDraftLabel(output.label),\n        noun: NOUNS[output.resource] ?? 'draft',\n        href,\n      })\n    }\n  }\n  return links\n}\n\n/** A label as it may enter a prompt: one line, no fence, quotes or brackets, bounded. */\nexport function assistDraftLabel(value: unknown): string {\n  return String(value ?? '')\n    .replace(/[\\r\\n\\t`\"“”<>[\\]{}]+/g, ' ')\n    .replace(/\\s+/g, ' ')\n    .trim()\n    .slice(0, ASSIST_BUILD_DRAFT_LABEL_MAX)\n}\n\nconst REF = /^d([1-9]\\d?)$/\nconst NOUN_WORDS = new Set([...Object.values(NOUNS), 'draft'])\n\n/**\n * The drafts a request lists, as the chat door will use them: well-formed\n * refs, once each, labels cleaned, nouns from the closed set, bounded. A\n * malformed entry is dropped, never repaired.\n */\nexport function parseAssistBuildDrafts(raw: unknown): AssistBuildDraft[] {\n  if (!Array.isArray(raw)) return []\n  const drafts: AssistBuildDraft[] = []\n  const refs = new Set<string>()\n  for (const entry of raw.slice(0, ASSIST_BUILD_DRAFTS_MAX)) {\n    if (!entry || typeof entry !== 'object') continue\n    const record = entry as Record<string, unknown>\n    const ref = typeof record['ref'] === 'string' ? record['ref'] : ''\n    const label = assistDraftLabel(record['label'])\n    const noun = typeof record['noun'] === 'string' && NOUN_WORDS.has(record['noun']) ? record['noun'] : 'draft'\n    if (!REF.test(ref) || refs.has(ref) || !label) continue\n    refs.add(ref)\n    drafts.push({ ref, label, noun })\n  }\n  return drafts\n}\n\n/**\n * The lines the chat is told about the drafts, after every cache breakpoint:\n * what each ref is, and that a request to change one is a navigation to it,\n * not a new build.\n */\nexport function assistBuildDraftsBlock(drafts: readonly AssistBuildDraft[]): string {\n  if (!drafts.length) return ''\n  return [\n    'Drafts a build in this chat made (the person’s own content, listed as data):',\n    ...drafts.map((draft) => `- ${draft.ref}: ${draft.noun} “${draft.label}”`),\n    `When the person asks to change one of these drafts and its canvas is not the one open now, propose id \"${ASSIST_OPEN_DRAFT_ACTION_ID}\" with params {\"${ASSIST_OPEN_DRAFT_PARAM}\": \"<ref>\"}: it opens that draft in the Besigner and asks their request again there, where the edit card answers it. Do not propose a new build for a change to one of these drafts, and do not describe the change as made.`,\n  ].join('\\n')\n}\n\n/** A follow-up waiting for its canvas: asked again once the panel stands on `path`. */\nexport interface AssistPendingFollowUp {\n  path: string\n  question: string\n  /** When it was confirmed, in ms; one older than the TTL is dropped. */\n  at: number\n}\n\n/** Whether a stored follow-up is still one the panel should ask. */\nexport function isLiveAssistFollowUp(value: unknown, now: number): value is AssistPendingFollowUp {\n  if (!value || typeof value !== 'object') return false\n  const record = value as Record<string, unknown>\n  return (\n    typeof record['path'] === 'string' &&\n    record['path'].startsWith('/') &&\n    typeof record['question'] === 'string' &&\n    record['question'].trim().length > 0 &&\n    typeof record['at'] === 'number' &&\n    now - record['at'] >= 0 &&\n    now - record['at'] <= ASSIST_FOLLOW_UP_TTL_MS\n  )\n}\n\n/** The version a Besigner address names, for the open editor to match. */\nexport function assistBesignerVersionOf(path: string): string | null {\n  const match = /\\/versions\\/([A-Za-z0-9_-]+)\\/besigner$/.exec(path)\n  return match ? match[1] : null\n}\n"],"names":["AI_JOB_BESIGNER_SEGMENT","ASSIST_OPEN_DRAFT_ACTION_ID","ASSIST_OPEN_DRAFT_PARAM","ASSIST_BUILD_DRAFTS_MAX","ASSIST_BUILD_DRAFT_LABEL_MAX","ASSIST_FOLLOW_UP_TTL_MS","NOUNS","screen","reusableComponent","layout","template","emailScreen","assistDraftBesignerHref","output","orgSlug","segment","resource","hostSubdomain","versionId","id","assistBuildDraftLinks","jobs","links","seen","Set","job","outputs","length","href","has","add","push","ref","label","assistDraftLabel","noun","value","String","replace","trim","slice","REF","NOUN_WORDS","Object","values","parseAssistBuildDrafts","raw","Array","isArray","drafts","refs","entry","record","test","assistBuildDraftsBlock","map","draft","join","isLiveAssistFollowUp","now","startsWith","assistBesignerVersionOf","path","match","exec"],"mappings":"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"}

package/src/lib/plugin-config.js

@@ -39,6 +39,7 @@ import { AI_CATALOG_PROVIDERS, AI_MODEL_CATALOG } from "./providers/catalog.js";
     'job.insight': 'jobInsightModel',
     'job.layout': 'jobLayoutModel',
     'job.logic': 'jobLogicModel',
+    'job.edit': 'jobEditModel',
     'job.template': 'jobTemplateModel',
     'job.page': 'jobPageModel',
     'job.products': 'jobProductsModel',
@@ -98,6 +99,7 @@ export const AI_CONFIG_SCHEMA = {
         modelField('job.insight', 'Insights model', 'Answering a question about the site’s figures, and the weekly insights.'),
         modelField('job.layout', 'Generation job (layout) model', 'Generating a shared layout from a confirmed plan.'),
         modelField('job.logic', 'Generation job (logic) model', 'Proposing a site function or variable, and explaining a function.'),
+        modelField('job.edit', 'Generation job (edit) model', 'Changing a page or layout the site already has, into a version visitors do not see.'),
         modelField('job.template', 'Generation job (template) model', 'Generating a page template from a confirmed plan.'),
         modelField('job.page', 'Generation job (page) model', 'Generating a page, one section at a time, from a confirmed plan.'),
         modelField('job.products', 'Generation job (products) model', 'Writing product copy, and proposing products, categories and discounts for a store.'),

package/src/lib/plugin-config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/plugin-config.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 { PluginConfigSchema } from '@aglyn/aglyn'\nimport { AI_PLUGIN_SETTINGS_ID } from './constants'\nimport { AI_CATALOG_PROVIDERS, AI_MODEL_CATALOG, type AiStepKind } from './providers/catalog'\n\n/**\n * The org's AI settings (AGL-2939), stored in `pluginSettings/ai` and\n * inherited per site the way every plugin setting is (AGL-428): which\n * provider serves the workspace, and which catalog model each kind of step\n * runs on. `platform` means \"whatever the deployment's environment says\",\n * which is what every workspace runs with until it chooses.\n *\n * PURE DATA (type-only aglyn import): the client barrel registers it via\n * '@aglyn/aglyn' and the /server entry via '@aglyn/aglyn/server'.\n */\n\n/** The value that defers to the deployment's environment. */\nexport const AI_SETTING_PLATFORM = 'platform'\n\n/** The setting key each step kind's model override is stored under. */\nexport const AI_STEP_MODEL_SETTING: Record<AiStepKind, string> = {\n  'assist.chat': 'chatModel',\n  'copy.element': 'copyElementModel',\n  'copy.section': 'copySectionModel',\n  'copy.blog': 'copyBlogModel',\n  'generate.section': 'generateModel',\n  'job.component': 'jobComponentModel',\n  'job.crm': 'jobCrmModel',\n  'job.experiment': 'jobExperimentModel',\n  'job.form': 'jobFormModel',\n  'job.insight': 'jobInsightModel',\n  'job.layout': 'jobLayoutModel',\n  'job.logic': 'jobLogicModel',\n  'job.template': 'jobTemplateModel',\n  'job.page': 'jobPageModel',\n  'job.products': 'jobProductsModel',\n  'job.seo': 'jobSeoModel',\n  'job.text': 'jobTextModel',\n  'job.theme': 'jobThemeModel',\n  'job.plan': 'jobPlanModel',\n  'job.email': 'jobEmailModel',\n  'job.campaign': 'jobCampaignModel',\n  'job.workflow': 'jobWorkflowModel',\n}\n\nconst MODEL_OPTIONS = [\n  { value: AI_SETTING_PLATFORM, label: 'Platform default' },\n  ...AI_MODEL_CATALOG.map((entry) => ({\n    value: entry.id,\n    label: `${entry.label} (${entry.provider})`,\n  })),\n]\n\nconst modelField = (kind: AiStepKind, label: string, description: string) => ({\n  key: AI_STEP_MODEL_SETTING[kind],\n  label,\n  type: 'select' as const,\n  options: MODEL_OPTIONS,\n  description,\n})\n\nexport const AI_CONFIG_SCHEMA: PluginConfigSchema = {\n  pluginId: AI_PLUGIN_SETTINGS_ID,\n  fields: [\n    {\n      key: 'provider',\n      label: 'AI provider',\n      type: 'select',\n      options: [\n        { value: AI_SETTING_PLATFORM, label: 'Platform default' },\n        ...AI_CATALOG_PROVIDERS.map((provider) => ({ value: provider.id, label: provider.label })),\n      ],\n      description:\n        'Which provider answers this workspace. A model chosen below must ' +\n        'be one the provider serves; otherwise the provider’s default for ' +\n        'that kind of step is used.',\n    },\n    modelField('assist.chat', 'Assistant model', 'The in-console assistant’s answers.'),\n    modelField('copy.element', 'Copy assistant (element) model', 'Rewriting one element’s text.'),\n    modelField('copy.section', 'Copy assistant (section) model', 'Writing a section’s copy.'),\n    modelField('copy.blog', 'Copy assistant (blog) model', 'Drafting a blog post.'),\n    modelField('generate.section', 'Section generation model', 'Generating a section’s structure.'),\n    modelField('job.component', 'Generation job (component) model', 'Generating a reusable component and its properties.'),\n    modelField('job.crm', 'Generation job (CRM) model', 'CRM record summaries and next steps, email drafts and import column matches.'),\n    modelField(\n      'job.experiment',\n      'Generation job (A/B test) model',\n      'Writing variants for an A/B test, and explaining what a test’s result means.',\n    ),\n    modelField('job.form', 'Generation job (form) model', 'Generating a form from a confirmed plan.'),\n    modelField('job.insight', 'Insights model', 'Answering a question about the site’s figures, and the weekly insights.'),\n    modelField('job.layout', 'Generation job (layout) model', 'Generating a shared layout from a confirmed plan.'),\n    modelField('job.logic', 'Generation job (logic) model', 'Proposing a site function or variable, and explaining a function.'),\n    modelField('job.template', 'Generation job (template) model', 'Generating a page template from a confirmed plan.'),\n    modelField('job.page', 'Generation job (page) model', 'Generating a page, one section at a time, from a confirmed plan.'),\n    modelField('job.products', 'Generation job (products) model', 'Writing product copy, and proposing products, categories and discounts for a store.'),\n    modelField('job.seo', 'Generation job (SEO) model', 'Search listings, image descriptions and a site audit’s fixes.'),\n    modelField('job.text', 'Generation job (text) model', 'The text step of a generation job.'),\n    modelField('job.theme', 'Generation job (theme) model', 'Proposing a change to a site’s theme.'),\n    modelField('job.plan', 'Generation job (plan) model', 'The plan step of a generation job.'),\n    modelField('job.email', 'Generation job (email) model', 'Generating an email design from a confirmed plan.'),\n    modelField('job.campaign', 'Generation job (campaign) model', 'Drafting a campaign and its email from a brief.'),\n    modelField('job.workflow', 'Generation job (automation) model', 'Drafting an automation from a description, and explaining one.'),\n  ],\n  defaults: {\n    provider: AI_SETTING_PLATFORM,\n    ...Object.fromEntries(\n      Object.values(AI_STEP_MODEL_SETTING).map((key) => [key, AI_SETTING_PLATFORM]),\n    ),\n  },\n}\n"],"names":["AI_PLUGIN_SETTINGS_ID","AI_CATALOG_PROVIDERS","AI_MODEL_CATALOG","AI_SETTING_PLATFORM","AI_STEP_MODEL_SETTING","MODEL_OPTIONS","value","label","map","entry","id","provider","modelField","kind","description","key","type","options","AI_CONFIG_SCHEMA","pluginId","fields","defaults","Object","fromEntries","values"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SAASA,qBAAqB,QAAQ,iBAAa;AACnD,SAASC,oBAAoB,EAAEC,gBAAgB,QAAyB,yBAAqB;AAE7F;;;;;;;;;CASC,GAED,2DAA2D,GAC3D,OAAO,MAAMC,sBAAsB,WAAU;AAE7C,qEAAqE,GACrE,OAAO,MAAMC,wBAAoD;IAC/D,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,aAAa;IACb,oBAAoB;IACpB,iBAAiB;IACjB,WAAW;IACX,kBAAkB;IAClB,YAAY;IACZ,eAAe;IACf,cAAc;IACd,aAAa;IACb,gBAAgB;IAChB,YAAY;IACZ,gBAAgB;IAChB,WAAW;IACX,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,aAAa;IACb,gBAAgB;IAChB,gBAAgB;AAClB,EAAC;AAED,MAAMC,gBAAgB;IACpB;QAAEC,OAAOH;QAAqBI,OAAO;IAAmB;OACrDL,iBAAiBM,GAAG,CAAC,CAACC,QAAW,CAAA;YAClCH,OAAOG,MAAMC,EAAE;YACfH,OAAO,GAAGE,MAAMF,KAAK,CAAC,EAAE,EAAEE,MAAME,QAAQ,CAAC,CAAC,CAAC;QAC7C,CAAA;CACD;AAED,MAAMC,aAAa,CAACC,MAAkBN,OAAeO,cAAyB,CAAA;QAC5EC,KAAKX,qBAAqB,CAACS,KAAK;QAChCN;QACAS,MAAM;QACNC,SAASZ;QACTS;IACF,CAAA;AAEA,OAAO,MAAMI,mBAAuC;IAClDC,UAAUnB;IACVoB,QAAQ;QACN;YACEL,KAAK;YACLR,OAAO;YACPS,MAAM;YACNC,SAAS;gBACP;oBAAEX,OAAOH;oBAAqBI,OAAO;gBAAmB;mBACrDN,qBAAqBO,GAAG,CAAC,CAACG,WAAc,CAAA;wBAAEL,OAAOK,SAASD,EAAE;wBAAEH,OAAOI,SAASJ,KAAK;oBAAC,CAAA;aACxF;YACDO,aACE,sEACA,sEACA;QACJ;QACAF,WAAW,eAAe,mBAAmB;QAC7CA,WAAW,gBAAgB,kCAAkC;QAC7DA,WAAW,gBAAgB,kCAAkC;QAC7DA,WAAW,aAAa,+BAA+B;QACvDA,WAAW,oBAAoB,4BAA4B;QAC3DA,WAAW,iBAAiB,oCAAoC;QAChEA,WAAW,WAAW,8BAA8B;QACpDA,WACE,kBACA,mCACA;QAEFA,WAAW,YAAY,+BAA+B;QACtDA,WAAW,eAAe,kBAAkB;QAC5CA,WAAW,cAAc,iCAAiC;QAC1DA,WAAW,aAAa,gCAAgC;QACxDA,WAAW,gBAAgB,mCAAmC;QAC9DA,WAAW,YAAY,+BAA+B;QACtDA,WAAW,gBAAgB,mCAAmC;QAC9DA,WAAW,WAAW,8BAA8B;QACpDA,WAAW,YAAY,+BAA+B;QACtDA,WAAW,aAAa,gCAAgC;QACxDA,WAAW,YAAY,+BAA+B;QACtDA,WAAW,aAAa,gCAAgC;QACxDA,WAAW,gBAAgB,mCAAmC;QAC9DA,WAAW,gBAAgB,qCAAqC;KACjE;IACDS,UAAU;QACRV,UAAUR;OACPmB,OAAOC,WAAW,CACnBD,OAAOE,MAAM,CAACpB,uBAAuBI,GAAG,CAAC,CAACO,MAAQ;YAACA;YAAKZ;SAAoB;AAGlF,EAAC"}
+{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/plugin-config.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 { PluginConfigSchema } from '@aglyn/aglyn'\nimport { AI_PLUGIN_SETTINGS_ID } from './constants'\nimport { AI_CATALOG_PROVIDERS, AI_MODEL_CATALOG, type AiStepKind } from './providers/catalog'\n\n/**\n * The org's AI settings (AGL-2939), stored in `pluginSettings/ai` and\n * inherited per site the way every plugin setting is (AGL-428): which\n * provider serves the workspace, and which catalog model each kind of step\n * runs on. `platform` means \"whatever the deployment's environment says\",\n * which is what every workspace runs with until it chooses.\n *\n * PURE DATA (type-only aglyn import): the client barrel registers it via\n * '@aglyn/aglyn' and the /server entry via '@aglyn/aglyn/server'.\n */\n\n/** The value that defers to the deployment's environment. */\nexport const AI_SETTING_PLATFORM = 'platform'\n\n/** The setting key each step kind's model override is stored under. */\nexport const AI_STEP_MODEL_SETTING: Record<AiStepKind, string> = {\n  'assist.chat': 'chatModel',\n  'copy.element': 'copyElementModel',\n  'copy.section': 'copySectionModel',\n  'copy.blog': 'copyBlogModel',\n  'generate.section': 'generateModel',\n  'job.component': 'jobComponentModel',\n  'job.crm': 'jobCrmModel',\n  'job.experiment': 'jobExperimentModel',\n  'job.form': 'jobFormModel',\n  'job.insight': 'jobInsightModel',\n  'job.layout': 'jobLayoutModel',\n  'job.logic': 'jobLogicModel',\n  'job.edit': 'jobEditModel',\n  'job.template': 'jobTemplateModel',\n  'job.page': 'jobPageModel',\n  'job.products': 'jobProductsModel',\n  'job.seo': 'jobSeoModel',\n  'job.text': 'jobTextModel',\n  'job.theme': 'jobThemeModel',\n  'job.plan': 'jobPlanModel',\n  'job.email': 'jobEmailModel',\n  'job.campaign': 'jobCampaignModel',\n  'job.workflow': 'jobWorkflowModel',\n}\n\nconst MODEL_OPTIONS = [\n  { value: AI_SETTING_PLATFORM, label: 'Platform default' },\n  ...AI_MODEL_CATALOG.map((entry) => ({\n    value: entry.id,\n    label: `${entry.label} (${entry.provider})`,\n  })),\n]\n\nconst modelField = (kind: AiStepKind, label: string, description: string) => ({\n  key: AI_STEP_MODEL_SETTING[kind],\n  label,\n  type: 'select' as const,\n  options: MODEL_OPTIONS,\n  description,\n})\n\nexport const AI_CONFIG_SCHEMA: PluginConfigSchema = {\n  pluginId: AI_PLUGIN_SETTINGS_ID,\n  fields: [\n    {\n      key: 'provider',\n      label: 'AI provider',\n      type: 'select',\n      options: [\n        { value: AI_SETTING_PLATFORM, label: 'Platform default' },\n        ...AI_CATALOG_PROVIDERS.map((provider) => ({ value: provider.id, label: provider.label })),\n      ],\n      description:\n        'Which provider answers this workspace. A model chosen below must ' +\n        'be one the provider serves; otherwise the provider’s default for ' +\n        'that kind of step is used.',\n    },\n    modelField('assist.chat', 'Assistant model', 'The in-console assistant’s answers.'),\n    modelField('copy.element', 'Copy assistant (element) model', 'Rewriting one element’s text.'),\n    modelField('copy.section', 'Copy assistant (section) model', 'Writing a section’s copy.'),\n    modelField('copy.blog', 'Copy assistant (blog) model', 'Drafting a blog post.'),\n    modelField('generate.section', 'Section generation model', 'Generating a section’s structure.'),\n    modelField('job.component', 'Generation job (component) model', 'Generating a reusable component and its properties.'),\n    modelField('job.crm', 'Generation job (CRM) model', 'CRM record summaries and next steps, email drafts and import column matches.'),\n    modelField(\n      'job.experiment',\n      'Generation job (A/B test) model',\n      'Writing variants for an A/B test, and explaining what a test’s result means.',\n    ),\n    modelField('job.form', 'Generation job (form) model', 'Generating a form from a confirmed plan.'),\n    modelField('job.insight', 'Insights model', 'Answering a question about the site’s figures, and the weekly insights.'),\n    modelField('job.layout', 'Generation job (layout) model', 'Generating a shared layout from a confirmed plan.'),\n    modelField('job.logic', 'Generation job (logic) model', 'Proposing a site function or variable, and explaining a function.'),\n    modelField('job.edit', 'Generation job (edit) model', 'Changing a page or layout the site already has, into a version visitors do not see.'),\n    modelField('job.template', 'Generation job (template) model', 'Generating a page template from a confirmed plan.'),\n    modelField('job.page', 'Generation job (page) model', 'Generating a page, one section at a time, from a confirmed plan.'),\n    modelField('job.products', 'Generation job (products) model', 'Writing product copy, and proposing products, categories and discounts for a store.'),\n    modelField('job.seo', 'Generation job (SEO) model', 'Search listings, image descriptions and a site audit’s fixes.'),\n    modelField('job.text', 'Generation job (text) model', 'The text step of a generation job.'),\n    modelField('job.theme', 'Generation job (theme) model', 'Proposing a change to a site’s theme.'),\n    modelField('job.plan', 'Generation job (plan) model', 'The plan step of a generation job.'),\n    modelField('job.email', 'Generation job (email) model', 'Generating an email design from a confirmed plan.'),\n    modelField('job.campaign', 'Generation job (campaign) model', 'Drafting a campaign and its email from a brief.'),\n    modelField('job.workflow', 'Generation job (automation) model', 'Drafting an automation from a description, and explaining one.'),\n  ],\n  defaults: {\n    provider: AI_SETTING_PLATFORM,\n    ...Object.fromEntries(\n      Object.values(AI_STEP_MODEL_SETTING).map((key) => [key, AI_SETTING_PLATFORM]),\n    ),\n  },\n}\n"],"names":["AI_PLUGIN_SETTINGS_ID","AI_CATALOG_PROVIDERS","AI_MODEL_CATALOG","AI_SETTING_PLATFORM","AI_STEP_MODEL_SETTING","MODEL_OPTIONS","value","label","map","entry","id","provider","modelField","kind","description","key","type","options","AI_CONFIG_SCHEMA","pluginId","fields","defaults","Object","fromEntries","values"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SAASA,qBAAqB,QAAQ,iBAAa;AACnD,SAASC,oBAAoB,EAAEC,gBAAgB,QAAyB,yBAAqB;AAE7F;;;;;;;;;CASC,GAED,2DAA2D,GAC3D,OAAO,MAAMC,sBAAsB,WAAU;AAE7C,qEAAqE,GACrE,OAAO,MAAMC,wBAAoD;IAC/D,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,aAAa;IACb,oBAAoB;IACpB,iBAAiB;IACjB,WAAW;IACX,kBAAkB;IAClB,YAAY;IACZ,eAAe;IACf,cAAc;IACd,aAAa;IACb,YAAY;IACZ,gBAAgB;IAChB,YAAY;IACZ,gBAAgB;IAChB,WAAW;IACX,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,aAAa;IACb,gBAAgB;IAChB,gBAAgB;AAClB,EAAC;AAED,MAAMC,gBAAgB;IACpB;QAAEC,OAAOH;QAAqBI,OAAO;IAAmB;OACrDL,iBAAiBM,GAAG,CAAC,CAACC,QAAW,CAAA;YAClCH,OAAOG,MAAMC,EAAE;YACfH,OAAO,GAAGE,MAAMF,KAAK,CAAC,EAAE,EAAEE,MAAME,QAAQ,CAAC,CAAC,CAAC;QAC7C,CAAA;CACD;AAED,MAAMC,aAAa,CAACC,MAAkBN,OAAeO,cAAyB,CAAA;QAC5EC,KAAKX,qBAAqB,CAACS,KAAK;QAChCN;QACAS,MAAM;QACNC,SAASZ;QACTS;IACF,CAAA;AAEA,OAAO,MAAMI,mBAAuC;IAClDC,UAAUnB;IACVoB,QAAQ;QACN;YACEL,KAAK;YACLR,OAAO;YACPS,MAAM;YACNC,SAAS;gBACP;oBAAEX,OAAOH;oBAAqBI,OAAO;gBAAmB;mBACrDN,qBAAqBO,GAAG,CAAC,CAACG,WAAc,CAAA;wBAAEL,OAAOK,SAASD,EAAE;wBAAEH,OAAOI,SAASJ,KAAK;oBAAC,CAAA;aACxF;YACDO,aACE,sEACA,sEACA;QACJ;QACAF,WAAW,eAAe,mBAAmB;QAC7CA,WAAW,gBAAgB,kCAAkC;QAC7DA,WAAW,gBAAgB,kCAAkC;QAC7DA,WAAW,aAAa,+BAA+B;QACvDA,WAAW,oBAAoB,4BAA4B;QAC3DA,WAAW,iBAAiB,oCAAoC;QAChEA,WAAW,WAAW,8BAA8B;QACpDA,WACE,kBACA,mCACA;QAEFA,WAAW,YAAY,+BAA+B;QACtDA,WAAW,eAAe,kBAAkB;QAC5CA,WAAW,cAAc,iCAAiC;QAC1DA,WAAW,aAAa,gCAAgC;QACxDA,WAAW,YAAY,+BAA+B;QACtDA,WAAW,gBAAgB,mCAAmC;QAC9DA,WAAW,YAAY,+BAA+B;QACtDA,WAAW,gBAAgB,mCAAmC;QAC9DA,WAAW,WAAW,8BAA8B;QACpDA,WAAW,YAAY,+BAA+B;QACtDA,WAAW,aAAa,gCAAgC;QACxDA,WAAW,YAAY,+BAA+B;QACtDA,WAAW,aAAa,gCAAgC;QACxDA,WAAW,gBAAgB,mCAAmC;QAC9DA,WAAW,gBAAgB,qCAAqC;KACjE;IACDS,UAAU;QACRV,UAAUR;OACPmB,OAAOC,WAAW,CACnBD,OAAOE,MAAM,CAACpB,uBAAuBI,GAAG,CAAC,CAACO,MAAQ;YAACA;YAAKZ;SAAoB;AAGlF,EAAC"}

package/src/lib/plugin.js

@@ -13,56 +13,90 @@
  * 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 { PLATFORM_BRAND_NAME, registerConsoleExtension } from "@aglyn/aglyn";
-import { AiCollaboratorPermissionsCell } from "./components/ai-collaborator-permissions-column.component.js";
-import { AiSaveAsComponent } from "./components/ai-save-as-component.component.js";
-import { AiGenerateSectionControl, AiRewriteControl } from "./components/besigner-ai-controls.component.js";
-import { AiAssistProviderOnHost, AssistPanelOnHost } from "./components/ai-permissions-on-host.component.js";
-import AiCreditsCard from "./components/ai-credits-card.component.js";
-import AiJobsTopBarIndicator from "./components/ai-jobs-indicator.component.js";
-import { AiCollaboratorCreditsCell, AiCollaboratorCreditsHeader, AiMemberCreditsCell, AiMemberCreditsHeader } from "./components/ai-credits-columns.component.js";
-import { AssistSignalsPage } from "./components/assist-signals-page.component.js";
-import BillingAssistOverageCard from "./components/billing-assist-overage-card.component.js";
-import { AiTopUsersCard } from "./components/billing-ai-top-users.component.js";
-import { AiAllotmentsCard } from "./components/billing-ai-allotments.component.js";
-import { AiCollaboratorAllotmentCell, AiCollaboratorAllotmentHeader, AiSiteAllotmentCard } from "./components/host-ai-allotments.component.js";
-import MemberAiAllotmentCard from "./components/member-ai-allotment-card.component.js";
-import MemberAiUsageCard from "./components/member-ai-usage-card.component.js";
-import AiThemeProposalCard from "./components/ai-theme-proposal-card.component.js";
-import StaffOrgAiCard from "./components/staff-org-ai-card.component.js";
-import { StaffOrgUsageAiCreditsCell, StaffOrgUsageAiOverageCell, StaffOrgUsageAiPool, StaffOrgUsageAssistCell } from "./components/staff-org-usage-ai-columns.component.js";
-import { StaffOrgsAiSpendCell, StaffOrgsAiSpendHeader } from "./components/staff-orgs-ai-spend-column.component.js";
-import StaffUserAiUsageCard from "./components/staff-user-ai-usage-card.component.js";
-import AiSeoAuditCard from "./components/ai-seo-audit-card.component.js";
-import AiSiteBatchCard from "./components/ai-site-batch-card.component.js";
-import AiSiteSeoStartCard from "./components/ai-site-seo-start-card.component.js";
-import AiSiteStartCard from "./components/ai-site-start-card.component.js";
-import AiSeoFieldsCard from "./components/ai-seo-fields-card.component.js";
-import AiDescribeAutomationButton from "./components/ai-describe-automation.component.js";
-import AiReviseAutomation from "./components/ai-revise-automation.component.js";
-import AiDescribeOrgAutomationButton from "./components/ai-describe-org-automation.component.js";
-import { AiInsightHostCard, AiInsightOrgCard } from "./components/ai-insight-card.component.js";
-import { AiLogicCreateButton, AiLogicFixReference, AiLogicFunctionTools } from "./components/ai-logic.component.js";
-import { AiFunnelAskButton, AiFunnelCreateButton } from "./components/ai-funnel-zones.component.js";
-import AiCrmEmailDraft from "./components/ai-crm-email-draft.component.js";
-import AiCrmImportMapping from "./components/ai-crm-import-mapping.component.js";
-import AiCrmRecordCard from "./components/ai-crm-record-card.component.js";
-import AiDescribePageButton from "./components/ai-describe-page.component.js";
-import AiMediaCreateButton from "./components/ai-media-create.component.js";
-import { AiDescribeComponentButton, AiDescribeFormButton, AiDescribeLayoutButton, AiDescribeTemplateButton } from "./components/ai-describe-button.component.js";
-import { AiDescribeEmailButton } from "./components/ai-describe-email.component.js";
-import { AiExperimentResultCard, AiExperimentVariantsCard } from "./components/ai-experiment-cards.component.js";
-import { AiExplainAutomation, AiExplainRunFailure } from "./components/ai-explain-automation.component.js";
-import AiCreateCampaignButton from "./components/ai-campaign-create.component.js";
-import AiMarketingInsightButton from "./components/ai-marketing-insight.component.js";
-import { AiCreateOverlayButton, AiOverlayEditorCard } from "./components/ai-overlay-cards.component.js";
-import AiProductCopyCard from "./components/ai-product-copy-card.component.js";
-import AiProductImportOption from "./components/ai-product-import-option.component.js";
-import AiProductsHubCard from "./components/ai-products-hub-card.component.js";
-import AiCreateProductsButton from "./components/ai-products-create-button.component.js";
-import AiJobsPage from "./components/ai-jobs-page.component.js";
+ */ import { PLATFORM_BRAND_NAME, aiAddonName, registerConsoleExtension } from "@aglyn/aglyn";
+import { LinearProgress } from "@mui/material";
+import { createElement } from "react";
+import { AiAssistProviderOnHost } from "./components/ai-assist-provider-on-host.component.js";
 import { AI_PLUGIN_ID } from "./constants.js";
 import { registerAiDeclarations } from "./declarations.js";
+import { lazyWidget } from "./lazy-widget.js";
+/*
+ * Every component below is registered by name and loaded the first time the
+ * shell draws it (AGL-3649); see `lazyWidget`. The console loads this plugin
+ * on every screen, so a static import of a component here is downloaded by
+ * every reader of every page, staff cards included.
+ */ /** What a page shows while its code arrives. */ const PAGE_LOADING = createElement(LinearProgress, {
+    'aria-label': 'Loading'
+});
+const AiCollaboratorPermissionsCell = lazyWidget('AiCollaboratorPermissionsCell', ()=>import("./components/ai-collaborator-permissions-column.component.js").then((m)=>m.AiCollaboratorPermissionsCell));
+const AiSaveAsComponent = lazyWidget('AiSaveAsComponent', ()=>import("./components/ai-save-as-component.component.js").then((m)=>m.AiSaveAsComponent));
+const AiGenerateSectionControl = lazyWidget('AiGenerateSectionControl', ()=>import("./components/besigner-ai-controls.component.js").then((m)=>m.AiGenerateSectionControl));
+const AiRewriteControl = lazyWidget('AiRewriteControl', ()=>import("./components/besigner-ai-controls.component.js").then((m)=>m.AiRewriteControl));
+const AssistPanelOnHost = lazyWidget('AssistPanelOnHost', ()=>import("./components/ai-permissions-on-host.component.js").then((m)=>m.AssistPanelOnHost));
+const AiCreditsCard = lazyWidget('AiCreditsCard', ()=>import("./components/ai-credits-card.component.js").then((m)=>m.default));
+const AiJobsTopBarIndicator = lazyWidget('AiJobsTopBarIndicator', ()=>import("./components/ai-jobs-indicator.component.js").then((m)=>m.default));
+const AiCollaboratorCreditsCell = lazyWidget('AiCollaboratorCreditsCell', ()=>import("./components/ai-credits-columns.component.js").then((m)=>m.AiCollaboratorCreditsCell));
+const AiCollaboratorCreditsHeader = lazyWidget('AiCollaboratorCreditsHeader', ()=>import("./components/ai-credits-columns.component.js").then((m)=>m.AiCollaboratorCreditsHeader));
+const AiMemberCreditsCell = lazyWidget('AiMemberCreditsCell', ()=>import("./components/ai-credits-columns.component.js").then((m)=>m.AiMemberCreditsCell));
+const AiMemberCreditsHeader = lazyWidget('AiMemberCreditsHeader', ()=>import("./components/ai-credits-columns.component.js").then((m)=>m.AiMemberCreditsHeader));
+const AssistSignalsPage = lazyWidget('AssistSignalsPage', ()=>import("./components/assist-signals-page.component.js").then((m)=>m.AssistSignalsPage), PAGE_LOADING);
+const BillingAssistOverageCard = lazyWidget('BillingAssistOverageCard', ()=>import("./components/billing-assist-overage-card.component.js").then((m)=>m.default));
+const AiTopUsersCard = lazyWidget('AiTopUsersCard', ()=>import("./components/billing-ai-top-users.component.js").then((m)=>m.AiTopUsersCard));
+const AiAllotmentsCard = lazyWidget('AiAllotmentsCard', ()=>import("./components/billing-ai-allotments.component.js").then((m)=>m.AiAllotmentsCard));
+const AiCollaboratorAllotmentCell = lazyWidget('AiCollaboratorAllotmentCell', ()=>import("./components/host-ai-allotments.component.js").then((m)=>m.AiCollaboratorAllotmentCell));
+const AiCollaboratorAllotmentHeader = lazyWidget('AiCollaboratorAllotmentHeader', ()=>import("./components/host-ai-allotments.component.js").then((m)=>m.AiCollaboratorAllotmentHeader));
+const AiSiteAllotmentCard = lazyWidget('AiSiteAllotmentCard', ()=>import("./components/host-ai-allotments.component.js").then((m)=>m.AiSiteAllotmentCard));
+const MemberAiAllotmentCard = lazyWidget('MemberAiAllotmentCard', ()=>import("./components/member-ai-allotment-card.component.js").then((m)=>m.default));
+const MemberAiUsageCard = lazyWidget('MemberAiUsageCard', ()=>import("./components/member-ai-usage-card.component.js").then((m)=>m.default));
+const AiThemeProposalCard = lazyWidget('AiThemeProposalCard', ()=>import("./components/ai-theme-proposal-card.component.js").then((m)=>m.default));
+const StaffOrgAiCard = lazyWidget('StaffOrgAiCard', ()=>import("./components/staff-org-ai-card.component.js").then((m)=>m.default));
+const StaffOrgAiConversations = lazyWidget('StaffOrgAiConversations', ()=>import("./components/staff-org-ai-conversations.component.js").then((m)=>m.default));
+const StaffOrgUsageAiCreditsCell = lazyWidget('StaffOrgUsageAiCreditsCell', ()=>import("./components/staff-org-usage-ai-columns.component.js").then((m)=>m.StaffOrgUsageAiCreditsCell));
+const StaffOrgUsageAiOverageCell = lazyWidget('StaffOrgUsageAiOverageCell', ()=>import("./components/staff-org-usage-ai-columns.component.js").then((m)=>m.StaffOrgUsageAiOverageCell));
+const StaffOrgUsageAiPool = lazyWidget('StaffOrgUsageAiPool', ()=>import("./components/staff-org-usage-ai-columns.component.js").then((m)=>m.StaffOrgUsageAiPool));
+const StaffOrgUsageAssistCell = lazyWidget('StaffOrgUsageAssistCell', ()=>import("./components/staff-org-usage-ai-columns.component.js").then((m)=>m.StaffOrgUsageAssistCell));
+const StaffOrgsAiSpendCell = lazyWidget('StaffOrgsAiSpendCell', ()=>import("./components/staff-orgs-ai-spend-column.component.js").then((m)=>m.StaffOrgsAiSpendCell));
+const StaffOrgsAiSpendHeader = lazyWidget('StaffOrgsAiSpendHeader', ()=>import("./components/staff-orgs-ai-spend-column.component.js").then((m)=>m.StaffOrgsAiSpendHeader));
+const StaffUserAiUsageCard = lazyWidget('StaffUserAiUsageCard', ()=>import("./components/staff-user-ai-usage-card.component.js").then((m)=>m.default));
+const AiSeoAuditCard = lazyWidget('AiSeoAuditCard', ()=>import("./components/ai-seo-audit-card.component.js").then((m)=>m.default));
+const AiSiteBatchCard = lazyWidget('AiSiteBatchCard', ()=>import("./components/ai-site-batch-card.component.js").then((m)=>m.default));
+const AiSiteSeoStartCard = lazyWidget('AiSiteSeoStartCard', ()=>import("./components/ai-site-seo-start-card.component.js").then((m)=>m.default));
+const AiSiteMemoryCard = lazyWidget('AiSiteMemoryCard', ()=>import("./components/ai-site-memory-card.component.js").then((m)=>m.default));
+const AiSiteStartCard = lazyWidget('AiSiteStartCard', ()=>import("./components/ai-site-start-card.component.js").then((m)=>m.default));
+const AiSeoFieldsCard = lazyWidget('AiSeoFieldsCard', ()=>import("./components/ai-seo-fields-card.component.js").then((m)=>m.default));
+const AiDescribeAutomationButton = lazyWidget('AiDescribeAutomationButton', ()=>import("./components/ai-describe-automation.component.js").then((m)=>m.default));
+const AiReviseAutomation = lazyWidget('AiReviseAutomation', ()=>import("./components/ai-revise-automation.component.js").then((m)=>m.default));
+const AiDescribeOrgAutomationButton = lazyWidget('AiDescribeOrgAutomationButton', ()=>import("./components/ai-describe-org-automation.component.js").then((m)=>m.default));
+const AiInsightHostCard = lazyWidget('AiInsightHostCard', ()=>import("./components/ai-insight-card.component.js").then((m)=>m.AiInsightHostCard));
+const AiInsightOrgCard = lazyWidget('AiInsightOrgCard', ()=>import("./components/ai-insight-card.component.js").then((m)=>m.AiInsightOrgCard));
+const AiLogicCreateButton = lazyWidget('AiLogicCreateButton', ()=>import("./components/ai-logic.component.js").then((m)=>m.AiLogicCreateButton));
+const AiLogicFixReference = lazyWidget('AiLogicFixReference', ()=>import("./components/ai-logic.component.js").then((m)=>m.AiLogicFixReference));
+const AiLogicFunctionTools = lazyWidget('AiLogicFunctionTools', ()=>import("./components/ai-logic.component.js").then((m)=>m.AiLogicFunctionTools));
+const AiFunnelAskButton = lazyWidget('AiFunnelAskButton', ()=>import("./components/ai-funnel-zones.component.js").then((m)=>m.AiFunnelAskButton));
+const AiFunnelCreateButton = lazyWidget('AiFunnelCreateButton', ()=>import("./components/ai-funnel-zones.component.js").then((m)=>m.AiFunnelCreateButton));
+const AiCrmEmailDraft = lazyWidget('AiCrmEmailDraft', ()=>import("./components/ai-crm-email-draft.component.js").then((m)=>m.default));
+const AiCrmImportMapping = lazyWidget('AiCrmImportMapping', ()=>import("./components/ai-crm-import-mapping.component.js").then((m)=>m.default));
+const AiCrmRecordCard = lazyWidget('AiCrmRecordCard', ()=>import("./components/ai-crm-record-card.component.js").then((m)=>m.default));
+const AiDescribePageButton = lazyWidget('AiDescribePageButton', ()=>import("./components/ai-describe-page.component.js").then((m)=>m.default));
+const AiMediaCreateButton = lazyWidget('AiMediaCreateButton', ()=>import("./components/ai-media-create.component.js").then((m)=>m.default));
+const AiDescribeComponentButton = lazyWidget('AiDescribeComponentButton', ()=>import("./components/ai-describe-button.component.js").then((m)=>m.AiDescribeComponentButton));
+const AiDescribeFormButton = lazyWidget('AiDescribeFormButton', ()=>import("./components/ai-describe-button.component.js").then((m)=>m.AiDescribeFormButton));
+const AiDescribeLayoutButton = lazyWidget('AiDescribeLayoutButton', ()=>import("./components/ai-describe-button.component.js").then((m)=>m.AiDescribeLayoutButton));
+const AiDescribeTemplateButton = lazyWidget('AiDescribeTemplateButton', ()=>import("./components/ai-describe-button.component.js").then((m)=>m.AiDescribeTemplateButton));
+const AiDescribeEmailButton = lazyWidget('AiDescribeEmailButton', ()=>import("./components/ai-describe-email.component.js").then((m)=>m.AiDescribeEmailButton));
+const AiExperimentResultCard = lazyWidget('AiExperimentResultCard', ()=>import("./components/ai-experiment-cards.component.js").then((m)=>m.AiExperimentResultCard));
+const AiExperimentVariantsCard = lazyWidget('AiExperimentVariantsCard', ()=>import("./components/ai-experiment-cards.component.js").then((m)=>m.AiExperimentVariantsCard));
+const AiExplainAutomation = lazyWidget('AiExplainAutomation', ()=>import("./components/ai-explain-automation.component.js").then((m)=>m.AiExplainAutomation));
+const AiExplainRunFailure = lazyWidget('AiExplainRunFailure', ()=>import("./components/ai-explain-automation.component.js").then((m)=>m.AiExplainRunFailure));
+const AiCreateCampaignButton = lazyWidget('AiCreateCampaignButton', ()=>import("./components/ai-campaign-create.component.js").then((m)=>m.default));
+const AiMarketingInsightButton = lazyWidget('AiMarketingInsightButton', ()=>import("./components/ai-marketing-insight.component.js").then((m)=>m.default));
+const AiCreateOverlayButton = lazyWidget('AiCreateOverlayButton', ()=>import("./components/ai-overlay-cards.component.js").then((m)=>m.AiCreateOverlayButton));
+const AiOverlayEditorCard = lazyWidget('AiOverlayEditorCard', ()=>import("./components/ai-overlay-cards.component.js").then((m)=>m.AiOverlayEditorCard));
+const AiProductCopyCard = lazyWidget('AiProductCopyCard', ()=>import("./components/ai-product-copy-card.component.js").then((m)=>m.default));
+const AiProductImportOption = lazyWidget('AiProductImportOption', ()=>import("./components/ai-product-import-option.component.js").then((m)=>m.default));
+const AiProductsHubCard = lazyWidget('AiProductsHubCard', ()=>import("./components/ai-products-hub-card.component.js").then((m)=>m.default));
+const AiCreateProductsButton = lazyWidget('AiCreateProductsButton', ()=>import("./components/ai-products-create-button.component.js").then((m)=>m.default));
+const AiJobsPage = lazyWidget('AiJobsPage', ()=>import("./components/ai-jobs-page.component.js").then((m)=>m.default), PAGE_LOADING);
 /**
  * The Aglyn AI plugin's console half (AGL-2939): the assistant dock, the
  * besigner copy assistant's provider, the billing, member and staff cards,
@@ -261,6 +295,12 @@ import { registerAiDeclarations } from "./declarations.js";
                 title: 'AI usage',
                 Component: StaffOrgAiCard
             },
+            {
+                slot: 'staffOrg',
+                widgetId: 'ai-org-conversations',
+                title: 'AI conversations',
+                Component: StaffOrgAiConversations
+            },
             {
                 slot: 'staffUser',
                 widgetId: 'ai-account-usage',
@@ -647,6 +687,17 @@ import { registerAiDeclarations } from "./declarations.js";
                 permission: 'ai.generate',
                 Component: AiSiteSeoStartCard
             },
+            // What Aglyn AI learned from the site's applied edits (AGL-3661), on
+            // Setup → Business profile, where the owner reads and forgets it. No
+            // generate permission: reading and clearing what the AI keeps about a
+            // site is every editor's, and the rules hold the write to the server.
+            {
+                slot: 'hostBusinessProfile',
+                widgetId: 'ai-site-memory',
+                title: `What ${aiAddonName()} learned`,
+                featureFlag: 'aiGenerative',
+                Component: AiSiteMemoryCard
+            },
             // The agency batch (AGL-2911): one brief across many of the org's
             // sites, from the page that lists them. The card asks the jobs route
             // about the release flag before it shows anything, and its own door