@aglyn/plugins-ai 1.0.0-beta.296 → 1.1.0

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'\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 * Elements a whole-document outline describes at most: one the server reads\n * from the stored document for an edit job, where nothing is selected and\n * nobody can be asked to select what the outline leaves out. Far past a page\n * an AI build or a starter makes (the starter home has 182), so in practice\n * the model sees every element it could be asked about.\n */\nexport const ASSIST_EDIT_WHOLE_MAX_NODES = 400\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  /**\n   * The element's own styles — carried for the selected element only, and\n   * for every element of a whole-document outline.\n   */\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   * The document as stored, read on the server for a job: every element in\n   * page order up to {@link ASSIST_EDIT_WHOLE_MAX_NODES}, each with its\n   * settings and styles, and nobody to ask. Never read from a request body.\n   */\n  whole?: true\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_WHOLE_MAX_NODES","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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"}
+{"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 * Elements a whole-document outline describes at most: one the server reads\n * from the stored document for an edit job, or the chat in the Besigner sends\n * of the open canvas (AGL-4116). Far past a page an AI build or a starter makes\n * (the starter home has 182), so in practice the model sees every element it\n * could be asked about.\n */\nexport const ASSIST_EDIT_WHOLE_MAX_NODES = 400\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  /**\n   * The element's own styles — carried for the selected element only, and\n   * for every element of a whole-document outline.\n   */\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   * The whole document, every element in page order up to\n   * {@link ASSIST_EDIT_WHOLE_MAX_NODES}, each with its settings and styles:\n   * read from the store for a job, or from the open canvas for the chat in the\n   * Besigner (AGL-4116).\n   */\n  whole?: true\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_WHOLE_MAX_NODES","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/model/assist-page-change.d.ts

@@ -84,3 +84,37 @@ export declare function assistPageChangeDraftVersion(changes: ReadonlyArray<{
     pageChange?: AssistPageChangeProposal | null;
     pageChangeJob?: AiJobSummary | null;
 }>, pageId: string): string | null;
+/** What a page change came to, as the turn that asked for it holds it. */
+export interface AssistPageChangeTurn {
+    pageChange?: AssistPageChangeProposal | null;
+    pageChangeJob?: AiJobSummary | null;
+    pageChangeNotice?: string | null;
+}
+/** A turn of a thread, as far as what it changed goes. */
+export interface AssistOutcomeTurn extends AssistPageChangeTurn {
+    edit?: {
+        summary: string;
+    } | null;
+    editOutcome?: {
+        kind: string;
+        message?: string;
+    } | null;
+}
+/** How many of a thread's outcomes ride a question, the newest kept. */
+export declare const ASSIST_OUTCOMES_SENT = 12;
+/**
+ * What became of a turn's page change, or null when the turn asked for none
+ * (AGL-4116).
+ */
+export declare function assistPageChangeOutcome(turn: AssistPageChangeTurn): string | null;
+/**
+ * What a thread's changes came to, oldest first, for the next question to
+ * carry apart from the thread's words (AGL-4116).
+ *
+ * Apart, because a note added to the assistant's own turn reads as the model
+ * saying so: it is told never to say a change is made, so it took its record
+ * of a saved draft for its own mistake and took the change back, telling the
+ * person nothing had changed. The chat sees a thread's text and nothing else,
+ * so without these it cannot know what happened at all.
+ */
+export declare function assistThreadOutcomes(turns: readonly AssistOutcomeTurn[]): string[];

package/src/lib/model/assist-page-change.js

@@ -82,5 +82,48 @@ function isRecord(value) {
     }
     return null;
 }
