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

package/src/lib/model/assist-edit.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/assist-edit.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 { ScreenSeoTextField } from '@aglyn/aglyn/app-utils/screen-seo-fields'\nimport type { ReusableComponentProp } from '@aglyn/aglyn/foundation/definitions/platform.types'\n\n/**\n * Assist level 3, the edit contract (AGL-2906): what the chat door proposes\n * for a besigner canvas, and what the panel applies once the author says so.\n *\n * Shared by the server, which validates a model's proposal into these\n * shapes, and the client, which applies them. Pure data and pure functions,\n * so the panel imports it without pulling the palette or the runtime.\n *\n * ## The boundary\n *\n * A proposal is OPERATIONS, never a document. The server writes nothing: it\n * answers with ops that name elements already on the canvas, or a validated\n * subtree to insert, and the client applies them through the canvas's own\n * guarded mutators, on confirm, as one undoable step. Every change lands as\n * an unsaved edit on the version the editor has open — a draft — and on a\n * version the live site serves, the editor's own new-version flow runs first.\n */\n\n/** The eight operations a proposal may carry. */\nexport const ASSIST_EDIT_OP_KINDS = [\n  'insertSubtree',\n  'updateProps',\n  'updateSx',\n  'move',\n  'remove',\n  'setSeo',\n  'rename',\n  'saveAsComponent',\n] as const\n\nexport type AssistEditOpKind = (typeof ASSIST_EDIT_OP_KINDS)[number]\n\n/** The id of the besigner view's edit action — the one edit a view offers. */\nexport const ASSIST_EDIT_ACTION_ID = 'edit.canvas'\n\n/** The name of the structured-output tool a model proposes an edit through. */\nexport const ASSIST_EDIT_TOOL_NAME = 'propose_canvas_edit'\n\n/** The besigner documents the edit rung opens on: those that keep versions. */\nexport type AssistEditDocumentKind = 'screen' | 'component' | 'layout'\n\nexport const ASSIST_EDIT_DOCUMENT_KINDS: readonly AssistEditDocumentKind[] = [\n  'screen',\n  'component',\n  'layout',\n]\n\nconst COLLECTION_KINDS: Readonly<Record<string, AssistEditDocumentKind>> = {\n  screens: 'screen',\n  components: 'component',\n  layouts: 'layout',\n}\n\nconst BESIGNER_DOCUMENT_ROUTE =\n  /^\\/[^/]+\\/hosts\\/[^/]+\\/(screens|components|layouts)\\/([A-Za-z0-9_-]{1,64})\\/versions\\/([A-Za-z0-9_-]{1,64})\\/besigner\\/?$/\n\n/** The document a besigner route has open. */\nexport interface AssistEditDocument {\n  kind: AssistEditDocumentKind\n  documentId: string\n  versionId: string\n}\n\n/**\n * The open document off a console path, or null off a route the edit rung\n * serves. Only the versioned editors qualify — a template or an email editor\n * has no version to make first, so the rung does not open there.\n */\nexport function assistEditDocumentOf(route: string): AssistEditDocument | null {\n  const match = BESIGNER_DOCUMENT_ROUTE.exec(String(route ?? ''))\n  if (!match) return null\n  return {\n    kind: COLLECTION_KINDS[match[1]],\n    documentId: match[2],\n    versionId: match[3],\n  }\n}\n\n/* ------------------------------------------------------------------ *\n * What the client tells the server about the canvas\n * ------------------------------------------------------------------ */\n\n/** Elements a request describes at most — the selection, its surroundings, its subtree. */\nexport const ASSIST_EDIT_CONTEXT_MAX_NODES = 60\n/** Props described per element at most. */\nexport const ASSIST_EDIT_CONTEXT_MAX_PROPS = 16\n/** Characters of a string prop the selected element carries into a request. */\nexport const ASSIST_EDIT_SELECTED_TEXT_CHARS = 400\n/** Characters of a string prop every other element carries. */\nexport const ASSIST_EDIT_OUTLINE_TEXT_CHARS = 80\n\n/**\n * One element of the canvas outline a request carries. Ids, component ids\n * and short primitive values only — never a stored document, never markup.\n */\nexport interface AssistEditCanvasNode {\n  id: string\n  componentId: string\n  /** Null for the document root. */\n  parentId: string | null\n  /** Position among the parent's children. */\n  index: number\n  childCount: number\n  /** The layer name, when the author gave it one. */\n  name?: string\n  /** Primitive props, strings shortened. */\n  props?: Record<string, string | number | boolean>\n  /** The element's own styles — carried for the selected element only. */\n  sx?: Record<string, unknown>\n  /**\n   * Described by its place alone, without props: an element around the\n   * selection, there so the model knows it exists and can ask for it.\n   */\n  brief?: boolean\n  /**\n   * An element described earlier whose contents this one's are built like,\n   * the way the cards of a row are. Its own contents are left out.\n   */\n  like?: string\n}\n\nexport interface AssistEditCanvasContext {\n  /** The element the author has selected, or null. */\n  selectedId: string | null\n  /**\n   * Elements in the whole document, the root included, so the prompt can say\n   * how much of it `nodes` leaves out. Absent from an outline sent by a panel\n   * that predates it.\n   */\n  total?: number\n  nodes: AssistEditCanvasNode[]\n}\n\n/* ------------------------------------------------------------------ *\n * What the server proposes\n * ------------------------------------------------------------------ */\n\n/** An element of a validated subtree, in the flat shape the canvas stores. */\nexport interface AssistEditNode {\n  $id: string\n  componentId: string\n  pluginId?: string\n  parentId: string | null\n  nodes: string[]\n  props: Record<string, unknown>\n  sx?: Record<string, unknown>\n  hidden?: boolean\n}\n\n/**\n * Every op that acts on an element names the component the server validated\n * it as, so the client can refuse an element that has changed since.\n */\ninterface AssistEditNodeOpBase {\n  nodeId: string\n  componentId: string\n}\n\nexport interface AssistEditInsertOp {\n  op: 'insertSubtree'\n  parentId: string\n  /** The component the parent was validated as. */\n  parentComponentId: string\n  /** Position among the parent's children; null appends. */\n  index: number | null\n  rootId: string\n  nodes: Record<string, AssistEditNode>\n}\n\nexport interface AssistEditUpdatePropsOp extends AssistEditNodeOpBase {\n  op: 'updateProps'\n  /** Merged over the props the element has; nothing else it carries changes. */\n  props: Record<string, unknown>\n}\n\nexport interface AssistEditUpdateSxOp extends AssistEditNodeOpBase {\n  op: 'updateSx'\n  /** Merged over the element's own styles, one key at a time. */\n  sx: Record<string, unknown>\n}\n\nexport interface AssistEditMoveOp extends AssistEditNodeOpBase {\n  op: 'move'\n  parentId: string\n  /** The component the new parent was validated as. */\n  parentComponentId: string\n  index: number | null\n}\n\nexport interface AssistEditRemoveOp extends AssistEditNodeOpBase {\n  op: 'remove'\n}\n\nexport interface AssistEditRenameOp extends AssistEditNodeOpBase {\n  op: 'rename'\n  name: string\n}\n\nexport interface AssistEditSetSeoOp {\n  op: 'setSeo'\n  fields: Partial<Record<ScreenSeoTextField, string>>\n}\n\n/**\n * A property the promoted subtree declares (AGL-2908), in the shape the\n * Properties dialog stores one — without a default.\n *\n * The server never sees a full value: the outline it read the selection from\n * shortens every string. So the default is read off the live canvas at apply\n * time, from the very field the token is about to replace, which is what\n * makes the instance render what was there a moment before.\n */\nexport type AssistEditComponentProp = Omit<ReusableComponentProp, 'defaultValue'>\n\n/** Where one property's token goes: an element of the selection, and a field of it. */\nexport interface AssistEditPropBinding {\n  nodeId: string\n  /** The component the element was validated as, so a changed one is refused. */\n  componentId: string\n  /** A prop of that element, or `hideIf` for a part a Yes / no hides. */\n  field: string\n  /** The property whose `{{prop.<name>}}` token the field takes. */\n  prop: string\n}\n\n/**\n * Save the selection as a reusable component (AGL-2908), with the properties\n * the model proposed and the tokens bound into the tree.\n *\n * The only op that creates a document. It creates exactly the one the manual\n * Save as reusable component creates, through the same host resources route,\n * where the plan's entitlement and the route's allow-list are enforced — and\n * it changes the open canvas the same way that action does, by swapping the\n * promoted subtree for an instance. Nothing is published and nothing is\n * saved: the swap is an unsaved edit on the version the editor has open.\n */\nexport interface AssistEditSaveAsComponentOp extends AssistEditNodeOpBase {\n  op: 'saveAsComponent'\n  /** The name the component is created under. */\n  name: string\n  props: AssistEditComponentProp[]\n  bindings: AssistEditPropBinding[]\n}\n\nexport type AssistEditOp =\n  | AssistEditInsertOp\n  | AssistEditUpdatePropsOp\n  | AssistEditUpdateSxOp\n  | AssistEditMoveOp\n  | AssistEditRemoveOp\n  | AssistEditRenameOp\n  | AssistEditSetSeoOp\n  | AssistEditSaveAsComponentOp\n\n/** Where a proposal applies, as the server read it off the request. */\nexport interface AssistEditTarget extends AssistEditDocument {\n  hostId: string\n}\n\n/** The counts the card shows before the author decides. */\nexport interface AssistEditDiff {\n  /** Elements added, every element of every inserted subtree counted. */\n  added: number\n  /** Elements removed — each with whatever it contains. */\n  removed: number\n  propsChanged: number\n  stylesChanged: number\n  moved: number\n  renamed: number\n  /** Search fields filled in. */\n  seoFields: number\n  /** Properties the selection declares once it is saved as a component. */\n  componentProps: number\n  /** Selections saved as a reusable component — at most one per proposal. */\n  componentsSaved: number\n}\n\n/** The most reasons a proposal carries for the changes validation left out. */\nexport const ASSIST_EDIT_MAX_DROPPED_REASONS = 10\n\nexport interface AssistEditProposal {\n  id: typeof ASSIST_EDIT_ACTION_ID\n  /** One line, in the model's words, of what the edit does. */\n  summary: string\n  ops: AssistEditOp[]\n  diff: AssistEditDiff\n  /** Why each change the model wrote and validation refused was left out. */\n  dropped: string[]\n  target: AssistEditTarget\n}\n\n/** The counts for a list of ops. */\nexport function summarizeAssistEditOps(ops: readonly AssistEditOp[]): AssistEditDiff {\n  const diff: AssistEditDiff = {\n    added: 0,\n    removed: 0,\n    propsChanged: 0,\n    stylesChanged: 0,\n    moved: 0,\n    renamed: 0,\n    seoFields: 0,\n    componentProps: 0,\n    componentsSaved: 0,\n  }\n  for (const op of ops) {\n    switch (op.op) {\n      case 'insertSubtree':\n        diff.added += Object.keys(op.nodes).length\n        break\n      case 'remove':\n        diff.removed += 1\n        break\n      case 'updateProps':\n        diff.propsChanged += 1\n        break\n      case 'updateSx':\n        diff.stylesChanged += 1\n        break\n      case 'move':\n        diff.moved += 1\n        break\n      case 'rename':\n        diff.renamed += 1\n        break\n      case 'setSeo':\n        diff.seoFields += Object.keys(op.fields).length\n        break\n      case 'saveAsComponent':\n        diff.componentsSaved += 1\n        diff.componentProps += op.props.length\n        break\n    }\n  }\n  return diff\n}\n\nconst plural = (count: number, one: string, many: string): string =>\n  `${count} ${count === 1 ? one : many}`\n\n/** The diff as the lines a person reads, zero counts omitted. */\nexport function describeAssistEditDiff(diff: AssistEditDiff): string[] {\n  const lines: string[] = []\n  if (diff.added) lines.push(`${plural(diff.added, 'element', 'elements')} added`)\n  if (diff.removed) lines.push(`${plural(diff.removed, 'element', 'elements')} removed`)\n  if (diff.propsChanged) {\n    lines.push(`${plural(diff.propsChanged, 'element’s settings', 'elements’ settings')} changed`)\n  }\n  if (diff.stylesChanged) {\n    lines.push(`${plural(diff.stylesChanged, 'element', 'elements')} restyled`)\n  }\n  if (diff.moved) lines.push(`${plural(diff.moved, 'element', 'elements')} moved`)\n  if (diff.renamed) lines.push(`${plural(diff.renamed, 'layer', 'layers')} renamed`)\n  if (diff.seoFields) {\n    lines.push(`${plural(diff.seoFields, 'search field', 'search fields')} filled in`)\n  }\n  if (diff.componentsSaved) {\n    lines.push(\n      `saved as a reusable component with ${plural(diff.componentProps, 'property', 'properties')}`,\n    )\n  }\n  return lines\n}\n\n/** The word each op kind is counted under in the activity row. */\nconst OP_COUNT_WORDS: Readonly<Record<AssistEditOpKind, string>> = {\n  updateProps: 'set',\n  updateSx: 'restyle',\n  insertSubtree: 'insert',\n  move: 'move',\n  remove: 'remove',\n  rename: 'rename',\n  setSeo: 'seo',\n  saveAsComponent: 'component',\n}\n\n/** The applied ops counted by kind, as the activity row names them (`{ set: 3, insert: 1 }`). */\nexport function assistEditOpCounts(ops: readonly AssistEditOp[]): Record<string, number> {\n  const counts: Record<string, number> = {}\n  for (const op of ops) {\n    const word = OP_COUNT_WORDS[op.op]\n    if (word) counts[word] = (counts[word] ?? 0) + 1\n  }\n  return counts\n}\n\n/** The words `assistEditOpCounts` counts under, for a door that reads them back. */\nexport const ASSIST_EDIT_OP_COUNT_WORDS: readonly string[] = Object.values(OP_COUNT_WORDS)\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/**\n * Whether a `done` event's `edit` field is a proposal this client can apply.\n * The server built it, so this is a shape check rather than a validation: it\n * keeps a malformed or foreign payload from reaching the canvas mutators.\n */\nexport function isAssistEditProposal(value: unknown): value is AssistEditProposal {\n  if (!isRecord(value) || value['id'] !== ASSIST_EDIT_ACTION_ID) return false\n  const target = value['target']\n  if (!isRecord(target)) return false\n  if (!ASSIST_EDIT_DOCUMENT_KINDS.includes(target['kind'] as AssistEditDocumentKind)) return false\n  if (typeof target['documentId'] !== 'string' || !target['documentId']) return false\n  const ops = value['ops']\n  if (!Array.isArray(ops) || !ops.length) return false\n  return ops.every(\n    (op) => isRecord(op) && ASSIST_EDIT_OP_KINDS.includes(op['op'] as AssistEditOpKind),\n  )\n}\n\n/* ------------------------------------------------------------------ *\n * What the client reports once the author applied a proposal\n * ------------------------------------------------------------------ */\n\n/** The body of `POST /api/assist/edit-applied`. */\nexport interface AssistEditAppliedReport {\n  orgId: string\n  hostId: string\n  /** The exchange whose answer carried the proposal. */\n  exchangeId: string\n  documentKind: AssistEditDocumentKind\n  documentId: string\n  /** The version the edits landed on — a new one when the open one was live. */\n  versionId: string\n  opCounts: Record<string, number>\n}\n"],"names":["ASSIST_EDIT_OP_KINDS","ASSIST_EDIT_ACTION_ID","ASSIST_EDIT_TOOL_NAME","ASSIST_EDIT_DOCUMENT_KINDS","COLLECTION_KINDS","screens","components","layouts","BESIGNER_DOCUMENT_ROUTE","assistEditDocumentOf","route","match","exec","String","kind","documentId","versionId","ASSIST_EDIT_CONTEXT_MAX_NODES","ASSIST_EDIT_CONTEXT_MAX_PROPS","ASSIST_EDIT_SELECTED_TEXT_CHARS","ASSIST_EDIT_OUTLINE_TEXT_CHARS","ASSIST_EDIT_MAX_DROPPED_REASONS","summarizeAssistEditOps","ops","diff","added","removed","propsChanged","stylesChanged","moved","renamed","seoFields","componentProps","componentsSaved","op","Object","keys","nodes","length","fields","props","plural","count","one","many","describeAssistEditDiff","lines","push","OP_COUNT_WORDS","updateProps","updateSx","insertSubtree","move","remove","rename","setSeo","saveAsComponent","assistEditOpCounts","counts","word","ASSIST_EDIT_OP_COUNT_WORDS","values","isRecord","value","Array","isArray","isAssistEditProposal","target","includes","every"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/assist-edit.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 { ScreenSeoTextField } from '@aglyn/aglyn/app-utils/screen-seo-fields'\nimport type { ReusableComponentProp } from '@aglyn/aglyn/foundation/definitions/platform.types'\nimport type { NodeInteraction } from '@aglyn/aglyn/app-utils/node-interactions'\n\n/**\n * Assist level 3, the edit contract (AGL-2906): what the chat door proposes\n * for a besigner canvas, and what the panel applies once the author says so.\n *\n * Shared by the server, which validates a model's proposal into these\n * shapes, and the client, which applies them. Pure data and pure functions,\n * so the panel imports it without pulling the palette or the runtime.\n *\n * ## The boundary\n *\n * A proposal is OPERATIONS, never a document. The server writes nothing: it\n * answers with ops that name elements already on the canvas, or a validated\n * subtree to insert, and the client applies them through the canvas's own\n * guarded mutators, on confirm, as one undoable step. Every change lands as\n * an unsaved edit on the version the editor has open — a draft — and on a\n * version the live site serves, the editor's own new-version flow runs first.\n */\n\n/** The nine operations a proposal may carry. */\nexport const ASSIST_EDIT_OP_KINDS = [\n  'insertSubtree',\n  'updateProps',\n  'updateSx',\n  'move',\n  'remove',\n  'setSeo',\n  'rename',\n  'saveAsComponent',\n  'addInteraction',\n] as const\n\nexport type AssistEditOpKind = (typeof ASSIST_EDIT_OP_KINDS)[number]\n\n/** The id of the besigner view's edit action — the one edit a view offers. */\nexport const ASSIST_EDIT_ACTION_ID = 'edit.canvas'\n\n/** The name of the structured-output tool a model proposes an edit through. */\nexport const ASSIST_EDIT_TOOL_NAME = 'propose_canvas_edit'\n\n/** The besigner documents the edit rung opens on: those that keep versions. */\nexport type AssistEditDocumentKind = 'screen' | 'component' | 'layout'\n\nexport const ASSIST_EDIT_DOCUMENT_KINDS: readonly AssistEditDocumentKind[] = [\n  'screen',\n  'component',\n  'layout',\n]\n\nconst COLLECTION_KINDS: Readonly<Record<string, AssistEditDocumentKind>> = {\n  screens: 'screen',\n  components: 'component',\n  layouts: 'layout',\n}\n\nconst BESIGNER_DOCUMENT_ROUTE =\n  /^\\/[^/]+\\/hosts\\/[^/]+\\/(screens|components|layouts)\\/([A-Za-z0-9_-]{1,64})\\/versions\\/([A-Za-z0-9_-]{1,64})\\/besigner\\/?$/\n\n/** The document a besigner route has open. */\nexport interface AssistEditDocument {\n  kind: AssistEditDocumentKind\n  documentId: string\n  versionId: string\n}\n\n/**\n * The open document off a console path, or null off a route the edit rung\n * serves. Only the versioned editors qualify — a template or an email editor\n * has no version to make first, so the rung does not open there.\n */\nexport function assistEditDocumentOf(route: string): AssistEditDocument | null {\n  const match = BESIGNER_DOCUMENT_ROUTE.exec(String(route ?? ''))\n  if (!match) return null\n  return {\n    kind: COLLECTION_KINDS[match[1]],\n    documentId: match[2],\n    versionId: match[3],\n  }\n}\n\n/* ------------------------------------------------------------------ *\n * What the client tells the server about the canvas\n * ------------------------------------------------------------------ */\n\n/** Elements a request describes at most — the selection, its surroundings, its subtree. */\nexport const ASSIST_EDIT_CONTEXT_MAX_NODES = 60\n/** Props described per element at most. */\nexport const ASSIST_EDIT_CONTEXT_MAX_PROPS = 16\n/** Characters of a string prop the selected element carries into a request. */\nexport const ASSIST_EDIT_SELECTED_TEXT_CHARS = 400\n/** Characters of a string prop every other element carries. */\nexport const ASSIST_EDIT_OUTLINE_TEXT_CHARS = 80\n\n/**\n * One element of the canvas outline a request carries. Ids, component ids\n * and short primitive values only — never a stored document, never markup.\n */\nexport interface AssistEditCanvasNode {\n  id: string\n  componentId: string\n  /** Null for the document root. */\n  parentId: string | null\n  /** Position among the parent's children. */\n  index: number\n  childCount: number\n  /** The layer name, when the author gave it one. */\n  name?: string\n  /** Primitive props, strings shortened. */\n  props?: Record<string, string | number | boolean>\n  /** The element's own styles — carried for the selected element only. */\n  sx?: Record<string, unknown>\n  /**\n   * Described by its place alone, without props: an element around the\n   * selection, there so the model knows it exists and can ask for it.\n   */\n  brief?: boolean\n  /**\n   * An element described earlier whose contents this one's are built like,\n   * the way the cards of a row are. Its own contents are left out.\n   */\n  like?: string\n  /**\n   * The interactions the element carries (AGL-3603), each by its name, the\n   * event it listens for and its steps' kinds — carried for the selected\n   * element only, so Assist can say what it does. Never a selector, a script\n   * or HTML.\n   */\n  interactions?: AssistEditInteractionSummary[]\n}\n\n/** One interaction on an element, as an outline describes it. */\nexport interface AssistEditInteractionSummary {\n  name: string\n  event: string\n  steps: string[]\n  enabled: boolean\n}\n\n/* ------------------------------------------------------------------ *\n * The interactions Assist may add (AGL-3603)\n * ------------------------------------------------------------------ */\n\n/**\n * The events an interaction Assist adds may listen for: those that watch the\n * element it is added to, the way the Besigner's Interactions section offers\n * them on a selected element.\n */\nexport const ASSIST_EDIT_INTERACTION_EVENTS = [\n  'elementClick',\n  'elementHoverEnter',\n  'elementHoverLeave',\n  'elementVisible',\n  'scrollToElement',\n] as const\n\nexport type AssistEditInteractionEvent = (typeof ASSIST_EDIT_INTERACTION_EVENTS)[number]\n\n/**\n * The steps it may take: the platform's basic presentational client steps,\n * which run on every plan and touch no data. No script, no HTML, no\n * attribute, no overlay, no analytics event — and no server step.\n */\nexport const ASSIST_EDIT_INTERACTION_STEPS = [\n  'showElement',\n  'hideElement',\n  'toggleElement',\n  'addClass',\n  'removeClass',\n  'toggleClass',\n  'scrollTo',\n  'playVideo',\n  'openDrawer',\n  'closeDrawer',\n  'toggleDrawer',\n  'openMenu',\n  'closeMenu',\n  'toggleMenu',\n  'redirect',\n  'siteAlert',\n] as const\n\nexport type AssistEditInteractionStep = (typeof ASSIST_EDIT_INTERACTION_STEPS)[number]\n\nexport interface AssistEditCanvasContext {\n  /** The element the author has selected, or null. */\n  selectedId: string | null\n  /**\n   * Elements in the whole document, the root included, so the prompt can say\n   * how much of it `nodes` leaves out. Absent from an outline sent by a panel\n   * that predates it.\n   */\n  total?: number\n  nodes: AssistEditCanvasNode[]\n}\n\n/* ------------------------------------------------------------------ *\n * What the server proposes\n * ------------------------------------------------------------------ */\n\n/** An element of a validated subtree, in the flat shape the canvas stores. */\nexport interface AssistEditNode {\n  $id: string\n  componentId: string\n  pluginId?: string\n  parentId: string | null\n  nodes: string[]\n  props: Record<string, unknown>\n  sx?: Record<string, unknown>\n  hidden?: boolean\n}\n\n/**\n * Every op that acts on an element names the component the server validated\n * it as, so the client can refuse an element that has changed since.\n */\ninterface AssistEditNodeOpBase {\n  nodeId: string\n  componentId: string\n}\n\nexport interface AssistEditInsertOp {\n  op: 'insertSubtree'\n  parentId: string\n  /** The component the parent was validated as. */\n  parentComponentId: string\n  /** Position among the parent's children; null appends. */\n  index: number | null\n  rootId: string\n  nodes: Record<string, AssistEditNode>\n}\n\nexport interface AssistEditUpdatePropsOp extends AssistEditNodeOpBase {\n  op: 'updateProps'\n  /** Merged over the props the element has; nothing else it carries changes. */\n  props: Record<string, unknown>\n}\n\nexport interface AssistEditUpdateSxOp extends AssistEditNodeOpBase {\n  op: 'updateSx'\n  /** Merged over the element's own styles, one key at a time. */\n  sx: Record<string, unknown>\n}\n\nexport interface AssistEditMoveOp extends AssistEditNodeOpBase {\n  op: 'move'\n  parentId: string\n  /** The component the new parent was validated as. */\n  parentComponentId: string\n  index: number | null\n}\n\nexport interface AssistEditRemoveOp extends AssistEditNodeOpBase {\n  op: 'remove'\n}\n\nexport interface AssistEditRenameOp extends AssistEditNodeOpBase {\n  op: 'rename'\n  name: string\n}\n\nexport interface AssistEditSetSeoOp {\n  op: 'setSeo'\n  fields: Partial<Record<ScreenSeoTextField, string>>\n}\n\n/**\n * A property the promoted subtree declares (AGL-2908), in the shape the\n * Properties dialog stores one — without a default.\n *\n * The server never sees a full value: the outline it read the selection from\n * shortens every string. So the default is read off the live canvas at apply\n * time, from the very field the token is about to replace, which is what\n * makes the instance render what was there a moment before.\n */\nexport type AssistEditComponentProp = Omit<ReusableComponentProp, 'defaultValue'>\n\n/** Where one property's token goes: an element of the selection, and a field of it. */\nexport interface AssistEditPropBinding {\n  nodeId: string\n  /** The component the element was validated as, so a changed one is refused. */\n  componentId: string\n  /** A prop of that element, or `hideIf` for a part a Yes / no hides. */\n  field: string\n  /** The property whose `{{prop.<name>}}` token the field takes. */\n  prop: string\n}\n\n/**\n * Save the selection as a reusable component (AGL-2908), with the properties\n * the model proposed and the tokens bound into the tree.\n *\n * The only op that creates a document. It creates exactly the one the manual\n * Save as reusable component creates, through the same host resources route,\n * where the plan's entitlement and the route's allow-list are enforced — and\n * it changes the open canvas the same way that action does, by swapping the\n * promoted subtree for an instance. Nothing is published and nothing is\n * saved: the swap is an unsaved edit on the version the editor has open.\n */\nexport interface AssistEditSaveAsComponentOp extends AssistEditNodeOpBase {\n  op: 'saveAsComponent'\n  /** The name the component is created under. */\n  name: string\n  props: AssistEditComponentProp[]\n  bindings: AssistEditPropBinding[]\n}\n\n/**\n * Add one interaction to an element (AGL-3603), in the shape the element\n * stores it — its trigger with no selector, which the element's id derives.\n * It never replaces or removes one the element already carries.\n */\nexport interface AssistEditAddInteractionOp extends AssistEditNodeOpBase {\n  op: 'addInteraction'\n  interaction: NodeInteraction\n  /** Every other element a step acts on, each with the component it was validated as. */\n  targets: Array<{ nodeId: string; componentId: string }>\n}\n\nexport type AssistEditOp =\n  | AssistEditAddInteractionOp\n  | AssistEditInsertOp\n  | AssistEditUpdatePropsOp\n  | AssistEditUpdateSxOp\n  | AssistEditMoveOp\n  | AssistEditRemoveOp\n  | AssistEditRenameOp\n  | AssistEditSetSeoOp\n  | AssistEditSaveAsComponentOp\n\n/** Where a proposal applies, as the server read it off the request. */\nexport interface AssistEditTarget extends AssistEditDocument {\n  hostId: string\n}\n\n/** The counts the card shows before the author decides. */\nexport interface AssistEditDiff {\n  /** Elements added, every element of every inserted subtree counted. */\n  added: number\n  /** Elements removed — each with whatever it contains. */\n  removed: number\n  propsChanged: number\n  stylesChanged: number\n  moved: number\n  renamed: number\n  /** Search fields filled in. */\n  seoFields: number\n  /** Properties the selection declares once it is saved as a component. */\n  componentProps: number\n  /** Selections saved as a reusable component — at most one per proposal. */\n  componentsSaved: number\n  /** Interactions added to elements. */\n  interactionsAdded: number\n}\n\n/** The most reasons a proposal carries for the changes validation left out. */\nexport const ASSIST_EDIT_MAX_DROPPED_REASONS = 10\n\nexport interface AssistEditProposal {\n  id: typeof ASSIST_EDIT_ACTION_ID\n  /** One line, in the model's words, of what the edit does. */\n  summary: string\n  ops: AssistEditOp[]\n  diff: AssistEditDiff\n  /** Why each change the model wrote and validation refused was left out. */\n  dropped: string[]\n  target: AssistEditTarget\n}\n\n/** The counts for a list of ops. */\nexport function summarizeAssistEditOps(ops: readonly AssistEditOp[]): AssistEditDiff {\n  const diff: AssistEditDiff = {\n    added: 0,\n    removed: 0,\n    propsChanged: 0,\n    stylesChanged: 0,\n    moved: 0,\n    renamed: 0,\n    seoFields: 0,\n    componentProps: 0,\n    componentsSaved: 0,\n    interactionsAdded: 0,\n  }\n  for (const op of ops) {\n    switch (op.op) {\n      case 'insertSubtree':\n        diff.added += Object.keys(op.nodes).length\n        break\n      case 'remove':\n        diff.removed += 1\n        break\n      case 'updateProps':\n        diff.propsChanged += 1\n        break\n      case 'updateSx':\n        diff.stylesChanged += 1\n        break\n      case 'move':\n        diff.moved += 1\n        break\n      case 'rename':\n        diff.renamed += 1\n        break\n      case 'setSeo':\n        diff.seoFields += Object.keys(op.fields).length\n        break\n      case 'saveAsComponent':\n        diff.componentsSaved += 1\n        diff.componentProps += op.props.length\n        break\n      case 'addInteraction':\n        diff.interactionsAdded += 1\n        break\n    }\n  }\n  return diff\n}\n\nconst plural = (count: number, one: string, many: string): string =>\n  `${count} ${count === 1 ? one : many}`\n\n/** The diff as the lines a person reads, zero counts omitted. */\nexport function describeAssistEditDiff(diff: AssistEditDiff): string[] {\n  const lines: string[] = []\n  if (diff.added) lines.push(`${plural(diff.added, 'element', 'elements')} added`)\n  if (diff.removed) lines.push(`${plural(diff.removed, 'element', 'elements')} removed`)\n  if (diff.propsChanged) {\n    lines.push(`${plural(diff.propsChanged, 'element’s settings', 'elements’ settings')} changed`)\n  }\n  if (diff.stylesChanged) {\n    lines.push(`${plural(diff.stylesChanged, 'element', 'elements')} restyled`)\n  }\n  if (diff.moved) lines.push(`${plural(diff.moved, 'element', 'elements')} moved`)\n  if (diff.renamed) lines.push(`${plural(diff.renamed, 'layer', 'layers')} renamed`)\n  if (diff.seoFields) {\n    lines.push(`${plural(diff.seoFields, 'search field', 'search fields')} filled in`)\n  }\n  if (diff.interactionsAdded) {\n    lines.push(`${plural(diff.interactionsAdded, 'interaction', 'interactions')} added`)\n  }\n  if (diff.componentsSaved) {\n    lines.push(\n      `saved as a reusable component with ${plural(diff.componentProps, 'property', 'properties')}`,\n    )\n  }\n  return lines\n}\n\n/** The word each op kind is counted under in the activity row. */\nconst OP_COUNT_WORDS: Readonly<Record<AssistEditOpKind, string>> = {\n  updateProps: 'set',\n  updateSx: 'restyle',\n  insertSubtree: 'insert',\n  move: 'move',\n  remove: 'remove',\n  rename: 'rename',\n  setSeo: 'seo',\n  saveAsComponent: 'component',\n  addInteraction: 'interaction',\n}\n\n/** The applied ops counted by kind, as the activity row names them (`{ set: 3, insert: 1 }`). */\nexport function assistEditOpCounts(ops: readonly AssistEditOp[]): Record<string, number> {\n  const counts: Record<string, number> = {}\n  for (const op of ops) {\n    const word = OP_COUNT_WORDS[op.op]\n    if (word) counts[word] = (counts[word] ?? 0) + 1\n  }\n  return counts\n}\n\n/** The words `assistEditOpCounts` counts under, for a door that reads them back. */\nexport const ASSIST_EDIT_OP_COUNT_WORDS: readonly string[] = Object.values(OP_COUNT_WORDS)\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/**\n * Whether a `done` event's `edit` field is a proposal this client can apply.\n * The server built it, so this is a shape check rather than a validation: it\n * keeps a malformed or foreign payload from reaching the canvas mutators.\n */\nexport function isAssistEditProposal(value: unknown): value is AssistEditProposal {\n  if (!isRecord(value) || value['id'] !== ASSIST_EDIT_ACTION_ID) return false\n  const target = value['target']\n  if (!isRecord(target)) return false\n  if (!ASSIST_EDIT_DOCUMENT_KINDS.includes(target['kind'] as AssistEditDocumentKind)) return false\n  if (typeof target['documentId'] !== 'string' || !target['documentId']) return false\n  const ops = value['ops']\n  if (!Array.isArray(ops) || !ops.length) return false\n  return ops.every(\n    (op) => isRecord(op) && ASSIST_EDIT_OP_KINDS.includes(op['op'] as AssistEditOpKind),\n  )\n}\n\n/* ------------------------------------------------------------------ *\n * What the client reports once the author applied a proposal\n * ------------------------------------------------------------------ */\n\n/** The body of `POST /api/assist/edit-applied`. */\nexport interface AssistEditAppliedReport {\n  orgId: string\n  hostId: string\n  /** The exchange whose answer carried the proposal. */\n  exchangeId: string\n  documentKind: AssistEditDocumentKind\n  documentId: string\n  /** The version the edits landed on — a new one when the open one was live. */\n  versionId: string\n  opCounts: Record<string, number>\n}\n"],"names":["ASSIST_EDIT_OP_KINDS","ASSIST_EDIT_ACTION_ID","ASSIST_EDIT_TOOL_NAME","ASSIST_EDIT_DOCUMENT_KINDS","COLLECTION_KINDS","screens","components","layouts","BESIGNER_DOCUMENT_ROUTE","assistEditDocumentOf","route","match","exec","String","kind","documentId","versionId","ASSIST_EDIT_CONTEXT_MAX_NODES","ASSIST_EDIT_CONTEXT_MAX_PROPS","ASSIST_EDIT_SELECTED_TEXT_CHARS","ASSIST_EDIT_OUTLINE_TEXT_CHARS","ASSIST_EDIT_INTERACTION_EVENTS","ASSIST_EDIT_INTERACTION_STEPS","ASSIST_EDIT_MAX_DROPPED_REASONS","summarizeAssistEditOps","ops","diff","added","removed","propsChanged","stylesChanged","moved","renamed","seoFields","componentProps","componentsSaved","interactionsAdded","op","Object","keys","nodes","length","fields","props","plural","count","one","many","describeAssistEditDiff","lines","push","OP_COUNT_WORDS","updateProps","updateSx","insertSubtree","move","remove","rename","setSeo","saveAsComponent","addInteraction","assistEditOpCounts","counts","word","ASSIST_EDIT_OP_COUNT_WORDS","values","isRecord","value","Array","isArray","isAssistEditProposal","target","includes","every"],"mappings":"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"}

