@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/components/assist-edit-canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/assist-edit-canvas.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  screenSeoStageKey,\n  type ScreenSeoTextField,\n} from '@aglyn/aglyn/app-utils/screen-seo-fields'\nimport {\n  NODE_HIDE_IF_PROP,\n  replaceSubtreeWithInstance,\n  reusableComponentDefinitionFrom,\n} from '@aglyn/aglyn/app-utils/compose-reusable-components'\nimport { CANVAS_ROOT_ELEMENT_ID } from '@aglyn/aglyn/foundation/constants/canvas'\nimport type {\n  ReusableComponentProp,\n  ReusableComponentPropValue,\n} from '@aglyn/aglyn/foundation/definitions/platform.types'\nimport {\n  stageEditorSessionFields,\n  type EditorSession,\n} from '@aglyn/aglyn/plugin-manager/editor-sessions'\nimport {\n  ASSIST_EDIT_CONTEXT_MAX_NODES,\n  ASSIST_EDIT_CONTEXT_MAX_PROPS,\n  ASSIST_EDIT_OUTLINE_TEXT_CHARS,\n  ASSIST_EDIT_SELECTED_TEXT_CHARS,\n  assistEditOpCounts,\n  type AssistEditCanvasContext,\n  type AssistEditCanvasNode,\n  type AssistEditInsertOp,\n  type AssistEditOp,\n  type AssistEditProposal,\n  type AssistEditComponentProp,\n  type AssistEditSaveAsComponentOp,\n} from '../model/assist-edit'\n\n/**\n * The edit rung's client half (AGL-2906): what the panel tells the server\n * about the open canvas, and how a confirmed proposal lands on it.\n *\n * Applying goes through the canvas's own guarded mutators — the same ones\n * the besigner's panels and the marketing appliers use — inside ONE\n * `batch`, so the whole proposal is one undo step and a guard that refuses\n * part-way leaves nothing behind. Every change is an unsaved edit on the\n * version the editor has open; saving it stays the author's act, with the\n * editor's own control. A version the live site serves is never edited:\n * the check refuses it, and the card offers the editor's own new-version\n * flow instead.\n */\n\n/** A node as the canvas holds it — the fields this module reads. */\nexport interface AssistEditCanvasNodeLike {\n  $id?: string\n  componentId?: string\n  parentId?: string | null\n  nodes?: string[]\n  name?: string\n  props?: unknown\n  sx?: unknown\n}\n\n/**\n * The slice of the besigner canvas the edit rung reads and drives. Every\n * member is one `CanvasManager` already has, so the panel hands over the\n * canvas itself and a spec hands over a real one.\n */\nexport interface AssistEditCanvas {\n  getNode(id: string): AssistEditCanvasNodeLike | undefined\n  batch<T>(mutate: () => T): T\n  updateNodeProps(node: any, props: any): void\n  updateNodeFields(node: any, patch: any): void\n  reparentNode(node: any, parent: any, index?: number): unknown\n  deleteNode(node: any): unknown\n  addNodeFromNested(nested: any, parent: any, index?: number): unknown\n  nodeAcceptsChildren(node: any): boolean\n  /** The whole document, which a component save reads its definition out of. */\n  toJSON(): { nodes: Record<string, unknown> }\n  /** The document after a save: the promoted subtree swapped for an instance. */\n  applyNodes(nodes: any): unknown\n}\n\nconst UNDESCRIBED_PROP = /^(html|sx|style|className|dangerouslySetInnerHTML|on[A-Z].*)$/\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/**\n * An observable's own keys as a plain object. A canvas node's `props` and\n * `sx` are observable proxies, and a spread of one is how a merge silently\n * copies nothing.\n */\nfunction plain(value: unknown): Record<string, unknown> {\n  const out: Record<string, unknown> = {}\n  if (!value || typeof value !== 'object') return out\n  for (const key in value as Record<string, unknown>) {\n    out[key] = (value as Record<string, unknown>)[key]\n  }\n  return out\n}\n\nfunction describeProps(\n  raw: unknown,\n  textChars: number,\n): Record<string, string | number | boolean> | undefined {\n  const props: Record<string, string | number | boolean> = {}\n  let kept = 0\n  for (const [name, value] of Object.entries(plain(raw))) {\n    if (kept >= ASSIST_EDIT_CONTEXT_MAX_PROPS) break\n    if (UNDESCRIBED_PROP.test(name)) continue\n    if (typeof value === 'string') {\n      if (!value.trim()) continue\n      props[name] = value.slice(0, textChars)\n    } else if (typeof value === 'number' && Number.isFinite(value)) {\n      props[name] = value\n    } else if (typeof value === 'boolean') {\n      props[name] = value\n    } else {\n      continue\n    }\n    kept += 1\n  }\n  return kept ? props : undefined\n}\n\nfunction describeSx(raw: unknown): Record<string, unknown> | undefined {\n  const sx: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(plain(raw))) {\n    if (typeof value === 'string' || typeof value === 'number') sx[key] = value\n    else if (isRecord(value)) sx[key] = plain(value)\n  }\n  return Object.keys(sx).length ? sx : undefined\n}\n\n/**\n * The selection's ancestors below the document root, top-level section first\n * and the selection last; null when its parents do not lead to the root,\n * which is not a chain the server can check.\n */\nfunction chainToRoot(\n  canvas: Pick<AssistEditCanvas, 'getNode'>,\n  selected: AssistEditCanvasNodeLike,\n): string[] | null {\n  const chain: string[] = []\n  const walked = new Set<string>()\n  let current: AssistEditCanvasNodeLike | undefined = selected\n  while (current?.$id && current.$id !== CANVAS_ROOT_ELEMENT_ID && !walked.has(current.$id)) {\n    walked.add(current.$id)\n    chain.unshift(current.$id)\n    current = current.parentId ? canvas.getNode(current.parentId) : undefined\n  }\n  return current?.$id === CANVAS_ROOT_ELEMENT_ID ? chain : null\n}\n\n/** Elements one shape is taken over at most; a larger subtree is never called alike. */\nconst SHAPE_LIMIT = 200\n\n/**\n * How an element is built: its component and, in order, its children's —\n * what two cards of one row have in common whatever their text. Null past\n * `SHAPE_LIMIT` elements, or for a subtree that loops back on itself.\n */\nfunction shapeOf(canvas: Pick<AssistEditCanvas, 'getNode'>, rootId: string): string | null {\n  let budget = SHAPE_LIMIT\n  const walked = new Set<string>()\n  const walk = (id: string): string | null => {\n    const node = canvas.getNode(id)\n    if (!node || walked.has(id) || --budget < 0) return null\n    walked.add(id)\n    const parts: string[] = []\n    for (const child of node.nodes ?? []) {\n      const part = walk(child)\n      if (part === null) return null\n      parts.push(part)\n    }\n    return `${String(node.componentId ?? '')}(${parts.join(',')})`\n  }\n  return walk(rootId)\n}\n\n/** Elements reachable from the document root through child lists, the root included. */\nfunction countElements(canvas: Pick<AssistEditCanvas, 'getNode'>): number {\n  let count = 0\n  const reached = new Set<string>([CANVAS_ROOT_ELEMENT_ID])\n  const pending = [CANVAS_ROOT_ELEMENT_ID]\n  while (pending.length) {\n    const node = canvas.getNode(pending.pop() as string)\n    if (!node) continue\n    count += 1\n    for (const child of node.nodes ?? []) {\n      if (reached.has(child)) continue\n      reached.add(child)\n      pending.push(child)\n    }\n  }\n  return count\n}\n\n/**\n * The canvas outline a question carries on the edit rung, in two tiers, until\n * the cap.\n *\n * Described in full, settings and all: the document root, the selection's\n * ancestors and the selection, the document's top-level sections, everything\n * inside the selection — what an edit to it changes — and its siblings.\n *\n * Described briefly, by place alone (`brief`): what surrounds that, so the\n * model knows it exists and asks for it rather than calling it missing —\n *\n * 1. what the selection's siblings hold, level by level (the icons beside a\n *    selected link, in the card they share);\n * 2. the siblings of each ancestor below the top-level section, nearest\n *    first (the other cards of the row, then what sits beside the row).\n *\n * An element built the same way as the selection, or as the ancestor it sits\n * beside, is marked `like` it and its contents are left out: one card\n * described, and every other card of the row says it holds the same.\n *\n * With nothing selected, it is the root, the top-level sections and one level\n * inside each: enough for a change to the page as a whole, and the prompt asks\n * for a selection before anything more specific.\n *\n * An element is only ever described after its parent, so every ancestor chain\n * the server checks is whole. `total` counts the document, and each element's\n * `childCount` stays its real one, so the server can tell the model what the\n * outline leaves out. The server holds this to its own limits before it quotes\n * a byte of it; null when the canvas has no document root loaded.\n */\nexport function describeAssistEditCanvas(\n  canvas: Pick<AssistEditCanvas, 'getNode'>,\n  selectedId: string | null,\n): AssistEditCanvasContext | null {\n  const root = canvas.getNode(CANVAS_ROOT_ELEMENT_ID)\n  if (!root) return null\n  const order: string[] = []\n  const seen = new Set<string>()\n  const brief = new Set<string>()\n  const like = new Map<string, string>()\n  const full = (): boolean => order.length >= ASSIST_EDIT_CONTEXT_MAX_NODES\n  const add = (id: string | undefined | null, briefly = false): void => {\n    if (!id || seen.has(id) || full()) return\n    if (!canvas.getNode(id)) return\n    seen.add(id)\n    order.push(id)\n    if (briefly) brief.add(id)\n  }\n  const childrenOf = (id: string): string[] => canvas.getNode(id)?.nodes ?? []\n  const shapes = new Map<string, string | null>()\n  const shape = (id: string): string | null => {\n    if (!shapes.has(id)) shapes.set(id, shapeOf(canvas, id))\n    return shapes.get(id) ?? null\n  }\n  // Alike only when there are contents to leave out.\n  const alike = (id: string, model: string): boolean =>\n    childrenOf(id).length > 0 && shape(id) !== null && shape(id) === shape(model)\n\n  add(CANVAS_ROOT_ELEMENT_ID)\n  const selected =\n    selectedId && selectedId !== CANVAS_ROOT_ELEMENT_ID ? canvas.getNode(selectedId) : undefined\n  const chain = selected?.$id ? chainToRoot(canvas, selected) : null\n  chain?.forEach((id) => add(id))\n  if (selected?.$id && chain && seen.has(selected.$id)) {\n    for (const id of root.nodes ?? []) add(id)\n    const inside = new Set<string>([selected.$id])\n    const queue = [...childrenOf(selected.$id)]\n    while (queue.length && !full()) {\n      const id = queue.shift() as string\n      if (inside.has(id)) continue\n      inside.add(id)\n      add(id)\n      queue.push(...childrenOf(id))\n    }\n    const siblings = selected.parentId\n      ? childrenOf(selected.parentId).filter((id) => id !== selected.$id)\n      : []\n    const held: string[] = []\n    for (const id of siblings) {\n      add(id)\n      // A sibling the cap left out takes its contents with it.\n      if (!seen.has(id)) continue\n      if (alike(id, selected.$id)) like.set(id, selected.$id)\n      else held.push(...childrenOf(id))\n    }\n    const reached = new Set<string>([...inside, ...siblings, ...held])\n    for (let level = held; level.length && !full(); ) {\n      const deeper: string[] = []\n      for (const id of level) {\n        add(id, true)\n        for (const child of childrenOf(id)) {\n          if (reached.has(child)) continue\n          reached.add(child)\n          deeper.push(child)\n        }\n      }\n      level = deeper\n    }\n    // Parent first; the top-level section's own siblings are the sections above.\n    for (const ancestor of chain.slice(1, -1).reverse()) {\n      const parentId = canvas.getNode(ancestor)?.parentId\n      for (const id of parentId ? childrenOf(parentId) : []) {\n        if (id === ancestor || seen.has(id)) continue\n        add(id, true)\n        if (seen.has(id) && alike(id, ancestor)) like.set(id, ancestor)\n      }\n    }\n  } else {\n    for (const id of root.nodes ?? []) add(id)\n    for (const section of root.nodes ?? []) {\n      for (const id of childrenOf(section)) add(id)\n    }\n  }\n\n  const nodes: AssistEditCanvasNode[] = order.map((id) => {\n    const node = canvas.getNode(id) as AssistEditCanvasNodeLike\n    const isRoot = id === CANVAS_ROOT_ELEMENT_ID\n    const parentId = isRoot ? null : (node.parentId ?? null)\n    const parent = parentId ? canvas.getNode(parentId) : undefined\n    const isSelected = id === selected?.$id\n    const isBrief = brief.has(id)\n    const props = isBrief\n      ? undefined\n      : describeProps(\n          node.props,\n          isSelected ? ASSIST_EDIT_SELECTED_TEXT_CHARS : ASSIST_EDIT_OUTLINE_TEXT_CHARS,\n        )\n    const sx = isSelected ? describeSx(node.sx) : undefined\n    const model = like.get(id)\n    return {\n      id,\n      componentId: String(node.componentId ?? ''),\n      parentId,\n      index: Math.max(0, parent?.nodes?.indexOf(id) ?? 0),\n      childCount: node.nodes?.length ?? 0,\n      ...(node.name ? { name: String(node.name) } : {}),\n      ...(props ? { props } : {}),\n      ...(sx ? { sx } : {}),\n      ...(isBrief ? { brief: true } : {}),\n      ...(model ? { like: model } : {}),\n    }\n  })\n  return {\n    selectedId: selected?.$id && seen.has(selected.$id) ? selected.$id : null,\n    total: countElements(canvas),\n    nodes,\n  }\n}\n\n/** Why a proposal cannot land on the open editor as it stands. */\nexport type AssistEditRefusal =\n  /** No editor is open. */\n  | 'no-editor'\n  /** The editor open is not the document the proposal was made for. */\n  | 'other-document'\n  /** The open version is the one the live site serves. */\n  | 'live-version'\n  /** An element the proposal names has gone or changed since. */\n  | 'stale'\n  /** The canvas's own guards refused part of the change. */\n  | 'refused'\n\nexport type AssistEditCheck =\n  | { ok: true }\n  | { ok: false; reason: AssistEditRefusal; message: string }\n\nexport type AssistEditApplyResult =\n  | {\n      ok: true\n      /** Applied ops, counted by kind for the activity row. */\n      opCounts: Record<string, number>\n      /** Editor fields staged, as the editor keys them. */\n      staged: string[]\n    }\n  | { ok: false; reason: AssistEditRefusal; message: string }\n\n/** Ids of the subtree at `rootId`, the root included, through child lists only. */\nfunction subtreeIds(\n  canvas: Pick<AssistEditCanvas, 'getNode'>,\n  rootId: string,\n): Set<string> {\n  const found = new Set<string>([rootId])\n  const queue = [...(canvas.getNode(rootId)?.nodes ?? [])]\n  while (queue.length) {\n    const id = queue.shift() as string\n    if (found.has(id) || !canvas.getNode(id)) continue\n    found.add(id)\n    queue.push(...(canvas.getNode(id)?.nodes ?? []))\n  }\n  return found\n}\n\nconst STALE: AssistEditCheck = {\n  ok: false,\n  reason: 'stale',\n  message: 'The canvas has changed since this was proposed, so nothing was applied. Ask again.',\n}\n\n/**\n * Whether the proposal can land on the open editor as it stands — checked in\n * full before anything is touched, so a refusal never leaves half an edit.\n */\nexport function checkAssistEdit(\n  canvas: Pick<AssistEditCanvas, 'getNode' | 'nodeAcceptsChildren'>,\n  proposal: AssistEditProposal,\n  session: EditorSession | undefined,\n): AssistEditCheck {\n  if (!session) {\n    return {\n      ok: false,\n      reason: 'no-editor',\n      message: 'Open the editor this change was proposed for to apply it.',\n    }\n  }\n  if (\n    session.documentKind !== proposal.target.kind ||\n    session.documentId !== proposal.target.documentId\n  ) {\n    return {\n      ok: false,\n      reason: 'other-document',\n      message: 'This change was proposed for a different document than the one open.',\n    }\n  }\n  if (session.isLiveVersion()) {\n    return {\n      ok: false,\n      reason: 'live-version',\n      message:\n        'This is the version your live site shows. Make a new version first, then apply the change there.',\n    }\n  }\n  for (const op of proposal.ops) {\n    switch (op.op) {\n      case 'setSeo': {\n        for (const field of Object.keys(op.fields) as ScreenSeoTextField[]) {\n          if (typeof session.fields?.[screenSeoStageKey(field)] !== 'function') {\n            return {\n              ok: false,\n              reason: 'other-document',\n              message: 'This editor has no search fields to fill in.',\n            }\n          }\n        }\n        break\n      }\n      case 'insertSubtree': {\n        const parent = canvas.getNode(op.parentId)\n        if (!parent || parent.componentId !== op.parentComponentId) return STALE\n        if (!canvas.nodeAcceptsChildren(parent)) return STALE\n        break\n      }\n      case 'move': {\n        const node = canvas.getNode(op.nodeId)\n        const parent = canvas.getNode(op.parentId)\n        if (!node || node.componentId !== op.componentId) return STALE\n        if (!parent || parent.componentId !== op.parentComponentId) return STALE\n        break\n      }\n      case 'saveAsComponent': {\n        const node = canvas.getNode(op.nodeId)\n        if (!node || node.componentId !== op.componentId) return STALE\n        // The document itself is not a section of itself: promoting the root\n        // would leave a document holding one instance of its own contents.\n        if (op.nodeId === CANVAS_ROOT_ELEMENT_ID) return STALE\n        const inside = subtreeIds(canvas, op.nodeId)\n        for (const binding of op.bindings) {\n          const bound = canvas.getNode(binding.nodeId)\n          if (!bound || bound.componentId !== binding.componentId) return STALE\n          // A closed world: a token outside the promoted subtree would bind a\n          // property of the new component to an element it does not contain.\n          if (!inside.has(binding.nodeId)) return STALE\n        }\n        break\n      }\n      default: {\n        const node = canvas.getNode(op.nodeId)\n        if (!node || node.componentId !== op.componentId) return STALE\n      }\n    }\n  }\n  return { ok: true }\n}\n\n/**\n * Styles merged one key at a time. A responsive patch over a plain value\n * keeps that value as the base breakpoint, so \"more padding on wide screens\"\n * does not quietly remove the padding everywhere else.\n */\nfunction mergeSx(\n  current: Record<string, unknown>,\n  patch: Record<string, unknown>,\n): Record<string, unknown> {\n  const out = { ...current }\n  for (const [key, value] of Object.entries(patch)) {\n    const existing = out[key]\n    if (isRecord(value) && isRecord(existing)) {\n      out[key] = { ...plain(existing), ...value }\n    } else if (isRecord(value) && (typeof existing === 'string' || typeof existing === 'number')) {\n      out[key] = { xs: existing, ...value }\n    } else {\n      out[key] = value\n    }\n  }\n  return out\n}\n\n/** A validated flat subtree as the nested shape `addNodeFromNested` takes. */\nfunction nestSubtree(op: AssistEditInsertOp): Record<string, unknown> {\n  const visited = new Set<string>()\n  const build = (id: string): Record<string, unknown> => {\n    visited.add(id)\n    const node = op.nodes[id]\n    return {\n      componentId: node.componentId,\n      ...(node.pluginId ? { pluginId: node.pluginId } : {}),\n      props: { ...node.props },\n      ...(node.sx ? { sx: { ...node.sx } } : {}),\n      ...(node.hidden ? { hidden: true } : {}),\n      nodes: node.nodes\n        .filter((child) => op.nodes[child] && !visited.has(child))\n        .map((child) => build(child)),\n    }\n  }\n  return build(op.rootId)\n}\n\nfunction live(canvas: AssistEditCanvas, id: string): AssistEditCanvasNodeLike {\n  const node = canvas.getNode(id)\n  if (!node) throw new Error(`element ${id} is no longer on the canvas`)\n  return node\n}\n\nfunction applyOne(canvas: AssistEditCanvas, op: AssistEditOp): void {\n  switch (op.op) {\n    case 'updateProps': {\n      const node = live(canvas, op.nodeId)\n      // Spread the props the element has: `updateNodeProps` REPLACES the bag,\n      // and a patch of one setting would otherwise strip every other one.\n      const next: Record<string, unknown> = { ...plain(node.props), ...op.props }\n      // Rich text renders `html` over `children`; proposed text replaces it.\n      if ('children' in op.props) delete next['html']\n      canvas.updateNodeProps(node, next)\n      return\n    }\n    case 'updateSx': {\n      const node = live(canvas, op.nodeId)\n      canvas.updateNodeFields(node, { sx: mergeSx(plain(node.sx), op.sx) })\n      return\n    }\n    case 'move':\n      canvas.reparentNode(live(canvas, op.nodeId), live(canvas, op.parentId), op.index ?? NaN)\n      return\n    case 'remove':\n      canvas.deleteNode(live(canvas, op.nodeId))\n      return\n    case 'rename':\n      canvas.updateNodeFields(live(canvas, op.nodeId), { name: op.name })\n      return\n    case 'insertSubtree':\n      canvas.addNodeFromNested(nestSubtree(op), live(canvas, op.parentId), op.index ?? NaN)\n      return\n    case 'setSeo':\n    case 'saveAsComponent':\n      // Both are applied outside the canvas batch: search fields are staged\n      // into the editor's own form, and a component save mints a document\n      // first and then swaps the subtree for an instance of it.\n      return\n  }\n}\n\n/* ------------------------------------------------------------------ *\n * Save the selection as a reusable component (AGL-2908)\n * ------------------------------------------------------------------ */\n\n/** What the apply needs from the console to create the component. */\nexport interface AssistEditComponentWriter {\n  /**\n   * Creates the component through `POST /api/hosts/resources`, where the\n   * plan's entitlement and the route's field allow-list are enforced, and\n   * answers its id. The plugin never writes Firestore from the browser.\n   */\n  createComponent(input: {\n    name: string\n    rootId: string\n    nodes: Record<string, unknown>\n    props: ReusableComponentProp[]\n  }): Promise<string>\n}\n\n/**\n * The value a bound field holds on the live canvas right now, which becomes\n * the property's default.\n *\n * `hideIf` is the exception: the part is on the page, so the property that\n * hides it starts at no. Every other field answers with what the author can\n * see, which is what makes the instance render exactly what was there.\n */\nfunction currentValue(\n  node: AssistEditCanvasNodeLike,\n  field: string,\n): ReusableComponentPropValue | undefined {\n  if (field === NODE_HIDE_IF_PROP) return false\n  const value = plain(node.props)[field]\n  if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {\n    return value\n  }\n  return undefined\n}\n\n/**\n * Whether a default the canvas gave is one the property's own control\n * offers. A Choice whose current value is not among its answers is a\n * selection that has changed since the proposal was made, and applying it\n * would declare a property no page could ever set back.\n */\nfunction defaultFitsProp(prop: AssistEditComponentProp, value: unknown): boolean {\n  if (!prop.options?.length) return true\n  return prop.options.some((option) => option.value === value)\n}\n\n/**\n * The definition the new component holds: the promoted subtree, with each\n * bound field replaced by its property's token.\n *\n * The defaults are read off the SAME fields a moment before they are\n * replaced, so the instance that takes the subtree's place renders what the\n * author was looking at. Returns null when a default no longer fits its\n * property, which is the stale case.\n */\nfunction componentDefinition(\n  canvas: AssistEditCanvas,\n  op: AssistEditSaveAsComponentOp,\n): { nodes: Record<string, unknown>; props: ReusableComponentProp[] } | null {\n  const nodes = reusableComponentDefinitionFrom(\n    canvas.toJSON().nodes as never,\n    op.nodeId,\n  ) as unknown as Record<string, Record<string, unknown>>\n  const defaults = new Map<string, ReusableComponentPropValue | undefined>()\n  for (const binding of op.bindings) {\n    const live = canvas.getNode(binding.nodeId)\n    const stored = nodes[binding.nodeId]\n    if (!live || !stored) return null\n    if (!defaults.has(binding.prop)) defaults.set(binding.prop, currentValue(live, binding.field))\n    stored['props'] = { ...plain(stored['props']), [binding.field]: `{{prop.${binding.prop}}}` }\n  }\n  const props: ReusableComponentProp[] = []\n  for (const declared of op.props) {\n    const value = defaults.get(declared.name)\n    if (!defaultFitsProp(declared, value)) return null\n    props.push({ ...declared, ...(value === undefined ? {} : { defaultValue: value }) })\n  }\n  return { nodes, props }\n}\n\n/**\n * Lands a confirmed proposal on the open editor: the canvas ops as ONE batch\n * — one undo step, all or nothing — then any search fields staged into the\n * editor's own form. Nothing is saved.\n */\nexport function applyAssistEdit(\n  canvas: AssistEditCanvas,\n  proposal: AssistEditProposal,\n  session: EditorSession | undefined,\n): AssistEditApplyResult {\n  const check = checkAssistEdit(canvas, proposal, session)\n  if (check.ok === false) return check\n  const open = session as EditorSession\n  const canvasOps = proposal.ops.filter((op) => op.op !== 'setSeo' && op.op !== 'saveAsComponent')\n  if (canvasOps.length) {\n    try {\n      canvas.batch(() => {\n        for (const op of canvasOps) applyOne(canvas, op)\n      })\n    } catch (error) {\n      console.error('assist edit refused by the canvas', error)\n      return {\n        ok: false,\n        reason: 'refused',\n        message: 'The editor refused part of this change, so none of it was applied.',\n      }\n    }\n  }\n  const staged: string[] = []\n  for (const op of proposal.ops) {\n    if (op.op !== 'setSeo') continue\n    const values: Record<string, string> = {}\n    for (const [field, value] of Object.entries(op.fields)) {\n      values[screenSeoStageKey(field as ScreenSeoTextField)] = String(value)\n    }\n    staged.push(...stageEditorSessionFields(open, values).staged)\n  }\n  return { ok: true, opCounts: assistEditOpCounts(proposal.ops), staged }\n}\n\n/**\n * Lands a proposal that saves the selection as a reusable component\n * (AGL-2908) — AGL-2866's recipe, in place, with no clipboard.\n *\n * The order is the manual action's order, and it matters:\n *\n * 1. the definition is read off the live subtree, each bound field replaced\n *    by its token and its current value kept as that property's default;\n * 2. the component is created through the host resources route, where the\n *    server enforces the plan's entitlement and its own allow-list — so a\n *    refusal happens before the open document is touched at all;\n * 3. the subtree is swapped for an instance of what was just created, inside\n *    ONE `batch` with the rest of the proposal's canvas ops: one undo step.\n *\n * The only document created is the component, exactly as Save as reusable\n * component creates one. The page change is an unsaved edit on the version\n * the editor has open, which the check has already refused to be a live one.\n * Nothing is published and nothing is saved.\n */\nexport async function applyAssistEditSavingComponent(\n  canvas: AssistEditCanvas,\n  proposal: AssistEditProposal,\n  session: EditorSession | undefined,\n  writer: AssistEditComponentWriter,\n): Promise<AssistEditApplyResult> {\n  const save = proposal.ops.find(\n    (op): op is AssistEditSaveAsComponentOp => op.op === 'saveAsComponent',\n  )\n  if (!save) return applyAssistEdit(canvas, proposal, session)\n  const check = checkAssistEdit(canvas, proposal, session)\n  if (check.ok === false) return check\n\n  const definition = componentDefinition(canvas, save)\n  if (!definition) return STALE as AssistEditApplyResult\n\n  let componentId: string\n  try {\n    componentId = await writer.createComponent({\n      name: save.name,\n      rootId: save.nodeId,\n      nodes: definition.nodes,\n      props: definition.props,\n    })\n  } catch (error) {\n    console.error('assist edit could not create the component', error)\n    return {\n      ok: false,\n      reason: 'refused',\n      message:\n        error instanceof Error && error.message\n          ? error.message\n          : 'The component could not be saved, so nothing on this page was changed.',\n    }\n  }\n\n  const canvasOps = proposal.ops.filter((op) => op.op !== 'setSeo' && op.op !== 'saveAsComponent')\n  try {\n    canvas.batch(() => {\n      for (const op of canvasOps) applyOne(canvas, op)\n      canvas.applyNodes(\n        replaceSubtreeWithInstance(\n          canvas.toJSON().nodes as never,\n          save.nodeId,\n          componentId,\n          save.name,\n        ),\n      )\n    })\n  } catch (error) {\n    console.error('assist edit refused by the canvas', error)\n    return {\n      ok: false,\n      reason: 'refused',\n      message:\n        'The component was saved, but the editor refused to swap this element for it. ' +\n        'Insert it from Your components instead.',\n    }\n  }\n  return { ok: true, opCounts: assistEditOpCounts(proposal.ops), staged: [] }\n}\n"],"names":["screenSeoStageKey","NODE_HIDE_IF_PROP","replaceSubtreeWithInstance","reusableComponentDefinitionFrom","CANVAS_ROOT_ELEMENT_ID","stageEditorSessionFields","ASSIST_EDIT_CONTEXT_MAX_NODES","ASSIST_EDIT_CONTEXT_MAX_PROPS","ASSIST_EDIT_OUTLINE_TEXT_CHARS","ASSIST_EDIT_SELECTED_TEXT_CHARS","assistEditOpCounts","UNDESCRIBED_PROP","isRecord","value","Array","isArray","plain","out","key","describeProps","raw","textChars","props","kept","name","Object","entries","test","trim","slice","Number","isFinite","undefined","describeSx","sx","keys","length","chainToRoot","canvas","selected","chain","walked","Set","current","$id","has","add","unshift","parentId","getNode","SHAPE_LIMIT","shapeOf","rootId","budget","walk","id","node","parts","child","nodes","part","push","String","componentId","join","countElements","count","reached","pending","pop","describeAssistEditCanvas","selectedId","root","order","seen","brief","like","Map","full","briefly","childrenOf","shapes","shape","set","get","alike","model","forEach","inside","queue","shift","siblings","filter","held","level","deeper","ancestor","reverse","section","map","parent","isRoot","isSelected","isBrief","index","Math","max","indexOf","childCount","total","subtreeIds","found","STALE","ok","reason","message","checkAssistEdit","proposal","session","documentKind","target","kind","documentId","isLiveVersion","op","ops","field","fields","parentComponentId","nodeAcceptsChildren","nodeId","binding","bindings","bound","mergeSx","patch","existing","xs","nestSubtree","visited","build","pluginId","hidden","live","Error","applyOne","next","updateNodeProps","updateNodeFields","reparentNode","NaN","deleteNode","addNodeFromNested","currentValue","defaultFitsProp","prop","options","some","option","componentDefinition","toJSON","defaults","stored","declared","defaultValue","applyAssistEdit","check","open","canvasOps","batch","error","console","staged","values","opCounts","applyAssistEditSavingComponent","writer","save","find","definition","createComponent","applyNodes"],"mappings":"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"}

package/src/lib/components/assist-edit-card.component.d.ts

@@ -0,0 +1,16 @@
+import type { EditorSession } from '@aglyn/aglyn/plugin-manager/editor-sessions';
+import { type AssistEditProposal } from '../model/assist-edit';
+export interface AssistEditCardProps {
+    proposal: AssistEditProposal;
+    /** The product's name as this org reads it. */
+    brand: string;
+    /** The open editor, or `undefined` when none is open. */
+    session: EditorSession | undefined;
+    /** Why the last attempt to apply was refused, when it was. */
+    failure?: string | null;
+    onApply: () => void;
+    onCreateVersion: () => void;
+    onDismiss: () => void;
+}
+export declare function AssistEditCard(props: AssistEditCardProps): import("react").JSX.Element;
+export default AssistEditCard;

package/src/lib/components/assist-edit-card.component.js

@@ -0,0 +1,181 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { mdiChevronDown, mdiChevronUp } from "@aglyn/shared-data-mdi";
+import { MdiIcon } from "@aglyn/shared-ui-jsx";
+import { Alert, Box, Button, Collapse, Link, Paper, Stack, Typography } from "@mui/material";
+import { useState } from "react";
+import { describeAssistEditDiff } from "../model/assist-edit.js";
+/**
+ * The edit card (AGL-2906): a level-3 proposal as the author decides on it.
+ *
+ * It says what would change — the counts, and what validation left out —
+ * and offers exactly one way forward for the editor as it stands:
+ *
+ *  - on the document the proposal was made for, on a version the live site
+ *    does not serve: **Apply as draft**, which the panel carries out through
+ *    the canvas's own mutators as one undoable, unsaved change;
+ *  - on the version the live site serves: **Make a new version**, the
+ *    editor's own flow, after which the same card offers Apply there;
+ *  - anywhere else: nothing to press but **No thanks**.
+ *
+ * The card makes no request and holds no write of its own: its buttons call
+ * back into the panel, which applies through the canvas and reports nothing
+ * but the counts.
+ */ const DOCUMENT_NOUNS = {
+    screen: 'page',
+    component: 'component',
+    layout: 'layout'
+};
+export function AssistEditCard(props) {
+    var _DOCUMENT_NOUNS_proposal_target_kind;
+    const { proposal, brand, session, failure, onApply, onCreateVersion, onDismiss } = props;
+    const [showDropped, setShowDropped] = useState(false);
+    const noun = (_DOCUMENT_NOUNS_proposal_target_kind = DOCUMENT_NOUNS[proposal.target.kind]) != null ? _DOCUMENT_NOUNS_proposal_target_kind : 'document';
+    const onDocument = Boolean(session && session.documentKind === proposal.target.kind && session.documentId === proposal.target.documentId);
+    const live = onDocument && Boolean(session == null ? void 0 : session.isLiveVersion());
+    const changes = describeAssistEditDiff(proposal.diff);
+    // A component save creates one document (AGL-2908), which is the one thing
+    // on this card that outlives an undo. The copy says so before Apply.
+    const savesComponent = proposal.ops.some((op)=>op.op === 'saveAsComponent');
+    return /*#__PURE__*/ _jsxs(Paper, {
+        variant: "outlined",
+        sx: {
+            mt: 1,
+            p: 1.5,
+            borderRadius: 2,
+            bgcolor: 'background.paper'
+        },
+        children: [
+            /*#__PURE__*/ _jsx(Typography, {
+                variant: "subtitle2",
+                children: "Proposed change"
+            }),
+            proposal.summary ? /*#__PURE__*/ _jsx(Typography, {
+                variant: "body2",
+                sx: {
+                    mt: 0.5
+                },
+                children: proposal.summary
+            }) : null,
+            changes.length > 0 && /*#__PURE__*/ _jsx(Stack, {
+                component: "ul",
+                sx: {
+                    m: 0,
+                    mt: 1,
+                    pl: 2.5
+                },
+                children: changes.map((line)=>/*#__PURE__*/ _jsx(Typography, {
+                        component: "li",
+                        variant: "caption",
+                        children: line
+                    }, line))
+            }),
+            proposal.dropped.length > 0 && /*#__PURE__*/ _jsxs(Box, {
+                sx: {
+                    mt: 0.5
+                },
+                children: [
+                    /*#__PURE__*/ _jsxs(Link, {
+                        component: "button",
+                        type: "button",
+                        variant: "caption",
+                        underline: "hover",
+                        onClick: ()=>setShowDropped((prior)=>!prior),
+                        sx: {
+                            display: 'inline-flex',
+                            alignItems: 'center',
+                            gap: 0.25
+                        },
+                        children: [
+                            `Left out (${proposal.dropped.length})`,
+                            /*#__PURE__*/ _jsx(MdiIcon, {
+                                path: showDropped ? mdiChevronUp.path : mdiChevronDown.path,
+                                sx: {
+                                    fontSize: 14
+                                }
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsx(Collapse, {
+                        in: showDropped,
+                        unmountOnExit: true,
+                        children: /*#__PURE__*/ _jsx(Stack, {
+                            component: "ul",
+                            sx: {
+                                m: 0,
+                                pl: 2.5
+                            },
+                            children: proposal.dropped.map((reason, index)=>/*#__PURE__*/ _jsx(Typography, {
+                                    component: "li",
+                                    variant: "caption",
+                                    color: "text.secondary",
+                                    children: reason
+                                }, index))
+                        })
+                    })
+                ]
+            }),
+            /*#__PURE__*/ _jsx(Typography, {
+                variant: "caption",
+                color: "text.secondary",
+                component: "div",
+                sx: {
+                    mt: 1
+                },
+                children: !onDocument ? `Open this ${noun} in the Besigner to apply the change.` : live ? `This is the version your live site shows. Make a new version first — the change is applied there, and the live ${noun} stays as it is.` : savesComponent ? `${brand} Assist changes nothing until you apply. Applying saves the component to your library, and swaps this element for one that follows it — an unsaved edit on the open canvas that undo takes back. Nothing is published.` : `${brand} Assist changes nothing until you apply. Applying adds these changes to the open canvas as unsaved edits: undo takes them back, and nothing is saved or published until you save.`
+            }),
+            failure ? /*#__PURE__*/ _jsx(Alert, {
+                severity: "warning",
+                sx: {
+                    mt: 1
+                },
+                children: failure
+            }) : null,
+            /*#__PURE__*/ _jsxs(Stack, {
+                direction: "row",
+                spacing: 1,
+                sx: {
+                    mt: 1.5
+                },
+                children: [
+                    onDocument && !live ? /*#__PURE__*/ _jsx(Button, {
+                        variant: "contained",
+                        size: "small",
+                        onClick: onApply,
+                        children: "Apply as draft"
+                    }) : null,
+                    onDocument && live && (session == null ? void 0 : session.createVersion) ? /*#__PURE__*/ _jsx(Button, {
+                        variant: "contained",
+                        size: "small",
+                        onClick: onCreateVersion,
+                        children: "Make a new version"
+                    }) : null,
+                    /*#__PURE__*/ _jsx(Button, {
+                        size: "small",
+                        color: "inherit",
+                        onClick: onDismiss,
+                        children: "No thanks"
+                    })
+                ]
+            })
+        ]
+    });
+}
+export default AssistEditCard;
+
+//# sourceMappingURL=assist-edit-card.component.js.map

package/src/lib/components/assist-edit-card.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/assist-edit-card.component.tsx"],"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'use client'\n\nimport type { EditorSession } from '@aglyn/aglyn/plugin-manager/editor-sessions'\nimport { mdiChevronDown, mdiChevronUp } from '@aglyn/shared-data-mdi'\nimport { MdiIcon } from '@aglyn/shared-ui-jsx'\nimport {\n  Alert,\n  Box,\n  Button,\n  Collapse,\n  Link,\n  Paper,\n  Stack,\n  Typography,\n} from '@mui/material'\nimport { useState } from 'react'\nimport {\n  describeAssistEditDiff,\n  type AssistEditDocumentKind,\n  type AssistEditProposal,\n} from '../model/assist-edit'\n\n/**\n * The edit card (AGL-2906): a level-3 proposal as the author decides on it.\n *\n * It says what would change — the counts, and what validation left out —\n * and offers exactly one way forward for the editor as it stands:\n *\n *  - on the document the proposal was made for, on a version the live site\n *    does not serve: **Apply as draft**, which the panel carries out through\n *    the canvas's own mutators as one undoable, unsaved change;\n *  - on the version the live site serves: **Make a new version**, the\n *    editor's own flow, after which the same card offers Apply there;\n *  - anywhere else: nothing to press but **No thanks**.\n *\n * The card makes no request and holds no write of its own: its buttons call\n * back into the panel, which applies through the canvas and reports nothing\n * but the counts.\n */\n\nconst DOCUMENT_NOUNS: Readonly<Record<AssistEditDocumentKind, string>> = {\n  screen: 'page',\n  component: 'component',\n  layout: 'layout',\n}\n\nexport interface AssistEditCardProps {\n  proposal: AssistEditProposal\n  /** The product's name as this org reads it. */\n  brand: string\n  /** The open editor, or `undefined` when none is open. */\n  session: EditorSession | undefined\n  /** Why the last attempt to apply was refused, when it was. */\n  failure?: string | null\n  onApply: () => void\n  onCreateVersion: () => void\n  onDismiss: () => void\n}\n\nexport function AssistEditCard(props: AssistEditCardProps) {\n  const { proposal, brand, session, failure, onApply, onCreateVersion, onDismiss } = props\n  const [showDropped, setShowDropped] = useState(false)\n  const noun = DOCUMENT_NOUNS[proposal.target.kind] ?? 'document'\n  const onDocument = Boolean(\n    session &&\n      session.documentKind === proposal.target.kind &&\n      session.documentId === proposal.target.documentId,\n  )\n  const live = onDocument && Boolean(session?.isLiveVersion())\n  const changes = describeAssistEditDiff(proposal.diff)\n  // A component save creates one document (AGL-2908), which is the one thing\n  // on this card that outlives an undo. The copy says so before Apply.\n  const savesComponent = proposal.ops.some((op) => op.op === 'saveAsComponent')\n\n  return (\n    <Paper\n      variant=\"outlined\"\n      sx={{ mt: 1, p: 1.5, borderRadius: 2, bgcolor: 'background.paper' }}\n    >\n      <Typography variant=\"subtitle2\">Proposed change</Typography>\n      {proposal.summary ? (\n        <Typography variant=\"body2\" sx={{ mt: 0.5 }}>\n          {proposal.summary}\n        </Typography>\n      ) : null}\n      {changes.length > 0 && (\n        <Stack component=\"ul\" sx={{ m: 0, mt: 1, pl: 2.5 }}>\n          {changes.map((line) => (\n            <Typography key={line} component=\"li\" variant=\"caption\">\n              {line}\n            </Typography>\n          ))}\n        </Stack>\n      )}\n      {proposal.dropped.length > 0 && (\n        <Box sx={{ mt: 0.5 }}>\n          <Link\n            component=\"button\"\n            type=\"button\"\n            variant=\"caption\"\n            underline=\"hover\"\n            onClick={() => setShowDropped((prior) => !prior)}\n            sx={{ display: 'inline-flex', alignItems: 'center', gap: 0.25 }}\n          >\n            {`Left out (${proposal.dropped.length})`}\n            <MdiIcon\n              path={showDropped ? mdiChevronUp.path : mdiChevronDown.path}\n              sx={{ fontSize: 14 }}\n            />\n          </Link>\n          <Collapse in={showDropped} unmountOnExit>\n            <Stack component=\"ul\" sx={{ m: 0, pl: 2.5 }}>\n              {proposal.dropped.map((reason, index) => (\n                <Typography\n                  key={index}\n                  component=\"li\"\n                  variant=\"caption\"\n                  color=\"text.secondary\"\n                >\n                  {reason}\n                </Typography>\n              ))}\n            </Stack>\n          </Collapse>\n        </Box>\n      )}\n      <Typography\n        variant=\"caption\"\n        color=\"text.secondary\"\n        component=\"div\"\n        sx={{ mt: 1 }}\n      >\n        {!onDocument\n          ? `Open this ${noun} in the Besigner to apply the change.`\n          : live\n            ? `This is the version your live site shows. Make a new version first — the change is applied there, and the live ${noun} stays as it is.`\n            : savesComponent\n              ? `${brand} Assist changes nothing until you apply. Applying saves the component to your library, and swaps this element for one that follows it — an unsaved edit on the open canvas that undo takes back. Nothing is published.`\n              : `${brand} Assist changes nothing until you apply. Applying adds these changes to the open canvas as unsaved edits: undo takes them back, and nothing is saved or published until you save.`}\n      </Typography>\n      {failure ? (\n        <Alert severity=\"warning\" sx={{ mt: 1 }}>\n          {failure}\n        </Alert>\n      ) : null}\n      <Stack direction=\"row\" spacing={1} sx={{ mt: 1.5 }}>\n        {onDocument && !live ? (\n          <Button variant=\"contained\" size=\"small\" onClick={onApply}>\n            Apply as draft\n          </Button>\n        ) : null}\n        {onDocument && live && session?.createVersion ? (\n          <Button variant=\"contained\" size=\"small\" onClick={onCreateVersion}>\n            Make a new version\n          </Button>\n        ) : null}\n        <Button size=\"small\" color=\"inherit\" onClick={onDismiss}>\n          No thanks\n        </Button>\n      </Stack>\n    </Paper>\n  )\n}\n\nexport default AssistEditCard\n"],"names":["mdiChevronDown","mdiChevronUp","MdiIcon","Alert","Box","Button","Collapse","Link","Paper","Stack","Typography","useState","describeAssistEditDiff","DOCUMENT_NOUNS","screen","component","layout","AssistEditCard","props","proposal","brand","session","failure","onApply","onCreateVersion","onDismiss","showDropped","setShowDropped","noun","target","kind","onDocument","Boolean","documentKind","documentId","live","isLiveVersion","changes","diff","savesComponent","ops","some","op","variant","sx","mt","p","borderRadius","bgcolor","summary","length","m","pl","map","line","dropped","type","underline","onClick","prior","display","alignItems","gap","path","fontSize","in","unmountOnExit","reason","index","color","severity","direction","spacing","size","createVersion"],"mappings":"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"}

package/src/lib/components/assist-jobs-drawer.component.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type AiJobOutput } from '../model/ai-jobs.types';
+import type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types';
+import { authorizedFetch } from '@aglyn/shared-util-http/authorized-token';
+import type { AiInsightSurface } from '../model/ai-insight';
+/**
+ * Where "open draft" goes, or `null` when the output has no page of its
+ * own — a `text` output carries its copy on the job and is shown inline.
+ * A versioned resource opens in the besigner on the version the job wrote;
+ * one the console lists without a detail page opens its list; a `theme`
+ * proposal opens the site's Theme section, where it is put in the editor.
+ *
+ * A console URL names a site by its SUBDOMAIN: the `[host]` segment resolves
+ * through the member's host projection by subdomain, never by document id.
+ * So an output that carries no `hostSubdomain` gets no link rather than one
+ * that opens no site.
+ */
+export declare function aiJobOutputHref(output: AiJobOutput, orgSlug: string): string | null;
+/**
+ * The navigation entry a page job proposes for the page it built (AGL-2907),
+ * or `null`. The job writes no menu: the member adds the entry once the page
+ * is live.
+ */
+export declare function aiJobNavigationProposal(output: AiJobOutput): string | null;
+/**
+ * `data:` frames out of an SSE body, one parsed event per frame. Shared with
+ * every panel that watches a job through the events route.
+ */
+export declare function readEventFrames(body: ReadableStream<Uint8Array>, onEvent: (event: Record<string, unknown>) => void): Promise<void>;
+export interface AssistJobsDrawerProps {
+    /** The org the panel is scoped to — `undefined` where the page named none. */
+    orgId: string | undefined;
+    org: Partial<AglynOrgBilling> | undefined;
+    orgReady: boolean;
+    orgSlug: string;
+    user: Parameters<typeof authorizedFetch>[0];
+    /** The `release_ai_generative` verdict, staff bypass applied (the shell's). */
+    visible: boolean;
+    /**
+     * The viewer is staff (AGL-3078): a job that stopped for a broken rule shows
+     * them where the refused answer broke it. Who may read a job is unchanged.
+     */
+    isStaff?: boolean;
+    /** The site the console page is on, when it is on one: a page is described for a site. */
+    hostId?: string | null;
+    /**
+     * The page's insight surface (AGL-2915) — a site's Analytics, Data or CRM
+     * Reports page, or the workspace's Data page — with the site's subdomain;
+     * `null` elsewhere, where no question about the figures is offered.
+     */
+    insight?: {
+        surface: Exclude<AiInsightSurface, 'digest'>;
+        host: string | null;
+    } | null;
+}
+export declare function AssistJobsDrawer({ orgId, org, orgReady, orgSlug, user, visible, isStaff, hostId, insight, }: AssistJobsDrawerProps): JSX.Element | null;
+export default AssistJobsDrawer;