+/** How many of a thread's outcomes ride a question, the newest kept. */ export const ASSIST_OUTCOMES_SENT = 12;
+/**
+ * What became of a turn's page change, or null when the turn asked for none
+ * (AGL-4116).
+ */ export function assistPageChangeOutcome(turn) {
+    var _turn_pageChangeJob, _output_note;
+    const proposal = turn.pageChange;
+    if (!proposal) return null;
+    const change = `Page change on ${proposal.pageName}`;
+    if (turn.pageChangeNotice) return `${change} not started: ${turn.pageChangeNotice}`;
+    const job = (_turn_pageChangeJob = turn.pageChangeJob) != null ? _turn_pageChangeJob : null;
+    const output = assistPageChangeOutput(job);
+    if (output) return `${change}: ${(_output_note = output.note) != null ? _output_note : 'saved, not published.'}`;
+    if ((job == null ? void 0 : job.status) === 'failed' || (job == null ? void 0 : job.status) === 'canceled') {
+        var _job_error;
+        return `${change} not made: ${(_job_error = job.error) != null ? _job_error : job.status}`;
+    }
+    return `${change} being made.`;
+}
+/** What became of a turn's edit card, or null while it waits for an answer. */ function assistEditOutcome(turn) {
+    var _turn_editOutcome, _turn_editOutcome1, _turn_editOutcome2;
+    if (!turn.edit) return null;
+    const summary = turn.edit.summary;
+    if (((_turn_editOutcome = turn.editOutcome) == null ? void 0 : _turn_editOutcome.kind) === 'applied') return `Applied to the open canvas as an unsaved change: ${summary}`;
+    if (((_turn_editOutcome1 = turn.editOutcome) == null ? void 0 : _turn_editOutcome1.kind) === 'dismissed') return `Not applied, they turned it down: ${summary}`;
+    if (((_turn_editOutcome2 = turn.editOutcome) == null ? void 0 : _turn_editOutcome2.kind) === 'failed') return `Could not be applied: ${summary}`;
+    return null;
+}
+/**
+ * What a thread's changes came to, oldest first, for the next question to
+ * carry apart from the thread's words (AGL-4116).
+ *
+ * Apart, because a note added to the assistant's own turn reads as the model
+ * saying so: it is told never to say a change is made, so it took its record
+ * of a saved draft for its own mistake and took the change back, telling the
+ * person nothing had changed. The chat sees a thread's text and nothing else,
+ * so without these it cannot know what happened at all.
+ */ export function assistThreadOutcomes(turns) {
+    return turns.flatMap((turn)=>[
+            assistPageChangeOutcome(turn),
+            assistEditOutcome(turn)
+        ]).filter((outcome)=>outcome !== null).slice(-ASSIST_OUTCOMES_SENT);
+}
 
 //# sourceMappingURL=assist-page-change.js.map