package/src/lib/plugin-config.js

@@ -38,6 +38,7 @@ import { AI_CATALOG_PROVIDERS, AI_MODEL_CATALOG } from "./providers/catalog.js";
     'job.form': 'jobFormModel',
     'job.insight': 'jobInsightModel',
     'job.layout': 'jobLayoutModel',
+    'job.logic': 'jobLogicModel',
     'job.template': 'jobTemplateModel',
     'job.page': 'jobPageModel',
     'job.products': 'jobProductsModel',
@@ -96,6 +97,7 @@ export const AI_CONFIG_SCHEMA = {
         modelField('job.form', 'Generation job (form) model', 'Generating a form from a confirmed plan.'),
         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.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.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.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,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,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.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"}

package/src/lib/plugin.js

@@ -39,16 +39,27 @@ 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 { AI_PLUGIN_ID } from "./constants.js";
 import { registerAiDeclarations } from "./declarations.js";
@@ -351,26 +362,33 @@ import { registerAiDeclarations } from "./declarations.js";
                 Component: AiSeoAuditCard
             },
             // A page from a brief (AGL-2907): "Create with AI" beside Templates and
-            // Create New Screen. Gated as the other generative widgets are, and it
-            // asks the jobs route about the release flag before it shows anything.
+            // Create New Screen. Gated as the other generative widgets are.
+            // On a plan that could buy the AI add-on and has not, each "Create with
+            // AI" entry here is mounted anyway (`showWhenNotEntitled`) and opens
+            // the add-on's dialog instead of the brief (AGL-3601). The shell holds
+            // each behind `release_ai_generative` too, so an entry draws at once
+            // and asks the jobs route nothing until its brief is sent.
             {
                 slot: 'hostScreens',
                 widgetId: 'ai-describe-page',
                 title: 'Describe a page',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
                 Component: AiDescribePageButton
             },
             // The same entry for a page template, a layout and a form (AGL-3043),
             // beside the create action of the page that lists each: the same
