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

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-layout-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 { CANVAS_ROOT_ELEMENT_ID } from '@aglyn/aglyn/foundation/constants/canvas'\nimport type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport { duplicateResource } from '@aglyn/tenant-data-admin/server/duplicate-resource'\nimport type { AiJob, AiJobOutput, AiJobPlan, AiJobReview } from '../model/ai-jobs.types'\nimport { aiHomeScreenIds, type AiSiteInventory } from '../model/ai-site-inventory'\nimport { AI_STEP_TIERS } from '../providers/catalog'\nimport { AI_ROUTING_TABLE, aiModelForStep } from '../providers/routing'\nimport {\n  aiDoctrineTreeTool,\n  runValidatedGeneration,\n  type AiValidatedTree,\n} from '../runtime/ai-doctrine'\nimport {\n  walkTree,\n  type AiDoctrineNode,\n  type AiDoctrineTree,\n  type AiDoctrineViolation,\n} from '../runtime/ai-doctrine-validators'\nimport type { AiLoadEstimate } from '../runtime/ai-palette'\nimport type { AiSystemBlock } from '../runtime/ai-runtime'\nimport { readSiteInventory } from '../runtime/site-inventory'\nimport { registerAiJobAdmission, type AiJobAdmission } from './ai-job-admission'\nimport {\n  aiBuildingPlanCreations,\n  aiJobPlanCreationsRefusal,\n  aiPlanCreationsRunMinimumMs,\n} from './ai-job-plan-creations'\nimport { aiJobDraftId, aiOriginJobId } from './ai-job-draft-ids'\nimport {\n  aiDraftAdmissionRefusal,\n  aiDraftAllowanceRefusal,\n  aiSiteSubdomain,\n  readAiDraft,\n  readAiDraftNodes,\n  writeAiDraft,\n  type AiDraftRecord,\n} from './ai-job-drafts'\nimport {\n  aiBracketedFactsNote,\n  aiCopySourceLines,\n  aiConfirmedPlan,\n  aiDoctrineReview,\n  aiGenerationSpent,\n  aiJobBriefLine,\n  aiLimitReview,\n  aiModelNodeIds,\n  aiPlacedComponentIds,\n  aiPlanCreation,\n  aiPlanReferenceLines,\n  aiPlanReuseViolations,\n  aiUnspentOutcome,\n} from './ai-job-generation'\nimport { aiPlanRegionViolations, aiPlannedLayoutRegions } from './ai-job-plan-conformance'\nimport { aiLayoutSitePages, aiLayoutSitePagesLines, aiLayoutWithSitePages } from './ai-job-layout-site-pages'\nimport type { AiJobStepRunner } from './ai-job-text-step'\nimport { aiJobStepBudget } from './ai-job-budget'\nimport { registerAiJobStep } from './ai-jobs'\n\n/**\n * The layout step (AGL-2909): the generation step of a `layout` job, run once\n * a member confirmed the job's plan.\n *\n * It builds ONE shared layout — a header with the site's navigation, the\n * Layout Slot each page renders in, a footer — through\n * `runValidatedGeneration('layout', …)`, so every building rule holds on the\n * tree before it is kept, and adds three checks of its own through `extend`: a\n * component the confirmed plan reuses is placed (rule 7), every region the\n * plan gives the layout is built (AGL-3024), and a navigation or menu\n * component the site already has is placed rather than drawn again (rule 1).\n *\n * The layout lands as a new draft (`ai-job-drafts.ts`): no screen uses it and\n * no layout nests it, so nothing on the live site changes until a member\n * assigns it. A plan that starts from a copy of a layout the site has gets\n * that copy, through the platform's duplicate module, and nothing generated —\n * so the copy is read back and held to the plan's regions the same way\n * (`aiCopiedLayoutReview`), because a branch that generates nothing is the one\n * branch where a promise can go unmet with no model to answer for it. A\n * source that already lacks a region the plan gives the layout is not copied\n * at all: the layout is built from it (AGL-3143 §14).\n *\n * A generation step runs on the job beat, never at an inline door: it\n * registers the least time its lookup rounds, its answer and its re-ask need\n * (AGL-3035), runs without extended thinking — the plan was reasoned out and\n * confirmed before it — and asks for no more of a tighter ceiling than the\n * doctrine's default for a layout than fits that time on the model it runs.\n */\n\n/** The longest answer a layout may run to; the tree is held to the layout budget either way. */\nexport const AI_JOB_LAYOUT_MAX_TOKENS = AI_ROUTING_TABLE['job.layout'].maxTokens\n\n/**\n * The layout step's time (AGL-3035, AGL-3036): its two inventory-lookup\n * rounds, its answer and its re-ask at the routing table's ceiling on the tier\n * `job.layout` is served from, fitted to what a beat can give a step.\n */\nexport const AI_JOB_LAYOUT_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.layout'],\n  maxTokens: AI_JOB_LAYOUT_MAX_TOKENS,\n})\n\n/** The least time one layout step needs before it starts. */\nexport const AI_JOB_LAYOUT_STEP_MINIMUM_MS = AI_JOB_LAYOUT_STEP_BUDGET.minimumMs\n\n/** A layout's name when the plan names none. */\nexport const AI_JOB_LAYOUT_DEFAULT_NAME = 'Site layout'\n\n/** The layout step's own instructions, cached after the doctrine. */\nexport const AI_JOB_LAYOUT_INSTRUCTIONS: readonly AiSystemBlock[] = [\n  {\n    text: [\n      'You build one shared layout for a website: the frame every page of the site renders inside. Answer with submit_layout: the whole layout as one flat node map.',\n      'A layout is a header, one Layout Slot and a footer, top to bottom. The header is an App Bar (muiAppBar) holding a Toolbar Content (muiToolbar) with the site’s name as text and its navigation. The footer is a Section (section) whose element is footer.',\n      'Navigation links the site’s own pages by id: a Page Link (muiScreenLink) whose screenId is a page id from the site inventory, in the order the brief and the confirmed plan give, seven at most in the header. Never invent a page id, and never link a page by its address.',\n      'When the site inventory lists a component whose name says it is navigation, a menu or a mega menu, place it in the header as an instance instead of building the navigation again. Place every component the confirmed plan reuses.',\n      'The Layout Slot (layoutSlot) is where each page renders and is the page’s main landmark: leave its component unset or main, and put nothing inside it. A layout carries no h1, because every page brings its own.',\n    ].join('\\n'),\n  },\n]\n\n/**\n * The layout job as the generation's user turn: the name, the brief, the\n * confirmed plan, and the layout a short copy would have started from\n * (`aiCopySourceLines`, AGL-3143 §14).\n */\nexport function aiJobLayoutPrompt(\n  job: Pick<AiJob, 'brief'> & Partial<Pick<AiJob, 'inputs'>>,\n  plan: AiJobPlan | null,\n  name: string,\n  source: readonly string[] = [],\n): string {\n  return [\n    `Layout name: ${name}`,\n    aiJobBriefLine(job),\n    ...aiPlanReferenceLines(plan),\n    // A scaffold's layout is built before its pages, whose navigation the platform writes (AGL-3596).\n    ...aiLayoutSitePagesLines(aiLayoutSitePages(job.inputs)),\n    ...source,\n  ].join('\\n')\n}\n\n/** A component name that says it is the site's navigation; a footer's links are not. */\nconst NAVIGATION_NAME = /\\b(?:nav|navigation|navbar|menu|mega ?menu)\\b/i\nconst FOOTER_NAME = /\\bfooter\\b/i\n\n/** A node that links somewhere: a Screen Link, or a Button pointed at a screen or an address. */\nfunction isLink(node: AiDoctrineNode): boolean {\n  if (node.componentId === 'muiScreenLink') return true\n  return (\n    node.componentId === 'muiButton' &&\n    (typeof node.props?.['screenId'] === 'string' || typeof node.props?.['href'] === 'string')\n  )\n}\n\n/**\n * The layout door's checks on a tree the doctrine admitted: every component\n * the confirmed plan reuses is placed, every region the confirmed plan gives\n * the layout is built (AGL-3024), and navigation the site already keeps as a\n * component is placed rather than drawn again in the header.\n */\nexport function aiLayoutReuseCheck(\n  inventory: AiSiteInventory | null,\n  plan: AiJobPlan | null,\n): (tree: AiValidatedTree) => AiDoctrineViolation[] {\n  const components = inventory?.components ?? []\n  const navigation = components.filter(\n    (component) => NAVIGATION_NAME.test(component.name) && !FOOTER_NAME.test(component.name),\n  )\n  return (tree) => {\n    const placed = aiPlacedComponentIds(tree)\n    const violations: AiDoctrineViolation[] = [\n      ...aiPlanReuseViolations(inventory, plan, placed, 'layout'),\n      ...aiPlanRegionViolations(plan, {\n        rootId: tree.rootId,\n        nodes: tree.nodes as unknown as Record<string, AiDoctrineNode>,\n      }),\n    ]\n    if (navigation.length && !navigation.some((component) => placed.has(component.id))) {\n      const visits = walkTree({\n        rootId: tree.rootId,\n        nodes: tree.nodes as unknown as Record<string, AiDoctrineNode>,\n      })\n      const slot = visits.findIndex(({ node }) => node.componentId === 'layoutSlot')\n      const header = slot === -1 ? visits : visits.slice(0, slot)\n      const links = header.filter(({ node }) => isLink(node)).map(({ id }) => id)\n      if (links.length >= 2) {\n        violations.push({\n          rule: 1,\n          code: 'navigation-rebuilt',\n          message: `The site already has the \"${navigation[0].name}\" component. Place it in the header instead of building the navigation again.`,\n          nodeIds: aiModelNodeIds(links, tree.sourceIds),\n        })\n      }\n    }\n    return violations\n  }\n}\n\n/**\n * The regions the confirmed plan gives the layout, against the layout a COPY\n * actually produced (AGL-3024); `null` when the copy keeps the plan, or when\n * the plan promised no region to keep.\n *\n * The duplicate branch generates nothing, so it is the one place a plan's\n * promise can go unmet without a model ever answering for it. A copy that\n * cannot be read — deleted between the write and this read, or stored under a\n * root this check does not know — settles nothing, and a promise this step\n * cannot settle is reviewed by a person rather than reported as kept.\n */\nexport async function aiCopiedLayoutReview(\n  firestore: FirebaseFirestore.Firestore,\n  input: { hostId: string; id: string; name: string; plan: AiJobPlan | null },\n): Promise<AiJobReview | null> {\n  const planned = aiPlannedLayoutRegions(input.plan)\n  if (!planned.regions.length && !planned.unreadable.length) return null\n  const stored = await readAiDraftNodes(firestore, {\n    kind: 'layout',\n    hostId: input.hostId,\n    id: input.id,\n  })\n  const nodes = (stored?.nodes ?? {}) as unknown as Record<string, AiDoctrineNode>\n  if (!nodes[CANVAS_ROOT_ELEMENT_ID]) {\n    return {\n      reason: 'doctrine',\n      message: `\"${input.name}\" was copied from the layout the plan names, and this job could not read the copy back to check it has the regions the plan gives it. Open the layout and check it before you put a page in it.`,\n      findings: [],\n    }\n  }\n  const violations = aiPlanRegionViolations(input.plan, { rootId: CANVAS_ROOT_ELEMENT_ID, nodes })\n  if (!violations.length) return null\n  return aiDoctrineReview({\n    message: `\"${input.name}\" is a copy of the layout the plan names, and a copy is all it is: ${violations[0].message}`,\n    violations,\n  })\n}\n\n/**\n * A layout job is admitted for a site of the job's own org with a shared\n * layout to spare, and confirmed only for a plan whose other creations it\n * builds (AGL-3143 §15).\n */\nexport const aiLayoutJobAdmission: AiJobAdmission = (context) =>\n  aiDraftAdmissionRefusal(context.firestore, {\n    orgId: context.orgId,\n    hostId: context.hostId,\n    kind: 'layout',\n    org: context.org,\n    ownCheck: (hostId) => aiJobPlanCreationsRefusal('layout', context, hostId),\n  })\n\nexport interface AiJobLayoutStepDeps {\n  /** The inventory reader; specs hand in a fake. */\n  readInventory?: typeof readSiteInventory\n  /** The platform's duplicate module, for a plan that starts from a copy. */\n  duplicate?: typeof duplicateResource\n}\n\nexport function createAiJobLayoutStep(deps: AiJobLayoutStepDeps = {}): AiJobStepRunner {\n  const readInventory = deps.readInventory ?? readSiteInventory\n  const duplicate = deps.duplicate ?? duplicateResource\n  return async ({ job, now, signal, firestore, modelFor }) => {\n    const hostId = job.hostId\n    if (!hostId) throw new Error('a layout job names no site, and its admission refuses one')\n    const output = (draft: AiDraftRecord, load?: AiLoadEstimate | null, note?: string | null): AiJobOutput => ({\n      resource: 'layout',\n      id: draft.id,\n      versionId: draft.versionId,\n      hostId,\n      hostSubdomain: draft.hostSubdomain,\n      label: draft.name,\n      ...(load ? { load } : {}),\n      ...(note ? { note } : {}),\n    })\n    // The switch's answer for this job, else the routing table's (AGL-2942).\n    const model = modelFor?.('job.layout') ?? aiModelForStep('job.layout')\n\n    // A run cut off after its draft was written reports that draft, found by the id the job recorded.\n    const draftId = aiJobDraftId(job, 'layout')\n    const written = await readAiDraft(firestore, { kind: 'layout', hostId, id: draftId })\n    if (written) return aiUnspentOutcome(model, { outputs: [output(written)] })\n\n    const [inventory, orgSnapshot] = await Promise.all([\n      readInventory(job.orgId, hostId, { firestore }),\n      firestore.collection('orgs').doc(job.orgId).get(),\n    ])\n    const org = (orgSnapshot.data() ?? null) as Partial<AglynOrgBilling> | null\n    const plan = aiConfirmedPlan(job)\n    const creation = aiPlanCreation(plan, 'layout')\n    const name = creation?.name || AI_JOB_LAYOUT_DEFAULT_NAME\n\n    // The plan starts from a copy of a layout the site has (rule 15): the copy\n    // is the draft, and nothing is generated. A source gone since the plan\n    // was made is built from the brief instead. A source that cannot keep the\n    // plan's regions is built FROM instead (AGL-3143 §14), as the page step\n    // builds from a short source: copying it could only end in the review\n    // below, and Try again would copy the same thing. Only a source read and\n    // found short diverts; one this step cannot read still copies, and the\n    // review after the copy answers for it.\n    const source = creation?.duplicateOf\n      ? inventory.layouts.find((layout) => layout.id === creation.duplicateOf)\n      : undefined\n    const sourceReview = source\n      ? await aiCopiedLayoutReview(firestore, { hostId, id: source.id, plan, name: source.name })\n      : null\n    const sourceShort = Boolean(sourceReview?.findings.length)\n    const sourceTree =\n      source && sourceShort ? await readAiDraftNodes(firestore, { kind: 'layout', hostId, id: source.id }) : null\n    const sourceLines =\n      source && sourceShort ? aiCopySourceLines('layout', source.name, sourceTree?.nodes ?? null) : []\n    if (creation?.duplicateOf && source && !sourceShort) {\n      const copy = await duplicate('layout', {\n        orgId: job.orgId,\n        hostId,\n        sourceId: creation.duplicateOf,\n        name,\n        uid: job.createdBy,\n        org: org as Record<string, unknown> | null,\n        // The same claim the page step makes (AGL-3024): a copy core mints is\n        // written under core's own id, never `draftId`, so a step that runs\n        // again — a pass resumed, a run cut off after the copy — would mint a\n        // second. The job's recorded id makes core replay the one it made.\n        attemptKey: draftId,\n      })\n      if (copy.ok) {\n        // A copy is not a build (AGL-3024). This branch generates nothing, so\n        // whatever the plan promised BEYOND the source is not in the draft\n        // unless the source already had it: a plan reading \"from a copy of the\n        // base layout, adding a sidebar\" gets the base layout, the sidebar\n        // nowhere in it, and until now reported Done. The copy's own regions\n        // answer the plan's, and a copy that cannot be read answers nothing —\n        // which is a stop for a person, never a Done.\n        const review = await aiCopiedLayoutReview(firestore, { hostId, id: copy.id, plan, name })\n        if (review) return aiUnspentOutcome(model, { review })\n        const hostSubdomain = await aiSiteSubdomain(firestore, hostId)\n        return aiUnspentOutcome(model, {\n          outputs: [output({ id: copy.id, versionId: copy.versionId, name: copy.name, hostSubdomain })],\n        })\n      }\n      if (copy.ok === false && copy.status === 403) {\n        return aiUnspentOutcome(model, { review: aiLimitReview(copy.error) })\n      }\n    }\n\n    const allowance = await aiDraftAllowanceRefusal(firestore, { kind: 'layout', hostId, org })\n    if (allowance) return aiUnspentOutcome(model, { review: aiLimitReview(allowance) })\n\n    // The pages a site scaffold builds after this layout (AGL-3596): their\n    // ids are the plan's, so the header links them by id, written by the\n    // platform before the doctrine checks the tree.\n    const sitePages = aiLayoutSitePages(job.inputs)\n    const result = await runValidatedGeneration('layout', {\n      step: 'job.layout',\n      model,\n      instructions: AI_JOB_LAYOUT_INSTRUCTIONS,\n      inventory,\n      messages: [{ role: 'user', content: aiJobLayoutPrompt(job, plan, name, sourceLines) }],\n      tool: aiDoctrineTreeTool('layout'),\n      maxTokens: AI_JOB_LAYOUT_STEP_BUDGET.maxTokens(model),\n      ...(AI_ROUTING_TABLE['job.layout'].thinking ? { thinking: AI_ROUTING_TABLE['job.layout'].thinking } : {}),\n      ...(AI_ROUTING_TABLE['job.layout'].effort ? { effort: AI_ROUTING_TABLE['job.layout'].effort } : {}),\n      extend: aiLayoutReuseCheck(inventory, plan),\n      ...(sitePages.length\n        ? {\n            context: { screenIds: [...inventory.screens.map((screen) => screen.id), ...sitePages.map((page) => page.id)] },\n            complete: (tree: unknown) =>\n              aiLayoutWithSitePages(tree, sitePages, { homeScreenIds: aiHomeScreenIds(inventory) }),\n          }\n        : {}),\n      ...(signal ? { signal } : {}),\n    })\n    const spent = aiGenerationSpent(result)\n    if (result.status === 'refused') return { ...spent, refused: true }\n    if (result.status === 'needs_input') return { ...spent, review: aiDoctrineReview(result) }\n\n    const draft = await writeAiDraft(firestore, {\n      kind: 'layout',\n      hostId,\n      id: draftId,\n      uid: job.createdBy,\n      org,\n      name,\n      nodes: result.value.nodes,\n      aiJobId: aiOriginJobId(job),\n      now,\n    })\n    if (draft.ok === false) {\n      if (draft.status === 404) throw new Error(`site ${hostId} vanished while its layout was generated`)\n      return { ...spent, review: aiLimitReview(draft.error) }\n    }\n    // The facts the brief did not give, which the member fills before publishing (AGL-3056).\n    const note = aiBracketedFactsNote({\n      tree: { rootId: result.value.rootId, nodes: result.value.nodes as unknown as AiDoctrineTree['nodes'] },\n      inventory,\n    })\n    return { ...spent, outputs: [output(draft, result.value.load, note)] }\n  }\n}\n\n/** The layout step, building the components and forms its plan creates before the layout (AGL-3143 §15). */\nexport const runAiJobLayoutStep = aiBuildingPlanCreations('layout', 'job.layout', createAiJobLayoutStep())\n\n/** Registers the layout step and the check a layout job passes before it is created or resumed. */\nexport function registerAiLayoutJob(): void {\n  registerAiJobStep('layout', runAiJobLayoutStep, {\n    minimumMs: AI_JOB_LAYOUT_STEP_MINIMUM_MS,\n    minimumMsFor: aiPlanCreationsRunMinimumMs('layout'),\n  })\n  registerAiJobAdmission('layout', aiLayoutJobAdmission)\n}\n"],"names":["CANVAS_ROOT_ELEMENT_ID","duplicateResource","aiHomeScreenIds","AI_STEP_TIERS","AI_ROUTING_TABLE","aiModelForStep","aiDoctrineTreeTool","runValidatedGeneration","walkTree","readSiteInventory","registerAiJobAdmission","aiBuildingPlanCreations","aiJobPlanCreationsRefusal","aiPlanCreationsRunMinimumMs","aiJobDraftId","aiOriginJobId","aiDraftAdmissionRefusal","aiDraftAllowanceRefusal","aiSiteSubdomain","readAiDraft","readAiDraftNodes","writeAiDraft","aiBracketedFactsNote","aiCopySourceLines","aiConfirmedPlan","aiDoctrineReview","aiGenerationSpent","aiJobBriefLine","aiLimitReview","aiModelNodeIds","aiPlacedComponentIds","aiPlanCreation","aiPlanReferenceLines","aiPlanReuseViolations","aiUnspentOutcome","aiPlanRegionViolations","aiPlannedLayoutRegions","aiLayoutSitePages","aiLayoutSitePagesLines","aiLayoutWithSitePages","aiJobStepBudget","registerAiJobStep","AI_JOB_LAYOUT_MAX_TOKENS","maxTokens","AI_JOB_LAYOUT_STEP_BUDGET","tier","AI_JOB_LAYOUT_STEP_MINIMUM_MS","minimumMs","AI_JOB_LAYOUT_DEFAULT_NAME","AI_JOB_LAYOUT_INSTRUCTIONS","text","join","aiJobLayoutPrompt","job","plan","name","source","inputs","NAVIGATION_NAME","FOOTER_NAME","isLink","node","componentId","props","aiLayoutReuseCheck","inventory","components","navigation","filter","component","test","tree","placed","violations","rootId","nodes","length","some","has","id","visits","slot","findIndex","header","slice","links","map","push","rule","code","message","nodeIds","sourceIds","aiCopiedLayoutReview","firestore","input","planned","regions","unreadable","stored","kind","hostId","reason","findings","aiLayoutJobAdmission","context","orgId","org","ownCheck","createAiJobLayoutStep","deps","readInventory","duplicate","now","signal","modelFor","orgSnapshot","Error","output","draft","load","note","resource","versionId","hostSubdomain","label","model","draftId","written","outputs","Promise","all","collection","doc","get","data","creation","duplicateOf","layouts","find","layout","undefined","sourceReview","sourceShort","Boolean","sourceTree","sourceLines","copy","sourceId","uid","createdBy","attemptKey","ok","review","status","error","allowance","sitePages","result","step","instructions","messages","role","content","tool","thinking","effort","extend","screenIds","screens","screen","page","complete","homeScreenIds","spent","refused","value","aiJobId","runAiJobLayoutStep","registerAiLayoutJob","minimumMsFor"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-layout-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 { CANVAS_ROOT_ELEMENT_ID } from '@aglyn/aglyn/foundation/constants/canvas'\nimport type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport { duplicateResource } from '@aglyn/tenant-data-admin/server/duplicate-resource'\nimport type { AiJob, AiJobOutput, AiJobPlan, AiJobReview } from '../model/ai-jobs.types'\nimport { aiHomeScreenIds, type AiSiteInventory } from '../model/ai-site-inventory'\nimport { AI_STEP_TIERS } from '../providers/catalog'\nimport { AI_ROUTING_TABLE, aiModelForStep } from '../providers/routing'\nimport {\n  aiDoctrineTreeTool,\n  runValidatedGeneration,\n  type AiValidatedTree,\n} from '../runtime/ai-doctrine'\nimport {\n  walkTree,\n  type AiDoctrineNode,\n  type AiDoctrineTree,\n  type AiDoctrineViolation,\n} from '../runtime/ai-doctrine-validators'\nimport type { AiLoadEstimate } from '../runtime/ai-palette'\nimport type { AiSystemBlock } from '../runtime/ai-runtime'\nimport { readSiteInventory } from '../runtime/site-inventory'\nimport { registerAiJobAdmission, type AiJobAdmission } from './ai-job-admission'\nimport {\n  aiBuildingPlanCreations,\n  aiJobPlanCreationsRefusal,\n  aiPlanCreationsRunMinimumMs,\n} from './ai-job-plan-creations'\nimport { aiJobDraftId, aiOriginJobId } from './ai-job-draft-ids'\nimport {\n  aiDraftAdmissionRefusal,\n  aiDraftAllowanceRefusal,\n  aiSiteSubdomain,\n  readAiDraft,\n  readAiDraftNodes,\n  writeAiDraft,\n  type AiDraftRecord,\n} from './ai-job-drafts'\nimport {\n  aiBracketedFactsNote,\n  aiCopySourceLines,\n  aiConfirmedPlan,\n  aiDoctrineReview,\n  aiGenerationSpent,\n  aiJobBriefLine,\n  aiLimitReview,\n  aiModelNodeIds,\n  aiPlacedComponentIds,\n  aiPlanCreation,\n  aiPlanReferenceLines,\n  aiPlanReuseViolations,\n  aiUnspentOutcome,\n} from './ai-job-generation'\nimport { aiPlanRegionViolations, aiPlannedLayoutRegions } from './ai-job-plan-conformance'\nimport { aiLayoutSitePages, aiLayoutSitePagesLines, aiLayoutWithSitePages } from './ai-job-layout-site-pages'\nimport { aiLayoutInventedContactViolations, aiLayoutWithSiteName } from './ai-layout-site-facts'\nimport { aiLayoutWithFullHeight } from './ai-layout-full-height'\nimport type { AiJobStepRunner } from './ai-job-text-step'\nimport { AI_LAYOUT_FRAME_TOOL } from '../layout-language/ai-layout-language'\nimport {\n  AI_JOB_LAYOUT_LANGUAGE_BUDGET,\n  AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS,\n  AI_LAYOUT_FRAME_KIND,\n  aiLayoutFrameCheck,\n  aiLayoutFramePrompt,\n  aiLayoutFrameTargets,\n  aiLayoutHomeId,\n  aiLayoutNavPages,\n  aiLayoutSiteName,\n  type AiLayoutFrameBuilt,\n} from './ai-job-layout-language'\nimport { aiJobUsesLayoutLanguage } from './ai-job-page-language'\nimport { aiJobStepBudget } from './ai-job-budget'\nimport { registerAiJobStep } from './ai-jobs'\n\n/**\n * The layout step (AGL-2909): the generation step of a `layout` job, run once\n * a member confirmed the job's plan.\n *\n * It builds ONE shared layout — a header with the site's navigation, the\n * Layout Slot each page renders in, a footer — through\n * `runValidatedGeneration('layout', …)`, so every building rule holds on the\n * tree before it is kept, and adds three checks of its own through `extend`: a\n * component the confirmed plan reuses is placed (rule 7), every region the\n * plan gives the layout is built (AGL-3024), and a navigation or menu\n * component the site already has is placed rather than drawn again (rule 1).\n *\n * The layout lands as a new draft (`ai-job-drafts.ts`): no screen uses it and\n * no layout nests it, so nothing on the live site changes until a member\n * assigns it. A plan that starts from a copy of a layout the site has gets\n * that copy, through the platform's duplicate module, and nothing generated —\n * so the copy is read back and held to the plan's regions the same way\n * (`aiCopiedLayoutReview`), because a branch that generates nothing is the one\n * branch where a promise can go unmet with no model to answer for it. A\n * source that already lacks a region the plan gives the layout is not copied\n * at all: the layout is built from it (AGL-3143 §14).\n *\n * A generation step runs on the job beat, never at an inline door: it\n * registers the least time its lookup rounds, its answer and its re-ask need\n * (AGL-3035), runs without extended thinking — the plan was reasoned out and\n * confirmed before it — and asks for no more of a tighter ceiling than the\n * doctrine's default for a layout than fits that time on the model it runs.\n */\n\n/** The longest answer a layout may run to; the tree is held to the layout budget either way. */\nexport const AI_JOB_LAYOUT_MAX_TOKENS = AI_ROUTING_TABLE['job.layout'].maxTokens\n\n/**\n * The layout step's time (AGL-3035, AGL-3036): its two inventory-lookup\n * rounds, its answer and its re-ask at the routing table's ceiling on the tier\n * `job.layout` is served from, fitted to what a beat can give a step.\n */\nexport const AI_JOB_LAYOUT_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.layout'],\n  maxTokens: AI_JOB_LAYOUT_MAX_TOKENS,\n})\n\n/** The least time one layout step needs before it starts. */\nexport const AI_JOB_LAYOUT_STEP_MINIMUM_MS = AI_JOB_LAYOUT_STEP_BUDGET.minimumMs\n\n/** A layout's name when the plan names none. */\nexport const AI_JOB_LAYOUT_DEFAULT_NAME = 'Site layout'\n\n/** The layout step's own instructions, cached after the doctrine. */\nexport const AI_JOB_LAYOUT_INSTRUCTIONS: readonly AiSystemBlock[] = [\n  {\n    text: [\n      'You build one shared layout for a website: the frame every page of the site renders inside. Answer with submit_layout: the whole layout as one flat node map.',\n      'A layout is a header, one Layout Slot and a footer, top to bottom. The header is an App Bar (muiAppBar) holding a Toolbar Content (muiToolbar) with the site’s name as text and its navigation. The footer is a Section (section) whose element is footer.',\n      'Navigation links the site’s own pages by id: a Page Link (muiScreenLink) whose screenId is a page id from the site inventory, in the order the brief and the confirmed plan give, seven at most in the header. Never invent a page id, and never link a page by its address.',\n      'When the site inventory lists a component whose name says it is navigation, a menu or a mega menu, place it in the header as an instance instead of building the navigation again. Place every component the confirmed plan reuses.',\n      'The Layout Slot (layoutSlot) is where each page renders and is the page’s main landmark: leave its component unset or main, and put nothing inside it. A layout carries no h1, because every page brings its own.',\n    ].join('\\n'),\n  },\n]\n\n/**\n * The layout job as the generation's user turn: the name, the brief, the\n * confirmed plan, and the layout a short copy would have started from\n * (`aiCopySourceLines`, AGL-3143 §14).\n */\nexport function aiJobLayoutPrompt(\n  job: Pick<AiJob, 'brief'> & Partial<Pick<AiJob, 'inputs'>>,\n  plan: AiJobPlan | null,\n  name: string,\n  source: readonly string[] = [],\n): string {\n  return [\n    `Layout name: ${name}`,\n    aiJobBriefLine(job),\n    ...aiPlanReferenceLines(plan),\n    // A scaffold's layout is built before its pages, whose navigation the platform writes (AGL-3596).\n    ...aiLayoutSitePagesLines(aiLayoutSitePages(job.inputs)),\n    ...source,\n  ].join('\\n')\n}\n\n/** A component name that says it is the site's navigation; a footer's links are not. */\nconst NAVIGATION_NAME = /\\b(?:nav|navigation|navbar|menu|mega ?menu)\\b/i\nconst FOOTER_NAME = /\\bfooter\\b/i\n\n/** A node that links somewhere: a Screen Link, or a Button pointed at a screen or an address. */\nfunction isLink(node: AiDoctrineNode): boolean {\n  if (node.componentId === 'muiScreenLink') return true\n  return (\n    node.componentId === 'muiButton' &&\n    (typeof node.props?.['screenId'] === 'string' || typeof node.props?.['href'] === 'string')\n  )\n}\n\n/**\n * The layout door's checks on a tree the doctrine admitted: every component\n * the confirmed plan reuses is placed, every region the confirmed plan gives\n * the layout is built (AGL-3024), and navigation the site already keeps as a\n * component is placed rather than drawn again in the header.\n */\nexport function aiLayoutReuseCheck(\n  inventory: AiSiteInventory | null,\n  plan: AiJobPlan | null,\n): (tree: AiValidatedTree) => AiDoctrineViolation[] {\n  const components = inventory?.components ?? []\n  const navigation = components.filter(\n    (component) => NAVIGATION_NAME.test(component.name) && !FOOTER_NAME.test(component.name),\n  )\n  return (tree) => {\n    const placed = aiPlacedComponentIds(tree)\n    const violations: AiDoctrineViolation[] = [\n      ...aiPlanReuseViolations(inventory, plan, placed, 'layout'),\n      ...aiPlanRegionViolations(plan, {\n        rootId: tree.rootId,\n        nodes: tree.nodes as unknown as Record<string, AiDoctrineNode>,\n      }),\n    ]\n    if (navigation.length && !navigation.some((component) => placed.has(component.id))) {\n      const visits = walkTree({\n        rootId: tree.rootId,\n        nodes: tree.nodes as unknown as Record<string, AiDoctrineNode>,\n      })\n      const slot = visits.findIndex(({ node }) => node.componentId === 'layoutSlot')\n      const header = slot === -1 ? visits : visits.slice(0, slot)\n      const links = header.filter(({ node }) => isLink(node)).map(({ id }) => id)\n      if (links.length >= 2) {\n        violations.push({\n          rule: 1,\n          code: 'navigation-rebuilt',\n          message: `The site already has the \"${navigation[0].name}\" component. Place it in the header instead of building the navigation again.`,\n          nodeIds: aiModelNodeIds(links, tree.sourceIds),\n        })\n      }\n    }\n    return violations\n  }\n}\n\n/**\n * Every check the layout door adds to the doctrine's: the reuse and region\n * checks above, and no contact detail the brief does not give (AGL-3596).\n */\nexport function aiLayoutChecks(\n  inventory: AiSiteInventory | null,\n  plan: AiJobPlan | null,\n  brief: string,\n): (tree: AiValidatedTree) => AiDoctrineViolation[] {\n  const reuse = aiLayoutReuseCheck(inventory, plan)\n  return (tree) => [\n    ...reuse(tree),\n    ...aiLayoutInventedContactViolations(\n      { rootId: tree.rootId, nodes: tree.nodes as unknown as Record<string, AiDoctrineNode> },\n      brief,\n    ).map((violation) => ({ ...violation, nodeIds: aiModelNodeIds(violation.nodeIds ?? [], tree.sourceIds) })),\n  ]\n}\n\n/**\n * The regions the confirmed plan gives the layout, against the layout a COPY\n * actually produced (AGL-3024); `null` when the copy keeps the plan, or when\n * the plan promised no region to keep.\n *\n * The duplicate branch generates nothing, so it is the one place a plan's\n * promise can go unmet without a model ever answering for it. A copy that\n * cannot be read — deleted between the write and this read, or stored under a\n * root this check does not know — settles nothing, and a promise this step\n * cannot settle is reviewed by a person rather than reported as kept.\n */\nexport async function aiCopiedLayoutReview(\n  firestore: FirebaseFirestore.Firestore,\n  input: { hostId: string; id: string; name: string; plan: AiJobPlan | null },\n): Promise<AiJobReview | null> {\n  const planned = aiPlannedLayoutRegions(input.plan)\n  if (!planned.regions.length && !planned.unreadable.length) return null\n  const stored = await readAiDraftNodes(firestore, {\n    kind: 'layout',\n    hostId: input.hostId,\n    id: input.id,\n  })\n  const nodes = (stored?.nodes ?? {}) as unknown as Record<string, AiDoctrineNode>\n  if (!nodes[CANVAS_ROOT_ELEMENT_ID]) {\n    return {\n      reason: 'doctrine',\n      message: `\"${input.name}\" was copied from the layout the plan names, and this job could not read the copy back to check it has the regions the plan gives it. Open the layout and check it before you put a page in it.`,\n      findings: [],\n    }\n  }\n  const violations = aiPlanRegionViolations(input.plan, { rootId: CANVAS_ROOT_ELEMENT_ID, nodes })\n  if (!violations.length) return null\n  return aiDoctrineReview({\n    message: `\"${input.name}\" is a copy of the layout the plan names, and a copy is all it is: ${violations[0].message}`,\n    violations,\n  })\n}\n\n/**\n * A layout job is admitted for a site of the job's own org with a shared\n * layout to spare, and confirmed only for a plan whose other creations it\n * builds (AGL-3143 §15).\n */\nexport const aiLayoutJobAdmission: AiJobAdmission = (context) =>\n  aiDraftAdmissionRefusal(context.firestore, {\n    orgId: context.orgId,\n    hostId: context.hostId,\n    kind: 'layout',\n    org: context.org,\n    ownCheck: (hostId) => aiJobPlanCreationsRefusal('layout', context, hostId),\n  })\n\nexport interface AiJobLayoutStepDeps {\n  /** The inventory reader; specs hand in a fake. */\n  readInventory?: typeof readSiteInventory\n  /** The platform's duplicate module, for a plan that starts from a copy. */\n  duplicate?: typeof duplicateResource\n}\n\nexport function createAiJobLayoutStep(deps: AiJobLayoutStepDeps = {}): AiJobStepRunner {\n  const readInventory = deps.readInventory ?? readSiteInventory\n  const duplicate = deps.duplicate ?? duplicateResource\n  return async ({ job, now, signal, firestore, modelFor }) => {\n    const hostId = job.hostId\n    if (!hostId) throw new Error('a layout job names no site, and its admission refuses one')\n    const output = (draft: AiDraftRecord, load?: AiLoadEstimate | null, note?: string | null): AiJobOutput => ({\n      resource: 'layout',\n      id: draft.id,\n      versionId: draft.versionId,\n      hostId,\n      hostSubdomain: draft.hostSubdomain,\n      label: draft.name,\n      ...(load ? { load } : {}),\n      ...(note ? { note } : {}),\n    })\n    // The switch's answer for this job, else the routing table's (AGL-2942).\n    const model = modelFor?.('job.layout') ?? aiModelForStep('job.layout')\n\n    // A run cut off after its draft was written reports that draft, found by the id the job recorded.\n    const draftId = aiJobDraftId(job, 'layout')\n    const written = await readAiDraft(firestore, { kind: 'layout', hostId, id: draftId })\n    if (written) return aiUnspentOutcome(model, { outputs: [output(written)] })\n\n    const [inventory, orgSnapshot] = await Promise.all([\n      readInventory(job.orgId, hostId, { firestore }),\n      firestore.collection('orgs').doc(job.orgId).get(),\n    ])\n    const org = (orgSnapshot.data() ?? null) as Partial<AglynOrgBilling> | null\n    const plan = aiConfirmedPlan(job)\n    const creation = aiPlanCreation(plan, 'layout')\n    const name = creation?.name || AI_JOB_LAYOUT_DEFAULT_NAME\n\n    // The plan starts from a copy of a layout the site has (rule 15): the copy\n    // is the draft, and nothing is generated. A source gone since the plan\n    // was made is built from the brief instead. A source that cannot keep the\n    // plan's regions is built FROM instead (AGL-3143 §14), as the page step\n    // builds from a short source: copying it could only end in the review\n    // below, and Try again would copy the same thing. Only a source read and\n    // found short diverts; one this step cannot read still copies, and the\n    // review after the copy answers for it.\n    const source = creation?.duplicateOf\n      ? inventory.layouts.find((layout) => layout.id === creation.duplicateOf)\n      : undefined\n    const sourceReview = source\n      ? await aiCopiedLayoutReview(firestore, { hostId, id: source.id, plan, name: source.name })\n      : null\n    const sourceShort = Boolean(sourceReview?.findings.length)\n    const sourceTree =\n      source && sourceShort ? await readAiDraftNodes(firestore, { kind: 'layout', hostId, id: source.id }) : null\n    const sourceLines =\n      source && sourceShort ? aiCopySourceLines('layout', source.name, sourceTree?.nodes ?? null) : []\n    if (creation?.duplicateOf && source && !sourceShort) {\n      const copy = await duplicate('layout', {\n        orgId: job.orgId,\n        hostId,\n        sourceId: creation.duplicateOf,\n        name,\n        uid: job.createdBy,\n        org: org as Record<string, unknown> | null,\n        // The same claim the page step makes (AGL-3024): a copy core mints is\n        // written under core's own id, never `draftId`, so a step that runs\n        // again — a pass resumed, a run cut off after the copy — would mint a\n        // second. The job's recorded id makes core replay the one it made.\n        attemptKey: draftId,\n      })\n      if (copy.ok) {\n        // A copy is not a build (AGL-3024). This branch generates nothing, so\n        // whatever the plan promised BEYOND the source is not in the draft\n        // unless the source already had it: a plan reading \"from a copy of the\n        // base layout, adding a sidebar\" gets the base layout, the sidebar\n        // nowhere in it, and until now reported Done. The copy's own regions\n        // answer the plan's, and a copy that cannot be read answers nothing —\n        // which is a stop for a person, never a Done.\n        const review = await aiCopiedLayoutReview(firestore, { hostId, id: copy.id, plan, name })\n        if (review) return aiUnspentOutcome(model, { review })\n        const hostSubdomain = await aiSiteSubdomain(firestore, hostId)\n        return aiUnspentOutcome(model, {\n          outputs: [output({ id: copy.id, versionId: copy.versionId, name: copy.name, hostSubdomain })],\n        })\n      }\n      if (copy.ok === false && copy.status === 403) {\n        return aiUnspentOutcome(model, { review: aiLimitReview(copy.error) })\n      }\n    }\n\n    const allowance = await aiDraftAllowanceRefusal(firestore, { kind: 'layout', hostId, org })\n    if (allowance) return aiUnspentOutcome(model, { review: aiLimitReview(allowance) })\n\n    if (aiJobUsesLayoutLanguage(job)) {\n      // ── The header and footer designed in the layout language (AGL-3660) ──\n      const siteName = aiLayoutSiteName(job)\n      const pages = aiLayoutNavPages(job, inventory)\n      const targets = aiLayoutFrameTargets(job, inventory)\n      const result = await runValidatedGeneration<AiLayoutFrameBuilt>(AI_LAYOUT_FRAME_KIND, {\n        step: 'job.layout',\n        model,\n        instructions: AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS,\n        inventory,\n        messages: [{ role: 'user', content: aiLayoutFramePrompt({ job, siteName, pages, targets }) }],\n        tool: AI_LAYOUT_FRAME_TOOL,\n        maxTokens: AI_JOB_LAYOUT_LANGUAGE_BUDGET.maxTokens(model),\n        thinking: 'off',\n        check: aiLayoutFrameCheck({\n          siteName,\n          homeId: aiLayoutHomeId(pages, inventory),\n          pages,\n          targets,\n          extend: aiLayoutChecks(inventory, plan, job.brief),\n        }),\n        ...(signal ? { signal } : {}),\n      })\n      const spent = aiGenerationSpent(result)\n      if (result.status === 'refused') return { ...spent, refused: true }\n      if (result.status === 'needs_input') return { ...spent, review: aiDoctrineReview(result) }\n      const draft = await writeAiDraft(firestore, {\n        kind: 'layout',\n        hostId,\n        id: draftId,\n        uid: job.createdBy,\n        org,\n        name,\n        nodes: result.value.nodes,\n        aiJobId: aiOriginJobId(job),\n        now,\n      })\n      if (draft.ok === false) {\n        if (draft.status === 404) throw new Error(`site ${hostId} vanished while its layout was generated`)\n        return { ...spent, review: aiLimitReview(draft.error) }\n      }\n      const note = aiBracketedFactsNote({\n        tree: { rootId: result.value.rootId, nodes: result.value.nodes as unknown as AiDoctrineTree['nodes'] },\n        inventory,\n      })\n      return { ...spent, outputs: [output(draft, result.value.load, note)] }\n    }\n\n    // The pages a site scaffold builds after this layout (AGL-3596): their\n    // ids are the plan's, so the header links them by id, written by the\n    // platform before the doctrine checks the tree.\n    const sitePages = aiLayoutSitePages(job.inputs)\n    const result = await runValidatedGeneration('layout', {\n      step: 'job.layout',\n      model,\n      instructions: AI_JOB_LAYOUT_INSTRUCTIONS,\n      inventory,\n      messages: [{ role: 'user', content: aiJobLayoutPrompt(job, plan, name, sourceLines) }],\n      tool: aiDoctrineTreeTool('layout'),\n      maxTokens: AI_JOB_LAYOUT_STEP_BUDGET.maxTokens(model),\n      ...(AI_ROUTING_TABLE['job.layout'].thinking ? { thinking: AI_ROUTING_TABLE['job.layout'].thinking } : {}),\n      ...(AI_ROUTING_TABLE['job.layout'].effort ? { effort: AI_ROUTING_TABLE['job.layout'].effort } : {}),\n      extend: aiLayoutChecks(inventory, plan, job.brief),\n      // The site's name is written as the token that reads it, and the\n      // layout fills the window so a short page keeps its footer at the\n      // bottom (AGL-3596).\n      complete: (tree: unknown) =>\n        aiLayoutWithFullHeight(\n          aiLayoutWithSiteName(\n            sitePages.length ? aiLayoutWithSitePages(tree, sitePages, { homeScreenIds: aiHomeScreenIds(inventory) }) : tree,\n            typeof job.inputs?.['businessName'] === 'string' ? job.inputs['businessName'] : null,\n          ),\n        ),\n      ...(sitePages.length\n        ? { context: { screenIds: [...inventory.screens.map((screen) => screen.id), ...sitePages.map((page) => page.id)] } }\n        : {}),\n      ...(signal ? { signal } : {}),\n    })\n    const spent = aiGenerationSpent(result)\n    if (result.status === 'refused') return { ...spent, refused: true }\n    if (result.status === 'needs_input') return { ...spent, review: aiDoctrineReview(result) }\n\n    const draft = await writeAiDraft(firestore, {\n      kind: 'layout',\n      hostId,\n      id: draftId,\n      uid: job.createdBy,\n      org,\n      name,\n      nodes: result.value.nodes,\n      aiJobId: aiOriginJobId(job),\n      now,\n    })\n    if (draft.ok === false) {\n      if (draft.status === 404) throw new Error(`site ${hostId} vanished while its layout was generated`)\n      return { ...spent, review: aiLimitReview(draft.error) }\n    }\n    // The facts the brief did not give, which the member fills before publishing (AGL-3056).\n    const note = aiBracketedFactsNote({\n      tree: { rootId: result.value.rootId, nodes: result.value.nodes as unknown as AiDoctrineTree['nodes'] },\n      inventory,\n    })\n    return { ...spent, outputs: [output(draft, result.value.load, note)] }\n  }\n}\n\n/** The layout step, building the components and forms its plan creates before the layout (AGL-3143 §15). */\nexport const runAiJobLayoutStep = aiBuildingPlanCreations('layout', 'job.layout', createAiJobLayoutStep())\n\n/** Registers the layout step and the check a layout job passes before it is created or resumed. */\nexport function registerAiLayoutJob(): void {\n  registerAiJobStep('layout', runAiJobLayoutStep, {\n    minimumMs: AI_JOB_LAYOUT_STEP_MINIMUM_MS,\n    minimumMsFor: aiPlanCreationsRunMinimumMs('layout'),\n  })\n  registerAiJobAdmission('layout', aiLayoutJobAdmission)\n}\n"],"names":["CANVAS_ROOT_ELEMENT_ID","duplicateResource","aiHomeScreenIds","AI_STEP_TIERS","AI_ROUTING_TABLE","aiModelForStep","aiDoctrineTreeTool","runValidatedGeneration","walkTree","readSiteInventory","registerAiJobAdmission","aiBuildingPlanCreations","aiJobPlanCreationsRefusal","aiPlanCreationsRunMinimumMs","aiJobDraftId","aiOriginJobId","aiDraftAdmissionRefusal","aiDraftAllowanceRefusal","aiSiteSubdomain","readAiDraft","readAiDraftNodes","writeAiDraft","aiBracketedFactsNote","aiCopySourceLines","aiConfirmedPlan","aiDoctrineReview","aiGenerationSpent","aiJobBriefLine","aiLimitReview","aiModelNodeIds","aiPlacedComponentIds","aiPlanCreation","aiPlanReferenceLines","aiPlanReuseViolations","aiUnspentOutcome","aiPlanRegionViolations","aiPlannedLayoutRegions","aiLayoutSitePages","aiLayoutSitePagesLines","aiLayoutWithSitePages","aiLayoutInventedContactViolations","aiLayoutWithSiteName","aiLayoutWithFullHeight","AI_LAYOUT_FRAME_TOOL","AI_JOB_LAYOUT_LANGUAGE_BUDGET","AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS","AI_LAYOUT_FRAME_KIND","aiLayoutFrameCheck","aiLayoutFramePrompt","aiLayoutFrameTargets","aiLayoutHomeId","aiLayoutNavPages","aiLayoutSiteName","aiJobUsesLayoutLanguage","aiJobStepBudget","registerAiJobStep","AI_JOB_LAYOUT_MAX_TOKENS","maxTokens","AI_JOB_LAYOUT_STEP_BUDGET","tier","AI_JOB_LAYOUT_STEP_MINIMUM_MS","minimumMs","AI_JOB_LAYOUT_DEFAULT_NAME","AI_JOB_LAYOUT_INSTRUCTIONS","text","join","aiJobLayoutPrompt","job","plan","name","source","inputs","NAVIGATION_NAME","FOOTER_NAME","isLink","node","componentId","props","aiLayoutReuseCheck","inventory","components","navigation","filter","component","test","tree","placed","violations","rootId","nodes","length","some","has","id","visits","slot","findIndex","header","slice","links","map","push","rule","code","message","nodeIds","sourceIds","aiLayoutChecks","brief","reuse","violation","aiCopiedLayoutReview","firestore","input","planned","regions","unreadable","stored","kind","hostId","reason","findings","aiLayoutJobAdmission","context","orgId","org","ownCheck","createAiJobLayoutStep","deps","readInventory","duplicate","now","signal","modelFor","orgSnapshot","Error","output","draft","load","note","resource","versionId","hostSubdomain","label","model","draftId","written","outputs","Promise","all","collection","doc","get","data","creation","duplicateOf","layouts","find","layout","undefined","sourceReview","sourceShort","Boolean","sourceTree","sourceLines","copy","sourceId","uid","createdBy","attemptKey","ok","review","status","error","allowance","siteName","pages","targets","result","step","instructions","messages","role","content","tool","thinking","check","homeId","extend","spent","refused","value","aiJobId","sitePages","effort","complete","homeScreenIds","screenIds","screens","screen","page","runAiJobLayoutStep","registerAiLayoutJob","minimumMsFor"],"mappings":"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"}

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

@@ -0,0 +1,107 @@
+/**
+ * @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 HostFunction } from '@aglyn/aglyn/app-utils/functions';
+import { type AiLogicContext, type AiLogicSiteVariable } from '../model/ai-logic-job';
+import { type AiCustomGenerationInput } from '../runtime/ai-doctrine';
+import type { AiSystemBlock } from '../runtime/ai-runtime';
+import { type AiWorkflowExplanation } from '../tools/ai-workflow-tool';
+import { type AiJobAdmission } from './ai-job-admission';
+import { type AiJobStepRunner } from './ai-job-text-step';
+import { readAiLogicFunction, readAiLogicRecords } from './ai-logic-records';
+/**
+ * The `logic` step (AGL-3603): a function or a variable proposed from a
+ * description, a saved function changed or fixed, or one explained.
+ *
+ * The model is shown the expression grammar the evaluator runs — operators,
+ * built-ins, how a dictionary's member is read — and, in the user turn, the
+ * site's variables by name, type and value, and its function names. A saved
+ * function is shown as an outline of its own definition. It answers through
+ * `submit_function`, `submit_variable` or `submit_explanation`; a function
+ * is held to the grammar, to the names it may read and to a first run before
+ * it is kept (`checkAiLogicFunction`), and a re-ask names what failed.
+ *
+ * Nothing is written. A proposal rides on a `logic` output, and the logic
+ * editor opens it for a person to save.
+ */
+/** The longest the step may take reading the site first. */
+export declare const AI_LOGIC_RECORDS_READ_MS = 2000;
+/** The step's time: its answer and its re-ask at the `job.logic` ceiling, with its own reads. */
+export declare const AI_JOB_LOGIC_STEP_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+export declare const AI_JOB_LOGIC_STEP_MINIMUM_MS: number;
+export declare function aiJobLogicModel(): string;
+/** How many site variables the user turn lists, and how much of each value. */
+export declare const AI_LOGIC_VARIABLES_LISTED = 60;
+export declare const AI_LOGIC_VALUE_LISTED_CHARS = 120;
+/**
+ * The instructions, byte-identical on every request so they cache: one block
+ * for a function, a variable and an explanation alike, because a block of
+ * either half alone is under the balanced tier's cacheable minimum, and the
+ * two halves together clear it on every tool.
+ */
+export declare const AI_JOB_LOGIC_INSTRUCTIONS: readonly AiSystemBlock[];
+/** A saved function as lines a model reads: its own definition, in the editor's terms. */
+export declare function aiLogicFunctionOutline(definition: HostFunction): string;
+/** What a function or a variable is asked from. */
+export declare function aiJobLogicPrompt(input: {
+    brief: string;
+    mode: 'function' | 'variable' | 'explain';
+    context: AiLogicContext;
+    saved: HostFunction | null;
+}): string;
+/** The function generation as the doctrine's loop runs it. */
+export declare function aiJobLogicFunctionGeneration(request: {
+    brief: string;
+    context: AiLogicContext;
+    saved: HostFunction | null;
+    model: string;
+    signal?: AbortSignal;
+}): AiCustomGenerationInput<HostFunction>;
+/** The variable generation. */
+export declare function aiJobLogicVariableGeneration(request: {
+    brief: string;
+    context: AiLogicContext;
+    model: string;
+    signal?: AbortSignal;
+}): AiCustomGenerationInput<AiLogicSiteVariable>;
+/** The explanation generation. */
+export declare function aiJobLogicExplainGeneration(request: {
+    brief: string;
+    context: AiLogicContext;
+    saved: HostFunction;
+    model: string;
+    signal?: AbortSignal;
+}): AiCustomGenerationInput<AiWorkflowExplanation>;
+export interface AiJobLogicStepDeps {
+    readRecords?: typeof readAiLogicRecords;
+    readFunction?: typeof readAiLogicFunction;
+}
+export declare function createAiJobLogicStep(deps?: AiJobLogicStepDeps): AiJobStepRunner;
+export declare const runAiJobLogicStep: AiJobStepRunner;
+/** The plugin that keeps Functions & Variables. */
+export declare const AI_LOGIC_PLUGIN_ID = "logic";
+export interface AiLogicJobAdmissionDeps {
+    readFunction?: typeof readAiLogicFunction;
+}
+/**
+ * A logic job is admitted for a site of its org with Logic on for it and past
+ * its release flag; a change or an explanation also needs the function it
+ * names to exist.
+ */
+export declare function createAiLogicJobAdmission(deps?: AiLogicJobAdmissionDeps): AiJobAdmission;
+export declare const aiLogicJobAdmission: AiJobAdmission;
+/** Registers the logic step and the check a logic job passes before it is created or resumed. */
+export declare function registerAiLogicJob(): void;