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

package/src/lib/model/ai-credit-estimate.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-credit-estimate.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * WHAT A JOB REALLY COSTS, NEXT TO WHAT IT CAN COST (AGL-3722).\n *\n * Every job's cost used to be quoted at its CEILING: each pass at the\n * `AI_SITE_PASS_CREDITS` (50) a pass is reserved against. A Free Assist\n * build of two pages, a quote form and a layout was quoted 600 credits and\n * refused with 164 left, when builds like it measure about a fifth of that.\n *\n * So a job is now quoted as a RANGE: what it is likely to cost (the sum of\n * the measured medians of what it builds), what it costs nine times in ten\n * (the measured p90s), and its ceiling (the old figure, unchanged). The\n * meter still charges actual use, and the reservation each pass takes is\n * still the ceiling's 50 — only the words and the Free admission move:\n * a Free job is admitted outright when its p90 fits what is left, and asked\n * to be confirmed when it does not.\n *\n * This module is pure: the console, the doors and the specs read one table.\n */\n\n/** One measured cost: the median and the 90th percentile, in credits. */\nexport interface AiMeasuredCredits {\n  median: number\n  p90: number\n}\n\n/**\n * MEASURED IN PRODUCTION, credits per unit, over every `done` AI job since\n * 2026-10-01 (read 2026-10-09; a whole Free site job came to 148–160):\n *\n *   page item   30 / 40   (a page of about `AI_MEASURED_PAGE_SECTIONS` sections, its listing included)\n *   form        29 / 31\n *   layout      23 / 24   (header and footer, one answer)\n *   theme        4 /  8   (a site start's look)\n *   plan step   21 / 70\n *\n * THE FAST TIER'S PART, REPRICED (AGL-3781). A site start's look, a Free\n * start's plan and every page's listing run on the fast tier, measured above\n * on Claude Haiku 4.5 at its cost. They run on Claude Haiku 5.5 at the\n * platform's markup now, so those parts are repriced from what production\n * sent, at the new rates and about 30% more tokens: over October 1–14 a look\n * 4 / 7 → 1 / 2, a Free start's plan 15 / 22 → 3 / 5, a listing 3 / 5 → 1 / 1\n * (2 less on every page), and a whole two-page Free site 148 → 121 at the\n * median. The other rows ran on the balanced tier and do not move.\n *\n * HOW TO RE-MEASURE: a read-only collection-group read of `aiJobs` in\n * production where `status == 'done'` and `createdAt` is in the window; group\n * each ledger row's (`items[]`) `creditsSpent` by its `op` (the site start's\n * look is the `theme` row), take the plan step's `steps[].creditsSpent` for\n * `plan`, and each job's `creditsSpent` for the whole-site band. Put each\n * group's median and 90th percentile here, and the dates in\n * `AI_MEASURED_AT`. `ai-credit-estimate.spec.ts` holds the table, the page\n * scaling and the measured whole-site band together, so a re-measure that\n * moves one moves the spec with it.\n */\nexport const AI_MEASURED_UNIT_CREDITS = {\n  // 30 / 40 with its listing at Haiku 4.5's cost.\n  page: { median: 28, p90: 38 },\n  form: { median: 29, p90: 31 },\n  layout: { median: 23, p90: 24 },\n  // 4 / 8 on Haiku 4.5.\n  theme: { median: 1, p90: 2 },\n  // 21 / 70: the median is a Free start's plan, on the fast tier; the p90 a\n  // plan on the balanced tier, which does not move.\n  plan: { median: 4, p90: 70 },\n} as const satisfies Record<string, AiMeasuredCredits>\n\n/**\n * MEASURED IN PRODUCTION, credits per unit of a PAID site start, whose plan\n * and parts run on the paid routing (Sonnet) rather than a Free start's\n * (Haiku) the table above is mostly made of: every `done` paid site job\n * since 2026-10-01, read 2026-10-12 (6 jobs; products from the 4 stores; AGL-3739).\n *\n *   plan step   81 / 86   (a Free start's plan: 20 / 42 on Haiku 4.5, 3 / 5 repriced)\n *   page item   29 / 49   (about `AI_MEASURED_PAGE_SECTIONS` sections; 27 / 47 with its listing repriced)\n *   form        32 / 39\n *   layout      29 / 29\n *   theme        4 /  4   (1 / 1 repriced)\n *   email       49 / 51\n *   products    64 / 66   (a store's first products, one answer)\n *\n * A 5-page store with its welcome email was quoted about 277 off the table\n * above: its plan at a Free start's 21 where paid plans run about 81, and its\n * first products not counted at all where they run about 64. Those stores\n * came to 413-448; this table quotes one at about 404.\n *\n * Re-measure as the table above says, keeping only jobs whose plan step's\n * `tokens.model` is the paid routing's.\n */\nexport const AI_MEASURED_PAID_SITE_CREDITS = {\n  plan: { median: 81, p90: 86 },\n  page: { median: 27, p90: 47 },\n  form: { median: 32, p90: 39 },\n  layout: { median: 29, p90: 29 },\n  theme: { median: 1, p90: 1 },\n  email: { median: 49, p90: 51 },\n  products: { median: 64, p90: 66 },\n} as const satisfies Record<string, AiMeasuredCredits>\n\n/**\n * A page brought in from a person's own website (AGL-3976), priced as an AI\n * page: a paid site start's page as measured above, since an imported page is\n * one answer in the layout language and its listing, written inside one job\n * the way a site start writes its pages. Its site's header and footer, built\n * once in an import's first wave, is that table's layout.\n *\n * Re-measure from done `import` jobs' item ledgers once production has run\n * them: their `page` rows' `creditsSpent`, as the paid table is read.\n */\nexport const AI_MEASURED_IMPORT_CREDITS = {\n  page: AI_MEASURED_PAID_SITE_CREDITS.page,\n  frame: AI_MEASURED_PAID_SITE_CREDITS.layout,\n  /**\n   * A main page Aglyn AI arranges from its old page's own lines (AGL-4083):\n   * one frame-sized structured answer, no prose, and its listing.\n   * PROVISIONAL until the first live import measures it; it prices nothing\n   * until the step marks a page `arranged`.\n   */\n  arranged: { median: 12, p90: 20 },\n  /** A page copied as it is (AGL-4083): its listing pass alone. Provisional, as `arranged`. */\n  copied: { median: 1, p90: 2 },\n} as const satisfies Record<string, AiMeasuredCredits>\n\n/**\n * When the table above was read, and from when its jobs ran. Both tables\n * were measured before AGL-3781 asked a paid site's plan at medium effort and\n * the layout language's pages and frames at low. A lower effort draws less,\n * so their plan, page and layout figures stand as the higher reading until\n * the next re-measure: a quote is never under what is drawn.\n */\nexport const AI_MEASURED_AT = { read: '2026-10-09', since: '2026-10-01' } as const\n\n/**\n * What a whole Free two-page site job measured at, in credits, in the same\n * window: 148–160 with its plan, look and listings at Haiku 4.5's cost, 27\n * less at the median with them repriced (AGL-3781).\n */\nexport const AI_MEASURED_FREE_SITE_CREDITS = { low: 121, high: 133 } as const\n\n/** The sections the measured page item is about: a page is scaled around it. */\nexport const AI_MEASURED_PAGE_SECTIONS = 5\n\n/**\n * What a page of this many sections is likely to cost: the measured page\n * scaled by its sections around the ~5-section median — about 6 credits a\n * section, 8 at the p90.\n */\nexport function aiMeasuredPageCredits(sections: number): AiMeasuredCredits {\n  const count = Math.max(1, Math.floor(Number.isFinite(sections) ? sections : AI_MEASURED_PAGE_SECTIONS))\n  const { median, p90 } = AI_MEASURED_UNIT_CREDITS.page\n  return {\n    median: Math.ceil((median * count) / AI_MEASURED_PAGE_SECTIONS),\n    p90: Math.ceil((p90 * count) / AI_MEASURED_PAGE_SECTIONS),\n  }\n}\n\n/**\n * What a page costs when it is written ON ITS OWN — a page an Assist build or\n * a page job writes, rather than one of a site start's pages (AGL-3722).\n *\n * The table's page item is a site start's: its pages are written one after\n * another inside one job, the later ones reading the prompt the first one\n * paid to write, so a 2-section second page measured 19–28. A page written on\n * its own pays that prompt itself and reads the site it lands on, and costs\n * what a site start's FIRST page costs: a 5-section home page measured 39–78\n * (median 40, p90 78), standalone page jobs' writing step 82–105 for a\n * 2-section page, and the Assist build pages of 2026-10-09 22–89 each. Quoting\n * a build's pages at the site start's scaled median told a Free workspace\n * \"about 48 credits\" for two 4-section pages (AGL-3722, 2026-10-10).\n *\n * So it is priced as a fixed cost — the prompt, the site, the listing — and a\n * cost per section: a 4-section page about 38 (p90 76), a 5-section 44 (p90 88).\n * The fixed part was 16 / 30 with its listing at Haiku 4.5's cost (AGL-3781).\n */\nexport const AI_MEASURED_STANDALONE_PAGE = {\n  fixed: { median: 14, p90: 28 },\n  perSection: { median: 6, p90: 12 },\n} as const satisfies Record<string, AiMeasuredCredits>\n\n/** What a page of this many sections written on its own is likely to cost. */\nexport function aiMeasuredStandalonePageCredits(sections: number): AiMeasuredCredits {\n  const count = Math.max(1, Math.floor(Number.isFinite(sections) ? sections : AI_MEASURED_PAGE_SECTIONS))\n  const { fixed, perSection } = AI_MEASURED_STANDALONE_PAGE\n  return {\n    median: fixed.median + perSection.median * count,\n    p90: fixed.p90 + perSection.p90 * count,\n  }\n}\n\n/**\n * What a creation costs when it is written ON ITS OWN (AGL-3722), where it\n * measured apart from a site start's: an Assist build's layout came to 24–28\n * (2026-10-09/10), against a site start's 23/24 written in its warm prompt.\n * A form measured the same either way (25–30 on its own, 29/31 in a site\n * start), so it keeps the table's figure.\n */\nexport const AI_MEASURED_STANDALONE_CREATION_CREDITS = {\n  layout: { median: 26, p90: 30 },\n} as const satisfies Record<string, AiMeasuredCredits>\n\n/**\n * What one pass of a kind with no measurement of its own is likely to cost\n * (a component, an email design, a template, an item another runner\n * builds), written on its own: a component job's writing step measured\n * 52–65, a form job's 37, a layout job's 63, and the Assist build of\n * 2026-10-09 a welcome email at 46 and a products step at 60. Until\n * 2026-10-10 this was a site start's form (29/31), which is written inside a\n * site job's warm prompt and is the cheapest single answer there is.\n */\nexport const AI_MEASURED_PASS_CREDITS: AiMeasuredCredits = { median: 50, p90: 65 }\n\n/** A job's cost as it is quoted: likely, nine times in ten, and at its worst. */\nexport interface AiCreditRange {\n  /** The sum of the measured medians: what the job is likely to spend. */\n  likely: number\n  /** The sum of the measured p90s: what a Free job is admitted on. */\n  p90: number\n  /** Every pass at its reserve: what it can spend at most. */\n  ceiling: number\n}\n\nexport const AI_CREDIT_RANGE_ZERO: AiCreditRange = { likely: 0, p90: 0, ceiling: 0 }\n\n/** Two ranges added. */\nexport function aiCreditRangeAdd(a: AiCreditRange, b: AiCreditRange): AiCreditRange {\n  return { likely: a.likely + b.likely, p90: a.p90 + b.p90, ceiling: a.ceiling + b.ceiling }\n}\n\n/** A measured cost as a range with its own ceiling, the likely and p90 never above it. */\nexport function aiCreditRangeOf(measured: AiMeasuredCredits, ceiling: number): AiCreditRange {\n  const top = Math.max(0, Math.ceil(ceiling))\n  return { likely: Math.min(measured.median, top), p90: Math.min(measured.p90, top), ceiling: top }\n}\n\n/** A range whose likely and p90 are each at least the last, and at most the ceiling. */\nexport function aiCreditRangeOrdered(range: AiCreditRange): AiCreditRange {\n  const ceiling = Math.max(0, Math.ceil(range.ceiling))\n  const likely = Math.min(Math.max(0, Math.ceil(range.likely)), ceiling)\n  const p90 = Math.min(Math.max(likely, Math.ceil(range.p90)), ceiling)\n  return { likely, p90, ceiling }\n}\n\nconst n = (value: number) => value.toLocaleString('en-US')\n\n/**\n * The range as every surface quotes it: \"About 106 credits (up to 650)\".\n * A job whose likely figure is its ceiling says one number.\n */\nexport function aiCreditRangeText(range: AiCreditRange): string {\n  if (range.likely >= range.ceiling) return `About ${n(range.ceiling)} credits`\n  return `About ${n(range.likely)} credits (up to ${n(range.ceiling)})`\n}\n\n/**\n * Whether a Free job of this range needs the person's go-ahead before it\n * starts (AGL-3722): its p90 is more than what is left. A job whose p90\n * fits starts with no prompt; one that does not starts only when confirmed,\n * builds as much as what is left pays for, and pauses with Resume.\n */\nexport function aiCreditsNeedConfirm(range: Pick<AiCreditRange, 'p90'>, left: number): boolean {\n  return Number.isFinite(left) && range.p90 > Math.max(0, Math.floor(left))\n}\n\n/** The smaller first build a Free job that does not fit is offered (AGL-3722). */\nexport interface AiCreditsSmaller {\n  /** \"Build the home page first\". */\n  label: string\n  likely: number\n  p90: number\n  ceiling: number\n}\n\n/**\n * What a Free job that does not fit what is left says before it starts, and\n * the choices it offers: build what fits, a smaller first build, or Upgrade.\n * The door that refuses an unconfirmed start answers with it (status 409,\n * `code: AI_CREDITS_CONFIRM_CODE`), and the plan card and the guided start\n * draw it from the same figures.\n */\nexport interface AiCreditsPrompt extends AiCreditRange {\n  left: number\n  resetsOn: string\n  smaller: AiCreditsSmaller | null\n}\n\n/** The `code` a door answers an unconfirmed Free start with. */\nexport const AI_CREDITS_CONFIRM_CODE = 'credits-confirm'\n\n/** \"Build what fits\": the go-ahead for a Free job past what is left. */\nexport const AI_CREDITS_BUILD_WHAT_FITS = 'Build what fits'\n\n/** The smaller first build's button: \"Build the home page first (about 64 credits)\". */\nexport function aiCreditsSmallerText(smaller: Pick<AiCreditsSmaller, 'label' | 'likely'>): string {\n  return `${smaller.label} (about ${n(smaller.likely)} credits)`\n}\n\n/** Which way on a prompt offers, in the order it offers them. */\nexport type AiCreditsChoiceKey = 'fits' | 'smaller' | 'upgrade'\n\n/** One way on, as its option button reads it: a short label and the figure under it (AGL-3722). */\nexport interface AiCreditsChoice {\n  key: AiCreditsChoiceKey\n  label: string\n  detail: string\n  /** The one choice drawn as the primary button. */\n  recommended: boolean\n}\n\nconst credit = (count: number) => `${n(count)} ${count === 1 ? 'credit' : 'credits'}`\n\n/**\n * The prompt's ways on, as its three option buttons read them (Zach,\n * 2026-10-10: \"more appealing and consistent\"): build what fits, the smaller\n * first build when there is one, and Upgrade when it can be offered — each a\n * short sentence-case label with its figure under it. The smaller build is\n * the recommended one when its p90 fits what is left, since it then finishes;\n * otherwise building what fits is.\n */\nexport function aiCreditsChoices(\n  prompt: Pick<AiCreditsPrompt, 'left' | 'smaller'>,\n  offers: { smaller: boolean; upgrade: boolean },\n): AiCreditsChoice[] {\n  const left = Math.max(0, Math.floor(prompt.left))\n  const smaller = offers.smaller ? prompt.smaller : null\n  const smallerFits = smaller !== null && smaller.p90 <= left\n  const choices: AiCreditsChoice[] = [\n    {\n      key: 'fits',\n      label: AI_CREDITS_BUILD_WHAT_FITS,\n      detail: `Uses your ${credit(left)} left, then pauses`,\n      recommended: !smallerFits,\n    },\n  ]\n  if (smaller) {\n    choices.push({\n      key: 'smaller',\n      label: smaller.label,\n      detail: smallerFits ? `About ${credit(smaller.likely)}, fits what you have left` : `About ${credit(smaller.likely)}`,\n      recommended: smallerFits,\n    })\n  }\n  if (offers.upgrade) choices.push({ key: 'upgrade', label: 'Upgrade', detail: 'Get more credits', recommended: false })\n  return choices\n}\n\n/** A reset day as a person reads it: \"November 1\". */\nfunction resetLabel(resetsOn: string): string {\n  const at = new Date(`${resetsOn}T00:00:00.000Z`)\n  return Number.isFinite(at.getTime())\n    ? at.toLocaleDateString('en-US', { month: 'long', day: 'numeric', timeZone: 'UTC' })\n    : 'the first of next month'\n}\n\n/**\n * The plain sentence (Zach, 2026-10-09): \"This build is about N credits (up\n * to M). You have L left, so it will build as much as it can and pause when\n * your credits run out. You can upgrade or resume when they renew.\"\n */\nexport function aiCreditsPromptText(prompt: AiCreditsPrompt, noun: 'build' | 'site' = 'build'): string {\n  const size =\n    prompt.likely >= prompt.ceiling\n      ? `about ${n(prompt.ceiling)} credits`\n      : `about ${n(prompt.likely)} credits (up to ${n(prompt.ceiling)})`\n  const left = Math.max(0, Math.floor(prompt.left))\n  return (\n    `This ${noun} is ${size}. You have ${n(left)} left, so it will build as much as it can and pause ` +\n    `when your credits run out. You can upgrade or resume when they renew on ${resetLabel(prompt.resetsOn)}.`\n  )\n}\n\n/**\n * The record a confirmed Free start keeps (AGL-3722): who said go, when,\n * what was left then and the range they were shown.\n */\nexport interface AiJobCreditsConfirmation extends AiCreditRange {\n  by: string\n  at: Date | string\n  left: number\n}\n\n/** The confirmation a door keeps on the job for the prompt the person confirmed, or `null` when there was none. */\nexport function aiCreditsConfirmation(\n  prompt: AiCreditsPrompt | null,\n  by: string,\n  at: Date,\n): AiJobCreditsConfirmation | null {\n  if (!prompt) return null\n  return { by, at, left: prompt.left, likely: prompt.likely, p90: prompt.p90, ceiling: prompt.ceiling }\n}\n\n/** The prompt a range needs against what is left, or `null` when it fits. */\nexport function aiCreditsPromptFor(\n  range: AiCreditRange,\n  credits: { left: number; resetsOn: string } | null | undefined,\n  smaller: AiCreditsSmaller | null = null,\n): AiCreditsPrompt | null {\n  if (!credits || !aiCreditsNeedConfirm(range, credits.left)) return null\n  return { ...range, left: Math.max(0, Math.floor(credits.left)), resetsOn: credits.resetsOn, smaller }\n}\n"],"names":["AI_MEASURED_UNIT_CREDITS","page","median","p90","form","layout","theme","plan","AI_MEASURED_PAID_SITE_CREDITS","email","products","AI_MEASURED_IMPORT_CREDITS","frame","arranged","copied","AI_MEASURED_AT","read","since","AI_MEASURED_FREE_SITE_CREDITS","low","high","AI_MEASURED_PAGE_SECTIONS","aiMeasuredPageCredits","sections","count","Math","max","floor","Number","isFinite","ceil","AI_MEASURED_STANDALONE_PAGE","fixed","perSection","aiMeasuredStandalonePageCredits","AI_MEASURED_STANDALONE_CREATION_CREDITS","AI_MEASURED_PASS_CREDITS","AI_CREDIT_RANGE_ZERO","likely","ceiling","aiCreditRangeAdd","a","b","aiCreditRangeOf","measured","top","min","aiCreditRangeOrdered","range","n","value","toLocaleString","aiCreditRangeText","aiCreditsNeedConfirm","left","AI_CREDITS_CONFIRM_CODE","AI_CREDITS_BUILD_WHAT_FITS","aiCreditsSmallerText","smaller","label","credit","aiCreditsChoices","prompt","offers","smallerFits","choices","key","detail","recommended","push","upgrade","resetLabel","resetsOn","at","Date","getTime","toLocaleDateString","month","day","timeZone","aiCreditsPromptText","noun","size","aiCreditsConfirmation","by","aiCreditsPromptFor","credits"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-credit-estimate.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * WHAT A JOB REALLY COSTS, NEXT TO WHAT IT CAN COST (AGL-3722).\n *\n * Every job's cost used to be quoted at its CEILING: each pass at the\n * `AI_SITE_PASS_CREDITS` (50) a pass is reserved against. A Free Assist\n * build of two pages, a quote form and a layout was quoted 600 credits and\n * refused with 164 left, when builds like it measure about a fifth of that.\n *\n * So a job is now quoted as a RANGE: what it is likely to cost (the sum of\n * the measured medians of what it builds), what it costs nine times in ten\n * (the measured p90s), and its ceiling (the old figure, unchanged). The\n * meter still charges actual use, and the reservation each pass takes is\n * still the ceiling's 50 — only the words and the Free admission move:\n * a Free job is admitted outright when its p90 fits what is left, and asked\n * to be confirmed when it does not.\n *\n * This module is pure: the console, the doors and the specs read one table.\n */\n\n/** One measured cost: the median and the 90th percentile, in credits. */\nexport interface AiMeasuredCredits {\n  median: number\n  p90: number\n}\n\n/**\n * MEASURED IN PRODUCTION, credits per unit, over every `done` AI job since\n * 2026-10-01 (read 2026-10-09; a whole Free site job came to 148–160):\n *\n *   page item   30 / 40   (a page of about `AI_MEASURED_PAGE_SECTIONS` sections, its listing included)\n *   form        29 / 31\n *   layout      23 / 24   (header and footer, one answer)\n *   theme        4 /  8   (a site start's look)\n *   plan step   21 / 70\n *\n * THE FAST TIER'S PART, REPRICED (AGL-3781). A site start's look, a Free\n * start's plan and every page's listing run on the fast tier, measured above\n * on Claude Haiku 4.5 at its cost. They run on Claude Haiku 5.5 at the\n * platform's markup now, so those parts are repriced from what production\n * sent, at the new rates and about 30% more tokens: over October 1–14 a look\n * 4 / 7 → 1 / 2, a Free start's plan 15 / 22 → 3 / 5, a listing 3 / 5 → 1 / 1\n * (2 less on every page), and a whole two-page Free site 148 → 121 at the\n * median. The other rows ran on the balanced tier and do not move.\n *\n * HOW TO RE-MEASURE: a read-only collection-group read of `aiJobs` in\n * production where `status == 'done'` and `createdAt` is in the window; group\n * each ledger row's (`items[]`) `creditsSpent` by its `op` (the site start's\n * look is the `theme` row), take the plan step's `steps[].creditsSpent` for\n * `plan`, and each job's `creditsSpent` for the whole-site band. Put each\n * group's median and 90th percentile here, and the dates in\n * `AI_MEASURED_AT`. `ai-credit-estimate.spec.ts` holds the table, the page\n * scaling and the measured whole-site band together, so a re-measure that\n * moves one moves the spec with it.\n */\nexport const AI_MEASURED_UNIT_CREDITS = {\n  // 30 / 40 with its listing at Haiku 4.5's cost.\n  page: { median: 28, p90: 38 },\n  form: { median: 29, p90: 31 },\n  layout: { median: 23, p90: 24 },\n  // 4 / 8 on Haiku 4.5.\n  theme: { median: 1, p90: 2 },\n  // 21 / 70: the median is a Free start's plan, on the fast tier; the p90 a\n  // plan on the balanced tier, which does not move.\n  plan: { median: 4, p90: 70 },\n} as const satisfies Record<string, AiMeasuredCredits>\n\n/**\n * MEASURED IN PRODUCTION, credits per unit of a PAID site start, whose plan\n * and parts run on the paid routing (Sonnet) rather than a Free start's\n * (Haiku) the table above is mostly made of: every `done` paid site job\n * since 2026-10-01, read 2026-10-12 (6 jobs; products from the 4 stores; AGL-3739).\n *\n *   plan step   81 / 86   (a Free start's plan: 20 / 42 on Haiku 4.5, 3 / 5 repriced)\n *   page item   29 / 49   (about `AI_MEASURED_PAGE_SECTIONS` sections; 27 / 47 with its listing repriced)\n *   form        32 / 39\n *   layout      29 / 29\n *   theme        4 /  4   (1 / 1 repriced)\n *   email       49 / 51\n *   products    64 / 66   (a store's first products, one answer)\n *\n * A 5-page store with its welcome email was quoted about 277 off the table\n * above: its plan at a Free start's 21 where paid plans run about 81, and its\n * first products not counted at all where they run about 64. Those stores\n * came to 413-448; this table quotes one at about 404.\n *\n * Re-measure as the table above says, keeping only jobs whose plan step's\n * `tokens.model` is the paid routing's.\n */\nexport const AI_MEASURED_PAID_SITE_CREDITS = {\n  plan: { median: 81, p90: 86 },\n  page: { median: 27, p90: 47 },\n  form: { median: 32, p90: 39 },\n  layout: { median: 29, p90: 29 },\n  theme: { median: 1, p90: 1 },\n  email: { median: 49, p90: 51 },\n  products: { median: 64, p90: 66 },\n} as const satisfies Record<string, AiMeasuredCredits>\n\n/**\n * A page brought in from a person's own website (AGL-3976), priced as an AI\n * page: a paid site start's page as measured above, since an imported page is\n * one answer in the layout language and its listing, written inside one job\n * the way a site start writes its pages. Its site's header and footer, built\n * once in an import's first wave, is that table's layout.\n *\n * Re-measure from done `import` jobs' item ledgers once production has run\n * them: their `page` rows' `creditsSpent`, as the paid table is read.\n */\nexport const AI_MEASURED_IMPORT_CREDITS = {\n  page: AI_MEASURED_PAID_SITE_CREDITS.page,\n  frame: AI_MEASURED_PAID_SITE_CREDITS.layout,\n  /**\n   * A main page whose design Aglyn AI answers (AGL-4107): one small answer on\n   * the balanced tier over the page's read structure — about 1,000 to 1,300\n   * tokens in, two thirds of them its cached instructions, and 500 to 900 out\n   * with its thinking, $0.009–$0.017 at Sonnet 5.5's billed rates over the\n   * recorded aglyn.com pages — and no listing, the source's own being kept.\n   * The 10/29 run spent 36–58 a page on a smaller model for a line-by-line\n   * answer twenty times the size. PROVISIONAL until the next live import\n   * measures it.\n   */\n  arranged: { median: 16, p90: 30 },\n  /** A page copied as it is (AGL-4083): no model, and a listing only where the source has none. Provisional, as `arranged`. */\n  copied: { median: 1, p90: 2 },\n} as const satisfies Record<string, AiMeasuredCredits>\n\n/**\n * When the table above was read, and from when its jobs ran. Both tables\n * were measured before AGL-3781 asked a paid site's plan at medium effort and\n * the layout language's pages and frames at low. A lower effort draws less,\n * so their plan, page and layout figures stand as the higher reading until\n * the next re-measure: a quote is never under what is drawn.\n */\nexport const AI_MEASURED_AT = { read: '2026-10-09', since: '2026-10-01' } as const\n\n/**\n * What a whole Free two-page site job measured at, in credits, in the same\n * window: 148–160 with its plan, look and listings at Haiku 4.5's cost, 27\n * less at the median with them repriced (AGL-3781).\n */\nexport const AI_MEASURED_FREE_SITE_CREDITS = { low: 121, high: 133 } as const\n\n/** The sections the measured page item is about: a page is scaled around it. */\nexport const AI_MEASURED_PAGE_SECTIONS = 5\n\n/**\n * What a page of this many sections is likely to cost: the measured page\n * scaled by its sections around the ~5-section median — about 6 credits a\n * section, 8 at the p90.\n */\nexport function aiMeasuredPageCredits(sections: number): AiMeasuredCredits {\n  const count = Math.max(1, Math.floor(Number.isFinite(sections) ? sections : AI_MEASURED_PAGE_SECTIONS))\n  const { median, p90 } = AI_MEASURED_UNIT_CREDITS.page\n  return {\n    median: Math.ceil((median * count) / AI_MEASURED_PAGE_SECTIONS),\n    p90: Math.ceil((p90 * count) / AI_MEASURED_PAGE_SECTIONS),\n  }\n}\n\n/**\n * What a page costs when it is written ON ITS OWN — a page an Assist build or\n * a page job writes, rather than one of a site start's pages (AGL-3722).\n *\n * The table's page item is a site start's: its pages are written one after\n * another inside one job, the later ones reading the prompt the first one\n * paid to write, so a 2-section second page measured 19–28. A page written on\n * its own pays that prompt itself and reads the site it lands on, and costs\n * what a site start's FIRST page costs: a 5-section home page measured 39–78\n * (median 40, p90 78), standalone page jobs' writing step 82–105 for a\n * 2-section page, and the Assist build pages of 2026-10-09 22–89 each. Quoting\n * a build's pages at the site start's scaled median told a Free workspace\n * \"about 48 credits\" for two 4-section pages (AGL-3722, 2026-10-10).\n *\n * So it is priced as a fixed cost — the prompt, the site, the listing — and a\n * cost per section: a 4-section page about 38 (p90 76), a 5-section 44 (p90 88).\n * The fixed part was 16 / 30 with its listing at Haiku 4.5's cost (AGL-3781).\n */\nexport const AI_MEASURED_STANDALONE_PAGE = {\n  fixed: { median: 14, p90: 28 },\n  perSection: { median: 6, p90: 12 },\n} as const satisfies Record<string, AiMeasuredCredits>\n\n/** What a page of this many sections written on its own is likely to cost. */\nexport function aiMeasuredStandalonePageCredits(sections: number): AiMeasuredCredits {\n  const count = Math.max(1, Math.floor(Number.isFinite(sections) ? sections : AI_MEASURED_PAGE_SECTIONS))\n  const { fixed, perSection } = AI_MEASURED_STANDALONE_PAGE\n  return {\n    median: fixed.median + perSection.median * count,\n    p90: fixed.p90 + perSection.p90 * count,\n  }\n}\n\n/**\n * What a creation costs when it is written ON ITS OWN (AGL-3722), where it\n * measured apart from a site start's: an Assist build's layout came to 24–28\n * (2026-10-09/10), against a site start's 23/24 written in its warm prompt.\n * A form measured the same either way (25–30 on its own, 29/31 in a site\n * start), so it keeps the table's figure.\n */\nexport const AI_MEASURED_STANDALONE_CREATION_CREDITS = {\n  layout: { median: 26, p90: 30 },\n} as const satisfies Record<string, AiMeasuredCredits>\n\n/**\n * What one pass of a kind with no measurement of its own is likely to cost\n * (a component, an email design, a template, an item another runner\n * builds), written on its own: a component job's writing step measured\n * 52–65, a form job's 37, a layout job's 63, and the Assist build of\n * 2026-10-09 a welcome email at 46 and a products step at 60. Until\n * 2026-10-10 this was a site start's form (29/31), which is written inside a\n * site job's warm prompt and is the cheapest single answer there is.\n */\nexport const AI_MEASURED_PASS_CREDITS: AiMeasuredCredits = { median: 50, p90: 65 }\n\n/** A job's cost as it is quoted: likely, nine times in ten, and at its worst. */\nexport interface AiCreditRange {\n  /** The sum of the measured medians: what the job is likely to spend. */\n  likely: number\n  /** The sum of the measured p90s: what a Free job is admitted on. */\n  p90: number\n  /** Every pass at its reserve: what it can spend at most. */\n  ceiling: number\n}\n\nexport const AI_CREDIT_RANGE_ZERO: AiCreditRange = { likely: 0, p90: 0, ceiling: 0 }\n\n/** Two ranges added. */\nexport function aiCreditRangeAdd(a: AiCreditRange, b: AiCreditRange): AiCreditRange {\n  return { likely: a.likely + b.likely, p90: a.p90 + b.p90, ceiling: a.ceiling + b.ceiling }\n}\n\n/** A measured cost as a range with its own ceiling, the likely and p90 never above it. */\nexport function aiCreditRangeOf(measured: AiMeasuredCredits, ceiling: number): AiCreditRange {\n  const top = Math.max(0, Math.ceil(ceiling))\n  return { likely: Math.min(measured.median, top), p90: Math.min(measured.p90, top), ceiling: top }\n}\n\n/** A range whose likely and p90 are each at least the last, and at most the ceiling. */\nexport function aiCreditRangeOrdered(range: AiCreditRange): AiCreditRange {\n  const ceiling = Math.max(0, Math.ceil(range.ceiling))\n  const likely = Math.min(Math.max(0, Math.ceil(range.likely)), ceiling)\n  const p90 = Math.min(Math.max(likely, Math.ceil(range.p90)), ceiling)\n  return { likely, p90, ceiling }\n}\n\nconst n = (value: number) => value.toLocaleString('en-US')\n\n/**\n * The range as every surface quotes it: \"About 106 credits (up to 650)\".\n * A job whose likely figure is its ceiling says one number.\n */\nexport function aiCreditRangeText(range: AiCreditRange): string {\n  if (range.likely >= range.ceiling) return `About ${n(range.ceiling)} credits`\n  return `About ${n(range.likely)} credits (up to ${n(range.ceiling)})`\n}\n\n/**\n * Whether a Free job of this range needs the person's go-ahead before it\n * starts (AGL-3722): its p90 is more than what is left. A job whose p90\n * fits starts with no prompt; one that does not starts only when confirmed,\n * builds as much as what is left pays for, and pauses with Resume.\n */\nexport function aiCreditsNeedConfirm(range: Pick<AiCreditRange, 'p90'>, left: number): boolean {\n  return Number.isFinite(left) && range.p90 > Math.max(0, Math.floor(left))\n}\n\n/** The smaller first build a Free job that does not fit is offered (AGL-3722). */\nexport interface AiCreditsSmaller {\n  /** \"Build the home page first\". */\n  label: string\n  likely: number\n  p90: number\n  ceiling: number\n}\n\n/**\n * What a Free job that does not fit what is left says before it starts, and\n * the choices it offers: build what fits, a smaller first build, or Upgrade.\n * The door that refuses an unconfirmed start answers with it (status 409,\n * `code: AI_CREDITS_CONFIRM_CODE`), and the plan card and the guided start\n * draw it from the same figures.\n */\nexport interface AiCreditsPrompt extends AiCreditRange {\n  left: number\n  resetsOn: string\n  smaller: AiCreditsSmaller | null\n}\n\n/** The `code` a door answers an unconfirmed Free start with. */\nexport const AI_CREDITS_CONFIRM_CODE = 'credits-confirm'\n\n/** \"Build what fits\": the go-ahead for a Free job past what is left. */\nexport const AI_CREDITS_BUILD_WHAT_FITS = 'Build what fits'\n\n/** The smaller first build's button: \"Build the home page first (about 64 credits)\". */\nexport function aiCreditsSmallerText(smaller: Pick<AiCreditsSmaller, 'label' | 'likely'>): string {\n  return `${smaller.label} (about ${n(smaller.likely)} credits)`\n}\n\n/** Which way on a prompt offers, in the order it offers them. */\nexport type AiCreditsChoiceKey = 'fits' | 'smaller' | 'upgrade'\n\n/** One way on, as its option button reads it: a short label and the figure under it (AGL-3722). */\nexport interface AiCreditsChoice {\n  key: AiCreditsChoiceKey\n  label: string\n  detail: string\n  /** The one choice drawn as the primary button. */\n  recommended: boolean\n}\n\nconst credit = (count: number) => `${n(count)} ${count === 1 ? 'credit' : 'credits'}`\n\n/**\n * The prompt's ways on, as its three option buttons read them (Zach,\n * 2026-10-10: \"more appealing and consistent\"): build what fits, the smaller\n * first build when there is one, and Upgrade when it can be offered — each a\n * short sentence-case label with its figure under it. The smaller build is\n * the recommended one when its p90 fits what is left, since it then finishes;\n * otherwise building what fits is.\n */\nexport function aiCreditsChoices(\n  prompt: Pick<AiCreditsPrompt, 'left' | 'smaller'>,\n  offers: { smaller: boolean; upgrade: boolean },\n): AiCreditsChoice[] {\n  const left = Math.max(0, Math.floor(prompt.left))\n  const smaller = offers.smaller ? prompt.smaller : null\n  const smallerFits = smaller !== null && smaller.p90 <= left\n  const choices: AiCreditsChoice[] = [\n    {\n      key: 'fits',\n      label: AI_CREDITS_BUILD_WHAT_FITS,\n      detail: `Uses your ${credit(left)} left, then pauses`,\n      recommended: !smallerFits,\n    },\n  ]\n  if (smaller) {\n    choices.push({\n      key: 'smaller',\n      label: smaller.label,\n      detail: smallerFits ? `About ${credit(smaller.likely)}, fits what you have left` : `About ${credit(smaller.likely)}`,\n      recommended: smallerFits,\n    })\n  }\n  if (offers.upgrade) choices.push({ key: 'upgrade', label: 'Upgrade', detail: 'Get more credits', recommended: false })\n  return choices\n}\n\n/** A reset day as a person reads it: \"November 1\". */\nfunction resetLabel(resetsOn: string): string {\n  const at = new Date(`${resetsOn}T00:00:00.000Z`)\n  return Number.isFinite(at.getTime())\n    ? at.toLocaleDateString('en-US', { month: 'long', day: 'numeric', timeZone: 'UTC' })\n    : 'the first of next month'\n}\n\n/**\n * The plain sentence (Zach, 2026-10-09): \"This build is about N credits (up\n * to M). You have L left, so it will build as much as it can and pause when\n * your credits run out. You can upgrade or resume when they renew.\"\n */\nexport function aiCreditsPromptText(prompt: AiCreditsPrompt, noun: 'build' | 'site' = 'build'): string {\n  const size =\n    prompt.likely >= prompt.ceiling\n      ? `about ${n(prompt.ceiling)} credits`\n      : `about ${n(prompt.likely)} credits (up to ${n(prompt.ceiling)})`\n  const left = Math.max(0, Math.floor(prompt.left))\n  return (\n    `This ${noun} is ${size}. You have ${n(left)} left, so it will build as much as it can and pause ` +\n    `when your credits run out. You can upgrade or resume when they renew on ${resetLabel(prompt.resetsOn)}.`\n  )\n}\n\n/**\n * The record a confirmed Free start keeps (AGL-3722): who said go, when,\n * what was left then and the range they were shown.\n */\nexport interface AiJobCreditsConfirmation extends AiCreditRange {\n  by: string\n  at: Date | string\n  left: number\n}\n\n/** The confirmation a door keeps on the job for the prompt the person confirmed, or `null` when there was none. */\nexport function aiCreditsConfirmation(\n  prompt: AiCreditsPrompt | null,\n  by: string,\n  at: Date,\n): AiJobCreditsConfirmation | null {\n  if (!prompt) return null\n  return { by, at, left: prompt.left, likely: prompt.likely, p90: prompt.p90, ceiling: prompt.ceiling }\n}\n\n/** The prompt a range needs against what is left, or `null` when it fits. */\nexport function aiCreditsPromptFor(\n  range: AiCreditRange,\n  credits: { left: number; resetsOn: string } | null | undefined,\n  smaller: AiCreditsSmaller | null = null,\n): AiCreditsPrompt | null {\n  if (!credits || !aiCreditsNeedConfirm(range, credits.left)) return null\n  return { ...range, left: Math.max(0, Math.floor(credits.left)), resetsOn: credits.resetsOn, smaller }\n}\n"],"names":["AI_MEASURED_UNIT_CREDITS","page","median","p90","form","layout","theme","plan","AI_MEASURED_PAID_SITE_CREDITS","email","products","AI_MEASURED_IMPORT_CREDITS","frame","arranged","copied","AI_MEASURED_AT","read","since","AI_MEASURED_FREE_SITE_CREDITS","low","high","AI_MEASURED_PAGE_SECTIONS","aiMeasuredPageCredits","sections","count","Math","max","floor","Number","isFinite","ceil","AI_MEASURED_STANDALONE_PAGE","fixed","perSection","aiMeasuredStandalonePageCredits","AI_MEASURED_STANDALONE_CREATION_CREDITS","AI_MEASURED_PASS_CREDITS","AI_CREDIT_RANGE_ZERO","likely","ceiling","aiCreditRangeAdd","a","b","aiCreditRangeOf","measured","top","min","aiCreditRangeOrdered","range","n","value","toLocaleString","aiCreditRangeText","aiCreditsNeedConfirm","left","AI_CREDITS_CONFIRM_CODE","AI_CREDITS_BUILD_WHAT_FITS","aiCreditsSmallerText","smaller","label","credit","aiCreditsChoices","prompt","offers","smallerFits","choices","key","detail","recommended","push","upgrade","resetLabel","resetsOn","at","Date","getTime","toLocaleDateString","month","day","timeZone","aiCreditsPromptText","noun","size","aiCreditsConfirmation","by","aiCreditsPromptFor","credits"],"mappings":"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"}

package/src/lib/model/ai-site-import.d.ts

@@ -26,9 +26,11 @@ export declare const AI_SITE_IMPORT_WAVE_PAGES = 10;
 /**
  * The most pages one import reads, whatever the plan allows: an unlimited
  * plan is still one crawl's worth, and the crawl's own time budget may stop
- * sooner (the inventory then says so).
+ * sooner (the inventory then says so). Only pages count: a file a link
+ * points at is never fetched as one (AGL-4106), so aglyn.com's 209 pages fit
+ * with room where 136 press-kit files once took 136 of 200.
  */
-export declare const AI_SITE_IMPORT_MAX_PAGES = 200;
+export declare const AI_SITE_IMPORT_MAX_PAGES = 400;
 /** The fewest pages under one address prefix that make it a collection. */
 export declare const AI_SITE_IMPORT_COLLECTION_MIN = 3;
 /** The most photos brought in from one page. */
@@ -45,16 +47,21 @@ export declare const AI_SITE_IMPORT_MAX_SECTIONS = 24;
 export declare const AI_SITE_IMPORT_READ_MAX_BLOCKS = 2000;
 /** The most characters of one page's blocks a wave's read keeps: a long policy is 40,000. */
 export declare const AI_SITE_IMPORT_READ_MAX_CHARS = 120000;
+/** The most characters one page's layout keeps on the job document (AGL-4106): its icons' drawings go first. */
+export declare const AI_SITE_IMPORT_LAYOUT_MAX_CHARS = 48000;
 /**
- * The most characters of blocks the reads of one import hold at once: they
+ * The most characters of blocks (and their layouts, AGL-4106) the reads of one import hold at once: they
  * ride the job document, which Firestore caps at 1 MiB, beside the
  * inventory and the ledger. A wave's later page past it keeps what fits and
  * says it was cut.
  */
 export declare const AI_SITE_IMPORT_WAVE_READ_MAX_CHARS = 400000;
 /**
- * A page with more words of its own than this is copied as it is, never
- * arranged (AGL-4083): a policy, an article, a long story.
+ * A collection's page longer than this is prose: a policy, an article, a
+ * long story (AGL-4083). A collection's page is copied as it is whatever its
+ * length, and since AGL-4106 a main page is arranged whatever its length:
+ * `/product` at 1,072 words is laid out as its source lays it out, not copied
+ * as one column.
  */
 export declare const AI_SITE_IMPORT_PROSE_WORDS = 900;
 /** The answers bot protection and firewalls turn a crawler away with: asked to sign in, refused, or told to slow down. */
@@ -110,7 +117,9 @@ export type AiSiteImportLeftOutReason =
 /** It sends visitors to another website. */
  | 'off-site'
 /** The read stopped (its clock, its bytes, its page count) before it got to it (AGL-4083). */
- | 'not-reached';
+ | 'not-reached'
+/** A link to a file (a download, a PDF with no extension), not a page (AGL-4106). */
+ | 'file';
 export declare const AI_SITE_IMPORT_LEFT_OUT_REASONS: readonly AiSiteImportLeftOutReason[];
 /** The reasons that mean the page was there and AglynBot could not read it: the "could not be read" of what was found. */
 export declare const AI_SITE_IMPORT_UNREAD_REASONS: readonly AiSiteImportLeftOutReason[];
@@ -130,6 +139,250 @@ export interface AiSiteImportPhoto {
     /** The address on the old site it was read from, where a page that is copied places it (AGL-4084). */
     from?: string;
 }
+/**
+ * One line of a page, by its index in the page's main-region blocks
+ * (`AiSiteImportPageRead.blocks`, 0-based). The layout holds no words of
+ * its own: every word is a block's, placed once.
+ */
+export type SiteImportLineRef = number;
+/** A section's background, in the layout language's bands. */
+export type SiteImportBand = 'plain' | 'soft' | 'brand' | 'dark';
+/** How the source draws a button: filled, outlined, or as a link with button padding. */
+export type SiteImportButtonStyle = 'primary' | 'secondary' | 'quiet';
+/** What a repeated group of the source is. */
+export type SiteImportGroupKind = 'cards' | 'steps' | 'stats' | 'faq' | 'quotes' | 'logos' | 'pricing' | 'list' | 'text';
+export declare const SITE_IMPORT_GROUP_KINDS: readonly SiteImportGroupKind[];
+/** One line in place. `role` only where the source's own styling says it (an uppercase eyebrow, a large lede, a small note). */
+export interface SiteImportLayoutLine {
+    kind: 'line';
+    line: SiteImportLineRef;
+    role?: 'eyebrow' | 'lede' | 'note';
+    /** The source draws this line (a link, or a `<button>`'s words) as a button. Its destination is the link block's `href`. */
+    button?: SiteImportButtonStyle;
+}
+/** A picture in place: an image block. */
+export interface SiteImportLayoutPicture {
+    kind: 'picture';
+    line: SiteImportLineRef;
+    /** Where clicking it goes, when it sits in a link. */
+    href?: string;
+    /** It sits in a `<button>` (a video's poster, a lightbox): the picture is kept, the button is not a destination. */
+    button?: true;
+}
+/** An icon standing on its own, by index into `SiteImportLayout.icons`. */
+export interface SiteImportLayoutIcon {
+    kind: 'icon';
+    icon: number;
+}
+/** Where one of the page's forms sat, by index into `AiSiteImportPageRead.forms`. */
+export interface SiteImportLayoutForm {
+    kind: 'form';
+    form: number;
+}
+/**
+ * A row of columns side by side; `cols` are relative widths in twelfths
+ * (`[4, 8]`, `[1, 1, 1]`). Every list of lists is a list of objects: the
+ * layout rides a Firestore document, which holds no array inside an array.
+ */
+export interface SiteImportLayoutRow {
+    kind: 'row';
+    cols: number[];
+    cells: Array<{
+        nodes: SiteImportLayoutNode[];
+    }>;
+}
+/**
+ * One item of a group. Every line of the item is in `lines`, in order, and
+ * in exactly one of the named parts.
+ */
+export interface SiteImportLayoutItem {
+    lines: SiteImportLineRef[];
+    /** The item's name: its heading, its title link, or its first short line. */
+    title?: SiteImportLineRef;
+    /** A stat's figure, a step's number, a plan's price. */
+    figure?: SiteImportLineRef;
+    text?: SiteImportLineRef[];
+    /** Its bullet points (a plan's features). */
+    list?: SiteImportLineRef[];
+    /** Its own call to action: a "See … →" link or a button, last in the item. */
+    link?: SiteImportLineRef[];
+    image?: SiteImportLineRef;
+    /** The icon that leads it, by index into `SiteImportLayout.icons`. */
+    icon?: number;
+    /** The icon each of its bullet points carries (a check mark), when they share one. */
+    listIcon?: number;
+    /** Where the item goes as a whole: its title link's address. */
+    to?: string;
+}
+export interface SiteImportLayoutGroup {
+    kind: 'group';
+    group: SiteImportGroupKind;
+    /** Columns the source lays the items out in on a wide screen. */
+    columns: number;
+    /** Each item is drawn as a box (a border, a shadow or a fill of its own). */
+    boxed: boolean;
+    items: SiteImportLayoutItem[];
+}
+/** A table: rows of cells, each cell its lines (objects, not nested arrays, for Firestore). */
+export interface SiteImportLayoutTable {
+    kind: 'table';
+    /** Whether the first row names the columns. */
+    header: boolean;
+    rows: Array<{
+        cells: Array<{
+            lines: SiteImportLineRef[];
+        }>;
+    }>;
+}
+/** A tab strip and its panels; a panel the source did not draw is empty. */
+export interface SiteImportLayoutTabs {
+    kind: 'tabs';
+    tabs: Array<{
+        label: SiteImportLineRef | null;
+        selected?: true;
+        panel: SiteImportLayoutNode[];
+    }>;
+}
+export type SiteImportLayoutNode = SiteImportLayoutLine | SiteImportLayoutPicture | SiteImportLayoutIcon | SiteImportLayoutForm | SiteImportLayoutRow | SiteImportLayoutGroup | SiteImportLayoutTable | SiteImportLayoutTabs;
+/** Where the hero's picture sits against its words. */
+export type SiteImportHeroPicture = 'beside' | 'behind' | 'below' | 'above';
+export interface SiteImportLayoutSection {
+    /** Its `aria-label`, its heading, or "Section n": neutralized, cut to a label. */
+    name: string;
+    /** How its edges were found: a landmark (`<section>`), a container of its own, or its headings. */
+    from: 'landmark' | 'container' | 'heading';
+    band: SiteImportBand;
+    /** Its background color as `#rrggbb`, when it has one. */
+    background: string | null;
+    /** A gradient or a photo behind it. */
+    backdrop?: {
+        kind: 'gradient';
+    } | {
+        kind: 'picture';
+        url: string;
+    };
+    align: 'start' | 'center';
+    /** Set on the section holding the page's first `<h1>`. */
+    hero?: {
+        picture: SiteImportHeroPicture | null;
+    };
+    nodes: SiteImportLayoutNode[];
+    /** Every line of the section, in order. */
+    lines: SiteImportLineRef[];
+}
+/** An icon the page draws, once however often it repeats. */
+export interface SiteImportIconShape {
+    viewBox: string;
+    /** One path, for the Besigner's icon element (`iconPath`, drawn on a 24-unit square). */
+    path?: string;
+    /** A small drawing of several shapes, geometry only, for a picture of it. */
+    svg?: string;
+}
+/** What the source's look is made of (AGL-4106), read from its stylesheets. */
+export interface SiteImportLookFacts {
+    fonts: {
+        /** The family its body text is set in, as named, when it is not a system font. */
+        body: string | null;
+        /** The family its headings are set in. */
+        headings: string | null;
+        /** The families it loads from Google Fonts, in order. */
+        google: string[];
+    };
+    /** The page's own background, `#rrggbb`. */
+    background: string | null;
+    /** Its body text color. */
+    text: string | null;
+    /** The fill of its filled buttons, the most used first. */
+    buttonFill: string | null;
+    /** The text color on them. */
+    buttonText: string | null;
+    /** Its buttons' corner radius, px. */
+    buttonRadius: number | null;
+    /** The color its text links are drawn in. */
+    link: string | null;
+    /** Its header bar's background. */
+    header: string | null;
+}
+/** A page's layout, as the source lays it out (AGL-4106). */
+export interface SiteImportLayout {
+    v: 1;
+    sections: SiteImportLayoutSection[];
+    icons: SiteImportIconShape[];
+    look: SiteImportLookFacts;
+}
+/** One entry of a menu, as the source's header shows it. */
+export interface SiteImportNavEntry {
+    label: string;
+    /** The line under it in a mega menu. */
+    text?: string;
+    /** Where it goes: absolute http(s), `mailto:` or `tel:`. */
+    href: string;
+    /** Its icon, when it has a one-path icon. */
+    iconPath?: string;
+    viewBox?: string;
+    /** The heading of the menu's column it sits in ("By team"). */
+    column?: string;
+}
+/** A top-level item of the source's menu: a link, or a menu of entries under a name. */
+export interface SiteImportNavGroup {
+    label: string;
+    /** Where the name itself goes; `null` when it only opens its menu. */
+    href: string | null;
+    /** Empty for a plain link. */
+    items: SiteImportNavEntry[];
+}
+/** A button in the source's header outside its menu ("Sign in", "Start free"). */
+export interface SiteImportNavCta {
+    label: string;
+    href: string | null;
+    style: SiteImportButtonStyle;
+}
+/** The source's header menu (AGL-4106). Untrusted data from the owner's site. */
+export interface SiteImportNavTree {
+    items: SiteImportNavGroup[];
+    ctas: SiteImportNavCta[];
+    /** The source shows a menu button on phones. */
+    phoneMenu: boolean;
+    /** The header bar's background, `#rrggbb`. */
+    background: string | null;
+}
+export interface SiteImportFooterLink {
+    label: string;
+    href: string;
+}
+/** The source's footer (AGL-4106): its columns, profiles and facts, as written. */
+export interface SiteImportFooter {
+    columns: Array<{
+        heading: string;
+        links: SiteImportFooterLink[];
+    }>;
+    /** Its links to profiles on other sites. */
+    social: Array<SiteImportFooterLink & {
+        network: string;
+    }>;
+    /** Links outside any column and not a profile (Privacy, Terms, Status). */
+    links: SiteImportFooterLink[];
+    /** Its lines of text outside links (a tagline), as written. */
+    text: string[];
+    address: string | null;
+    phone: string | null;
+    email: string | null;
+    /** Its © line, word for word. */
+    copyright: string | null;
+}
+/** Every line a layout's nodes place, in order. */
+export declare function siteImportLayoutLines(nodes: readonly SiteImportLayoutNode[]): SiteImportLineRef[];
+/** How many characters a layout weighs on the job document. */
+export declare function siteImportLayoutChars(layout: SiteImportLayout | null | undefined): number;
+/**
+ * A layout over only the first `count` lines (a read the wave's budget cut
+ * short): references past the cut are dropped, and what is left empty goes.
+ */
+export declare function siteImportLayoutWithin(layout: SiteImportLayout, count: number): SiteImportLayout;
+/** Nodes with only the lines `keep` keeps; what is left empty goes. */
+export declare function siteImportFilterNodes(list: readonly SiteImportLayoutNode[], keep: (ref: SiteImportLineRef) => boolean): SiteImportLayoutNode[];
+/** A layout with its icons' drawings dropped, for a page that must be lighter. */
+export declare function siteImportLayoutWithoutDrawings(layout: SiteImportLayout): SiteImportLayout;
 /** What a wave's read found on one page, for its model answer. Never on the wire. */
 export interface AiSiteImportPageRead {
     at: string;
@@ -157,6 +410,21 @@ export interface AiSiteImportPageRead {
     words?: number;
     /** The forms the page asks visitors to fill in, by their fields. */
     forms?: SiteImportForm[];
+    /**
+     * How the source lays the page out (AGL-4106): its sections, bands, rows,
+     * groups, pictures, icons and buttons, over `blocks` by index. Absent on a
+     * read made before the reader, or when it did not fit the wave's budget.
+     */
+    layout?: SiteImportLayout | null;
+    /**
+     * The page's browser title and meta description as the source writes them
+     * (AGL-4107), which the new page's listing keeps word for word. Absent on a
+     * read made before they were kept.
+     */
+    meta?: {
+        title: string;
+        description: string;
+    };
 }
 /** How a page is built from its old page, as the step chose: its words copied as they are, or arranged by Aglyn AI. */
 export type AiSiteImportBuild = 'copied' | 'arranged';
@@ -193,7 +461,12 @@ export interface AiSiteImportPage {
         assets: AiSiteImportPhoto[];
     } | null;
 }
-export type AiSiteImportWaveStatus = 'waiting' | 'running' | 'review' | 'done';
+/**
+ * A wave's place in its import: waiting to start, running, in and waiting for
+ * the person's review, in, or `stopped` — the import was canceled before the
+ * wave was in, while it ran or before it started (AGL-4107).
+ */
+export type AiSiteImportWaveStatus = 'waiting' | 'running' | 'review' | 'done' | 'stopped';
 export interface AiSiteImportWave {
     index: number;
     label: string;
@@ -235,8 +508,6 @@ export interface AiSiteImportState {
     frame: {
         draftId: string;
     } | null;
-    /** The Trust & Safety row this import is logged under. */
-    reviewId: string | null;
     /**
      * "Start every remaining wave" (AGL-4083): each wave closes and the next
      * starts with no review between them; the last wave's close is the stop.
@@ -286,7 +557,24 @@ export interface AiSiteImportHome {
         social: string[];
         address: string;
     };
+    /**
+     * The source's header menu as its home page builds it (AGL-4108): its
+     * items, their menus, its buttons. The header and footer are drawn from it
+     * with no model; absent on a read made before the reader, or where the home
+     * page has no menu the reader can find.
+     */
+    nav?: SiteImportNavTree | null;
+    /** The source's footer as its home page builds it (AGL-4108): its columns, profiles, facts and © line. */
+    footer?: SiteImportFooter | null;
+    /** What the source's look is made of (AGL-4108): its colors, its button fill and corners, its fonts. */
+    look?: SiteImportLookFacts | null;
 }
+/**
+ * Whether the site's header and footer are built from the source's own menu
+ * (AGL-4108), with no model: the home page's menu was read. Then the frame
+ * costs nothing and is quoted at nothing.
+ */
+export declare function aiSiteImportFrameIsRead(state: Pick<AiSiteImportState, 'home'> | null | undefined): boolean;
 /** What the look pass did (AGL-4084): no model is asked. */
 export interface AiSiteImportLook {
     at: string;
@@ -417,7 +705,6 @@ export interface AiSiteImportInventoryInput {
     existingPages: number;
     /** Mints one draft id; the inventory names every page's draft before any is written. */
     mintId: () => string;
-    reviewId?: string | null;
     wavePages?: number;
 }
 /**
@@ -487,13 +774,20 @@ export declare function aiSiteImportPhotosIn(state: AiSiteImportState, slot: str
 export declare function aiSiteImportPageSettled(state: AiSiteImportState, slot: string): AiSiteImportState;
 /** A wave is in: waiting for its review, or done when no wave follows it. */
 export declare function aiSiteImportWaveClosed(state: AiSiteImportState, index: number, at: string): AiSiteImportState;
+/**
+ * The state of an import a person canceled (AGL-4107): every wave settled. A
+ * wave that ran, or was waiting to, is stopped; one already in, for review or
+ * done, is in. On 10/29 a canceled import still showed its second wave as
+ * running, with nothing running it.
+ */
+export declare function aiSiteImportCanceled(state: AiSiteImportState, at: string): AiSiteImportState;
 /** The state as the console reads it: every page's read text left off. */
 export declare function aiSiteImportWire(state: AiSiteImportState | null | undefined): AiSiteImportState | null;
 /**
  * How a page is built (AGL-4083), decided by code: every page of a collection
- * (a blog, the legal pages, news) and any page longer than
- * `AI_SITE_IMPORT_PROSE_WORDS` is copied as it is; the main pages are
- * arranged by Aglyn AI, their words kept as written.
+ * (a blog, the legal pages, news) is copied as it is; every main page is
+ * arranged by Aglyn AI whatever its length (AGL-4106), its words kept as
+ * written. Both are laid out from the source's own layout.
  */
 export declare function aiSiteImportPageBuild(page: Pick<AiSiteImportPage, 'group' | 'words'>): AiSiteImportBuild;
 /**