-            // dialog, the same gates, and the same question to the jobs route
-            // before it shows anything.
+            // dialog and the same gates.
             {
                 slot: 'hostTemplates',
                 widgetId: 'ai-describe-template',
                 title: 'Describe a page template',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
                 Component: AiDescribeTemplateButton
             },
             {
@@ -379,6 +397,8 @@ import { registerAiDeclarations } from "./declarations.js";
                 title: 'Describe a layout',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
                 Component: AiDescribeLayoutButton
             },
             {
@@ -387,47 +407,186 @@ import { registerAiDeclarations } from "./declarations.js";
                 title: 'Describe a form',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
                 Component: AiDescribeFormButton
             },
             // And a reusable component from a brief (AGL-3051), beside Templates
             // and Create Component: the component job's first entry point, which
             // had none in the console.
+            // Pictures from a description (AGL-3602): "Create with AI" beside Upload
+            // media in the media library, and in its empty state. Gated as the
+            // other generative widgets are, by the shell alone: it asks nothing of
+            // a server until someone creates a picture, and the door decides then.
+            {
+                slot: 'mediaLibrary',
+                widgetId: 'ai-media-create',
+                title: 'Create images with AI',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                Component: AiMediaCreateButton
+            },
             {
                 slot: 'hostComponents',
                 widgetId: 'ai-describe-component',
                 title: 'Describe a reusable component',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
                 Component: AiDescribeComponentButton
             },
