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

package/src/lib/jobs/ai-job-edit-step.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-edit-step.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 { checkEntitlement } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport { SCREEN_KIND_TEMPLATE } from '@aglyn/aglyn/app-utils/screen-route'\nimport { screenSeoStageKey, SCREEN_SEO_TEXT_FIELDS } from '@aglyn/aglyn/app-utils/screen-seo-fields'\nimport { decodeStoredNodes, encodeStoredNodes } from '@aglyn/aglyn/app-utils/stored-nodes'\nimport { CanvasManager } from '@aglyn/aglyn/canvas-manager/canvas-manager'\nimport { FEATURE_FLAG } from '@aglyn/aglyn/foundation/constants/shared'\nimport type { EditorSession } from '@aglyn/aglyn/plugin-manager/editor-sessions'\nimport type { NodesMap } from '@aglyn/aglyn/types/nodes'\nimport { resolveOrgIdForHost } from '@aglyn/tenant-data-admin/server/organizations'\nimport { applyAssistEdit } from '../components/assist-edit-canvas'\nimport {\n  AI_EDIT_COMPONENT_LEFT_OUT,\n  AI_EDIT_EMAIL_COPY,\n  AI_EDIT_GONE_COPY,\n  AI_EDIT_NEEDS_VERSIONING_COPY,\n  AI_EDIT_NO_NODES_COPY,\n  AI_EDIT_NO_SITE_COPY,\n  AI_EDIT_NOTHING_COPY,\n  AI_EDIT_REFUSED_COPY,\n  AI_EDIT_SEO_LEFT_OUT,\n  AI_EDIT_STALE_COPY,\n  AI_EDIT_VERSION_GONE_COPY,\n  aiEditJobOutline,\n  aiEditOutputNote,\n  aiEditVersionName,\n  parseAiEditJobInputs,\n  type AiEditJobInputs,\n  type AiEditPlacement,\n  type AiEditTargetKind,\n} from '../model/ai-edit-job'\nimport type { AiJob, AiJobOutput } from '../model/ai-jobs.types'\nimport {\n  ASSIST_EDIT_TOOL_NAME,\n  type AssistEditCanvasContext,\n  type AssistEditOp,\n  type AssistEditProposal,\n  type AssistEditTarget,\n} from '../model/assist-edit'\nimport { AI_STEP_TIERS } from '../providers/catalog'\nimport { AI_ROUTING_TABLE, aiModelForStep } from '../providers/routing'\nimport {\n  runValidatedGeneration,\n  validateStreamedGeneration,\n  type AiCustomGenerationInput,\n} from '../runtime/ai-doctrine'\nimport { AI_PALETTE } from '../runtime/ai-palette.generated'\nimport type { AiSystemBlock } from '../runtime/ai-runtime'\nimport {\n  assistEditTool,\n  checkAssistEditAnswer,\n  editCanvasBlock,\n  editSelectionBlock,\n  parseAssistEditContext,\n} from '../server/assist-edit'\nimport { registerAiJobAdmission, type AiJobAdmission, type AiJobAdmissionRefusal } from './ai-job-admission'\nimport { aiJobStepBudget } from './ai-job-budget'\nimport { aiOriginJobId } from './ai-job-draft-ids'\nimport { aiGenerationSpent, aiLimitReview, aiUnspentOutcome } from './ai-job-generation'\nimport { AI_JOB_BRIEF_MAX_CHARS, type AiJobStepOutcome, type AiJobStepRunner } from './ai-job-text-step'\nimport { registerAiJobStep } from './ai-jobs'\n\n/**\n * The `edit` step (AGL-3616): a change to a page or a layout the site already\n * has, from a description, made on the server with no editor open.\n *\n * It is the Assist edit rung, run as a job. The model is shown the stored\n * document as the rung's outline and proposes through the rung's own tool;\n * its answer is held to the rung's closed world and palette validators\n * (`checkAssistEditAnswer`) and re-asked once, naming what was left out; and\n * what survives lands through the canvas's own guarded mutators\n * (`applyAssistEdit`), on a `CanvasManager` built headless from the stored\n * nodes, inside the transaction that writes it.\n *\n * ── Where the change lands, decided before anything is spent ────────────\n *\n * Never on a version a visitor sees. With version history, a NEW version\n * beside the one it started from — a copy of that version's stored fields with\n * the changed nodes — which becomes the page's current version only when the\n * page is not published; a published page's current version, and a layout's,\n * never move. Without it, in place, on a version no visitor reaches: an\n * unpublished page's, or one that is not the current version and no schedule\n * will publish. Anything else is refused as a plan limit, charged nothing.\n *\n * ── What a job cannot do that the editor can ────────────────────────────\n *\n * The rung's chat door never offers saving part of a page as a reusable\n * component, and neither does this. A page's search title and description\n * live on the page itself, not on a version, so they are written only for a\n * page that is not published; on a published page they are left out, and the\n * output's note says so, as it says every change it left out.\n *\n * ── One version per job ──────────────────────────────────────────────────\n *\n * The new version is named by the job's id — a build's unit is named by its\n * plan item's id — so a run asked again finds what it wrote and spends\n * nothing. A change made in place stamps the version with the job's id for\n * the same reason.\n */\n\n/** The longest the step may take reading the page and writing it. */\nexport const AI_EDIT_READS_MS = 2_000\n\n/** The step's time: its answer and its re-ask at the `job.edit` ceiling, with its own reads. */\nexport const AI_JOB_EDIT_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.edit'],\n  maxTokens: AI_ROUTING_TABLE['job.edit'].maxTokens,\n  lookups: 0,\n  ownReadsMs: AI_EDIT_READS_MS,\n})\n\nexport const AI_JOB_EDIT_STEP_MINIMUM_MS = AI_JOB_EDIT_STEP_BUDGET.minimumMs\n\nexport function aiJobEditModel(): string {\n  return aiModelForStep('job.edit')\n}\n\n/**\n * The job's own rules, byte-identical on every request, ahead of the rung's\n * protocol and catalog for the document's kind, which carries the breakpoint:\n * both are the same for every site, so a kind's whole prefix caches once.\n */\nexport const AI_JOB_EDIT_RULES: AiSystemBlock = {\n  text: [\n    'You change a page or a layout the person already has, as a job that runs on its own. No editor is open, nothing is selected, and nobody can answer a question before you finish.',\n    `- Make exactly the change the request asks for, and keep everything else as it is: other elements, their text, their styles and their order. Never rewrite, restyle, move or remove what the request does not ask about.`,\n    '- Find the elements the request means in the canvas outline the request carries, by what they say and what they are. Name only ids that outline lists.',\n    `- If the outline does not show an element the request is about, change nothing for that part: never guess at an element.`,\n    `- Call ${ASSIST_EDIT_TOOL_NAME} exactly once, with every operation. Its summary is one short line saying what changed, in the language of the request; it names the version the change is saved in.`,\n    \"- Fill in a page's search title or description only when the request asks for it.\",\n    '- What you change is saved where no visitor sees it until the person publishes it, so never say the site or the page has changed.',\n    '- The protocol below was written for Assist’s chat. In this job there is no user to ask or to press Apply, and no selection: what it says about those does not apply. Everything else in it — the operations, their fields, the elements and the style tokens — does.',\n  ].join('\\n'),\n}\n\n/** The system blocks for one kind of document. */\nexport function aiJobEditInstructions(kind: AiEditTargetKind): AiSystemBlock[] {\n  return [AI_JOB_EDIT_RULES, { text: editCanvasBlock(kind), cacheBreakpoint: true }]\n}\n\n/** What the change is asked from: the document's outline, then the request. */\nexport function aiJobEditPrompt(input: { brief: string; context: AssistEditCanvasContext }): string {\n  return [editSelectionBlock(input.context), '', `Request: ${input.brief.slice(0, AI_JOB_BRIEF_MAX_CHARS)}`].join('\\n')\n}\n\n/** The edit as the doctrine's loop runs it: the rung's tool, held to the rung's check. */\nexport function aiJobEditGeneration(request: {\n  brief: string\n  context: AssistEditCanvasContext\n  target: AssistEditTarget\n  model: string\n  signal?: AbortSignal\n}): AiCustomGenerationInput<AssistEditProposal> {\n  const row = AI_ROUTING_TABLE['job.edit']\n  const kind = request.target.kind as AiEditTargetKind\n  return {\n    step: 'job.edit',\n    model: request.model,\n    instructions: aiJobEditInstructions(kind),\n    messages: [{ role: 'user', content: aiJobEditPrompt(request) }],\n    tool: assistEditTool(kind),\n    maxTokens: AI_JOB_EDIT_STEP_BUDGET.maxTokens(request.model),\n    ...(row.thinking ? { thinking: row.thinking } : {}),\n    ...(row.effort ? { effort: row.effort } : {}),\n    ...(request.signal ? { signal: request.signal } : {}),\n    check: (answer) => checkAssistEditAnswer(answer, { context: request.context, target: request.target }),\n  }\n}\n\n// ── The document, headless ────────────────────────────────────────────────\n\n/**\n * The slice of the platform a headless canvas asks: whether an element takes\n * children, answered from the AI palette the edit validator reads, so the\n * canvas refuses exactly what the validator refuses.\n */\nconst AI_EDIT_CANVAS_PLATFORM = {\n  components: {\n    getSchema: (componentId: string) => {\n      const entry = AI_PALETTE[componentId]\n      if (!entry) return undefined\n      return entry.acceptsChildren ? {} : { flags: { dropping: FEATURE_FLAG.DISABLED } }\n    },\n    getLabel: (componentId: string) => AI_PALETTE[componentId]?.displayName ?? componentId,\n  },\n}\n\n/** A canvas over a stored node map, with the editor's own guarded mutators and no editor. */\nexport function aiEditCanvas(nodes: NodesMap): CanvasManager {\n  const canvas = new CanvasManager(AI_EDIT_CANVAS_PLATFORM as never)\n  canvas.setNodes(nodes)\n  return canvas\n}\n\n/**\n * Lands a proposal on a stored node map, as the editor lands one on its open\n * canvas: checked whole first, then one batch, all or nothing. The session is\n * the version being written, which is never one a visitor sees; a page's\n * search fields are captured into `seo` only where `seo` is given.\n */\nexport function aiApplyEditToNodes(\n  nodes: NodesMap,\n  proposal: AssistEditProposal,\n  seo?: Partial<Record<(typeof SCREEN_SEO_TEXT_FIELDS)[number], string>>,\n): { ok: true; nodes: NodesMap } | { ok: false; reason: string } {\n  const canvas = aiEditCanvas(nodes)\n  const fields: Record<string, (value: string) => void> = {}\n  if (seo) {\n    for (const field of SCREEN_SEO_TEXT_FIELDS) fields[screenSeoStageKey(field)] = (value) => (seo[field] = value)\n  }\n  const session: EditorSession = {\n    documentKind: proposal.target.kind,\n    documentId: proposal.target.documentId,\n    versionId: proposal.target.versionId,\n    isLiveVersion: () => false,\n    ...(seo ? { fields } : {}),\n  }\n  const applied = applyAssistEdit(canvas, proposal, session)\n  if (applied.ok === false) return { ok: false, reason: applied.reason }\n  return { ok: true, nodes: canvas.toJSON().nodes as NodesMap }\n}\n\n// ── Reading the document ──────────────────────────────────────────────────\n\ntype Firestore = FirebaseFirestore.Firestore\n\nconst COLLECTIONS: Readonly<Record<AiEditTargetKind, 'screens' | 'layouts'>> = {\n  screen: 'screens',\n  layout: 'layouts',\n}\n\n/** The page or layout an edit job changes, as it stands before anything is spent. */\nexport interface AiEditTargetRead {\n  kind: AiEditTargetKind\n  id: string\n  name: string\n  hostSubdomain: string | null\n  /** The document's current version. */\n  pointerVersionId: string | null\n  /** The version the change starts from. */\n  sourceVersionId: string\n  nodes: NodesMap\n  /** Whether visitors see the document's current version: a published page, a collection template, any layout. */\n  served: boolean\n  /** The version a pending publish schedule will make current, if any. */\n  scheduledVersionId: string | null\n  /** What this job already wrote, when a run of it got that far. */\n  written: { versionId: string; placement: AiEditPlacement } | null\n}\n\nexport interface AiEditTargetRefusal {\n  status: 400 | 404\n  error: string\n}\n\nconst text = (value: unknown): string => (typeof value === 'string' ? value : '')\n\n/** Whether visitors see a page's current version: it is routed, or it renders a collection's entries. */\nfunction screenServed(screen: FirebaseFirestore.DocumentSnapshot, host: FirebaseFirestore.DocumentSnapshot): boolean {\n  if (screen.get('kind') === SCREEN_KIND_TEMPLATE) return true\n  const routing = host.get('screens') as Record<string, unknown> | null | undefined\n  return typeof routing?.[screen.id] === 'string'\n}\n\nfunction pendingScheduleVersion(doc: FirebaseFirestore.DocumentSnapshot): string | null {\n  const schedule = doc.get('publishSchedule') as Record<string, unknown> | null | undefined\n  if (!schedule || schedule['status'] !== 'pending' || schedule['action'] === 'unpublish') return null\n  return text(schedule['versionId']) || null\n}\n\n/**\n * The document an edit job changes, on the job's own site: the page or\n * layout named, not deleted, not an email design, and the version it starts\n * from with a document in it. A refusal names what is wrong.\n */\nexport async function readAiEditTarget(\n  firestore: Firestore,\n  input: {\n    orgId: string\n    hostId: string\n    inputs: AiEditJobInputs\n    /** The job's own version id, to find what a run of it wrote; `null` at the door, before there is one. */\n    jobId: string | null\n  },\n): Promise<AiEditTargetRead | AiEditTargetRefusal> {\n  const hostRef = firestore.collection('hosts').doc(input.hostId)\n  const host = await hostRef.get()\n  if (!host.exists || host.get('orgId') !== input.orgId) return { status: 404, error: AI_EDIT_NO_SITE_COPY }\n  const kinds: AiEditTargetKind[] = input.inputs.targetKind ? [input.inputs.targetKind] : ['screen', 'layout']\n  for (const kind of kinds) {\n    const docRef = hostRef.collection(COLLECTIONS[kind]).doc(input.inputs.target)\n    const doc = await docRef.get()\n    if (!doc.exists) continue\n    if (doc.get('deletedAt') != null) return { status: 404, error: AI_EDIT_GONE_COPY }\n    if (kind === 'screen' && doc.get('kind') === 'email') return { status: 400, error: AI_EDIT_EMAIL_COPY }\n    const pointerVersionId = text(doc.get('versionId')) || null\n    const versions = docRef.collection('versions')\n    const hostSubdomain = text(host.get('subdomain')) || null\n    const name = text(doc.get('displayName')) || (kind === 'screen' ? 'Page' : 'Layout')\n    // A run of this job that got as far as its write.\n    const own = input.jobId ? await versions.doc(input.jobId).get() : null\n    const sourceVersionId = input.inputs.versionId ?? pointerVersionId\n    const base = {\n      kind,\n      id: doc.id,\n      name,\n      hostSubdomain,\n      pointerVersionId,\n      served: kind === 'layout' || screenServed(doc, host),\n      scheduledVersionId: pendingScheduleVersion(doc),\n    }\n    if (own?.exists && input.jobId) {\n      const placement: AiEditPlacement = pointerVersionId === input.jobId ? 'new-current' : 'new-beside'\n      return { ...base, sourceVersionId: sourceVersionId ?? input.jobId, nodes: {}, written: { versionId: input.jobId, placement } }\n    }\n    if (!sourceVersionId) return { status: 404, error: AI_EDIT_VERSION_GONE_COPY }\n    const source = await versions.doc(sourceVersionId).get()\n    if (!source.exists) return { status: 404, error: AI_EDIT_VERSION_GONE_COPY }\n    if (input.jobId && source.get('aiEditJobId') === input.jobId) {\n      return { ...base, sourceVersionId, nodes: {}, written: { versionId: sourceVersionId, placement: 'in-place' } }\n    }\n    const nodes = decodeStoredNodes<NodesMap>(source.get('nodes'))\n    if (!nodes || !Object.keys(nodes).length) return { status: 400, error: AI_EDIT_NO_NODES_COPY }\n    return { ...base, sourceVersionId, nodes, written: null }\n  }\n  return { status: 404, error: AI_EDIT_GONE_COPY }\n}\n\n/**\n * Where a change may land (see the module head), or `refused` when the only\n * place is a version visitors see and the plan keeps no version history.\n */\nexport function aiEditPlacement(input: {\n  versioning: boolean\n  served: boolean\n  sourceIsPointer: boolean\n  sourceScheduled: boolean\n}): AiEditPlacement | 'refused' {\n  if (input.versioning) return !input.served && input.sourceIsPointer ? 'new-current' : 'new-beside'\n  const seen = input.sourceScheduled || (input.sourceIsPointer && input.served)\n  return seen ? 'refused' : 'in-place'\n}\n\n// ── Writing it ────────────────────────────────────────────────────────────\n\nexport interface AiEditWriteInput {\n  hostId: string\n  kind: AiEditTargetKind\n  id: string\n  sourceVersionId: string\n  /** The new version's id, which is the job's; also the stamp a change in place carries. */\n  jobVersionId: string\n  versioning: boolean\n  proposal: AssistEditProposal\n  /** Whether the page's search fields may be written: a page no visitor reaches. */\n  writeSeo: boolean\n  versionName: string\n  uid: string\n  /** The job the member started, stamped as `aiJobId` on a new version. */\n  aiJobId: string\n  now: Date\n}\n\nexport type AiEditWrite =\n  | { ok: true; versionId: string; placement: AiEditPlacement; seoWritten: boolean }\n  | { ok: false; error: string }\n\n/**\n * The change written, in one transaction that reads the document as it is\n * stored NOW — a member may have saved, published or changed plan's history\n * since the read — decides where it lands again on that, and applies the\n * proposal to the stored nodes through the canvas's guards. An element that\n * changed since the model saw it refuses the whole change, as the editor does.\n */\nexport async function writeAiEdit(firestore: Firestore, input: AiEditWriteInput): Promise<AiEditWrite> {\n  const hostRef = firestore.collection('hosts').doc(input.hostId)\n  const docRef = hostRef.collection(COLLECTIONS[input.kind]).doc(input.id)\n  const versions = docRef.collection('versions')\n  const sourceRef = versions.doc(input.sourceVersionId)\n  const newRef = versions.doc(input.jobVersionId)\n  return firestore.runTransaction(async (tx): Promise<AiEditWrite> => {\n    const [host, doc, source, already] = await Promise.all([tx.get(hostRef), tx.get(docRef), tx.get(sourceRef), tx.get(newRef)])\n    const pointer = text(doc.get('versionId')) || null\n    if (already.exists) {\n      return { ok: true, versionId: input.jobVersionId, placement: pointer === input.jobVersionId ? 'new-current' : 'new-beside', seoWritten: false }\n    }\n    if (!doc.exists || doc.get('deletedAt') != null) return { ok: false, error: AI_EDIT_GONE_COPY }\n    if (!source.exists) return { ok: false, error: AI_EDIT_VERSION_GONE_COPY }\n    const served = input.kind === 'layout' || screenServed(doc, host)\n    const placement = aiEditPlacement({\n      versioning: input.versioning,\n      served,\n      sourceIsPointer: pointer === input.sourceVersionId,\n      sourceScheduled: pendingScheduleVersion(doc) === input.sourceVersionId,\n    })\n    if (placement === 'refused') return { ok: false, error: AI_EDIT_NEEDS_VERSIONING_COPY }\n    const nodes = decodeStoredNodes<NodesMap>(source.get('nodes'))\n    if (!nodes) return { ok: false, error: AI_EDIT_NO_NODES_COPY }\n    const versionId = placement === 'in-place' ? input.sourceVersionId : input.jobVersionId\n    const seo: Partial<Record<(typeof SCREEN_SEO_TEXT_FIELDS)[number], string>> = {}\n    const writeSeo = input.writeSeo && input.kind === 'screen' && !served\n    const proposal: AssistEditProposal = {\n      ...input.proposal,\n      ops: writeSeo ? input.proposal.ops : input.proposal.ops.filter((op) => op.op !== 'setSeo'),\n      target: { ...input.proposal.target, versionId },\n    }\n    const applied = aiApplyEditToNodes(nodes, proposal, writeSeo ? seo : undefined)\n    if (applied.ok === false) return { ok: false, error: applied.reason === 'stale' ? AI_EDIT_STALE_COPY : AI_EDIT_REFUSED_COPY }\n    const packed = encodeStoredNodes(applied.nodes)\n    if (!packed) return { ok: false, error: AI_EDIT_NO_NODES_COPY }\n    const stored = Buffer.from(packed)\n    const docPatch: Record<string, unknown> = {}\n    if (placement === 'in-place') {\n      tx.update(sourceRef, { nodes: stored, updatedAt: input.now, aiEditJobId: input.jobVersionId })\n    } else {\n      // A copy of the version it started from — its layout binding, its\n      // declared properties, everything the editor stored — with the changed\n      // tree, as the versions route copies one.\n      const copy = { ...(source.data() as Record<string, unknown>) }\n      delete copy['aiEditJobId']\n      tx.create(newRef, {\n        ...copy,\n        nodes: stored,\n        displayName: input.versionName,\n        createdAt: input.now,\n        updatedAt: input.now,\n        createdBy: input.uid,\n        aiJobId: input.aiJobId,\n      })\n      if (placement === 'new-current') docPatch['versionId'] = input.jobVersionId\n    }\n    for (const [field, value] of Object.entries(seo)) {\n      if (value) docPatch[`seo.${field}`] = value\n    }\n    if (Object.keys(docPatch).length) tx.update(docRef, { ...docPatch, updatedAt: input.now })\n    return { ok: true, versionId, placement, seoWritten: Object.keys(seo).length > 0 }\n  })\n}\n\n// ── The runner ────────────────────────────────────────────────────────────\n\nexport interface AiJobEditStepDeps {\n  readTarget?: typeof readAiEditTarget\n  writeEdit?: typeof writeAiEdit\n}\n\n/** What an edit wrote, as the job's output: a link into the Besigner on the version written. */\nexport function aiEditOutput(\n  read: Pick<AiEditTargetRead, 'kind' | 'id' | 'name' | 'hostSubdomain'>,\n  hostId: string,\n  written: { versionId: string; placement: AiEditPlacement },\n  leftOut: readonly string[],\n): AiJobOutput {\n  return {\n    resource: read.kind,\n    id: read.id,\n    versionId: written.versionId,\n    hostId,\n    hostSubdomain: read.hostSubdomain,\n    label: read.name,\n    note: aiEditOutputNote({ kind: read.kind, placement: written.placement, leftOut }),\n  }\n}\n\n/** The new version's id: the job's own, which a build's unit takes from its plan item. */\nexport function aiEditVersionId(job: Pick<AiJob, '$id'>): string {\n  return job.$id.slice(0, 64)\n}\n\n/**\n * The ops a job may save, and why it left the rest out: never a component\n * save, and a page's search fields only where no visitor reaches the page.\n */\nexport function aiEditJobOps(\n  ops: readonly AssistEditOp[],\n  options: { seo: boolean },\n): { ops: AssistEditOp[]; leftOut: string[] } {\n  const kept: AssistEditOp[] = []\n  const leftOut = new Set<string>()\n  for (const op of ops) {\n    if (op.op === 'saveAsComponent') leftOut.add(AI_EDIT_COMPONENT_LEFT_OUT)\n    else if (op.op === 'setSeo' && !options.seo) leftOut.add(AI_EDIT_SEO_LEFT_OUT)\n    else kept.push(op)\n  }\n  return { ops: kept, leftOut: [...leftOut] }\n}\n\nexport function createAiJobEditStep(deps: AiJobEditStepDeps = {}): AiJobStepRunner {\n  const readTarget = deps.readTarget ?? readAiEditTarget\n  const writeEdit = deps.writeEdit ?? writeAiEdit\n  return async ({ job, now, signal, firestore, org, modelFor }): Promise<AiJobStepOutcome> => {\n    const model = modelFor?.('job.edit') ?? aiJobEditModel()\n    const unspent = (failure: string): AiJobStepOutcome => ({ ...aiUnspentOutcome(model), failure })\n    const inputs = parseAiEditJobInputs(job.inputs)\n    if (typeof inputs === 'string') return unspent(inputs)\n    const hostId = job.hostId\n    if (!hostId) return unspent(AI_EDIT_NO_SITE_COPY)\n    const read = await readTarget(firestore, { orgId: job.orgId, hostId, inputs, jobId: aiEditVersionId(job) })\n    if ('error' in read) return unspent(read.error)\n    if (read.written) return aiUnspentOutcome(model, { outputs: [aiEditOutput(read, hostId, read.written, [])] })\n\n    const orgData = org ?? ((await firestore.collection('orgs').doc(job.orgId).get()).data() ?? null)\n    const versioning = checkEntitlement(orgData as never, 'versioning')\n    const placement = aiEditPlacement({\n      versioning,\n      served: read.served,\n      sourceIsPointer: read.sourceVersionId === read.pointerVersionId,\n      sourceScheduled: read.scheduledVersionId === read.sourceVersionId,\n    })\n    if (placement === 'refused') return aiUnspentOutcome(model, { review: aiLimitReview(AI_EDIT_NEEDS_VERSIONING_COPY) })\n    const outline = aiEditJobOutline(read.nodes)\n    const context = outline ? parseAssistEditContext(outline) : null\n    if (!context) return unspent(AI_EDIT_NO_NODES_COPY)\n    const target: AssistEditTarget = {\n      kind: read.kind,\n      documentId: read.id,\n      versionId: placement === 'in-place' ? read.sourceVersionId : aiEditVersionId(job),\n      hostId,\n    }\n\n    const generation = await runValidatedGeneration(\n      'edit',\n      aiJobEditGeneration({ brief: job.brief, context, target, model, ...(signal ? { signal } : {}) }),\n    )\n    const spent = { ...aiGenerationSpent(generation), ...(generation.effort ? { effort: generation.effort } : {}) }\n    if (generation.status === 'refused') return { ...spent, refused: true }\n    // An answer its re-ask still could not make whole keeps the changes that\n    // survived, as the chat door's card does, and says what it left out; one\n    // with none, or one that broke a numbered rule, is nothing to save.\n    let proposal: AssistEditProposal | null = generation.status === 'ok' ? generation.value : null\n    const refused = generation.status === 'needs_input' ? generation.answer : null\n    if (!proposal && refused) {\n      const salvaged = validateStreamedGeneration('edit', {\n        answer: refused,\n        check: (answer) => checkAssistEditAnswer(answer, { context, target }),\n      })\n      proposal = salvaged.status === 'ok' ? salvaged.value : null\n    }\n    if (!proposal) return { ...spent, failure: AI_EDIT_NOTHING_COPY }\n\n    const seo = read.kind === 'screen' && !read.served\n    const kept = aiEditJobOps(proposal.ops, { seo })\n    const leftOut = [...proposal.dropped, ...kept.leftOut]\n    if (!kept.ops.length) {\n      return { ...spent, failure: `Nothing was saved. Left out: ${leftOut.join('; ') || 'every change'}.` }\n    }\n    const write = await writeEdit(firestore, {\n      hostId,\n      kind: read.kind,\n      id: read.id,\n      sourceVersionId: read.sourceVersionId,\n      jobVersionId: aiEditVersionId(job),\n      versioning,\n      proposal: { ...proposal, ops: kept.ops },\n      writeSeo: seo,\n      versionName: aiEditVersionName(proposal.summary),\n      uid: job.createdBy,\n      aiJobId: aiOriginJobId(job),\n      now,\n    })\n    if (write.ok === false) return { ...spent, failure: write.error }\n    return { ...spent, outputs: [aiEditOutput(read, hostId, write, leftOut)] }\n  }\n}\n\nexport const runAiJobEditStep = createAiJobEditStep()\n\n// ── Admission ─────────────────────────────────────────────────────────────\n\nexport interface AiEditJobAdmissionDeps {\n  readTarget?: typeof readAiEditTarget\n  ownerOf?: typeof resolveOrgIdForHost\n}\n\n/**\n * An edit job is admitted for a page or layout of a site of its own org,\n * and only where the change has somewhere to land that no visitor sees on\n * this workspace's plan — refused in the plan's words before anything exists.\n */\nexport function createAiEditJobAdmission(deps: AiEditJobAdmissionDeps = {}): AiJobAdmission {\n  const readTarget = deps.readTarget ?? readAiEditTarget\n  const ownerOf = deps.ownerOf ?? resolveOrgIdForHost\n  return async (context): Promise<AiJobAdmissionRefusal | null> => {\n    const inputs = parseAiEditJobInputs(context.inputs)\n    if (typeof inputs === 'string') return { status: 400, error: inputs }\n    if (!context.hostId) return { status: 400, error: AI_EDIT_NO_SITE_COPY }\n    const owner = await ownerOf(context.hostId)\n    if (!owner || owner !== context.orgId) return { status: 404, error: 'Unknown site' }\n    // A job asked about at its door has no run to find yet.\n    const read = await readTarget(context.firestore, { orgId: context.orgId, hostId: context.hostId, inputs, jobId: null })\n    if ('error' in read) return read\n    const placement = aiEditPlacement({\n      versioning: checkEntitlement(context.org as never, 'versioning'),\n      served: read.served,\n      sourceIsPointer: read.sourceVersionId === read.pointerVersionId,\n      sourceScheduled: read.scheduledVersionId === read.sourceVersionId,\n    })\n    return placement === 'refused' ? { status: 403, error: AI_EDIT_NEEDS_VERSIONING_COPY } : null\n  }\n}\n\nexport const aiEditJobAdmission = createAiEditJobAdmission()\n\n/** Registers the edit step and the check an edit job passes before it is created or resumed. */\nexport function registerAiEditJob(): void {\n  registerAiJobStep('edit', runAiJobEditStep, { minimumMs: AI_JOB_EDIT_STEP_MINIMUM_MS })\n  registerAiJobAdmission('edit', aiEditJobAdmission)\n}\n"],"names":["checkEntitlement","SCREEN_KIND_TEMPLATE","screenSeoStageKey","SCREEN_SEO_TEXT_FIELDS","decodeStoredNodes","encodeStoredNodes","CanvasManager","FEATURE_FLAG","resolveOrgIdForHost","applyAssistEdit","AI_EDIT_COMPONENT_LEFT_OUT","AI_EDIT_EMAIL_COPY","AI_EDIT_GONE_COPY","AI_EDIT_NEEDS_VERSIONING_COPY","AI_EDIT_NO_NODES_COPY","AI_EDIT_NO_SITE_COPY","AI_EDIT_NOTHING_COPY","AI_EDIT_REFUSED_COPY","AI_EDIT_SEO_LEFT_OUT","AI_EDIT_STALE_COPY","AI_EDIT_VERSION_GONE_COPY","aiEditJobOutline","aiEditOutputNote","aiEditVersionName","parseAiEditJobInputs","ASSIST_EDIT_TOOL_NAME","AI_STEP_TIERS","AI_ROUTING_TABLE","aiModelForStep","runValidatedGeneration","validateStreamedGeneration","AI_PALETTE","assistEditTool","checkAssistEditAnswer","editCanvasBlock","editSelectionBlock","parseAssistEditContext","registerAiJobAdmission","aiJobStepBudget","aiOriginJobId","aiGenerationSpent","aiLimitReview","aiUnspentOutcome","AI_JOB_BRIEF_MAX_CHARS","registerAiJobStep","AI_EDIT_READS_MS","AI_JOB_EDIT_STEP_BUDGET","tier","maxTokens","lookups","ownReadsMs","AI_JOB_EDIT_STEP_MINIMUM_MS","minimumMs","aiJobEditModel","AI_JOB_EDIT_RULES","text","join","aiJobEditInstructions","kind","cacheBreakpoint","aiJobEditPrompt","input","context","brief","slice","aiJobEditGeneration","request","row","target","step","model","instructions","messages","role","content","tool","thinking","effort","signal","check","answer","AI_EDIT_CANVAS_PLATFORM","components","getSchema","componentId","entry","undefined","acceptsChildren","flags","dropping","DISABLED","getLabel","displayName","aiEditCanvas","nodes","canvas","setNodes","aiApplyEditToNodes","proposal","seo","fields","field","value","session","documentKind","documentId","versionId","isLiveVersion","applied","ok","reason","toJSON","COLLECTIONS","screen","layout","screenServed","host","get","routing","id","pendingScheduleVersion","doc","schedule","readAiEditTarget","firestore","hostRef","collection","hostId","exists","orgId","status","error","kinds","inputs","targetKind","docRef","pointerVersionId","versions","hostSubdomain","name","own","jobId","sourceVersionId","base","served","scheduledVersionId","placement","written","source","Object","keys","length","aiEditPlacement","versioning","sourceIsPointer","seen","sourceScheduled","writeAiEdit","sourceRef","newRef","jobVersionId","runTransaction","tx","already","Promise","all","pointer","seoWritten","writeSeo","ops","filter","op","packed","stored","Buffer","from","docPatch","update","updatedAt","now","aiEditJobId","copy","data","create","versionName","createdAt","createdBy","uid","aiJobId","entries","aiEditOutput","read","leftOut","resource","label","note","aiEditVersionId","job","$id","aiEditJobOps","options","kept","Set","add","push","createAiJobEditStep","deps","readTarget","writeEdit","org","modelFor","unspent","failure","outputs","orgData","review","outline","generation","spent","refused","salvaged","dropped","write","summary","runAiJobEditStep","createAiEditJobAdmission","ownerOf","owner","aiEditJobAdmission","registerAiEditJob"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-edit-step.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 { checkEntitlement } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport { SCREEN_KIND_TEMPLATE } from '@aglyn/aglyn/app-utils/screen-route'\nimport { screenSeoStageKey, SCREEN_SEO_TEXT_FIELDS } from '@aglyn/aglyn/app-utils/screen-seo-fields'\nimport { hasConcurrentWrite, versionStamp } from '@aglyn/aglyn/app-utils/guarded-version-save'\nimport { decodeStoredNodes, encodeStoredNodes } from '@aglyn/aglyn/app-utils/stored-nodes'\nimport { VERSION_DRAFT_COLLECTION, VERSION_DRAFT_DOC_ID } from '@aglyn/aglyn/app-utils/version-draft'\nimport { CanvasManager } from '@aglyn/aglyn/canvas-manager/canvas-manager'\nimport { FEATURE_FLAG } from '@aglyn/aglyn/foundation/constants/shared'\nimport type { EditorSession } from '@aglyn/aglyn/plugin-manager/editor-sessions'\nimport type { NodesMap } from '@aglyn/aglyn/types/nodes'\nimport { resolveOrgIdForHost } from '@aglyn/tenant-data-admin/server/organizations'\nimport { applyAssistEdit } from '../components/assist-edit-canvas'\nimport {\n  AI_EDIT_COMPONENT_LEFT_OUT,\n  AI_EDIT_EMAIL_COPY,\n  AI_EDIT_GONE_COPY,\n  AI_EDIT_NO_NODES_COPY,\n  AI_EDIT_NO_SITE_COPY,\n  AI_EDIT_NOTHING_COPY,\n  AI_EDIT_REFUSED_COPY,\n  AI_EDIT_SEO_LEFT_OUT,\n  AI_EDIT_STALE_COPY,\n  AI_EDIT_VERSION_GONE_COPY,\n  aiEditJobOutline,\n  aiEditOutputNote,\n  aiEditVersionName,\n  parseAiEditJobInputs,\n  type AiEditJobInputs,\n  type AiEditPlacement,\n  type AiEditTargetKind,\n} from '../model/ai-edit-job'\nimport type { AiJob, AiJobOutput } from '../model/ai-jobs.types'\nimport {\n  ASSIST_EDIT_TOOL_NAME,\n  type AssistEditCanvasContext,\n  type AssistEditOp,\n  type AssistEditProposal,\n  type AssistEditTarget,\n} from '../model/assist-edit'\nimport { AI_STEP_TIERS } from '../providers/catalog'\nimport { AI_ROUTING_TABLE, aiModelForStep } from '../providers/routing'\nimport {\n  runValidatedGeneration,\n  validateStreamedGeneration,\n  type AiCustomGenerationInput,\n} from '../runtime/ai-doctrine'\nimport { AI_PALETTE } from '../runtime/ai-palette.generated'\nimport type { AiSystemBlock } from '../runtime/ai-runtime'\nimport { readAiSiteDatasets } from '../runtime/site-inventory'\nimport {\n  assistEditTool,\n  checkAssistEditAnswer,\n  editCanvasBlock,\n  editDatasetsBlock,\n  editSelectionBlock,\n  parseAssistEditContext,\n  type AssistEditDataset,\n  type AssistEditDatasetScope,\n} from '../server/assist-edit'\nimport { registerAiJobAdmission, type AiJobAdmission, type AiJobAdmissionRefusal } from './ai-job-admission'\nimport { aiJobStepBudget } from './ai-job-budget'\nimport { aiOriginJobId } from './ai-job-draft-ids'\nimport { aiGenerationSpent, aiUnspentOutcome } from './ai-job-generation'\nimport { AI_JOB_BRIEF_MAX_CHARS, type AiJobStepOutcome, type AiJobStepRunner } from './ai-job-text-step'\nimport { registerAiJobStep } from './ai-jobs'\n\n/**\n * The `edit` step (AGL-3616): a change to a page or a layout the site already\n * has, from a description, made on the server with no editor open.\n *\n * It is the Assist edit rung, run as a job. The model is shown the stored\n * document as the rung's outline and proposes through the rung's own tool;\n * its answer is held to the rung's closed world and palette validators\n * (`checkAssistEditAnswer`) and re-asked once, naming what was left out; and\n * what survives lands through the canvas's own guarded mutators\n * (`applyAssistEdit`), on a `CanvasManager` built headless from the stored\n * nodes, inside the transaction that writes it.\n *\n * ── Where the change lands, decided before anything is spent ────────────\n *\n * Never on a version a visitor sees. By default, on every plan, in the\n * WORKING DRAFT of the version it started from (AGL-4116): the one document\n * the Besigner saves to as an author works and offers with Open draft, which\n * publishing moves into the version. The change is built on the draft the\n * author already has, when the Besigner would still offer it, so their work\n * in progress is never thrown away; otherwise on the version's own tree.\n *\n * Only when the request asks for a new version, and the plan keeps version\n * history, a NEW version beside the one it started from — a copy of that\n * version's stored fields with the changed nodes — which becomes the page's\n * current version only when the page is not published; a published page's\n * current version, and a layout's, never move. Asked for without version\n * history, the change goes into the draft and the output says why.\n *\n * ── What a job cannot do that the editor can ────────────────────────────\n *\n * The rung's chat door never offers saving part of a page as a reusable\n * component, and neither does this. A page's search title and description\n * live on the page itself, not on a version, so they are written only for a\n * page that is not published; on a published page they are left out, and the\n * output's note says so, as it says every change it left out.\n *\n * ── One version per job ──────────────────────────────────────────────────\n *\n * The new version is named by the job's id — a build's unit is named by its\n * plan item's id — so a run asked again finds what it wrote and spends\n * nothing. A draft the job writes is stamped with the job's id for the same\n * reason.\n */\n\n/** The longest the step may take reading the page and writing it. */\nexport const AI_EDIT_READS_MS = 2_000\n\n/** The step's time: its answer and its re-ask at the `job.edit` ceiling, with its own reads. */\nexport const AI_JOB_EDIT_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.edit'],\n  maxTokens: AI_ROUTING_TABLE['job.edit'].maxTokens,\n  lookups: 0,\n  ownReadsMs: AI_EDIT_READS_MS,\n})\n\nexport const AI_JOB_EDIT_STEP_MINIMUM_MS = AI_JOB_EDIT_STEP_BUDGET.minimumMs\n\nexport function aiJobEditModel(): string {\n  return aiModelForStep('job.edit')\n}\n\n/**\n * The job's own rules, byte-identical on every request, ahead of the rung's\n * protocol and catalog for the document's kind, which carries the breakpoint:\n * both are the same for every site, so a kind's whole prefix caches once.\n */\nexport const AI_JOB_EDIT_RULES: AiSystemBlock = {\n  text: [\n    'You change a page or a layout the person already has, as a job that runs on its own. No editor is open, nothing is selected, and nobody can answer a question before you finish.',\n    `- Make exactly the change the request asks for, and keep everything else as it is: other elements, their text, their styles and their order. Never rewrite, restyle, move or remove what the request does not ask about, beyond what making that change needs.`,\n    '- Find the elements the request means in the outline of the whole document the request carries, by what they say, what they are and where they sit on the page. Name only ids that outline lists.',\n    `- If the outline does not show an element the request is about, change nothing for that part: never guess at an element.`,\n    `- Call ${ASSIST_EDIT_TOOL_NAME} exactly once, with every operation. Its summary is one short line saying what changed, in the language of the request; it names the version the change is saved in.`,\n    \"- Fill in a page's search title or description only when the request asks for it.\",\n    '- What you change is saved where no visitor sees it until the person publishes it, so never say the site or the page has changed.',\n    '- The protocol below was written for Assist’s chat. In this job there is no user to ask or to press Apply, and no selection: what it says about those does not apply. Everything else in it — the operations, their fields, the elements and the style tokens — does.',\n  ].join('\\n'),\n}\n\n/** The system blocks for one kind of document. */\nexport function aiJobEditInstructions(kind: AiEditTargetKind): AiSystemBlock[] {\n  return [AI_JOB_EDIT_RULES, { text: editCanvasBlock(kind), cacheBreakpoint: true }]\n}\n\n/**\n * What the change is asked from: the document's outline, the site's datasets\n * an element may show the records of (AGL-3616), then the request.\n */\nexport function aiJobEditPrompt(input: {\n  brief: string\n  context: AssistEditCanvasContext\n  datasets?: readonly AssistEditDataset[]\n}): string {\n  const datasets = editDatasetsBlock(input.datasets ?? [])\n  return [\n    editSelectionBlock(input.context),\n    ...(datasets ? ['', datasets] : []),\n    '',\n    `Request: ${input.brief.slice(0, AI_JOB_BRIEF_MAX_CHARS)}`,\n  ].join('\\n')\n}\n\n/**\n * The datasets an edit to this document knows (AGL-3616): every one the site\n * holds, and the one whose record page the document is, if it is one.\n */\nexport function aiEditDatasetScope(\n  datasets: ReadonlyArray<AssistEditDataset & { recordScreenId?: string }>,\n  read: Pick<AiEditTargetRead, 'kind' | 'id'>,\n): Required<AssistEditDatasetScope> {\n  const record = read.kind === 'screen' ? datasets.find((dataset) => dataset.recordScreenId === read.id) : undefined\n  return {\n    datasets: datasets.map(({ id, name, fields, fieldIds, imageField }) => ({\n      id,\n      name,\n      fields,\n      ...(fieldIds ? { fieldIds } : {}),\n      ...(imageField ? { imageField } : {}),\n    })),\n    recordDatasetId: record?.id ?? null,\n  }\n}\n\n/** The edit as the doctrine's loop runs it: the rung's tool, held to the rung's check. */\nexport function aiJobEditGeneration(request: {\n  brief: string\n  context: AssistEditCanvasContext\n  target: AssistEditTarget\n  model: string\n  signal?: AbortSignal\n} & AssistEditDatasetScope): AiCustomGenerationInput<AssistEditProposal> {\n  const row = AI_ROUTING_TABLE['job.edit']\n  const kind = request.target.kind as AiEditTargetKind\n  return {\n    step: 'job.edit',\n    model: request.model,\n    instructions: aiJobEditInstructions(kind),\n    messages: [{ role: 'user', content: aiJobEditPrompt(request) }],\n    tool: assistEditTool(kind),\n    maxTokens: AI_JOB_EDIT_STEP_BUDGET.maxTokens(request.model),\n    ...(row.thinking ? { thinking: row.thinking } : {}),\n    ...(row.effort ? { effort: row.effort } : {}),\n    ...(request.signal ? { signal: request.signal } : {}),\n    check: (answer) =>\n      checkAssistEditAnswer(answer, {\n        context: request.context,\n        target: request.target,\n        ...(request.datasets ? { datasets: request.datasets } : {}),\n        ...(request.recordDatasetId ? { recordDatasetId: request.recordDatasetId } : {}),\n      }),\n  }\n}\n\n// ── The document, headless ────────────────────────────────────────────────\n\n/**\n * The slice of the platform a headless canvas asks: whether an element takes\n * children, answered from the AI palette the edit validator reads, so the\n * canvas refuses exactly what the validator refuses.\n */\nconst AI_EDIT_CANVAS_PLATFORM = {\n  components: {\n    getSchema: (componentId: string) => {\n      const entry = AI_PALETTE[componentId]\n      if (!entry) return undefined\n      return entry.acceptsChildren ? {} : { flags: { dropping: FEATURE_FLAG.DISABLED } }\n    },\n    getLabel: (componentId: string) => AI_PALETTE[componentId]?.displayName ?? componentId,\n  },\n}\n\n/** A canvas over a stored node map, with the editor's own guarded mutators and no editor. */\nexport function aiEditCanvas(nodes: NodesMap): CanvasManager {\n  const canvas = new CanvasManager(AI_EDIT_CANVAS_PLATFORM as never)\n  canvas.setNodes(nodes)\n  return canvas\n}\n\n/**\n * Lands a proposal on a stored node map, as the editor lands one on its open\n * canvas: checked whole first, then one batch, all or nothing. The session is\n * the version being written, which is never one a visitor sees; a page's\n * search fields are captured into `seo` only where `seo` is given.\n */\nexport function aiApplyEditToNodes(\n  nodes: NodesMap,\n  proposal: AssistEditProposal,\n  seo?: Partial<Record<(typeof SCREEN_SEO_TEXT_FIELDS)[number], string>>,\n): { ok: true; nodes: NodesMap } | { ok: false; reason: string } {\n  const canvas = aiEditCanvas(nodes)\n  const fields: Record<string, (value: string) => void> = {}\n  if (seo) {\n    for (const field of SCREEN_SEO_TEXT_FIELDS) fields[screenSeoStageKey(field)] = (value) => (seo[field] = value)\n  }\n  const session: EditorSession = {\n    documentKind: proposal.target.kind,\n    documentId: proposal.target.documentId,\n    versionId: proposal.target.versionId,\n    isLiveVersion: () => false,\n    ...(seo ? { fields } : {}),\n  }\n  const applied = applyAssistEdit(canvas, proposal, session)\n  if (applied.ok === false) return { ok: false, reason: applied.reason }\n  return { ok: true, nodes: canvas.toJSON().nodes as NodesMap }\n}\n\n// ── Reading the document ──────────────────────────────────────────────────\n\ntype Firestore = FirebaseFirestore.Firestore\n\nconst COLLECTIONS: Readonly<Record<AiEditTargetKind, 'screens' | 'layouts'>> = {\n  screen: 'screens',\n  layout: 'layouts',\n}\n\n/** The page or layout an edit job changes, as it stands before anything is spent. */\nexport interface AiEditTargetRead {\n  kind: AiEditTargetKind\n  id: string\n  name: string\n  hostSubdomain: string | null\n  /** The document's current version. */\n  pointerVersionId: string | null\n  /** The version the change starts from. */\n  sourceVersionId: string\n  /** The version's own tree. */\n  nodes: NodesMap\n  /**\n   * The version's working draft, when it has one the Besigner would still\n   * offer: an author's saved work in progress, which a change to the draft\n   * is built on. Null when there is none, or the version was saved since.\n   */\n  draft: { nodes: NodesMap } | null\n  /** Whether visitors see the document's current version: a published page, a collection template, any layout. */\n  served: boolean\n  /** The version a pending publish schedule will make current, if any. */\n  scheduledVersionId: string | null\n  /** What this job already wrote, when a run of it got that far. */\n  written: { versionId: string; placement: AiEditPlacement } | null\n}\n\nexport interface AiEditTargetRefusal {\n  status: 400 | 404\n  error: string\n}\n\nconst text = (value: unknown): string => (typeof value === 'string' ? value : '')\n\n/** Whether visitors see a page's current version: it is routed, or it renders a collection's entries. */\nfunction screenServed(screen: FirebaseFirestore.DocumentSnapshot, host: FirebaseFirestore.DocumentSnapshot): boolean {\n  if (screen.get('kind') === SCREEN_KIND_TEMPLATE) return true\n  const routing = host.get('screens') as Record<string, unknown> | null | undefined\n  return typeof routing?.[screen.id] === 'string'\n}\n\nfunction pendingScheduleVersion(doc: FirebaseFirestore.DocumentSnapshot): string | null {\n  const schedule = doc.get('publishSchedule') as Record<string, unknown> | null | undefined\n  if (!schedule || schedule['status'] !== 'pending' || schedule['action'] === 'unpublish') return null\n  return text(schedule['versionId']) || null\n}\n\n/**\n * A version's working draft as the Besigner would offer it: a tree, taken\n * against the version as it is stored now. A draft the version has been\n * saved past is not offered there (it would undo that save), so a change is\n * not built on it here either. `aiEditJobId` names the job that wrote it.\n */\nfunction usableDraft(\n  draft: FirebaseFirestore.DocumentSnapshot,\n  version: FirebaseFirestore.DocumentSnapshot,\n): { nodes: NodesMap; aiEditJobId: string | null } | null {\n  if (!draft.exists) return null\n  const nodes = decodeStoredNodes<NodesMap>(draft.get('nodes'))\n  if (!nodes || !Object.keys(nodes).length) return null\n  const baseStamp = typeof draft.get('baseStamp') === 'string' ? (draft.get('baseStamp') as string) : null\n  if (hasConcurrentWrite(baseStamp, versionStamp(version.get('updatedAt')))) return null\n  return { nodes, aiEditJobId: text(draft.get('aiEditJobId')) || null }\n}\n\n/** A version's working draft document: the Besigner's, at the core's one address. */\nfunction draftRef(versions: FirebaseFirestore.CollectionReference, versionId: string): FirebaseFirestore.DocumentReference {\n  return versions.doc(versionId).collection(VERSION_DRAFT_COLLECTION).doc(VERSION_DRAFT_DOC_ID)\n}\n\n/**\n * The document an edit job changes, on the job's own site: the page or\n * layout named, not deleted, not an email design, and the version it starts\n * from with a document in it. A refusal names what is wrong.\n */\nexport async function readAiEditTarget(\n  firestore: Firestore,\n  input: {\n    orgId: string\n    hostId: string\n    inputs: AiEditJobInputs\n    /** The job's own version id, to find what a run of it wrote; `null` at the door, before there is one. */\n    jobId: string | null\n  },\n): Promise<AiEditTargetRead | AiEditTargetRefusal> {\n  const hostRef = firestore.collection('hosts').doc(input.hostId)\n  const host = await hostRef.get()\n  if (!host.exists || host.get('orgId') !== input.orgId) return { status: 404, error: AI_EDIT_NO_SITE_COPY }\n  const kinds: AiEditTargetKind[] = input.inputs.targetKind ? [input.inputs.targetKind] : ['screen', 'layout']\n  for (const kind of kinds) {\n    const docRef = hostRef.collection(COLLECTIONS[kind]).doc(input.inputs.target)\n    const doc = await docRef.get()\n    if (!doc.exists) continue\n    if (doc.get('deletedAt') != null) return { status: 404, error: AI_EDIT_GONE_COPY }\n    if (kind === 'screen' && doc.get('kind') === 'email') return { status: 400, error: AI_EDIT_EMAIL_COPY }\n    const pointerVersionId = text(doc.get('versionId')) || null\n    const versions = docRef.collection('versions')\n    const hostSubdomain = text(host.get('subdomain')) || null\n    const name = text(doc.get('displayName')) || (kind === 'screen' ? 'Page' : 'Layout')\n    // A run of this job that got as far as its write.\n    const own = input.jobId ? await versions.doc(input.jobId).get() : null\n    const sourceVersionId = input.inputs.versionId ?? pointerVersionId\n    const base = {\n      kind,\n      id: doc.id,\n      name,\n      hostSubdomain,\n      pointerVersionId,\n      served: kind === 'layout' || screenServed(doc, host),\n      scheduledVersionId: pendingScheduleVersion(doc),\n    }\n    if (own?.exists && input.jobId) {\n      const placement: AiEditPlacement = pointerVersionId === input.jobId ? 'new-current' : 'new-beside'\n      return { ...base, sourceVersionId: sourceVersionId ?? input.jobId, nodes: {}, draft: null, written: { versionId: input.jobId, placement } }\n    }\n    if (!sourceVersionId) return { status: 404, error: AI_EDIT_VERSION_GONE_COPY }\n    const [source, draftDoc] = await Promise.all([versions.doc(sourceVersionId).get(), draftRef(versions, sourceVersionId).get()])\n    if (!source.exists) return { status: 404, error: AI_EDIT_VERSION_GONE_COPY }\n    if (input.jobId && source.get('aiEditJobId') === input.jobId) {\n      return { ...base, sourceVersionId, nodes: {}, draft: null, written: { versionId: sourceVersionId, placement: 'in-place' } }\n    }\n    const draft = usableDraft(draftDoc, source)\n    if (input.jobId && draft?.aiEditJobId === input.jobId) {\n      return { ...base, sourceVersionId, nodes: {}, draft: null, written: { versionId: sourceVersionId, placement: 'draft' } }\n    }\n    const nodes = decodeStoredNodes<NodesMap>(source.get('nodes'))\n    if (!nodes || !Object.keys(nodes).length) return { status: 400, error: AI_EDIT_NO_NODES_COPY }\n    return { ...base, sourceVersionId, nodes, draft: draft ? { nodes: draft.nodes } : null, written: null }\n  }\n  return { status: 404, error: AI_EDIT_GONE_COPY }\n}\n\n/**\n * Where a change may land (see the module head), or `refused` when the only\n * place is a version visitors see and the plan keeps no version history.\n */\nexport function aiEditPlacement(input: {\n  versioning: boolean\n  served: boolean\n  sourceIsPointer: boolean\n  sourceScheduled: boolean\n}): AiEditPlacement | 'refused' {\n  if (input.versioning) return !input.served && input.sourceIsPointer ? 'new-current' : 'new-beside'\n  const seen = input.sourceScheduled || (input.sourceIsPointer && input.served)\n  return seen ? 'refused' : 'in-place'\n}\n\n/**\n * Where an edit job's change lands (AGL-4116): the version's working draft,\n * unless the request asked for a new version and the plan keeps version\n * history — then where {@link aiEditPlacement} puts a new one. Never refused:\n * a draft is on every plan, and no visitor sees it.\n */\nexport function aiEditJobPlacement(input: {\n  newVersion: boolean\n  versioning: boolean\n  served: boolean\n  sourceIsPointer: boolean\n  sourceScheduled: boolean\n}): AiEditPlacement {\n  if (!input.newVersion || !input.versioning) return 'draft'\n  const placed = aiEditPlacement(input)\n  return placed === 'refused' ? 'draft' : placed\n}\n\n// ── Writing it ────────────────────────────────────────────────────────────\n\nexport interface AiEditWriteInput {\n  hostId: string\n  kind: AiEditTargetKind\n  id: string\n  sourceVersionId: string\n  /** The new version's id, which is the job's; also the stamp a draft it writes carries. */\n  jobVersionId: string\n  versioning: boolean\n  /** The request asked for a new version (see {@link aiEditJobPlacement}). */\n  newVersion: boolean\n  proposal: AssistEditProposal\n  /** Whether the page's search fields may be written: a page no visitor reaches. */\n  writeSeo: boolean\n  versionName: string\n  uid: string\n  /** The job the member started, stamped as `aiJobId` on a new version. */\n  aiJobId: string\n  now: Date\n}\n\nexport type AiEditWrite =\n  | { ok: true; versionId: string; placement: AiEditPlacement; seoWritten: boolean }\n  | { ok: false; error: string }\n\n/**\n * The change written, in one transaction that reads the document as it is\n * stored NOW — a member may have saved, published or changed plan's history\n * since the read — decides where it lands again on that, and applies the\n * proposal to the stored nodes through the canvas's guards. An element that\n * changed since the model saw it refuses the whole change, as the editor does.\n */\nexport async function writeAiEdit(firestore: Firestore, input: AiEditWriteInput): Promise<AiEditWrite> {\n  const hostRef = firestore.collection('hosts').doc(input.hostId)\n  const docRef = hostRef.collection(COLLECTIONS[input.kind]).doc(input.id)\n  const versions = docRef.collection('versions')\n  const sourceRef = versions.doc(input.sourceVersionId)\n  const newRef = versions.doc(input.jobVersionId)\n  const sourceDraftRef = draftRef(versions, input.sourceVersionId)\n  return firestore.runTransaction(async (tx): Promise<AiEditWrite> => {\n    const [host, doc, source, already, draftDoc] = await Promise.all([\n      tx.get(hostRef),\n      tx.get(docRef),\n      tx.get(sourceRef),\n      tx.get(newRef),\n      tx.get(sourceDraftRef),\n    ])\n    const pointer = text(doc.get('versionId')) || null\n    if (already.exists) {\n      return { ok: true, versionId: input.jobVersionId, placement: pointer === input.jobVersionId ? 'new-current' : 'new-beside', seoWritten: false }\n    }\n    if (!doc.exists || doc.get('deletedAt') != null) return { ok: false, error: AI_EDIT_GONE_COPY }\n    if (!source.exists) return { ok: false, error: AI_EDIT_VERSION_GONE_COPY }\n    const served = input.kind === 'layout' || screenServed(doc, host)\n    const placement = aiEditJobPlacement({\n      newVersion: input.newVersion,\n      versioning: input.versioning,\n      served,\n      sourceIsPointer: pointer === input.sourceVersionId,\n      sourceScheduled: pendingScheduleVersion(doc) === input.sourceVersionId,\n    })\n    // Read again here, as the version is: an author who saved their draft,\n    // or published it, since the read is what the change is built on now.\n    const draft = placement === 'draft' ? usableDraft(draftDoc, source) : null\n    if (draft?.aiEditJobId === input.jobVersionId) {\n      return { ok: true, versionId: input.sourceVersionId, placement, seoWritten: false }\n    }\n    const nodes = draft?.nodes ?? decodeStoredNodes<NodesMap>(source.get('nodes'))\n    if (!nodes) return { ok: false, error: AI_EDIT_NO_NODES_COPY }\n    const versionId = placement === 'draft' ? input.sourceVersionId : input.jobVersionId\n    const seo: Partial<Record<(typeof SCREEN_SEO_TEXT_FIELDS)[number], string>> = {}\n    const writeSeo = input.writeSeo && input.kind === 'screen' && !served\n    const proposal: AssistEditProposal = {\n      ...input.proposal,\n      ops: writeSeo ? input.proposal.ops : input.proposal.ops.filter((op) => op.op !== 'setSeo'),\n      target: { ...input.proposal.target, versionId },\n    }\n    const applied = aiApplyEditToNodes(nodes, proposal, writeSeo ? seo : undefined)\n    if (applied.ok === false) return { ok: false, error: applied.reason === 'stale' ? AI_EDIT_STALE_COPY : AI_EDIT_REFUSED_COPY }\n    const packed = encodeStoredNodes(applied.nodes)\n    if (!packed) return { ok: false, error: AI_EDIT_NO_NODES_COPY }\n    const stored = Buffer.from(packed)\n    const docPatch: Record<string, unknown> = {}\n    if (placement === 'draft') {\n      // The whole working tree, as the Besigner writes a draft, taken against\n      // the version as stored so the Besigner offers it with Open draft.\n      tx.set(sourceDraftRef, {\n        nodes: stored,\n        baseStamp: versionStamp(source.get('updatedAt')),\n        updatedByUid: input.uid,\n        updatedByEmail: null,\n        updatedAt: input.now,\n        aiEditJobId: input.jobVersionId,\n      })\n    } else {\n      // A copy of the version it started from — its layout binding, its\n      // declared properties, everything the editor stored — with the changed\n      // tree, as the versions route copies one.\n      const copy = { ...(source.data() as Record<string, unknown>) }\n      delete copy['aiEditJobId']\n      tx.create(newRef, {\n        ...copy,\n        nodes: stored,\n        displayName: input.versionName,\n        createdAt: input.now,\n        updatedAt: input.now,\n        createdBy: input.uid,\n        aiJobId: input.aiJobId,\n      })\n      if (placement === 'new-current') docPatch['versionId'] = input.jobVersionId\n    }\n    for (const [field, value] of Object.entries(seo)) {\n      if (value) docPatch[`seo.${field}`] = value\n    }\n    if (Object.keys(docPatch).length) tx.update(docRef, { ...docPatch, updatedAt: input.now })\n    return { ok: true, versionId, placement, seoWritten: Object.keys(seo).length > 0 }\n  })\n}\n\n// ── The runner ────────────────────────────────────────────────────────────\n\nexport interface AiJobEditStepDeps {\n  readTarget?: typeof readAiEditTarget\n  writeEdit?: typeof writeAiEdit\n  readDatasets?: typeof readAiSiteDatasets\n}\n\n/** What an edit wrote, as the job's output: a link into the Besigner on the version written. */\nexport function aiEditOutput(\n  read: Pick<AiEditTargetRead, 'kind' | 'id' | 'name' | 'hostSubdomain'>,\n  hostId: string,\n  written: { versionId: string; placement: AiEditPlacement },\n  leftOut: readonly string[],\n  options: { versionsUnavailable?: boolean } = {},\n): AiJobOutput {\n  return {\n    resource: read.kind,\n    id: read.id,\n    versionId: written.versionId,\n    hostId,\n    hostSubdomain: read.hostSubdomain,\n    label: read.name,\n    ...(written.placement === 'draft' ? { inDraft: true as const } : {}),\n    note: aiEditOutputNote({\n      kind: read.kind,\n      placement: written.placement,\n      leftOut,\n      ...(options.versionsUnavailable ? { versionsUnavailable: true } : {}),\n    }),\n  }\n}\n\n/** The new version's id: the job's own, which a build's unit takes from its plan item. */\nexport function aiEditVersionId(job: Pick<AiJob, '$id'>): string {\n  return job.$id.slice(0, 64)\n}\n\n/**\n * The ops a job may save, and why it left the rest out: never a component\n * save, and a page's search fields only where no visitor reaches the page.\n */\nexport function aiEditJobOps(\n  ops: readonly AssistEditOp[],\n  options: { seo: boolean },\n): { ops: AssistEditOp[]; leftOut: string[] } {\n  const kept: AssistEditOp[] = []\n  const leftOut = new Set<string>()\n  for (const op of ops) {\n    if (op.op === 'saveAsComponent') leftOut.add(AI_EDIT_COMPONENT_LEFT_OUT)\n    else if (op.op === 'setSeo' && !options.seo) leftOut.add(AI_EDIT_SEO_LEFT_OUT)\n    else kept.push(op)\n  }\n  return { ops: kept, leftOut: [...leftOut] }\n}\n\nexport function createAiJobEditStep(deps: AiJobEditStepDeps = {}): AiJobStepRunner {\n  const readTarget = deps.readTarget ?? readAiEditTarget\n  const writeEdit = deps.writeEdit ?? writeAiEdit\n  const readDatasets = deps.readDatasets ?? readAiSiteDatasets\n  return async ({ job, now, signal, firestore, org, modelFor }): Promise<AiJobStepOutcome> => {\n    const model = modelFor?.('job.edit') ?? aiJobEditModel()\n    const unspent = (failure: string): AiJobStepOutcome => ({ ...aiUnspentOutcome(model), failure })\n    const inputs = parseAiEditJobInputs(job.inputs)\n    if (typeof inputs === 'string') return unspent(inputs)\n    const hostId = job.hostId\n    if (!hostId) return unspent(AI_EDIT_NO_SITE_COPY)\n    const read = await readTarget(firestore, { orgId: job.orgId, hostId, inputs, jobId: aiEditVersionId(job) })\n    if ('error' in read) return unspent(read.error)\n    if (read.written) return aiUnspentOutcome(model, { outputs: [aiEditOutput(read, hostId, read.written, [])] })\n\n    const orgData = org ?? ((await firestore.collection('orgs').doc(job.orgId).get()).data() ?? null)\n    const versioning = checkEntitlement(orgData as never, 'versioning')\n    const placement = aiEditJobPlacement({\n      newVersion: inputs.newVersion,\n      versioning,\n      served: read.served,\n      sourceIsPointer: read.sourceVersionId === read.pointerVersionId,\n      sourceScheduled: read.scheduledVersionId === read.sourceVersionId,\n    })\n    // A change to the draft is made on the draft the author already has.\n    const outline = aiEditJobOutline(placement === 'draft' && read.draft ? read.draft.nodes : read.nodes)\n    const context = outline ? parseAssistEditContext(outline, { whole: true }) : null\n    if (!context) return unspent(AI_EDIT_NO_NODES_COPY)\n    const target: AssistEditTarget = {\n      kind: read.kind,\n      documentId: read.id,\n      versionId: placement === 'draft' ? read.sourceVersionId : aiEditVersionId(job),\n      hostId,\n    }\n\n    // The site's datasets, so a request to show records binds a repeat to a\n    // real one instead of writing tokens nothing fills (AGL-3616).\n    const datasets = aiEditDatasetScope(await readDatasets(job.orgId, hostId), read)\n\n    const generation = await runValidatedGeneration(\n      'edit',\n      aiJobEditGeneration({ brief: job.brief, context, target, model, ...datasets, ...(signal ? { signal } : {}) }),\n    )\n    const spent = { ...aiGenerationSpent(generation), ...(generation.effort ? { effort: generation.effort } : {}) }\n    if (generation.status === 'refused') return { ...spent, refused: true }\n    // An answer its re-ask still could not make whole keeps the changes that\n    // survived, as the chat door's card does, and says what it left out; one\n    // with none, or one that broke a numbered rule, is nothing to save.\n    let proposal: AssistEditProposal | null = generation.status === 'ok' ? generation.value : null\n    const refused = generation.status === 'needs_input' ? generation.answer : null\n    if (!proposal && refused) {\n      const salvaged = validateStreamedGeneration('edit', {\n        answer: refused,\n        check: (answer) => checkAssistEditAnswer(answer, { context, target, ...datasets }),\n      })\n      proposal = salvaged.status === 'ok' ? salvaged.value : null\n    }\n    if (!proposal) return { ...spent, failure: AI_EDIT_NOTHING_COPY }\n\n    const seo = read.kind === 'screen' && !read.served\n    const kept = aiEditJobOps(proposal.ops, { seo })\n    const leftOut = [...proposal.dropped, ...kept.leftOut]\n    if (!kept.ops.length) {\n      return { ...spent, failure: `Nothing was saved. Left out: ${leftOut.join('; ') || 'every change'}.` }\n    }\n    const write = await writeEdit(firestore, {\n      hostId,\n      kind: read.kind,\n      id: read.id,\n      sourceVersionId: read.sourceVersionId,\n      jobVersionId: aiEditVersionId(job),\n      versioning,\n      newVersion: inputs.newVersion,\n      proposal: { ...proposal, ops: kept.ops },\n      writeSeo: seo,\n      versionName: aiEditVersionName(proposal.summary),\n      uid: job.createdBy,\n      aiJobId: aiOriginJobId(job),\n      now,\n    })\n    if (write.ok === false) return { ...spent, failure: write.error }\n    const versionsUnavailable = inputs.newVersion && !versioning\n    return { ...spent, outputs: [aiEditOutput(read, hostId, write, leftOut, { versionsUnavailable })] }\n  }\n}\n\nexport const runAiJobEditStep = createAiJobEditStep()\n\n// ── Admission ─────────────────────────────────────────────────────────────\n\nexport interface AiEditJobAdmissionDeps {\n  readTarget?: typeof readAiEditTarget\n  ownerOf?: typeof resolveOrgIdForHost\n}\n\n/**\n * An edit job is admitted for a page or layout of a site of its own org that\n * has a version to start from. Every plan has somewhere to put the change\n * that no visitor sees — the version's draft — so no plan is refused.\n */\nexport function createAiEditJobAdmission(deps: AiEditJobAdmissionDeps = {}): AiJobAdmission {\n  const readTarget = deps.readTarget ?? readAiEditTarget\n  const ownerOf = deps.ownerOf ?? resolveOrgIdForHost\n  return async (context): Promise<AiJobAdmissionRefusal | null> => {\n    const inputs = parseAiEditJobInputs(context.inputs)\n    if (typeof inputs === 'string') return { status: 400, error: inputs }\n    if (!context.hostId) return { status: 400, error: AI_EDIT_NO_SITE_COPY }\n    const owner = await ownerOf(context.hostId)\n    if (!owner || owner !== context.orgId) return { status: 404, error: 'Unknown site' }\n    // A job asked about at its door has no run to find yet.\n    const read = await readTarget(context.firestore, { orgId: context.orgId, hostId: context.hostId, inputs, jobId: null })\n    // Every plan has somewhere to put the change: the page's draft (AGL-4116).\n    return 'error' in read ? read : null\n  }\n}\n\nexport const aiEditJobAdmission = createAiEditJobAdmission()\n\n/** Registers the edit step and the check an edit job passes before it is created or resumed. */\nexport function registerAiEditJob(): void {\n  registerAiJobStep('edit', runAiJobEditStep, { minimumMs: AI_JOB_EDIT_STEP_MINIMUM_MS })\n  registerAiJobAdmission('edit', aiEditJobAdmission)\n}\n"],"names":["checkEntitlement","SCREEN_KIND_TEMPLATE","screenSeoStageKey","SCREEN_SEO_TEXT_FIELDS","hasConcurrentWrite","versionStamp","decodeStoredNodes","encodeStoredNodes","VERSION_DRAFT_COLLECTION","VERSION_DRAFT_DOC_ID","CanvasManager","FEATURE_FLAG","resolveOrgIdForHost","applyAssistEdit","AI_EDIT_COMPONENT_LEFT_OUT","AI_EDIT_EMAIL_COPY","AI_EDIT_GONE_COPY","AI_EDIT_NO_NODES_COPY","AI_EDIT_NO_SITE_COPY","AI_EDIT_NOTHING_COPY","AI_EDIT_REFUSED_COPY","AI_EDIT_SEO_LEFT_OUT","AI_EDIT_STALE_COPY","AI_EDIT_VERSION_GONE_COPY","aiEditJobOutline","aiEditOutputNote","aiEditVersionName","parseAiEditJobInputs","ASSIST_EDIT_TOOL_NAME","AI_STEP_TIERS","AI_ROUTING_TABLE","aiModelForStep","runValidatedGeneration","validateStreamedGeneration","AI_PALETTE","readAiSiteDatasets","assistEditTool","checkAssistEditAnswer","editCanvasBlock","editDatasetsBlock","editSelectionBlock","parseAssistEditContext","registerAiJobAdmission","aiJobStepBudget","aiOriginJobId","aiGenerationSpent","aiUnspentOutcome","AI_JOB_BRIEF_MAX_CHARS","registerAiJobStep","AI_EDIT_READS_MS","AI_JOB_EDIT_STEP_BUDGET","tier","maxTokens","lookups","ownReadsMs","AI_JOB_EDIT_STEP_MINIMUM_MS","minimumMs","aiJobEditModel","AI_JOB_EDIT_RULES","text","join","aiJobEditInstructions","kind","cacheBreakpoint","aiJobEditPrompt","input","datasets","context","brief","slice","aiEditDatasetScope","read","record","find","dataset","recordScreenId","id","undefined","map","name","fields","fieldIds","imageField","recordDatasetId","aiJobEditGeneration","request","row","target","step","model","instructions","messages","role","content","tool","thinking","effort","signal","check","answer","AI_EDIT_CANVAS_PLATFORM","components","getSchema","componentId","entry","acceptsChildren","flags","dropping","DISABLED","getLabel","displayName","aiEditCanvas","nodes","canvas","setNodes","aiApplyEditToNodes","proposal","seo","field","value","session","documentKind","documentId","versionId","isLiveVersion","applied","ok","reason","toJSON","COLLECTIONS","screen","layout","screenServed","host","get","routing","pendingScheduleVersion","doc","schedule","usableDraft","draft","version","exists","Object","keys","length","baseStamp","aiEditJobId","draftRef","versions","collection","readAiEditTarget","firestore","hostRef","hostId","orgId","status","error","kinds","inputs","targetKind","docRef","pointerVersionId","hostSubdomain","own","jobId","sourceVersionId","base","served","scheduledVersionId","placement","written","source","draftDoc","Promise","all","aiEditPlacement","versioning","sourceIsPointer","seen","sourceScheduled","aiEditJobPlacement","newVersion","placed","writeAiEdit","sourceRef","newRef","jobVersionId","sourceDraftRef","runTransaction","tx","already","pointer","seoWritten","writeSeo","ops","filter","op","packed","stored","Buffer","from","docPatch","set","updatedByUid","uid","updatedByEmail","updatedAt","now","copy","data","create","versionName","createdAt","createdBy","aiJobId","entries","update","aiEditOutput","leftOut","options","resource","label","inDraft","note","versionsUnavailable","aiEditVersionId","job","$id","aiEditJobOps","kept","Set","add","push","createAiJobEditStep","deps","readTarget","writeEdit","readDatasets","org","modelFor","unspent","failure","outputs","orgData","outline","whole","generation","spent","refused","salvaged","dropped","write","summary","runAiJobEditStep","createAiEditJobAdmission","ownerOf","owner","aiEditJobAdmission","registerAiEditJob"],"mappings":"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"}