package/src/lib/model/assist-page-change.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/assist-page-change.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\n/**\n * A change to a page the site already has, asked in the Assist chat\n * (AGL-4116). No plan and no new page: the panel starts one `edit` job on\n * that page, which saves the change into the page's draft — on every plan,\n * the draft the Besigner offers with Open draft — and the card links the\n * page in the Besigner, where the person checks it and publishes it. Only\n * when they ask for a new version, and the plan keeps version history, is\n * the change saved as a new unpublished version instead.\n *\n * Asked through a build, a change to the home page came back as a second\n * page at `/` the plan generated from scratch, and every follow-up made\n * another plan. This is the short way, for the request that only changes\n * what is there.\n *\n * Shared by the chat door that resolves it and the panel that starts it.\n * Pure: no request, no React.\n */\n\nimport type { AiJobOutput, AiJobSummary } from './ai-jobs.types'\n\n/** The strict tool the chat model asks for a change to a page through. */\nexport const ASSIST_PAGE_CHANGE_TOOL_NAME = 'change_page'\n\n/** The proposal's fixed id, as `assistant_proposal_shown` records it. */\nexport const ASSIST_PAGE_CHANGE_ACTION_ID = 'page-change'\n\n/** The longest one-line summary the card shows. */\nexport const ASSIST_PAGE_CHANGE_SUMMARY_MAX_CHARS = 200\n\nconst DOCUMENT_ID = /^[A-Za-z0-9_-]{1,100}$/\n\nexport interface AssistPageChangeProposal {\n  id: typeof ASSIST_PAGE_CHANGE_ACTION_ID\n  /** The site the request was asked on; the job is created for it. */\n  hostId: string\n  /** The page to change: one the site has, by its id. */\n  pageId: string\n  /** The page's name, as the site's list of pages gives it. */\n  pageName: string\n  /** What to change on it, in the person's words. */\n  brief: string\n  /** One line saying what will change. */\n  summary: string\n  /** They asked for a new version of the page; otherwise the change goes into its draft. */\n  newVersion?: boolean\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\n/** Shape-checks a page change before it can start a job. */\nexport function isAssistPageChangeProposal(value: unknown): value is AssistPageChangeProposal {\n  if (!isRecord(value) || value['id'] !== ASSIST_PAGE_CHANGE_ACTION_ID) return false\n  return (\n    typeof value['hostId'] === 'string' &&\n    DOCUMENT_ID.test(value['hostId']) &&\n    typeof value['pageId'] === 'string' &&\n    DOCUMENT_ID.test(value['pageId']) &&\n    typeof value['pageName'] === 'string' &&\n    typeof value['brief'] === 'string' &&\n    value['brief'].trim().length > 0 &&\n    typeof value['summary'] === 'string' &&\n    (value['newVersion'] === undefined || typeof value['newVersion'] === 'boolean')\n  )\n}\n\n/**\n * The body of `POST /api/ai/jobs` a page change starts: an `edit` of the\n * page. `versionId` is the version an earlier change in the same\n * conversation wrote to, so a follow-up changes that version's draft rather\n * than starting again from the published page.\n */\nexport function assistPageChangeJobRequest(\n  orgId: string,\n  proposal: AssistPageChangeProposal,\n  versionId: string | null,\n): {\n  orgId: string\n  hostId: string\n  kind: 'edit'\n  brief: string\n  inputs: { target: string; targetKind: 'screen'; versionId?: string; newVersion?: true }\n} {\n  return {\n    orgId,\n    hostId: proposal.hostId,\n    kind: 'edit',\n    brief: proposal.brief,\n    inputs: {\n      target: proposal.pageId,\n      targetKind: 'screen',\n      ...(versionId ? { versionId } : {}),\n      ...(proposal.newVersion ? { newVersion: true as const } : {}),\n    },\n  }\n}\n\n/** The version a finished change wrote to the page, or `null` before there is one. */\nexport function assistPageChangeOutput(job: Pick<AiJobSummary, 'status' | 'outputs'> | null): AiJobOutput | null {\n  if (!job || job.status !== 'done') return null\n  return job.outputs.find((output) => output.resource === 'screen' && Boolean(output.versionId)) ?? null\n}\n\n/**\n * The version a new change to `pageId` continues (AGL-4116): the one the\n * conversation's latest finished change to that page wrote to — its draft\n * holds that change — or `null` to start from the page as it is.\n */\nexport function assistPageChangeDraftVersion(\n  changes: ReadonlyArray<{ pageChange?: AssistPageChangeProposal | null; pageChangeJob?: AiJobSummary | null }>,\n  pageId: string,\n): string | null {\n  for (let index = changes.length - 1; index >= 0; index -= 1) {\n    const change = changes[index]\n    if (change.pageChange?.pageId !== pageId) continue\n    const output = assistPageChangeOutput(change.pageChangeJob ?? null)\n    if (output?.versionId) return output.versionId\n  }\n  return null\n}\n"],"names":["ASSIST_PAGE_CHANGE_TOOL_NAME","ASSIST_PAGE_CHANGE_ACTION_ID","ASSIST_PAGE_CHANGE_SUMMARY_MAX_CHARS","DOCUMENT_ID","isRecord","value","Array","isArray","isAssistPageChangeProposal","test","trim","length","undefined","assistPageChangeJobRequest","orgId","proposal","versionId","hostId","kind","brief","inputs","target","pageId","targetKind","newVersion","assistPageChangeOutput","job","status","outputs","find","output","resource","Boolean","assistPageChangeDraftVersion","changes","index","change","pageChange","pageChangeJob"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;CAgBC;AAID,wEAAwE,GACxE,OAAO,MAAMA,+BAA+B,cAAa;AAEzD,uEAAuE,GACvE,OAAO,MAAMC,+BAA+B,cAAa;AAEzD,iDAAiD,GACjD,OAAO,MAAMC,uCAAuC,IAAG;AAEvD,MAAMC,cAAc;AAkBpB,SAASC,SAASC,KAAc;IAC9B,OAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,CAACC,MAAMC,OAAO,CAACF;AACvE;AAEA,0DAA0D,GAC1D,OAAO,SAASG,2BAA2BH,KAAc;IACvD,IAAI,CAACD,SAASC,UAAUA,KAAK,CAAC,KAAK,KAAKJ,8BAA8B,OAAO;IAC7E,OACE,OAAOI,KAAK,CAAC,SAAS,KAAK,YAC3BF,YAAYM,IAAI,CAACJ,KAAK,CAAC,SAAS,KAChC,OAAOA,KAAK,CAAC,SAAS,KAAK,YAC3BF,YAAYM,IAAI,CAACJ,KAAK,CAAC,SAAS,KAChC,OAAOA,KAAK,CAAC,WAAW,KAAK,YAC7B,OAAOA,KAAK,CAAC,QAAQ,KAAK,YAC1BA,KAAK,CAAC,QAAQ,CAACK,IAAI,GAAGC,MAAM,GAAG,KAC/B,OAAON,KAAK,CAAC,UAAU,KAAK,YAC3BA,CAAAA,KAAK,CAAC,aAAa,KAAKO,aAAa,OAAOP,KAAK,CAAC,aAAa,KAAK,SAAQ;AAEjF;AAEA;;;;;CAKC,GACD,OAAO,SAASQ,2BACdC,KAAa,EACbC,QAAkC,EAClCC,SAAwB;IAQxB,OAAO;QACLF;QACAG,QAAQF,SAASE,MAAM;QACvBC,MAAM;QACNC,OAAOJ,SAASI,KAAK;QACrBC,QAAQ;YACNC,QAAQN,SAASO,MAAM;YACvBC,YAAY;WACRP,YAAY;YAAEA;QAAU,IAAI,CAAC,GAC7BD,SAASS,UAAU,GAAG;YAAEA,YAAY;QAAc,IAAI,CAAC;IAE/D;AACF;AAEA,oFAAoF,GACpF,OAAO,SAASC,uBAAuBC,GAAoD;QAElFA;IADP,IAAI,CAACA,OAAOA,IAAIC,MAAM,KAAK,QAAQ,OAAO;IAC1C,QAAOD,oBAAAA,IAAIE,OAAO,CAACC,IAAI,CAAC,CAACC,SAAWA,OAAOC,QAAQ,KAAK,YAAYC,QAAQF,OAAOd,SAAS,cAArFU,oBAA2F;AACpG;AAEA;;;;CAIC,GACD,OAAO,SAASO,6BACdC,OAA6G,EAC7GZ,MAAc;IAEd,IAAK,IAAIa,QAAQD,QAAQvB,MAAM,GAAG,GAAGwB,SAAS,GAAGA,SAAS,EAAG;YAGrBC;YADlCA;QADJ,MAAMA,SAASF,OAAO,CAACC,MAAM;QAC7B,IAAIC,EAAAA,qBAAAA,OAAOC,UAAU,qBAAjBD,mBAAmBd,MAAM,MAAKA,QAAQ;QAC1C,MAAMQ,SAASL,wBAAuBW,wBAAAA,OAAOE,aAAa,YAApBF,wBAAwB;QAC9D,IAAIN,0BAAAA,OAAQd,SAAS,EAAE,OAAOc,OAAOd,SAAS;IAChD;IACA,OAAO;AACT"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/assist-page-change.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\n/**\n * A change to a page the site already has, asked in the Assist chat\n * (AGL-4116). No plan and no new page: the panel starts one `edit` job on\n * that page, which saves the change into the page's draft — on every plan,\n * the draft the Besigner offers with Open draft — and the card links the\n * page in the Besigner, where the person checks it and publishes it. Only\n * when they ask for a new version, and the plan keeps version history, is\n * the change saved as a new unpublished version instead.\n *\n * Asked through a build, a change to the home page came back as a second\n * page at `/` the plan generated from scratch, and every follow-up made\n * another plan. This is the short way, for the request that only changes\n * what is there.\n *\n * Shared by the chat door that resolves it and the panel that starts it.\n * Pure: no request, no React.\n */\n\nimport type { AiJobOutput, AiJobSummary } from './ai-jobs.types'\n\n/** The strict tool the chat model asks for a change to a page through. */\nexport const ASSIST_PAGE_CHANGE_TOOL_NAME = 'change_page'\n\n/** The proposal's fixed id, as `assistant_proposal_shown` records it. */\nexport const ASSIST_PAGE_CHANGE_ACTION_ID = 'page-change'\n\n/** The longest one-line summary the card shows. */\nexport const ASSIST_PAGE_CHANGE_SUMMARY_MAX_CHARS = 200\n\nconst DOCUMENT_ID = /^[A-Za-z0-9_-]{1,100}$/\n\nexport interface AssistPageChangeProposal {\n  id: typeof ASSIST_PAGE_CHANGE_ACTION_ID\n  /** The site the request was asked on; the job is created for it. */\n  hostId: string\n  /** The page to change: one the site has, by its id. */\n  pageId: string\n  /** The page's name, as the site's list of pages gives it. */\n  pageName: string\n  /** What to change on it, in the person's words. */\n  brief: string\n  /** One line saying what will change. */\n  summary: string\n  /** They asked for a new version of the page; otherwise the change goes into its draft. */\n  newVersion?: boolean\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\n/** Shape-checks a page change before it can start a job. */\nexport function isAssistPageChangeProposal(value: unknown): value is AssistPageChangeProposal {\n  if (!isRecord(value) || value['id'] !== ASSIST_PAGE_CHANGE_ACTION_ID) return false\n  return (\n    typeof value['hostId'] === 'string' &&\n    DOCUMENT_ID.test(value['hostId']) &&\n    typeof value['pageId'] === 'string' &&\n    DOCUMENT_ID.test(value['pageId']) &&\n    typeof value['pageName'] === 'string' &&\n    typeof value['brief'] === 'string' &&\n    value['brief'].trim().length > 0 &&\n    typeof value['summary'] === 'string' &&\n    (value['newVersion'] === undefined || typeof value['newVersion'] === 'boolean')\n  )\n}\n\n/**\n * The body of `POST /api/ai/jobs` a page change starts: an `edit` of the\n * page. `versionId` is the version an earlier change in the same\n * conversation wrote to, so a follow-up changes that version's draft rather\n * than starting again from the published page.\n */\nexport function assistPageChangeJobRequest(\n  orgId: string,\n  proposal: AssistPageChangeProposal,\n  versionId: string | null,\n): {\n  orgId: string\n  hostId: string\n  kind: 'edit'\n  brief: string\n  inputs: { target: string; targetKind: 'screen'; versionId?: string; newVersion?: true }\n} {\n  return {\n    orgId,\n    hostId: proposal.hostId,\n    kind: 'edit',\n    brief: proposal.brief,\n    inputs: {\n      target: proposal.pageId,\n      targetKind: 'screen',\n      ...(versionId ? { versionId } : {}),\n      ...(proposal.newVersion ? { newVersion: true as const } : {}),\n    },\n  }\n}\n\n/** The version a finished change wrote to the page, or `null` before there is one. */\nexport function assistPageChangeOutput(job: Pick<AiJobSummary, 'status' | 'outputs'> | null): AiJobOutput | null {\n  if (!job || job.status !== 'done') return null\n  return job.outputs.find((output) => output.resource === 'screen' && Boolean(output.versionId)) ?? null\n}\n\n/**\n * The version a new change to `pageId` continues (AGL-4116): the one the\n * conversation's latest finished change to that page wrote to — its draft\n * holds that change — or `null` to start from the page as it is.\n */\nexport function assistPageChangeDraftVersion(\n  changes: ReadonlyArray<{ pageChange?: AssistPageChangeProposal | null; pageChangeJob?: AiJobSummary | null }>,\n  pageId: string,\n): string | null {\n  for (let index = changes.length - 1; index >= 0; index -= 1) {\n    const change = changes[index]\n    if (change.pageChange?.pageId !== pageId) continue\n    const output = assistPageChangeOutput(change.pageChangeJob ?? null)\n    if (output?.versionId) return output.versionId\n  }\n  return null\n}\n\n/** What a page change came to, as the turn that asked for it holds it. */\nexport interface AssistPageChangeTurn {\n  pageChange?: AssistPageChangeProposal | null\n  pageChangeJob?: AiJobSummary | null\n  pageChangeNotice?: string | null\n}\n\n/** A turn of a thread, as far as what it changed goes. */\nexport interface AssistOutcomeTurn extends AssistPageChangeTurn {\n  edit?: { summary: string } | null\n  editOutcome?: { kind: string; message?: string } | null\n}\n\n/** How many of a thread's outcomes ride a question, the newest kept. */\nexport const ASSIST_OUTCOMES_SENT = 12\n\n/**\n * What became of a turn's page change, or null when the turn asked for none\n * (AGL-4116).\n */\nexport function assistPageChangeOutcome(turn: AssistPageChangeTurn): string | null {\n  const proposal = turn.pageChange\n  if (!proposal) return null\n  const change = `Page change on ${proposal.pageName}`\n  if (turn.pageChangeNotice) return `${change} not started: ${turn.pageChangeNotice}`\n  const job = turn.pageChangeJob ?? null\n  const output = assistPageChangeOutput(job)\n  if (output) return `${change}: ${output.note ?? 'saved, not published.'}`\n  if (job?.status === 'failed' || job?.status === 'canceled') {\n    return `${change} not made: ${job.error ?? job.status}`\n  }\n  return `${change} being made.`\n}\n\n/** What became of a turn's edit card, or null while it waits for an answer. */\nfunction assistEditOutcome(turn: AssistOutcomeTurn): string | null {\n  if (!turn.edit) return null\n  const summary = turn.edit.summary\n  if (turn.editOutcome?.kind === 'applied') return `Applied to the open canvas as an unsaved change: ${summary}`\n  if (turn.editOutcome?.kind === 'dismissed') return `Not applied, they turned it down: ${summary}`\n  if (turn.editOutcome?.kind === 'failed') return `Could not be applied: ${summary}`\n  return null\n}\n\n/**\n * What a thread's changes came to, oldest first, for the next question to\n * carry apart from the thread's words (AGL-4116).\n *\n * Apart, because a note added to the assistant's own turn reads as the model\n * saying so: it is told never to say a change is made, so it took its record\n * of a saved draft for its own mistake and took the change back, telling the\n * person nothing had changed. The chat sees a thread's text and nothing else,\n * so without these it cannot know what happened at all.\n */\nexport function assistThreadOutcomes(turns: readonly AssistOutcomeTurn[]): string[] {\n  return turns\n    .flatMap((turn) => [assistPageChangeOutcome(turn), assistEditOutcome(turn)])\n    .filter((outcome): outcome is string => outcome !== null)\n    .slice(-ASSIST_OUTCOMES_SENT)\n}\n"],"names":["ASSIST_PAGE_CHANGE_TOOL_NAME","ASSIST_PAGE_CHANGE_ACTION_ID","ASSIST_PAGE_CHANGE_SUMMARY_MAX_CHARS","DOCUMENT_ID","isRecord","value","Array","isArray","isAssistPageChangeProposal","test","trim","length","undefined","assistPageChangeJobRequest","orgId","proposal","versionId","hostId","kind","brief","inputs","target","pageId","targetKind","newVersion","assistPageChangeOutput","job","status","outputs","find","output","resource","Boolean","assistPageChangeDraftVersion","changes","index","change","pageChange","pageChangeJob","ASSIST_OUTCOMES_SENT","assistPageChangeOutcome","turn","pageName","pageChangeNotice","note","error","assistEditOutcome","edit","summary","editOutcome","assistThreadOutcomes","turns","flatMap","filter","outcome","slice"],"mappings":"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"}

package/src/lib/runtime/ai-node-tree.js

@@ -1,5 +1,6 @@
 import { _ as _extends } from "@swc/helpers/_/_extends";
 import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { _ as _to_property_key } from "@swc/helpers/_/_to_property_key";
 /**
  * @license
  * Copyright 2026 Aglyn LLC
@@ -20,6 +21,7 @@ import { AI_NODE_CAPABILITIES, AI_PALETTE, AI_SURFACES, AI_SX_TOKENS } from "./a
 import { linealRelationshipPermits } from "@aglyn/aglyn/app-utils/lineal-order";
 import { NODE_MAP_MAX_BYTES, nodeMapBytes } from "@aglyn/aglyn/app-utils/measure-node-map";
 import { parseMediaRef } from "@aglyn/aglyn/app-utils/media-ref";
+import { SX_SCHEME_DARK_KEY } from "@aglyn/aglyn/app-utils/scheme-sx";
 import { COMPONENT_PROP_NAME_PATTERN, REUSABLE_INSTANCE_COMPONENT_ID, REUSABLE_INSTANCE_PROP_VALUES_KEY } from "@aglyn/aglyn/app-utils/reusable-component-keys";
 import { createIdUrlSafe } from "@aglyn/aglyn/foundation/constants/app";
 import { CANVAS_ROOT_ELEMENT_ID } from "@aglyn/aglyn/foundation/constants/canvas";
@@ -877,7 +879,7 @@ function validate(input, surface, context) {
     ];
     mint(rootId);
     while(queue.length){
-        var _node_nodes;
+        var _node_nodes, _sxByNodeId_get;
         const { id, parentId } = queue.shift();
         const node = sanitized.nodes[id];
         const entry = AI_PALETTE[node.componentId];
@@ -986,7 +988,21 @@ function validate(input, surface, context) {
                 error: `${entry.displayName} (${id}) is missing its required "${propsResult.missing}" prop`
             };
         }
-        const sx = sanitizeSx(id, sxByNodeId.get(id), repairs);
+        // A logo code draws for one color scheme (AGL-4119): whether it shows, and
+        // nothing else. A model never writes this key, and its own sx never keeps it.
+        const _ref = (_sxByNodeId_get = sxByNodeId.get(id)) != null ? _sxByNodeId_get : {}, { [SX_SCHEME_DARK_KEY]: schemeSx } = _ref, ownSx = _object_without_properties_loose(_ref, [
+            _to_property_key(SX_SCHEME_DARK_KEY)
+        ]);
+        const shownInDark = codeBuilt && isRecord(schemeSx) && [
+            'none',
+            'block'
+        ].includes(String(schemeSx['display']));
+        const kept = sanitizeSx(id, shownInDark ? ownSx : sxByNodeId.get(id), repairs);
+        const sx = shownInDark ? _extends({}, kept, {
+            [SX_SCHEME_DARK_KEY]: {
+                display: schemeSx['display']
+            }
+        }) : kept;
         output[newId] = _extends({
             $id: newId,
             type: NodeType.NODE,