+            // An email design from a brief (AGL-3596), beside New template on a
+            // site's email templates — the zone the email plugin hosts. Its dialog
+            // also offers the draft campaign that would send it; the Campaigns
+            // section's own door is `ai-create-campaign`, below.
+            {
+                slot: 'hostEmailTemplates',
+                widgetId: 'ai-describe-email',
+                title: 'Describe an email',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiDescribeEmailButton
+            },
             // Automations by AI (AGL-2919), in the zones the workflows plugin hosts
             // on its Automation page: "Create with AI" beside Add action and Recipes,
             // "Explain it" in the editor of a saved automation, and "Why did this
-            // fail?" on a failed run. Gated as the other generative widgets are;
-            // each asks the jobs route about the release flag before it shows
-            // anything, and none of them changes an automation.
+            // fail?" on a failed run. Gated as the other generative widgets are,
+            // the release flag included, by the shell alone (AGL-3601): none asks
+            // the jobs route anything until it is used, and none of them changes an
+            // automation.
             {
                 slot: 'hostAutomations',
                 widgetId: 'ai-describe-automation',
                 title: 'Describe an automation',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
                 Component: AiDescribeAutomationButton
             },
+            // Funnels by AI (AGL-3605), in the zones the funnels plugin hosts on
+            // its card: a draft from a description, and its results explained.
+            {
+                slot: 'funnelsCreate',
+                widgetId: 'ai-describe-funnel',
+                title: 'Describe a funnel',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiFunnelCreateButton
+            },
+            {
+                slot: 'funnelInsight',
+                widgetId: 'ai-explain-funnel',
+                title: 'Ask AI about this funnel',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiFunnelAskButton
+            },
             {
                 slot: 'automationEditor',
                 widgetId: 'ai-explain-automation',
                 title: 'Explain this automation',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
                 Component: AiExplainAutomation
             },