package/src/lib/jobs/ai-job-import-step.d.ts

@@ -19,10 +19,10 @@ import type { AiJob, AiJobItemLedger } from '../model/ai-jobs.types';
 import { type AiSiteImportBuild, type AiSiteImportHome, type AiSiteImportLeftOutReason, type AiSiteImportPage, type AiSiteImportPageRead, type AiSiteImportState, type AiSiteImportWave } from '../model/ai-site-import';
 import { crawlSiteForImport, type SiteImportCrawlSeams, type SiteImportInventory } from '../site-import/site-import-crawl';
 import { type SiteImportPhotosDeps } from '../site-import/site-import-images';
+import { type AiLayoutFrameSource, type AiLayoutFrameSourceGround, type AiLayoutFrameSourceTo } from '../layout-language/ai-layout-frame-source';
 import { type AiSiteImportDocument } from './ai-site-import-document';
 import { aiRunSiteImportLook, type AiSiteImportLookDeps } from './ai-site-import-look';
 import { aiPublishImportedWave } from './ai-site-import-publish';
-import { fileSiteImportReview } from '../site-import/site-import-review';
 import { type AiJobAdmission } from './ai-job-admission';
 import { readAiScreenRoom } from './ai-job-drafts';
 import { type AiLayoutSitePage } from './ai-job-layout-site-pages';
