@aglyn/plugins-ai 1.0.0-beta.269 → 1.0.0-beta.271

package/src/lib/plan-entitlements.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/plan-entitlements.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// Types only: the manifest generator loads this module on its own to compile\n// the plan figures, before the catalog file core reads them from exists in\n// its new shape, so nothing here may reach a core module at runtime.\nimport type { OrgPlan } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport type { PluginPlanEntitlementsDeclaration } from '@aglyn/aglyn/plugin-manager/plugin-plan-entitlements'\n\n/**\n * THE AI PLUGIN'S PLAN BAND (AGL-3080): how many AI credits each plan\n * includes a month. Compiled into core's `PLAN_ENTITLEMENTS` by the manifest\n * generator (`register.planEntitlements`), so `/pricing`, the plan comparison\n * and every gate read the same figure they always have; this is where it is\n * written, beside the reasoning that sized it.\n */\ndeclare module '@aglyn/aglyn/plugin-manager/plugin-entitlement-keys' {\n  interface PluginEntitlementQuotas {\n    /**\n     * AI credits per calendar month — the band assist spends against.\n     *\n     * A CREDIT IS A UNIT OF MODEL COST, not a message. One assist action can\n     * cost two orders of magnitude more than another: a question is a few\n     * thousand tokens, while generating a screen carries the node tree, the\n     * component catalog and the theme tokens in, structured markup out, and\n     * iterates. A message allowance would price those the same, so one\n     * workspace's ten screen builds would outspend another's thousand\n     * questions and both would read as \"within allowance\".\n     *\n     * The unit is defined by `ASSIST_CREDIT_COST_USD` and the conversion\n     * lives in `assist-credits.ts`. Only that module turns credits into\n     * dollars; everything a customer sees counts credits, because the dollar\n     * figure behind them is our provider bill and not a price.\n     *\n     * ## HOW THE BAND IS SIZED, and why it is not a share of the price\n     *\n     * A credit is a dollar of provider spend at `ASSIST_CREDIT_COST_USD`, so\n     * the band IS a liability figure: the plan's whole assist give is\n     * `assistCreditsPerMonth / 1000` dollars. Credits past it are not a give\n     * — since AGL-2653 they are SOLD at `extraAssistCreditsUsdPer1k`, unless\n     * the org's `assistOverage.hardCap` asks `reserveAssistMessage` to refuse\n     * at the band instead. Sizing it as a share of the subscription price\n     * says nothing about whether the tier can afford it, because the price is\n     * also carrying storage, bandwidth, form submissions, dataset storage,\n     * API requests, contacts and email.\n     *\n     * So each band is sized against what those SEVEN other terms leave.\n     * Every paid band takes between a quarter and a third of that remainder,\n     * which keeps the tier's worst case positive and keeps the ladder's\n     * shape: the margin each tier holds at 100% of every band stays in\n     * proportion to what it held before assist was sold at all.\n     * `tier-margin-floor.spec.ts` is the model, and it pins both the rule and\n     * the resulting figures.\n     *\n     * The Aglyn AI add-on (AGL-2896) adds `AI_ADDON_CREDITS_PER_MONTH[plan]`\n     * to this band in `resolveOrgEntitlements` — one pool, widened, rather\n     * than a second meter.\n     */\n    assistCreditsPerMonth?: number\n  }\n}\n\n/**\n * AI credits an Enterprise agreement includes per month, before the contract\n * says otherwise.\n *\n * ## Never `UNLIMITED`, and the reason is not stylistic\n *\n * `UNLIMITED` is `Number.POSITIVE_INFINITY`, `JSON.stringify(Infinity)` is\n * `null`, and `Number(null)` is `0`. An unbounded assist band therefore\n * serialises to a band of ZERO through every route that does not also send\n * the explicit flag `restoreQuotaLimit` rebuilds from — which would hand the\n * only customers with a signed contract the one budget that refuses\n * everything. A finite number crosses the wire as itself.\n *\n * The band is also a real liability rather than a capacity we already own.\n * Storage and page views are infrastructure metered into the deal; assist is\n * a per-token charge from a third party, and generative building spends it in\n * units two orders of magnitude apart.\n *\n * ## Why this number\n *\n * Enterprise carries no list price, so the band cannot be sized the way every\n * self-serve tier's is — against what that tier's other cost terms leave out\n * of a known price. It is anchored to the top of the ladder instead: 116,000\n * credits is twice Agency's band, the rule every Enterprise fallback follows\n * since the 2026-09-07 pricing decision (see the `enterprise` row of\n * `PLAN_ENTITLEMENTS`). In cost that is $116 of provider spend a month, or\n * under 9% of any deal priced at or above the self-serve top. A deal below\n * that is sold as Agency, not written as an Enterprise agreement.\n *\n * ## It is a DEFAULT, and a contract raises it\n *\n * `resolveOrgEntitlements` applies a per-org\n * `entitlements.assistCreditsPerMonth` override ahead of this, so a deal that\n * buys more assist buys it on that org without moving the figure every other\n * agreement is measured against — the same mechanism the other contracted\n * bands use.\n */\nexport const ENTERPRISE_ASSIST_CREDITS_PER_MONTH = 116_000\n\n/**\n * The Free AI taste (AGL-2925): the credits a Free workspace draws on each\n * month, behind a hard wall.\n *\n * ## Why it exists\n *\n * So the AI landing pages can say \"generate your first page free\" and mean\n * it. Three hundred credits is one or two generated sections or a handful of\n * copy rewrites — enough to see what the assistant does, not enough to build\n * a site on. The band is a WALL: `PLAN_PRICING.free\n * .extraAssistCreditsUsdPer1k` stays `null`, so `assistBandRefuses` answers\n * true and the reservation refuses at 100% with no overage, no switch and no\n * invoice. Nothing about a Free workspace can produce a charge.\n *\n * ## What it costs, and why that is the number\n *\n * A credit is `ASSIST_CREDIT_COST_USD` of provider spend, so the band costs\n * at most **$0.30 per Free workspace per month** — asserted by\n * `apps/console/specs/tier-margin-floor.spec.ts`. It is the one AI band with\n * no invoice behind it, which is why the same issue closes every multiplier\n * a script could use before the flag flips:\n *\n *  - it is metered per ACCOUNT as well as per workspace, so the three free\n *    workspaces an account may hold (AGL-2265) share one 300-credit\n *    allowance rather than tripling it (`reserveAssistMessage`);\n *  - every free request is bounded per IP, per uid and per account per\n *    day (a minimum account age, `AI_FREE_MIN_ACCOUNT_AGE_HOURS`, is\n *    available and off by default — AGL-3591);\n *  - a platform-wide daily ceiling on free spend pauses the taste for\n *    everyone until the UTC day rolls, paid workspaces untouched.\n *\n * The account allowance reads THIS constant rather than the workspace's\n * resolved band, because a staff override that widens one workspace's band\n * is a decision about that workspace, not about how much one person may draw\n * across all of theirs.\n */\nexport const FREE_AI_TASTE_CREDITS_PER_MONTH = 300\n\n/** The AI credits each plan includes a month — see the key's own docblock. */\nexport const AI_CREDITS_BY_PLAN: Readonly<Record<OrgPlan, number>> = {\n  // The Free AI taste (AGL-2925): a real band, and a wall. See the constant\n  // for what it buys, what it costs and the precautions that keep one person\n  // from drawing it three times over.\n  free: FREE_AI_TASTE_CREDITS_PER_MONTH,\n  // The first paid rung of the assist ladder (AGL-3203). Starter banded at 0\n  // until 2026-09-20, which put a PAYING workspace below the Free taste's 300\n  // on the one axis a visitor compares straight down the column — the\n  // `/pricing` row read `300 / mo` for Free and `—` for Starter. A paid plan\n  // that includes less of something than the free plan is not a packaging\n  // subtlety; it is the comparison table arguing against the upgrade.\n  //\n  // 750 is deliberately small: 2.5x the taste, enough that the assistant is a\n  // thing the tier HAS rather than a thing it is shown, and $0.75 of provider\n  // spend a month at `ASSIST_CREDIT_COST_USD` against a $16 annual price — a\n  // twentieth of the $8.81 the tier's other metered bands already cost, and\n  // the widest margin on the ladder absorbs it with room left\n  // (`tier-margin-floor.spec.ts` carries the arithmetic).\n  //\n  // It is NOT a wall, unlike Free's: `PLAN_PRICING.starter\n  // .extraAssistCreditsUsdPer1k` is $3.00, so past 750 the tier meters and\n  // bills like every paid plan above it. The two fields move together by rule\n  // — a positive band with no rate beside it is usage past a bound that is\n  // silently free, which `plan-entitlements.spec.ts` forbids.\n  //\n  // `features.aiAssist` is TRUE, and AGL-3203 shipping it false was the\n  // defect AGL-3207 closes. The reasoning then was \"the band is credits, not\n  // the guided rung, exactly as on Free\" — but on Free the band IS spendable,\n  // through `aiGenerative`, which is the door the taste exists for. Starter\n  // carried neither flag, so it was the only row on the ladder sold a band\n  // with nothing to spend it through: 750 credits reachable only by buying\n  // the $9 add-on that was also the only thing that made them usable. \"No\n  // plan bands at zero any more\" was true of the number and false of the\n  // capability.\n  //\n  // It opens `aiAssist` rather than `aiGenerative` because that is the shape\n  // of every paid rung above it — the included band funds the guided\n  // assistant and generation is the add-on. Opening the generative door here\n  // instead would hand the FIRST paid rung a door Pro through Agency have to\n  // buy.\n  //\n  // No cost moves: `tier-margin-floor.spec.ts` already prices this tier's\n  // assist term at 100% burn of the 750 credits, 75¢/mo. A door does not\n  // widen a band; it only makes spend that was already modeled reachable.\n  //\n  // The AI add-on adds `AI_ADDON_CREDITS_PER_MONTH.starter` on top and\n  // switches `aiGenerative` on as well.\n  starter: 750,\n  // $2.75 of provider spend, against the $8.35 the tier's other seven cost\n  // terms leave out of $56. See the key's docblock for why the remainder and\n  // not the price is what sizes this.\n  pro: 2_750,\n  // $7.50, against the $22.69 the other seven terms leave out of $139.\n  business: 7_500,\n  // $10.00, against the $30.62 the other seven terms leave out of $249.\n  scale: 10_000,\n  // $13.00, against the $39.74 the other seven terms leave out of $399 — the\n  // thinnest remainder on the ladder, and the tier that binds the whole\n  // assist ladder's share of it.\n  advanced: 13_000,\n  // $58.00, against the $176.71 the other seven terms leave out of $1,299.\n  agency: 58_000,\n  enterprise: ENTERPRISE_ASSIST_CREDITS_PER_MONTH,\n}\n\n/** The AI plugin's plan figures, for the manifest generator. */\nexport function aiPlanEntitlements(): PluginPlanEntitlementsDeclaration {\n  return {\n    quotas: [\n      {\n        key: 'assistCreditsPerMonth',\n        label: 'AI credits / mo',\n        byPlan: AI_CREDITS_BY_PLAN,\n      },\n    ],\n  }\n}\n"],"names":["ENTERPRISE_ASSIST_CREDITS_PER_MONTH","FREE_AI_TASTE_CREDITS_PER_MONTH","AI_CREDITS_BY_PLAN","free","starter","pro","business","scale","advanced","agency","enterprise","aiPlanEntitlements","quotas","key","label","byPlan"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,6EAA6E;AAC7E,2EAA2E;AAC3E,qEAAqE;AAyDrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCC,GACD,OAAO,MAAMA,sCAAsC,OAAO;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCC,GACD,OAAO,MAAMC,kCAAkC,IAAG;AAElD,4EAA4E,GAC5E,OAAO,MAAMC,qBAAwD;IACnE,0EAA0E;IAC1E,2EAA2E;IAC3E,oCAAoC;IACpCC,MAAMF;IACN,2EAA2E;IAC3E,4EAA4E;IAC5E,oEAAoE;IACpE,2EAA2E;IAC3E,wEAAwE;IACxE,oEAAoE;IACpE,EAAE;IACF,4EAA4E;IAC5E,4EAA4E;IAC5E,2EAA2E;IAC3E,0EAA0E;IAC1E,4DAA4D;IAC5D,wDAAwD;IACxD,EAAE;IACF,yDAAyD;IACzD,yEAAyE;IACzE,4EAA4E;IAC5E,yEAAyE;IACzE,4DAA4D;IAC5D,EAAE;IACF,sEAAsE;IACtE,2EAA2E;IAC3E,4EAA4E;IAC5E,0EAA0E;IAC1E,yEAAyE;IACzE,yEAAyE;IACzE,wEAAwE;IACxE,uEAAuE;IACvE,cAAc;IACd,EAAE;IACF,2EAA2E;IAC3E,mEAAmE;IACnE,2EAA2E;IAC3E,2EAA2E;IAC3E,OAAO;IACP,EAAE;IACF,wEAAwE;IACxE,uEAAuE;IACvE,wEAAwE;IACxE,EAAE;IACF,qEAAqE;IACrE,sCAAsC;IACtCG,SAAS;IACT,yEAAyE;IACzE,2EAA2E;IAC3E,oCAAoC;IACpCC,KAAK;IACL,qEAAqE;IACrEC,UAAU;IACV,sEAAsE;IACtEC,OAAO;IACP,2EAA2E;IAC3E,sEAAsE;IACtE,+BAA+B;IAC/BC,UAAU;IACV,yEAAyE;IACzEC,QAAQ;IACRC,YAAYV;AACd,EAAC;AAED,8DAA8D,GAC9D,OAAO,SAASW;IACd,OAAO;QACLC,QAAQ;YACN;gBACEC,KAAK;gBACLC,OAAO;gBACPC,QAAQb;YACV;SACD;IACH;AACF"}
+{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/plan-entitlements.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// Types only: the manifest generator loads this module on its own to compile\n// the plan figures, before the catalog file core reads them from exists in\n// its new shape, so nothing here may reach a core module at runtime.\nimport type { OrgPlan } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport type { PluginPlanEntitlementsDeclaration } from '@aglyn/aglyn/plugin-manager/plugin-plan-entitlements'\n\n/**\n * THE AI PLUGIN'S PLAN BAND (AGL-3080): how many AI credits each plan\n * includes a month. Compiled into core's `PLAN_ENTITLEMENTS` by the manifest\n * generator (`register.planEntitlements`), so `/pricing`, the plan comparison\n * and every gate read the same figure they always have; this is where it is\n * written, beside the reasoning that sized it.\n */\ndeclare module '@aglyn/aglyn/plugin-manager/plugin-entitlement-keys' {\n  interface PluginEntitlementQuotas {\n    /**\n     * AI credits per calendar month — the band assist spends against.\n     *\n     * A CREDIT IS A UNIT OF MODEL COST, not a message. One assist action can\n     * cost two orders of magnitude more than another: a question is a few\n     * thousand tokens, while generating a screen carries the node tree, the\n     * component catalog and the theme tokens in, structured markup out, and\n     * iterates. A message allowance would price those the same, so one\n     * workspace's ten screen builds would outspend another's thousand\n     * questions and both would read as \"within allowance\".\n     *\n     * The unit is defined by `ASSIST_CREDIT_COST_USD` and the conversion\n     * lives in `assist-credits.ts`. Only that module turns credits into\n     * dollars; everything a customer sees counts credits, because the dollar\n     * figure behind them is our provider bill and not a price.\n     *\n     * ## HOW THE BAND IS SIZED, and why it is not a share of the price\n     *\n     * A credit is a dollar of provider spend at `ASSIST_CREDIT_COST_USD`, so\n     * the band IS a liability figure: the plan's whole assist give is\n     * `assistCreditsPerMonth / 1000` dollars. Credits past it are not a give\n     * — since AGL-2653 they are SOLD at `extraAssistCreditsUsdPer1k`, unless\n     * the org's `assistOverage.hardCap` asks `reserveAssistMessage` to refuse\n     * at the band instead. Sizing it as a share of the subscription price\n     * says nothing about whether the tier can afford it, because the price is\n     * also carrying storage, bandwidth, form submissions, dataset storage,\n     * API requests, contacts and email.\n     *\n     * So each band is sized against what those SEVEN other terms leave.\n     * Every paid band takes between a quarter and a third of that remainder,\n     * which keeps the tier's worst case positive and keeps the ladder's\n     * shape: the margin each tier holds at 100% of every band stays in\n     * proportion to what it held before assist was sold at all.\n     * `tier-margin-floor.spec.ts` is the model, and it pins both the rule and\n     * the resulting figures.\n     *\n     * ONE POOL FOR EVERYTHING (AGL-3965): this band pays for every Aglyn AI\n     * action, generation included, on every plan. An Aglyn AI tier adds its\n     * credits (`AI_TIERS[tier].credits`) to it in `resolveOrgEntitlements`\n     * — one pool, widened, rather than a second meter.\n     */\n    assistCreditsPerMonth?: number\n  }\n}\n\n/**\n * AI credits an Enterprise agreement includes per month, before the contract\n * says otherwise.\n *\n * ## Never `UNLIMITED`, and the reason is not stylistic\n *\n * `UNLIMITED` is `Number.POSITIVE_INFINITY`, `JSON.stringify(Infinity)` is\n * `null`, and `Number(null)` is `0`. An unbounded assist band therefore\n * serialises to a band of ZERO through every route that does not also send\n * the explicit flag `restoreQuotaLimit` rebuilds from — which would hand the\n * only customers with a signed contract the one budget that refuses\n * everything. A finite number crosses the wire as itself.\n *\n * The band is also a real liability rather than a capacity we already own.\n * Storage and page views are infrastructure metered into the deal; assist is\n * a per-token charge from a third party, and generative building spends it in\n * units two orders of magnitude apart.\n *\n * ## Why this number\n *\n * Enterprise carries no list price, so the band cannot be sized the way every\n * self-serve tier's is — against what that tier's other cost terms leave out\n * of a known price. It is anchored to the top of the ladder instead: 116,000\n * credits is twice Agency's band, the rule every Enterprise fallback follows\n * since the 2026-09-07 pricing decision (see the `enterprise` row of\n * `PLAN_ENTITLEMENTS`). In cost that is $116 of provider spend a month, or\n * under 9% of any deal priced at or above the self-serve top. A deal below\n * that is sold as Agency, not written as an Enterprise agreement.\n *\n * ## It is a DEFAULT, and a contract raises it\n *\n * `resolveOrgEntitlements` applies a per-org\n * `entitlements.assistCreditsPerMonth` override ahead of this, so a deal that\n * buys more assist buys it on that org without moving the figure every other\n * agreement is measured against — the same mechanism the other contracted\n * bands use.\n */\nexport const ENTERPRISE_ASSIST_CREDITS_PER_MONTH = 116_000\n\n/**\n * The Free AI taste (AGL-2925): the credits a Free workspace draws on each\n * month, behind a hard wall.\n *\n * ## Why it exists\n *\n * So the AI landing pages can say \"generate your first page free\" and mean\n * it. Three hundred credits is one or two generated sections or a handful of\n * copy rewrites — enough to see what the assistant does, not enough to build\n * a site on. The band is a WALL: `PLAN_PRICING.free\n * .extraAssistCreditsUsdPer1k` stays `null`, so `assistBandRefuses` answers\n * true and the reservation refuses at 100% with no overage, no switch and no\n * invoice. Nothing about a Free workspace can produce a charge.\n *\n * ## What it costs, and why that is the number\n *\n * A credit is `ASSIST_CREDIT_COST_USD` of provider spend, so the band costs\n * at most **$0.30 per Free workspace per month** — asserted by\n * `apps/console/specs/tier-margin-floor.spec.ts`. It is the one AI band with\n * no invoice behind it, which is why the same issue closes every multiplier\n * a script could use before the flag flips:\n *\n *  - it is metered per ACCOUNT as well as per workspace, so the three free\n *    workspaces an account may hold (AGL-2265) share one 300-credit\n *    allowance rather than tripling it (`reserveAssistMessage`);\n *  - every free request is bounded per IP, per uid and per account per\n *    day (a minimum account age, `AI_FREE_MIN_ACCOUNT_AGE_HOURS`, is\n *    available and off by default — AGL-3591);\n *  - a platform-wide daily ceiling on free spend pauses the taste for\n *    everyone until the UTC day rolls, paid workspaces untouched.\n *\n * The account allowance reads THIS constant rather than the workspace's\n * resolved band, because a staff override that widens one workspace's band\n * is a decision about that workspace, not about how much one person may draw\n * across all of theirs.\n */\nexport const FREE_AI_TASTE_CREDITS_PER_MONTH = 300\n\n/** The AI credits each plan includes a month — see the key's own docblock. */\nexport const AI_CREDITS_BY_PLAN: Readonly<Record<OrgPlan, number>> = {\n  // The Free AI taste (AGL-2925): a real band, and a wall. See the constant\n  // for what it buys, what it costs and the precautions that keep one person\n  // from drawing it three times over.\n  free: FREE_AI_TASTE_CREDITS_PER_MONTH,\n  // The first paid rung of the assist ladder (AGL-3203). Starter banded at 0\n  // until 2026-09-20, which put a PAYING workspace below the Free taste's 300\n  // on the one axis a visitor compares straight down the column — the\n  // `/pricing` row read `300 / mo` for Free and `—` for Starter. A paid plan\n  // that includes less of something than the free plan is not a packaging\n  // subtlety; it is the comparison table arguing against the upgrade.\n  //\n  // 750 is deliberately small: 2.5x the taste, enough that the assistant is a\n  // thing the tier HAS rather than a thing it is shown, and $0.75 of provider\n  // spend a month at `ASSIST_CREDIT_COST_USD` against a $16 annual price — a\n  // twentieth of the $8.81 the tier's other metered bands already cost, and\n  // the widest margin on the ladder absorbs it with room left\n  // (`tier-margin-floor.spec.ts` carries the arithmetic).\n  //\n  // It is NOT a wall, unlike Free's: `PLAN_PRICING.starter\n  // .extraAssistCreditsUsdPer1k` is $3.00, so past 750 the tier meters and\n  // bills like every paid plan above it. The two fields move together by rule\n  // — a positive band with no rate beside it is usage past a bound that is\n  // silently free, which `plan-entitlements.spec.ts` forbids.\n  //\n  // `features.aiAssist` is TRUE, and AGL-3203 shipping it false was the\n  // defect AGL-3207 closes. The reasoning then was \"the band is credits, not\n  // the guided rung, exactly as on Free\" — but on Free the band IS spendable,\n  // through `aiGenerative`, which is the door the taste exists for. Starter\n  // carried neither flag, so it was the only row on the ladder sold a band\n  // with nothing to spend it through: 750 credits reachable only by buying\n  // the $9 add-on that was also the only thing that made them usable. \"No\n  // plan bands at zero any more\" was true of the number and false of the\n  // capability.\n  //\n  // Since AGL-3965 it opens `aiGenerative` too, as every paid rung does: the\n  // included band pays for generation and assist alike (one pool), and an\n  // Aglyn AI tier adds credits on top rather than opening a door.\n  //\n  // No cost moves: `tier-margin-floor.spec.ts` already prices this tier's\n  // assist term at 100% burn of the 750 credits, 75¢/mo. A door does not\n  // widen a band; it only makes spend that was already modeled reachable.\n  starter: 750,\n  // $2.75 of provider spend, against the $8.35 the tier's other seven cost\n  // terms leave out of $56. See the key's docblock for why the remainder and\n  // not the price is what sizes this.\n  pro: 2_750,\n  // $7.50, against the $22.69 the other seven terms leave out of $139.\n  business: 7_500,\n  // $10.00, against the $30.62 the other seven terms leave out of $249.\n  scale: 10_000,\n  // $13.00, against the $39.74 the other seven terms leave out of $399 — the\n  // thinnest remainder on the ladder, and the tier that binds the whole\n  // assist ladder's share of it.\n  advanced: 13_000,\n  // $58.00, against the $176.71 the other seven terms leave out of $1,299.\n  agency: 58_000,\n  enterprise: ENTERPRISE_ASSIST_CREDITS_PER_MONTH,\n}\n\n/** The AI plugin's plan figures, for the manifest generator. */\nexport function aiPlanEntitlements(): PluginPlanEntitlementsDeclaration {\n  return {\n    quotas: [\n      {\n        key: 'assistCreditsPerMonth',\n        label: 'AI credits / mo',\n        byPlan: AI_CREDITS_BY_PLAN,\n      },\n    ],\n  }\n}\n"],"names":["ENTERPRISE_ASSIST_CREDITS_PER_MONTH","FREE_AI_TASTE_CREDITS_PER_MONTH","AI_CREDITS_BY_PLAN","free","starter","pro","business","scale","advanced","agency","enterprise","aiPlanEntitlements","quotas","key","label","byPlan"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,6EAA6E;AAC7E,2EAA2E;AAC3E,qEAAqE;AA0DrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCC,GACD,OAAO,MAAMA,sCAAsC,OAAO;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCC,GACD,OAAO,MAAMC,kCAAkC,IAAG;AAElD,4EAA4E,GAC5E,OAAO,MAAMC,qBAAwD;IACnE,0EAA0E;IAC1E,2EAA2E;IAC3E,oCAAoC;IACpCC,MAAMF;IACN,2EAA2E;IAC3E,4EAA4E;IAC5E,oEAAoE;IACpE,2EAA2E;IAC3E,wEAAwE;IACxE,oEAAoE;IACpE,EAAE;IACF,4EAA4E;IAC5E,4EAA4E;IAC5E,2EAA2E;IAC3E,0EAA0E;IAC1E,4DAA4D;IAC5D,wDAAwD;IACxD,EAAE;IACF,yDAAyD;IACzD,yEAAyE;IACzE,4EAA4E;IAC5E,yEAAyE;IACzE,4DAA4D;IAC5D,EAAE;IACF,sEAAsE;IACtE,2EAA2E;IAC3E,4EAA4E;IAC5E,0EAA0E;IAC1E,yEAAyE;IACzE,yEAAyE;IACzE,wEAAwE;IACxE,uEAAuE;IACvE,cAAc;IACd,EAAE;IACF,2EAA2E;IAC3E,wEAAwE;IACxE,gEAAgE;IAChE,EAAE;IACF,wEAAwE;IACxE,uEAAuE;IACvE,wEAAwE;IACxEG,SAAS;IACT,yEAAyE;IACzE,2EAA2E;IAC3E,oCAAoC;IACpCC,KAAK;IACL,qEAAqE;IACrEC,UAAU;IACV,sEAAsE;IACtEC,OAAO;IACP,2EAA2E;IAC3E,sEAAsE;IACtE,+BAA+B;IAC/BC,UAAU;IACV,yEAAyE;IACzEC,QAAQ;IACRC,YAAYV;AACd,EAAC;AAED,8DAA8D,GAC9D,OAAO,SAASW;IACd,OAAO;QACLC,QAAQ;YACN;gBACEC,KAAK;gBACLC,OAAO;gBACPC,QAAQb;YACV;SACD;IACH;AACF"}

package/src/lib/runtime/ai-dataset-generation.d.ts

@@ -71,7 +71,14 @@ export interface GenerateAiDatasetInput extends AiDatasetPromptInput {
 }
 /** Design one dataset. It writes nothing to the site. */
 export declare function generateAiDataset(input: GenerateAiDatasetInput): Promise<AiValidatedGeneration<AiDataset>>;
-/** A designed dataset as the data plugin's `dataset` writer takes it: values by field name. */
+/**
+ * A designed dataset as the data plugin's `dataset` writer takes it: values by
+ * field name. Its words' "a" and "an" agree with what follows them in English
+ * (`aiLayoutArticles`, AGL-3988), as a page's do: the beta.270 Sugar Hollow
+ * packages said "A easygoing session" in their records and on every page
+ * that listed them.
+ */
 export declare function aiDatasetDraftContent(name: string, dataset: AiDataset, options: {
     recordPages: boolean;
+    language?: string | null;
 }): Record<string, unknown>;

package/src/lib/runtime/ai-dataset-generation.js

@@ -17,6 +17,7 @@
 import { AI_ROUTING_TABLE } from "../providers/routing.js";
 import { AI_DATASET_LIMITS, AI_DATASET_LIST_SEPARATOR, AI_DATASET_TOOL, AI_DATASET_TOOL_NAME, checkAiDataset } from "../tools/ai-dataset-tool.js";
 import { runValidatedGeneration } from "./ai-doctrine.js";
+import { aiLayoutArticles } from "../layout-language/ai-layout-copy.js";
 /**
  * A SITE'S DATASETS (AGL-3616): the typed fields and first records of one
  * dataset a site plan created, through the doctrine's generation call and the
@@ -95,7 +96,14 @@ import { runValidatedGeneration } from "./ai-doctrine.js";
             })
     }));
 }
-/** A designed dataset as the data plugin's `dataset` writer takes it: values by field name. */ export function aiDatasetDraftContent(name, dataset, options) {
+/**
+ * A designed dataset as the data plugin's `dataset` writer takes it: values by
+ * field name. Its words' "a" and "an" agree with what follows them in English
+ * (`aiLayoutArticles`, AGL-3988), as a page's do: the beta.270 Sugar Hollow
+ * packages said "A easygoing session" in their records and on every page
+ * that listed them.
+ */ export function aiDatasetDraftContent(name, dataset, options) {
+    const said = (value)=>aiLayoutArticles(value, options.language);
     const records = dataset.records.map((values)=>{
         const record = {};
         dataset.fields.forEach((field, column)=>{
@@ -103,9 +111,11 @@ import { runValidatedGeneration } from "./ai-doctrine.js";
             const value = ((_values_column = values[column]) != null ? _values_column : '').trim();
             if (!value) return;
             if (field.type === 'list') {
-                record[field.name] = value.split(AI_DATASET_LIST_SEPARATOR.trim()).map((part)=>part.trim()).filter(Boolean);
+                record[field.name] = value.split(AI_DATASET_LIST_SEPARATOR.trim()).map((part)=>said(part.trim())).filter(Boolean);
             } else if (field.type === 'number' || field.type === 'integer') {
                 record[field.name] = value.replace(/,/g, '');
+            } else if (field.type === 'text') {
+                record[field.name] = said(value);
             } else {
                 record[field.name] = value;
             }

package/src/lib/runtime/ai-dataset-generation.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/runtime/ai-dataset-generation.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { AiStepKind } from '../providers/catalog'\nimport type { AiProvider } from '../providers/contract'\nimport { AI_ROUTING_TABLE, type AiPluginSettings } from '../providers/routing'\nimport {\n  AI_DATASET_LIMITS,\n  AI_DATASET_LIST_SEPARATOR,\n  AI_DATASET_TOOL,\n  AI_DATASET_TOOL_NAME,\n  checkAiDataset,\n  type AiDataset,\n} from '../tools/ai-dataset-tool'\nimport { runValidatedGeneration, type AiValidatedGeneration } from './ai-doctrine'\nimport type { AiSystemBlock } from './ai-runtime'\n\n/**\n * A SITE'S DATASETS (AGL-3616): the typed fields and first records of one\n * dataset a site plan created, through the doctrine's generation call and the\n * strict `submit_dataset` tool. The data plugin's writer stores what it\n * answers; nothing here writes.\n *\n * Routed as `job.products`, the row a store's first products are proposed on\n * (no thinking, a structured list from a brief, held to the storefront claim\n * rules): one dataset of a dozen records is the same work. Its answer is held\n * to a ceiling of its own under that row's. The rules are cached and\n * byte-identical; the site's words, the dataset and the pages that show it\n * ride in the user turn.\n */\n\n/** The step a dataset is routed as. */\nexport const AI_DATASET_STEP: AiStepKind = 'job.products'\n\n/**\n * One dataset's answer ceiling: twelve fields and twelve records of a few\n * sentences each, written as JSON, about 9,000 characters at three a token\n * with room; under the routing row's.\n */\nexport const AI_DATASET_MAX_TOKENS = Math.min(4_000, AI_ROUTING_TABLE[AI_DATASET_STEP].maxTokens)\n\n/** The generation kind a dataset is asked under, which the doctrine scopes. */\nexport const AI_DATASET_KIND = 'dataset'\n\n/** The rules for one dataset. Byte-identical on every request. */\nexport const AI_DATASET_INSTRUCTIONS: AiSystemBlock[] = [\n  {\n    text:\n      'You design one dataset of a new website: a list of like things — a menu, a team, services, portfolio pieces, events, questions and answers — kept as records the owner edits in one place, which the site’s pages list.\\n\\n' +\n      `Answer by calling ${AI_DATASET_TOOL_NAME} exactly once. A reply in prose cannot be used.\\n\\n` +\n      'Rules:\\n' +\n      [\n        'Keep the planned fields, in order and named exactly as planned; the pages around the dataset already name them. Add a field only where the records clearly need it.',\n        'Type each field: text for words, including a date or a time written the way a visitor reads it; number or integer only for a figure a visitor compares; boolean for yes or no; list for a few short tags. The first field names each record and is text.',\n        `Write ${AI_DATASET_LIMITS.recordsMin} to ${AI_DATASET_LIMITS.recordsMax} records, as many as the brief supports: what the business actually offers, in its own words where the brief gives them, otherwise plain and general enough to be true of it.`,\n        'Never invent a fact: no price, date, address, phone number, award, credential, client or number the brief does not give, and no review, testimonial, rating or quote from anyone. Leave a value \"\" rather than make one up.',\n        'Never give a person a name the brief does not give: a team member the brief does not name is their role, such as \"Head chef\".',\n        'Never say anything cures, treats, heals or prevents anything, and never promise a health, financial or legal result.',\n        `Values are plain text with no links, markup, emoji or square brackets, at most ${AI_DATASET_LIMITS.valueMax} characters each; a description is one to three sentences.`,\n        'Write in the language of the brief.',\n      ]\n        .map((rule) => `- ${rule}`)\n        .join('\\n'),\n    cacheBreakpoint: true,\n  },\n]\n\nexport interface AiDatasetPromptInput {\n  /** The site's words: the brief and its answers, as a unit's brief carries them. */\n  brief: string\n  /** The dataset as the plan named it, and why it has one. */\n  name: string\n  why: string\n  /** The field names the plan gave it. */\n  fields: readonly string[]\n  /** The sections that list it, by page: \"Menu › Our dishes (12 items)\". */\n  shownIn: readonly string[]\n  /** Whether each record also gets a page of its own. */\n  recordPages: boolean\n}\n\n/** The user turn: the site's words, the dataset, and where it is shown. */\nexport function aiDatasetPrompt(input: AiDatasetPromptInput): string {\n  return [\n    'Brief:',\n    input.brief.trim(),\n    `Dataset: “${input.name}” — ${input.why.trim() || 'the site’s structured content'}`,\n    `Planned fields: ${input.fields.length ? input.fields.map((field) => `“${field}”`).join(', ') : '(none: choose them)'}`,\n    input.shownIn.length ? `Listed on: ${input.shownIn.join('; ')}.` : 'Listed on the site’s pages.',\n    input.recordPages\n      ? 'Each record also gets a page of its own, so give each one enough to read: a sentence or two describing it.'\n      : 'Each record is shown as a card, so keep its values short.',\n  ].join('\\n')\n}\n\nexport interface GenerateAiDatasetInput extends AiDatasetPromptInput {\n  /** What a claim or a price may be quoted from: the brief and the site's answers. */\n  merchantWords: string\n  settings?: AiPluginSettings\n  model?: string\n  maxTokens?: number\n  signal?: AbortSignal\n  provider?: AiProvider\n}\n\n/** Design one dataset. It writes nothing to the site. */\nexport function generateAiDataset(input: GenerateAiDatasetInput): Promise<AiValidatedGeneration<AiDataset>> {\n  const row = AI_ROUTING_TABLE[AI_DATASET_STEP]\n  return runValidatedGeneration(AI_DATASET_KIND, {\n    step: AI_DATASET_STEP,\n    ...(input.settings ? { settings: input.settings } : {}),\n    ...(input.model ? { model: input.model } : {}),\n    instructions: AI_DATASET_INSTRUCTIONS,\n    messages: [{ role: 'user', content: aiDatasetPrompt(input) }],\n    tool: AI_DATASET_TOOL,\n    maxTokens: input.maxTokens ?? AI_DATASET_MAX_TOKENS,\n    ...(row.thinking ? { thinking: row.thinking } : {}),\n    ...(row.effort ? { effort: row.effort } : {}),\n    ...(input.signal ? { signal: input.signal } : {}),\n    ...(input.provider ? { provider: input.provider } : {}),\n    check: (answer) => checkAiDataset(answer, { planned: input.fields, merchantWords: input.merchantWords }),\n  }) as Promise<AiValidatedGeneration<AiDataset>>\n}\n\n/** A designed dataset as the data plugin's `dataset` writer takes it: values by field name. */\nexport function aiDatasetDraftContent(\n  name: string,\n  dataset: AiDataset,\n  options: { recordPages: boolean },\n): Record<string, unknown> {\n  const records = dataset.records.map((values) => {\n    const record: Record<string, unknown> = {}\n    dataset.fields.forEach((field, column) => {\n      const value = (values[column] ?? '').trim()\n      if (!value) return\n      if (field.type === 'list') {\n        record[field.name] = value.split(AI_DATASET_LIST_SEPARATOR.trim()).map((part) => part.trim()).filter(Boolean)\n      } else if (field.type === 'number' || field.type === 'integer') {\n        record[field.name] = value.replace(/,/g, '')\n      } else {\n        record[field.name] = value\n      }\n    })\n    return record\n  })\n  return {\n    name,\n    fields: dataset.fields.map((field) => ({ name: field.name, type: field.type })),\n    records,\n    // A record page shows each record at an address made from its name.\n    ...(options.recordPages && dataset.fields[0] ? { pageAddressFrom: dataset.fields[0].name } : {}),\n  }\n}\n"],"names":["AI_ROUTING_TABLE","AI_DATASET_LIMITS","AI_DATASET_LIST_SEPARATOR","AI_DATASET_TOOL","AI_DATASET_TOOL_NAME","checkAiDataset","runValidatedGeneration","AI_DATASET_STEP","AI_DATASET_MAX_TOKENS","Math","min","maxTokens","AI_DATASET_KIND","AI_DATASET_INSTRUCTIONS","text","recordsMin","recordsMax","valueMax","map","rule","join","cacheBreakpoint","aiDatasetPrompt","input","brief","trim","name","why","fields","length","field","shownIn","recordPages","generateAiDataset","row","step","settings","model","instructions","messages","role","content","tool","thinking","effort","signal","provider","check","answer","planned","merchantWords","aiDatasetDraftContent","dataset","options","records","values","record","forEach","column","value","type","split","part","filter","Boolean","replace","pageAddressFrom"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/runtime/ai-dataset-generation.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { AiStepKind } from '../providers/catalog'\nimport type { AiProvider } from '../providers/contract'\nimport { AI_ROUTING_TABLE, type AiPluginSettings } from '../providers/routing'\nimport {\n  AI_DATASET_LIMITS,\n  AI_DATASET_LIST_SEPARATOR,\n  AI_DATASET_TOOL,\n  AI_DATASET_TOOL_NAME,\n  checkAiDataset,\n  type AiDataset,\n} from '../tools/ai-dataset-tool'\nimport { runValidatedGeneration, type AiValidatedGeneration } from './ai-doctrine'\nimport { aiLayoutArticles } from '../layout-language/ai-layout-copy'\nimport type { AiSystemBlock } from './ai-runtime'\n\n/**\n * A SITE'S DATASETS (AGL-3616): the typed fields and first records of one\n * dataset a site plan created, through the doctrine's generation call and the\n * strict `submit_dataset` tool. The data plugin's writer stores what it\n * answers; nothing here writes.\n *\n * Routed as `job.products`, the row a store's first products are proposed on\n * (no thinking, a structured list from a brief, held to the storefront claim\n * rules): one dataset of a dozen records is the same work. Its answer is held\n * to a ceiling of its own under that row's. The rules are cached and\n * byte-identical; the site's words, the dataset and the pages that show it\n * ride in the user turn.\n */\n\n/** The step a dataset is routed as. */\nexport const AI_DATASET_STEP: AiStepKind = 'job.products'\n\n/**\n * One dataset's answer ceiling: twelve fields and twelve records of a few\n * sentences each, written as JSON, about 9,000 characters at three a token\n * with room; under the routing row's.\n */\nexport const AI_DATASET_MAX_TOKENS = Math.min(4_000, AI_ROUTING_TABLE[AI_DATASET_STEP].maxTokens)\n\n/** The generation kind a dataset is asked under, which the doctrine scopes. */\nexport const AI_DATASET_KIND = 'dataset'\n\n/** The rules for one dataset. Byte-identical on every request. */\nexport const AI_DATASET_INSTRUCTIONS: AiSystemBlock[] = [\n  {\n    text:\n      'You design one dataset of a new website: a list of like things — a menu, a team, services, portfolio pieces, events, questions and answers — kept as records the owner edits in one place, which the site’s pages list.\\n\\n' +\n      `Answer by calling ${AI_DATASET_TOOL_NAME} exactly once. A reply in prose cannot be used.\\n\\n` +\n      'Rules:\\n' +\n      [\n        'Keep the planned fields, in order and named exactly as planned; the pages around the dataset already name them. Add a field only where the records clearly need it.',\n        'Type each field: text for words, including a date or a time written the way a visitor reads it; number or integer only for a figure a visitor compares; boolean for yes or no; list for a few short tags. The first field names each record and is text.',\n        `Write ${AI_DATASET_LIMITS.recordsMin} to ${AI_DATASET_LIMITS.recordsMax} records, as many as the brief supports: what the business actually offers, in its own words where the brief gives them, otherwise plain and general enough to be true of it.`,\n        'Never invent a fact: no price, date, address, phone number, award, credential, client or number the brief does not give, and no review, testimonial, rating or quote from anyone. Leave a value \"\" rather than make one up.',\n        'Never give a person a name the brief does not give: a team member the brief does not name is their role, such as \"Head chef\".',\n        'Never say anything cures, treats, heals or prevents anything, and never promise a health, financial or legal result.',\n        `Values are plain text with no links, markup, emoji or square brackets, at most ${AI_DATASET_LIMITS.valueMax} characters each; a description is one to three sentences.`,\n        'Write in the language of the brief.',\n      ]\n        .map((rule) => `- ${rule}`)\n        .join('\\n'),\n    cacheBreakpoint: true,\n  },\n]\n\nexport interface AiDatasetPromptInput {\n  /** The site's words: the brief and its answers, as a unit's brief carries them. */\n  brief: string\n  /** The dataset as the plan named it, and why it has one. */\n  name: string\n  why: string\n  /** The field names the plan gave it. */\n  fields: readonly string[]\n  /** The sections that list it, by page: \"Menu › Our dishes (12 items)\". */\n  shownIn: readonly string[]\n  /** Whether each record also gets a page of its own. */\n  recordPages: boolean\n}\n\n/** The user turn: the site's words, the dataset, and where it is shown. */\nexport function aiDatasetPrompt(input: AiDatasetPromptInput): string {\n  return [\n    'Brief:',\n    input.brief.trim(),\n    `Dataset: “${input.name}” — ${input.why.trim() || 'the site’s structured content'}`,\n    `Planned fields: ${input.fields.length ? input.fields.map((field) => `“${field}”`).join(', ') : '(none: choose them)'}`,\n    input.shownIn.length ? `Listed on: ${input.shownIn.join('; ')}.` : 'Listed on the site’s pages.',\n    input.recordPages\n      ? 'Each record also gets a page of its own, so give each one enough to read: a sentence or two describing it.'\n      : 'Each record is shown as a card, so keep its values short.',\n  ].join('\\n')\n}\n\nexport interface GenerateAiDatasetInput extends AiDatasetPromptInput {\n  /** What a claim or a price may be quoted from: the brief and the site's answers. */\n  merchantWords: string\n  settings?: AiPluginSettings\n  model?: string\n  maxTokens?: number\n  signal?: AbortSignal\n  provider?: AiProvider\n}\n\n/** Design one dataset. It writes nothing to the site. */\nexport function generateAiDataset(input: GenerateAiDatasetInput): Promise<AiValidatedGeneration<AiDataset>> {\n  const row = AI_ROUTING_TABLE[AI_DATASET_STEP]\n  return runValidatedGeneration(AI_DATASET_KIND, {\n    step: AI_DATASET_STEP,\n    ...(input.settings ? { settings: input.settings } : {}),\n    ...(input.model ? { model: input.model } : {}),\n    instructions: AI_DATASET_INSTRUCTIONS,\n    messages: [{ role: 'user', content: aiDatasetPrompt(input) }],\n    tool: AI_DATASET_TOOL,\n    maxTokens: input.maxTokens ?? AI_DATASET_MAX_TOKENS,\n    ...(row.thinking ? { thinking: row.thinking } : {}),\n    ...(row.effort ? { effort: row.effort } : {}),\n    ...(input.signal ? { signal: input.signal } : {}),\n    ...(input.provider ? { provider: input.provider } : {}),\n    check: (answer) => checkAiDataset(answer, { planned: input.fields, merchantWords: input.merchantWords }),\n  }) as Promise<AiValidatedGeneration<AiDataset>>\n}\n\n/**\n * A designed dataset as the data plugin's `dataset` writer takes it: values by\n * field name. Its words' \"a\" and \"an\" agree with what follows them in English\n * (`aiLayoutArticles`, AGL-3988), as a page's do: the beta.270 Sugar Hollow\n * packages said \"A easygoing session\" in their records and on every page\n * that listed them.\n */\nexport function aiDatasetDraftContent(\n  name: string,\n  dataset: AiDataset,\n  options: { recordPages: boolean; language?: string | null },\n): Record<string, unknown> {\n  const said = (value: string) => aiLayoutArticles(value, options.language)\n  const records = dataset.records.map((values) => {\n    const record: Record<string, unknown> = {}\n    dataset.fields.forEach((field, column) => {\n      const value = (values[column] ?? '').trim()\n      if (!value) return\n      if (field.type === 'list') {\n        record[field.name] = value.split(AI_DATASET_LIST_SEPARATOR.trim()).map((part) => said(part.trim())).filter(Boolean)\n      } else if (field.type === 'number' || field.type === 'integer') {\n        record[field.name] = value.replace(/,/g, '')\n      } else if (field.type === 'text') {\n        record[field.name] = said(value)\n      } else {\n        record[field.name] = value\n      }\n    })\n    return record\n  })\n  return {\n    name,\n    fields: dataset.fields.map((field) => ({ name: field.name, type: field.type })),\n    records,\n    // A record page shows each record at an address made from its name.\n    ...(options.recordPages && dataset.fields[0] ? { pageAddressFrom: dataset.fields[0].name } : {}),\n  }\n}\n"],"names":["AI_ROUTING_TABLE","AI_DATASET_LIMITS","AI_DATASET_LIST_SEPARATOR","AI_DATASET_TOOL","AI_DATASET_TOOL_NAME","checkAiDataset","runValidatedGeneration","aiLayoutArticles","AI_DATASET_STEP","AI_DATASET_MAX_TOKENS","Math","min","maxTokens","AI_DATASET_KIND","AI_DATASET_INSTRUCTIONS","text","recordsMin","recordsMax","valueMax","map","rule","join","cacheBreakpoint","aiDatasetPrompt","input","brief","trim","name","why","fields","length","field","shownIn","recordPages","generateAiDataset","row","step","settings","model","instructions","messages","role","content","tool","thinking","effort","signal","provider","check","answer","planned","merchantWords","aiDatasetDraftContent","dataset","options","said","value","language","records","values","record","forEach","column","type","split","part","filter","Boolean","replace","pageAddressFrom"],"mappings":"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"}

package/src/lib/runtime/ai-doctrine-validators.d.ts

@@ -1242,39 +1242,32 @@ export declare function aiFreePageSectionsWithin(creations: {
     pages?: number;
 }, credits?: Readonly<AiFreePageWorstCase>): number;
 /**
- * The most sections past the Free wall a plan is trimmed by rather than
- * re-asked (AGL-3737). The live candle-shop start of 2026-10-12 planned 9
- * sections against a wall of 8 on all three answers, each with a home of 7:
- * the model reaching for the budget the site redo names ("plan 7 to 8") and
- * landing one band past it, which no re-ask cured. Within two, the plan's
- * shape is right and only a band or two the brief needs least is extra, so
- * taking those from the end loses nothing the plan depends on. Further over,
- * the shape itself is off — a list planned as sections, a page the wall
- * cannot pay for — and cutting more would drop content the model meant, so
- * that plan is still re-asked.
- */
-export declare const AI_FREE_WALL_SETTLE_MAX_OVER = 2;
-/**
- * A Free plan a section or two past the wall is trimmed to fit before the
- * rules read the plan (AGL-3737), rather than re-asked: which sections go has
- * one answer, so the re-ask only costs the member a stopped start. The live
- * candle-shop start of 2026-10-12 asked for a home of 7 and a second page of
- * 2 against a wall of 8, three answers running, and stopped needing input.
- *
- * One section goes at a time, the last of its page that `freeWallKeeps`
- * does not hold, from the page furthest past its share: the home at / past
- * its fewest (`aiSiteHomeMinSections`, five on a site start whose wall pays
- * for a full home), any other page past two; on a tie, the longer page, then
- * the home. No home goes under its fewest and no page under one section. The
- * shares are what a site start is told to plan (a home of five or six, the
- * other page two or three): the candle shop's 7 + 2 becomes 6 + 2, never
- * 7 + 1, and the recorded yoga answer's 6 + 4 becomes 5 + 3, the shape its
- * own redo chose.
- *
- * A plan more than `AI_FREE_WALL_SETTLE_MAX_OVER` past the wall, a site
- * start past its page cap, a plan with a list split into sections, and a
- * plan the trim cannot fit without a section it keeps are returned
- * unchanged, for the wall to re-ask.
+ * A Free plan past the wall is trimmed to the wall before the rules read the
+ * plan (AGL-3737, AGL-3969), rather than re-asked: a plan over its budget is
+ * the model's mistake, never the member's, and which sections go has one
+ * answer. The live candle-shop start of 2026-10-12 asked for a home of 7 and
+ * a second page of 2 against a wall of 8, three answers running, and stopped
+ * needing input; the Free candle shop of the beta.265 eval asked for 11, and
+ * its re-ask still for more than 8, and was refused (AGL-3969).
+ *
+ * One section goes at a time, exactly as many as the plan is over, so the
+ * plan keeps the whole budget. Each goes from the lowest tier any page still
+ * has: first a section `freeWallKeeps` does not hold; then one it holds only
+ * by its name (a contact, a call to action, a storefront's sign-up); last one
+ * that places something every use of which another section still places, so
+ * no creation is left unplaced. Within a tier it is the last such section of
+ * the page furthest past its share: the home at / past its fewest
+ * (`aiSiteHomeMinSections`, five on a site start whose wall pays for a full
+ * home), any other page past two; on a tie, the longer page, then the home.
+ * No home goes under its fewest, no page under one section, and no page loses
+ * its opening or a Shop page its product grid. The shares are what a site
+ * start is told to plan (a home of five or six, the other page two or three):
+ * the candle shop's 7 + 2 becomes 6 + 2, never 7 + 1, and the recorded yoga
+ * answer's 6 + 4 becomes 5 + 3, the shape its own redo chose.
+ *
+ * A site start past its page cap and a plan with a list split into sections
+ * are returned unchanged, for their re-ask; so is the rare plan whose every
+ * section past the wall is one no tier may take.
  */
 export declare function aiSettlePlanFreeWall(plan: AiBuildPlan, inventory: AiSiteInventory | null, capabilities?: AiPlanCapabilities | null): AiBuildPlan;
 /**

package/src/lib/runtime/ai-doctrine-validators.js

@@ -5263,24 +5263,13 @@ function slugKey(slug) {
         homeMin
     };
 }
-/**
- * The most sections past the Free wall a plan is trimmed by rather than
- * re-asked (AGL-3737). The live candle-shop start of 2026-10-12 planned 9
- * sections against a wall of 8 on all three answers, each with a home of 7:
- * the model reaching for the budget the site redo names ("plan 7 to 8") and
- * landing one band past it, which no re-ask cured. Within two, the plan's
- * shape is right and only a band or two the brief needs least is extra, so
- * taking those from the end loses nothing the plan depends on. Further over,
- * the shape itself is off — a list planned as sections, a page the wall
- * cannot pay for — and cutting more would drop content the model meant, so
- * that plan is still re-asked.
- */ export const AI_FREE_WALL_SETTLE_MAX_OVER = 2;
 /** A section through which a visitor reaches the owner: contact, a visit, a booking. */ const REACH_SECTION_NAME = /\b(?:contact|get in touch|visit(?: us)?|find us|locations?|hours|book(?:ing)?|reserve|reservations?)\b/i;
 /** A section that asks a visitor to act: a call to action, "Start your practice", "Get started". */ const CALL_TO_ACTION_NAME = /\b(?:call to action|cta|get started|start (?:your|a|here|now|today)|join (?:us|now|today|the)|ready to)\b/i;
 /**
- * Whether the Free wall's trim keeps a section of a page (AGL-3737): the
- * page's opening, any section that places something (a dataset it lists, a
- * form, a component — dropping it would leave a creation unplaced), one that
+ * Whether the Free wall's trim keeps a section of a page while the plan has
+ * any other to take (AGL-3737, AGL-3969): the page's opening, any section
+ * that places something (a dataset it lists, a form, a component — dropping
+ * it would leave a creation unplaced), one that
  * collects answers, says how to reach the owner or asks a visitor to act
  * (AGL-3899: a home's call to action is its way to the form), and a storefront's
  * listing parts — the bestsellers, the collections, the sign-up, and a Shop
@@ -5297,31 +5286,37 @@ function slugKey(slug) {
     return aiLayoutIsShopPage(screen) && aiLayoutShopGridSection(screen.sections) === index;
 }
 /**
- * A Free plan a section or two past the wall is trimmed to fit before the
- * rules read the plan (AGL-3737), rather than re-asked: which sections go has
- * one answer, so the re-ask only costs the member a stopped start. The live
- * candle-shop start of 2026-10-12 asked for a home of 7 and a second page of
- * 2 against a wall of 8, three answers running, and stopped needing input.
+ * A Free plan past the wall is trimmed to the wall before the rules read the
+ * plan (AGL-3737, AGL-3969), rather than re-asked: a plan over its budget is
+ * the model's mistake, never the member's, and which sections go has one
+ * answer. The live candle-shop start of 2026-10-12 asked for a home of 7 and
+ * a second page of 2 against a wall of 8, three answers running, and stopped
+ * needing input; the Free candle shop of the beta.265 eval asked for 11, and
+ * its re-ask still for more than 8, and was refused (AGL-3969).
  *
- * One section goes at a time, the last of its page that `freeWallKeeps`
- * does not hold, from the page furthest past its share: the home at / past
- * its fewest (`aiSiteHomeMinSections`, five on a site start whose wall pays
- * for a full home), any other page past two; on a tie, the longer page, then
- * the home. No home goes under its fewest and no page under one section. The
- * shares are what a site start is told to plan (a home of five or six, the
- * other page two or three): the candle shop's 7 + 2 becomes 6 + 2, never
- * 7 + 1, and the recorded yoga answer's 6 + 4 becomes 5 + 3, the shape its
- * own redo chose.
+ * One section goes at a time, exactly as many as the plan is over, so the
+ * plan keeps the whole budget. Each goes from the lowest tier any page still
+ * has: first a section `freeWallKeeps` does not hold; then one it holds only
+ * by its name (a contact, a call to action, a storefront's sign-up); last one
+ * that places something every use of which another section still places, so
+ * no creation is left unplaced. Within a tier it is the last such section of
+ * the page furthest past its share: the home at / past its fewest
+ * (`aiSiteHomeMinSections`, five on a site start whose wall pays for a full
+ * home), any other page past two; on a tie, the longer page, then the home.
+ * No home goes under its fewest, no page under one section, and no page loses
+ * its opening or a Shop page its product grid. The shares are what a site
+ * start is told to plan (a home of five or six, the other page two or three):
+ * the candle shop's 7 + 2 becomes 6 + 2, never 7 + 1, and the recorded yoga
+ * answer's 6 + 4 becomes 5 + 3, the shape its own redo chose.
  *
- * A plan more than `AI_FREE_WALL_SETTLE_MAX_OVER` past the wall, a site
- * start past its page cap, a plan with a list split into sections, and a
- * plan the trim cannot fit without a section it keeps are returned
- * unchanged, for the wall to re-ask.
+ * A site start past its page cap and a plan with a list split into sections
+ * are returned unchanged, for their re-ask; so is the rare plan whose every
+ * section past the wall is one no tier may take.
  */ export function aiSettlePlanFreeWall(plan, inventory, capabilities = null) {
     const wall = freePlanWall(plan, inventory, capabilities);
     if (!wall || wall.overPages) return plan;
     const over = wall.asked - wall.fits;
-    if (over <= 0 || over > AI_FREE_WALL_SETTLE_MAX_OVER) return plan;
+    if (over <= 0) return plan;
     // A list split into sections is joined by its re-ask, which frees the room;
     // a trim would cut one of its items and hide the split from the rule.
     if (detectPlanSplitLists(plan, inventory, capabilities).length) return plan;
@@ -5332,27 +5327,42 @@ function slugKey(slug) {
     const home = plan.screens.findIndex(aiSitePlanIsHome);
     const floor = (screenIndex)=>screenIndex === home ? Math.max(wall.homeMin, 1) : 1;
     const target = (screenIndex)=>screenIndex === home ? Math.max(wall.homeMin, 1) : 2;
-    // The last section of a page the trim may take, or -1.
-    const last = (screenIndex)=>{
+    // Whether another kept section places every use of this one.
+    const placedElsewhere = (screenIndex, at)=>kept[screenIndex][at].section.uses.every((use)=>kept.some((entries, other)=>entries.some((entry, place)=>(other !== screenIndex || place !== at) && entry.section.uses.includes(use))));
+    // Whether the trim may take a page's section on a tier: 0 one the page does
+    // not hold, 1 one it holds by name only, 2 a placement another still makes.
+    const takes = (screenIndex, at, tier)=>{
+        const screen = plan.screens[screenIndex];
+        const { section, index } = kept[screenIndex][at];
+        if (!freeWallKeeps(screen, index)) return true;
+        if (tier === 0 || aiLayoutIsShopPage(screen) && aiLayoutShopGridSection(screen.sections) === index) return false;
+        return section.uses.length === 0 || tier === 2 && placedElsewhere(screenIndex, at);
+    };
+    // The last section of a page the trim may take on a tier, or -1.
+    const last = (screenIndex, tier)=>{
         const entries = kept[screenIndex];
         if (entries.length <= floor(screenIndex)) return -1;
         for(let at = entries.length - 1; at > 0; at -= 1){
-            if (!freeWallKeeps(plan.screens[screenIndex], entries[at].index)) return at;
+            if (takes(screenIndex, at, tier)) return at;
         }
         return -1;
     };
     for(let left = over; left > 0; left -= 1){
         let pick = -1;
-        for(let index = 0; index < kept.length; index += 1){
-            if (last(index) === -1) continue;
-            const room = kept[index].length - target(index);
-            const best = pick === -1 ? null : kept[pick].length - target(pick);
-            if (best === null || room > best || room === best && (kept[index].length > kept[pick].length || kept[index].length === kept[pick].length && index === home)) {
-                pick = index;
+        let tier = -1;
+        while(pick === -1 && tier < 2){
+            tier += 1;
+            for(let index = 0; index < kept.length; index += 1){
+                if (last(index, tier) === -1) continue;
+                const room = kept[index].length - target(index);
+                const best = pick === -1 ? null : kept[pick].length - target(pick);
+                if (best === null || room > best || room === best && (kept[index].length > kept[pick].length || kept[index].length === kept[pick].length && index === home)) {
+                    pick = index;
+                }
             }
         }
         if (pick === -1) return plan;
-        kept[pick].splice(last(pick), 1);
+        kept[pick].splice(last(pick, tier), 1);
     }
     return _extends({}, plan, {
         screens: plan.screens.map((screen, index)=>kept[index].length === screen.sections.length ? screen : _extends({}, screen, {