+            // "Change with AI" and "Fix with AI" in a saved action's editor
+            // (AGL-3603): a changed copy drafted OFF beside it, never the saved
+            // action written in place.
+            {
+                slot: 'automationEditor',
+                widgetId: 'ai-revise-automation',
+                title: 'Change this automation with AI',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
+                Component: AiReviseAutomation
+            },
+            // "Create with AI" on the workspace's Org automations (AGL-3603): one
+            // of the workspace's automations drafted from a description and opened
+            // in that section's editor, unsaved and switched off.
+            {
+                slot: 'orgAutomations',
+                widgetId: 'ai-describe-org-automation',
+                title: 'Describe an org automation',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiDescribeOrgAutomationButton
+            },
+            // "Ask AI about these numbers" (AGL-3603): a tile on a site's
+            // dashboard and Analytics page, which both draw `hostDashboard`, and on
+            // the workspace's sites page. It opens the insight dialog the Assist
+            // panel opens, gated as every generative widget is.
+            {
+                slot: 'hostDashboard',
+                widgetId: 'ai-insight-ask',
+                title: 'Ask AI about these numbers',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiInsightHostCard
+            },
+            {
+                slot: 'orgDashboard',
+                widgetId: 'ai-insight-ask',
+                title: 'Ask AI about these numbers',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiInsightOrgCard
+            },
+            // Logic by AI (AGL-3603), in the zones the logic plugin hosts on its
+            // Functions & Variables page: Create with AI in the Functions and
+            // Variables card headers, Explain / Change / Fix in a saved function's
+            // editor, and Fix with AI on a broken reference an automation holds.
+            // Each proposal opens unsaved in the logic editor; none is saved here.
+            {
+                slot: 'hostLogic',
+                widgetId: 'ai-describe-logic',
+                title: 'Describe a function or variable',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiLogicCreateButton
+            },
+            {
+                slot: 'logicFunctionEditor',
+                widgetId: 'ai-logic-function',
+                title: 'This function with AI',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
+                Component: AiLogicFunctionTools
+            },
+            {
+                slot: 'logicReferenceIssue',
+                widgetId: 'ai-logic-fix-reference',
+                title: 'Fix this reference with AI',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
+                Component: AiLogicFixReference
+            },
             {
                 slot: 'automationRun',
                 widgetId: 'ai-explain-run-failure',
                 title: 'Why did this run fail?',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
                 Component: AiExplainRunFailure
             },
             // CRM by AI (AGL-2917): a record's summary and next step on its page,