@@ -90,7 +90,6 @@ export interface AiSiteImportStepDeps {
     fetchImage?: SiteImportPhotosDeps['fetch'];
     readRoom?: typeof readAiScreenRoom;
     readSiteName?: (firestore: FirebaseFirestore.Firestore, hostId: string) => Promise<string>;
-    fileReview?: typeof fileSiteImportReview;
     pageWritten?: typeof aiSitePageWritten;
     mintId?: () => string;
     clock?: () => number;
@@ -122,6 +121,26 @@ export declare function aiSiteImportBuildOf(page: Pick<AiSiteImportPage, 'group'
  * punctuation, else the person's.
  */
 export declare function aiSiteImportBrandName(given: string, own: string): string;
+/**
+ * Where a link of the source's header or footer goes on the new site
+ * (AGL-4108): a page the import brings in by its id, once its wave is the
+ * header's or before it; a page of a later wave by its address on the new
+ * site, which the page takes when its wave lands, since a link by id to a
+ * page not yet live is taken out when a wave goes live; and anywhere else by
+ * the source's own address, so a button that leaves the source leaves the
+ * new site too. `null` for an address no link may carry.
+ */
+export declare function aiSiteImportFrameLinkTo(state: Pick<AiSiteImportState, 'domain' | 'pages'>, wave: number): (href: string | null | undefined) => AiLayoutFrameSourceTo | null;
+/** The ground a source's header bar sits on (AGL-4108): dark, the brand's color, the page's own, or paper. */
+export declare function aiSiteImportHeaderGround(background: string | null, look: AiSiteImportHome['look']): AiLayoutFrameSourceGround;
+/**
+ * The site's header and footer as the source builds them (AGL-4108): its
+ * menu with its menus and their entries, its buttons with their own
+ * addresses and how they are drawn, and its footer, every link resolved
+ * (`aiSiteImportFrameLinkTo`). Every label is the source's, as written.
+ * `null` where the reader found no menu on the home page.
+ */
+export declare function aiSiteImportFrameSource(state: AiSiteImportState, wave: Pick<AiSiteImportWave, 'index'>): AiLayoutFrameSource | null;
 /** The header and footer's job: a layout of the site's brand, linking the wave's pages, in the layout language. */
 export declare function aiSiteImportFrameJob(job: AiJob, state: AiSiteImportState, wave: AiSiteImportWave, items: readonly AiJobItemLedger[]): AiJob;
 /** The page brought in, as its page job carries it: its lines, its photos, and the pages its links may go to (AGL-4084). */