@@ -504,8 +663,9 @@ import { registerAiDeclarations } from "./declarations.js";
             // Commerce by AI (AGL-2916): product copy in the product editor, the
             // catalog, categories and discounts on the products hub, and copy for
             // an import as it lands. The commerce plugin hosts the zones and makes
-            // every write; each card asks the jobs route about the release flag
-            // before it shows anything.
+            // every write. The shell holds the release flag; the products hub card
+            // reads its recent proposals before it draws its own controls, but
+            // offers the "Create with AI" door's brief from the moment it mounts.
             {
                 slot: 'productEditor',
                 widgetId: 'ai-product-copy',
@@ -520,8 +680,22 @@ import { registerAiDeclarations } from "./declarations.js";
                 title: 'Build your catalog with AI',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
                 Component: AiProductsHubCard
             },
+            // "Create with AI" beside Add product and in the empty catalog
+            // (AGL-3596): a door to the card's Propose products brief, shown only
+            // while that card is on the page to take it.
+            {
+                slot: 'productsCreate',
+                widgetId: 'ai-products-create',
+                title: 'Propose products',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiCreateProductsButton
+            },
             {
                 slot: 'productImport',
                 widgetId: 'ai-product-import',
@@ -534,8 +708,8 @@ import { registerAiDeclarations } from "./declarations.js";
             // editor, and one test's result read in plain words below its figures.
             // The A/B testing card hosts both zones, so they are drawn only where
             // that card is and only on a site with A/B testing; the shell holds the
-            // plan band and `ai.generate`, and each card asks the jobs route about
-            // the release flag before it shows anything. Neither writes: the
+            // plan band, `ai.generate` and the release flag, and neither card asks
+            // the jobs route anything until it is used (AGL-3601). Neither writes: the
             // experiment editor's Save is the only write, and an explanation has
             // nothing to apply.
             {
@@ -544,6 +718,7 @@ import { registerAiDeclarations } from "./declarations.js";
                 title: 'Write variants with AI',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
                 Component: AiExperimentVariantsCard
             },
             {
@@ -552,7 +727,61 @@ import { registerAiDeclarations } from "./declarations.js";
                 title: 'Explain this result with AI',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
                 Component: AiExperimentResultCard
+            },
+            // Overlays by AI (AGL-3603), in the zones the marketing plugin's
+            // overlays list hosts: "Create with AI" beside New bar and New popup,
+            // and "Write with AI" among the overlay editor's fields. Both start a
+            // `text` job asked for overlay copy; neither writes — the list saves a
+            // created overlay switched off, and the editor's Save is the write.
+            {
+                slot: 'hostOverlays',
+                widgetId: 'ai-create-overlay',
+                title: 'Create an overlay with AI',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiCreateOverlayButton
+            },
+            {
+                slot: 'overlayEditor',
+                widgetId: 'ai-overlay-copy',
+                title: 'Write overlay copy with AI',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
+                Component: AiOverlayEditorCard
+            },
+            // A campaign from a brief (AGL-3603), beside Create campaign on the
+            // Campaigns section the marketing plugin hosts: the `campaign` job's
+            // first console door, or the `email` job's where the plan sends no
+            // campaign email. Both write drafts that are aimed at nobody and sent
+            // by nobody until a member does.
+            {
+                slot: 'hostCampaigns',
+                widgetId: 'ai-create-campaign',
+                title: 'Create a campaign with AI',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiCreateCampaignButton
+            },
+            // The figures in words (AGL-3603), in the header of the Conversions
+            // section and of one campaign's report: the insight dialog the Assist
+            // panel opens, on the Marketing surface, for the site the figures are.
+            // It reads and cites; it changes nothing.
+            {
+                slot: 'marketingInsights',
+                widgetId: 'ai-marketing-insight',
+                title: 'Ask AI about these numbers',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiMarketingInsightButton
             }
         ]
     });