@aglyn/plugins-ai 1.0.0-beta.236 → 1.0.0-beta.238

package/src/lib/model/ai-credit-estimate.d.ts

@@ -0,0 +1,249 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * WHAT A JOB REALLY COSTS, NEXT TO WHAT IT CAN COST (AGL-3722).
+ *
+ * Every job's cost used to be quoted at its CEILING: each pass at the
+ * `AI_SITE_PASS_CREDITS` (50) a pass is reserved against. A Free Assist
+ * build of two pages, a quote form and a layout was quoted 600 credits and
+ * refused with 164 left, when builds like it measure about a fifth of that.
+ *
+ * So a job is now quoted as a RANGE: what it is likely to cost (the sum of
+ * the measured medians of what it builds), what it costs nine times in ten
+ * (the measured p90s), and its ceiling (the old figure, unchanged). The
+ * meter still charges actual use, and the reservation each pass takes is
+ * still the ceiling's 50 — only the words and the Free admission move:
+ * a Free job is admitted outright when its p90 fits what is left, and asked
+ * to be confirmed when it does not.
+ *
+ * This module is pure: the console, the doors and the specs read one table.
+ */
+/** One measured cost: the median and the 90th percentile, in credits. */
+export interface AiMeasuredCredits {
+    median: number;
+    p90: number;
+}
+/**
+ * MEASURED IN PRODUCTION, credits per unit, over every `done` AI job since
+ * 2026-10-01 (read 2026-10-09; a whole Free site job came to 148–160):
+ *
+ *   page item   30 / 40   (a page of about `AI_MEASURED_PAGE_SECTIONS` sections, its listing included)
+ *   form        29 / 31
+ *   layout      23 / 24   (header and footer, one answer)
+ *   theme        4 /  8   (a site start's look)
+ *   plan step   21 / 70
+ *
+ * HOW TO RE-MEASURE: a read-only collection-group read of `aiJobs` in
+ * production where `status == 'done'` and `createdAt` is in the window; group
+ * each ledger row's (`items[]`) `creditsSpent` by its `op` (the site start's
+ * look is the `theme` row), take the plan step's `steps[].creditsSpent` for
+ * `plan`, and each job's `creditsSpent` for the whole-site band. Put each
+ * group's median and 90th percentile here, and the dates in
+ * `AI_MEASURED_AT`. `ai-credit-estimate.spec.ts` holds the table, the page
+ * scaling and the measured whole-site band together, so a re-measure that
+ * moves one moves the spec with it.
+ */
+export declare const AI_MEASURED_UNIT_CREDITS: {
+    readonly page: {
+        readonly median: 30;
+        readonly p90: 40;
+    };
+    readonly form: {
+        readonly median: 29;
+        readonly p90: 31;
+    };
+    readonly layout: {
+        readonly median: 23;
+        readonly p90: 24;
+    };
+    readonly theme: {
+        readonly median: 4;
+        readonly p90: 8;
+    };
+    readonly plan: {
+        readonly median: 21;
+        readonly p90: 70;
+    };
+};
+/** When the table above was read, and from when its jobs ran. */
+export declare const AI_MEASURED_AT: {
+    readonly read: "2026-10-09";
+    readonly since: "2026-10-01";
+};
+/** What a whole Free two-page site job measured at, in credits, in the same window. */
+export declare const AI_MEASURED_FREE_SITE_CREDITS: {
+    readonly low: 148;
+    readonly high: 160;
+};
+/** The sections the measured page item is about: a page is scaled around it. */
+export declare const AI_MEASURED_PAGE_SECTIONS = 5;
+/**
+ * What a page of this many sections is likely to cost: the measured page
+ * scaled by its sections around the ~5-section median — about 6 credits a
+ * section, 8 at the p90.
+ */
+export declare function aiMeasuredPageCredits(sections: number): AiMeasuredCredits;
+/**
+ * What a page costs when it is written ON ITS OWN — a page an Assist build or
+ * a page job writes, rather than one of a site start's pages (AGL-3722).
+ *
+ * The table's page item is a site start's: its pages are written one after
+ * another inside one job, the later ones reading the prompt the first one
+ * paid to write, so a 2-section second page measured 19–28. A page written on
+ * its own pays that prompt itself and reads the site it lands on, and costs
+ * what a site start's FIRST page costs: a 5-section home page measured 39–78
+ * (median 40, p90 78), standalone page jobs' writing step 82–105 for a
+ * 2-section page, and the Assist build pages of 2026-10-09 22–89 each. Quoting
+ * a build's pages at the site start's scaled median told a Free workspace
+ * "about 48 credits" for two 4-section pages (AGL-3722, 2026-10-10).
+ *
+ * So it is priced as a fixed cost — the prompt, the site, the listing — and a
+ * cost per section: a 4-section page about 40 (p90 78), a 5-section 46 (p90 90).
+ */
+export declare const AI_MEASURED_STANDALONE_PAGE: {
+    readonly fixed: {
+        readonly median: 16;
+        readonly p90: 30;
+    };
+    readonly perSection: {
+        readonly median: 6;
+        readonly p90: 12;
+    };
+};
+/** What a page of this many sections written on its own is likely to cost. */
+export declare function aiMeasuredStandalonePageCredits(sections: number): AiMeasuredCredits;
+/**
+ * What a creation costs when it is written ON ITS OWN (AGL-3722), where it
+ * measured apart from a site start's: an Assist build's layout came to 24–28
+ * (2026-10-09/10), against a site start's 23/24 written in its warm prompt.
+ * A form measured the same either way (25–30 on its own, 29/31 in a site
+ * start), so it keeps the table's figure.
+ */
+export declare const AI_MEASURED_STANDALONE_CREATION_CREDITS: {
+    readonly layout: {
+        readonly median: 26;
+        readonly p90: 30;
+    };
+};
+/**
+ * What one pass of a kind with no measurement of its own is likely to cost
+ * (a component, an email design, a template, an item another runner
+ * builds), written on its own: a component job's writing step measured
+ * 52–65, a form job's 37, a layout job's 63, and the Assist build of
+ * 2026-10-09 a welcome email at 46 and a products step at 60. Until
+ * 2026-10-10 this was a site start's form (29/31), which is written inside a
+ * site job's warm prompt and is the cheapest single answer there is.
+ */
+export declare const AI_MEASURED_PASS_CREDITS: AiMeasuredCredits;
+/** A job's cost as it is quoted: likely, nine times in ten, and at its worst. */
+export interface AiCreditRange {
+    /** The sum of the measured medians: what the job is likely to spend. */
+    likely: number;
+    /** The sum of the measured p90s: what a Free job is admitted on. */
+    p90: number;
+    /** Every pass at its reserve: what it can spend at most. */
+    ceiling: number;
+}
+export declare const AI_CREDIT_RANGE_ZERO: AiCreditRange;
+/** Two ranges added. */
+export declare function aiCreditRangeAdd(a: AiCreditRange, b: AiCreditRange): AiCreditRange;
+/** A measured cost as a range with its own ceiling, the likely and p90 never above it. */
+export declare function aiCreditRangeOf(measured: AiMeasuredCredits, ceiling: number): AiCreditRange;
+/** A range whose likely and p90 are each at least the last, and at most the ceiling. */
+export declare function aiCreditRangeOrdered(range: AiCreditRange): AiCreditRange;
+/**
+ * The range as every surface quotes it: "About 106 credits (up to 650)".
+ * A job whose likely figure is its ceiling says one number.
+ */
+export declare function aiCreditRangeText(range: AiCreditRange): string;
+/**
+ * Whether a Free job of this range needs the person's go-ahead before it
+ * starts (AGL-3722): its p90 is more than what is left. A job whose p90
+ * fits starts with no prompt; one that does not starts only when confirmed,
+ * builds as much as what is left pays for, and pauses with Resume.
+ */
+export declare function aiCreditsNeedConfirm(range: Pick<AiCreditRange, 'p90'>, left: number): boolean;
+/** The smaller first build a Free job that does not fit is offered (AGL-3722). */
+export interface AiCreditsSmaller {
+    /** "Build the home page first". */
+    label: string;
+    likely: number;
+    p90: number;
+    ceiling: number;
+}
+/**
+ * What a Free job that does not fit what is left says before it starts, and
+ * the choices it offers: build what fits, a smaller first build, or Upgrade.
+ * The door that refuses an unconfirmed start answers with it (status 409,
+ * `code: AI_CREDITS_CONFIRM_CODE`), and the plan card and the guided start
+ * draw it from the same figures.
+ */
+export interface AiCreditsPrompt extends AiCreditRange {
+    left: number;
+    resetsOn: string;
+    smaller: AiCreditsSmaller | null;
+}
+/** The `code` a door answers an unconfirmed Free start with. */
+export declare const AI_CREDITS_CONFIRM_CODE = "credits-confirm";
+/** "Build what fits": the go-ahead for a Free job past what is left. */
+export declare const AI_CREDITS_BUILD_WHAT_FITS = "Build what fits";
+/** The smaller first build's button: "Build the home page first (about 64 credits)". */
+export declare function aiCreditsSmallerText(smaller: Pick<AiCreditsSmaller, 'label' | 'likely'>): string;
+/** Which way on a prompt offers, in the order it offers them. */
+export type AiCreditsChoiceKey = 'fits' | 'smaller' | 'upgrade';
+/** One way on, as its option button reads it: a short label and the figure under it (AGL-3722). */
+export interface AiCreditsChoice {
+    key: AiCreditsChoiceKey;
+    label: string;
+    detail: string;
+    /** The one choice drawn as the primary button. */
+    recommended: boolean;
+}
+/**
+ * The prompt's ways on, as its three option buttons read them (Zach,
+ * 2026-10-10: "more appealing and consistent"): build what fits, the smaller
+ * first build when there is one, and Upgrade when it can be offered — each a
+ * short sentence-case label with its figure under it. The smaller build is
+ * the recommended one when its p90 fits what is left, since it then finishes;
+ * otherwise building what fits is.
+ */
+export declare function aiCreditsChoices(prompt: Pick<AiCreditsPrompt, 'left' | 'smaller'>, offers: {
+    smaller: boolean;
+    upgrade: boolean;
+}): AiCreditsChoice[];
+/**
+ * The plain sentence (Zach, 2026-10-09): "This build is about N credits (up
+ * to M). You have L left, so it will build as much as it can and pause when
+ * your credits run out. You can upgrade or resume when they renew."
+ */
+export declare function aiCreditsPromptText(prompt: AiCreditsPrompt, noun?: 'build' | 'site'): string;
+/**
+ * The record a confirmed Free start keeps (AGL-3722): who said go, when,
+ * what was left then and the range they were shown.
+ */
+export interface AiJobCreditsConfirmation extends AiCreditRange {
+    by: string;
+    at: Date | string;
+    left: number;
+}
+/** The confirmation a door keeps on the job for the prompt the person confirmed, or `null` when there was none. */
+export declare function aiCreditsConfirmation(prompt: AiCreditsPrompt | null, by: string, at: Date): AiJobCreditsConfirmation | null;
+/** The prompt a range needs against what is left, or `null` when it fits. */
+export declare function aiCreditsPromptFor(range: AiCreditRange, credits: {
+    left: number;
+    resetsOn: string;
+} | null | undefined, smaller?: AiCreditsSmaller | null): AiCreditsPrompt | null;

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

@@ -0,0 +1,278 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * WHAT A JOB REALLY COSTS, NEXT TO WHAT IT CAN COST (AGL-3722).
+ *
+ * Every job's cost used to be quoted at its CEILING: each pass at the
+ * `AI_SITE_PASS_CREDITS` (50) a pass is reserved against. A Free Assist
+ * build of two pages, a quote form and a layout was quoted 600 credits and
+ * refused with 164 left, when builds like it measure about a fifth of that.
+ *
+ * So a job is now quoted as a RANGE: what it is likely to cost (the sum of
+ * the measured medians of what it builds), what it costs nine times in ten
+ * (the measured p90s), and its ceiling (the old figure, unchanged). The
+ * meter still charges actual use, and the reservation each pass takes is
+ * still the ceiling's 50 — only the words and the Free admission move:
+ * a Free job is admitted outright when its p90 fits what is left, and asked
+ * to be confirmed when it does not.
+ *
+ * This module is pure: the console, the doors and the specs read one table.
+ */ /** One measured cost: the median and the 90th percentile, in credits. */ import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * MEASURED IN PRODUCTION, credits per unit, over every `done` AI job since
+ * 2026-10-01 (read 2026-10-09; a whole Free site job came to 148–160):
+ *
+ *   page item   30 / 40   (a page of about `AI_MEASURED_PAGE_SECTIONS` sections, its listing included)
+ *   form        29 / 31
+ *   layout      23 / 24   (header and footer, one answer)
+ *   theme        4 /  8   (a site start's look)
+ *   plan step   21 / 70
+ *
+ * HOW TO RE-MEASURE: a read-only collection-group read of `aiJobs` in
+ * production where `status == 'done'` and `createdAt` is in the window; group
+ * each ledger row's (`items[]`) `creditsSpent` by its `op` (the site start's
+ * look is the `theme` row), take the plan step's `steps[].creditsSpent` for
+ * `plan`, and each job's `creditsSpent` for the whole-site band. Put each
+ * group's median and 90th percentile here, and the dates in
+ * `AI_MEASURED_AT`. `ai-credit-estimate.spec.ts` holds the table, the page
+ * scaling and the measured whole-site band together, so a re-measure that
+ * moves one moves the spec with it.
+ */ export const AI_MEASURED_UNIT_CREDITS = {
+    page: {
+        median: 30,
+        p90: 40
+    },
+    form: {
+        median: 29,
+        p90: 31
+    },
+    layout: {
+        median: 23,
+        p90: 24
+    },
+    theme: {
+        median: 4,
+        p90: 8
+    },
+    plan: {
+        median: 21,
+        p90: 70
+    }
+};
+/** When the table above was read, and from when its jobs ran. */ export const AI_MEASURED_AT = {
+    read: '2026-10-09',
+    since: '2026-10-01'
+};
+/** What a whole Free two-page site job measured at, in credits, in the same window. */ export const AI_MEASURED_FREE_SITE_CREDITS = {
+    low: 148,
+    high: 160
+};
+/** The sections the measured page item is about: a page is scaled around it. */ export const AI_MEASURED_PAGE_SECTIONS = 5;
+/**
+ * What a page of this many sections is likely to cost: the measured page
+ * scaled by its sections around the ~5-section median — about 6 credits a
+ * section, 8 at the p90.
+ */ export function aiMeasuredPageCredits(sections) {
+    const count = Math.max(1, Math.floor(Number.isFinite(sections) ? sections : AI_MEASURED_PAGE_SECTIONS));
+    const { median, p90 } = AI_MEASURED_UNIT_CREDITS.page;
+    return {
+        median: Math.ceil(median * count / AI_MEASURED_PAGE_SECTIONS),
+        p90: Math.ceil(p90 * count / AI_MEASURED_PAGE_SECTIONS)
+    };
+}
+/**
+ * What a page costs when it is written ON ITS OWN — a page an Assist build or
+ * a page job writes, rather than one of a site start's pages (AGL-3722).
+ *
+ * The table's page item is a site start's: its pages are written one after
+ * another inside one job, the later ones reading the prompt the first one
+ * paid to write, so a 2-section second page measured 19–28. A page written on
+ * its own pays that prompt itself and reads the site it lands on, and costs
+ * what a site start's FIRST page costs: a 5-section home page measured 39–78
+ * (median 40, p90 78), standalone page jobs' writing step 82–105 for a
+ * 2-section page, and the Assist build pages of 2026-10-09 22–89 each. Quoting
+ * a build's pages at the site start's scaled median told a Free workspace
+ * "about 48 credits" for two 4-section pages (AGL-3722, 2026-10-10).
+ *
+ * So it is priced as a fixed cost — the prompt, the site, the listing — and a
+ * cost per section: a 4-section page about 40 (p90 78), a 5-section 46 (p90 90).
+ */ export const AI_MEASURED_STANDALONE_PAGE = {
+    fixed: {
+        median: 16,
+        p90: 30
+    },
+    perSection: {
+        median: 6,
+        p90: 12
+    }
+};
+/** What a page of this many sections written on its own is likely to cost. */ export function aiMeasuredStandalonePageCredits(sections) {
+    const count = Math.max(1, Math.floor(Number.isFinite(sections) ? sections : AI_MEASURED_PAGE_SECTIONS));
+    const { fixed, perSection } = AI_MEASURED_STANDALONE_PAGE;
+    return {
+        median: fixed.median + perSection.median * count,
+        p90: fixed.p90 + perSection.p90 * count
+    };
+}
+/**
+ * What a creation costs when it is written ON ITS OWN (AGL-3722), where it
+ * measured apart from a site start's: an Assist build's layout came to 24–28
+ * (2026-10-09/10), against a site start's 23/24 written in its warm prompt.
+ * A form measured the same either way (25–30 on its own, 29/31 in a site
+ * start), so it keeps the table's figure.
+ */ export const AI_MEASURED_STANDALONE_CREATION_CREDITS = {
+    layout: {
+        median: 26,
+        p90: 30
+    }
+};
+/**
+ * What one pass of a kind with no measurement of its own is likely to cost
+ * (a component, an email design, a template, an item another runner
+ * builds), written on its own: a component job's writing step measured
+ * 52–65, a form job's 37, a layout job's 63, and the Assist build of
+ * 2026-10-09 a welcome email at 46 and a products step at 60. Until
+ * 2026-10-10 this was a site start's form (29/31), which is written inside a
+ * site job's warm prompt and is the cheapest single answer there is.
+ */ export const AI_MEASURED_PASS_CREDITS = {
+    median: 50,
+    p90: 65
+};
+export const AI_CREDIT_RANGE_ZERO = {
+    likely: 0,
+    p90: 0,
+    ceiling: 0
+};
+/** Two ranges added. */ export function aiCreditRangeAdd(a, b) {
+    return {
+        likely: a.likely + b.likely,
+        p90: a.p90 + b.p90,
+        ceiling: a.ceiling + b.ceiling
+    };
+}
+/** A measured cost as a range with its own ceiling, the likely and p90 never above it. */ export function aiCreditRangeOf(measured, ceiling) {
+    const top = Math.max(0, Math.ceil(ceiling));
+    return {
+        likely: Math.min(measured.median, top),
+        p90: Math.min(measured.p90, top),
+        ceiling: top
+    };
+}
+/** A range whose likely and p90 are each at least the last, and at most the ceiling. */ export function aiCreditRangeOrdered(range) {
+    const ceiling = Math.max(0, Math.ceil(range.ceiling));
+    const likely = Math.min(Math.max(0, Math.ceil(range.likely)), ceiling);
+    const p90 = Math.min(Math.max(likely, Math.ceil(range.p90)), ceiling);
+    return {
+        likely,
+        p90,
+        ceiling
+    };
+}
+const n = (value)=>value.toLocaleString('en-US');
+/**
+ * The range as every surface quotes it: "About 106 credits (up to 650)".
+ * A job whose likely figure is its ceiling says one number.
+ */ export function aiCreditRangeText(range) {
+    if (range.likely >= range.ceiling) return `About ${n(range.ceiling)} credits`;
+    return `About ${n(range.likely)} credits (up to ${n(range.ceiling)})`;
+}
+/**
+ * Whether a Free job of this range needs the person's go-ahead before it
+ * starts (AGL-3722): its p90 is more than what is left. A job whose p90
+ * fits starts with no prompt; one that does not starts only when confirmed,
+ * builds as much as what is left pays for, and pauses with Resume.
+ */ export function aiCreditsNeedConfirm(range, left) {
+    return Number.isFinite(left) && range.p90 > Math.max(0, Math.floor(left));
+}
+/** The `code` a door answers an unconfirmed Free start with. */ export const AI_CREDITS_CONFIRM_CODE = 'credits-confirm';
+/** "Build what fits": the go-ahead for a Free job past what is left. */ export const AI_CREDITS_BUILD_WHAT_FITS = 'Build what fits';
+/** The smaller first build's button: "Build the home page first (about 64 credits)". */ export function aiCreditsSmallerText(smaller) {
+    return `${smaller.label} (about ${n(smaller.likely)} credits)`;
+}
+const credit = (count)=>`${n(count)} ${count === 1 ? 'credit' : 'credits'}`;
+/**
+ * The prompt's ways on, as its three option buttons read them (Zach,
+ * 2026-10-10: "more appealing and consistent"): build what fits, the smaller
+ * first build when there is one, and Upgrade when it can be offered — each a
+ * short sentence-case label with its figure under it. The smaller build is
+ * the recommended one when its p90 fits what is left, since it then finishes;
+ * otherwise building what fits is.
+ */ export function aiCreditsChoices(prompt, offers) {
+    const left = Math.max(0, Math.floor(prompt.left));
+    const smaller = offers.smaller ? prompt.smaller : null;
+    const smallerFits = smaller !== null && smaller.p90 <= left;
+    const choices = [
+        {
+            key: 'fits',
+            label: AI_CREDITS_BUILD_WHAT_FITS,
+            detail: `Uses your ${credit(left)} left, then pauses`,
+            recommended: !smallerFits
+        }
+    ];
+    if (smaller) {
+        choices.push({
+            key: 'smaller',
+            label: smaller.label,
+            detail: smallerFits ? `About ${credit(smaller.likely)}, fits what you have left` : `About ${credit(smaller.likely)}`,
+            recommended: smallerFits
+        });
+    }
+    if (offers.upgrade) choices.push({
+        key: 'upgrade',
+        label: 'Upgrade',
+        detail: 'Get more credits',
+        recommended: false
+    });
+    return choices;
+}
+/** A reset day as a person reads it: "November 1". */ function resetLabel(resetsOn) {
+    const at = new Date(`${resetsOn}T00:00:00.000Z`);
+    return Number.isFinite(at.getTime()) ? at.toLocaleDateString('en-US', {
+        month: 'long',
+        day: 'numeric',
+        timeZone: 'UTC'
+    }) : 'the first of next month';
+}
+/**
+ * The plain sentence (Zach, 2026-10-09): "This build is about N credits (up
+ * to M). You have L left, so it will build as much as it can and pause when
+ * your credits run out. You can upgrade or resume when they renew."
+ */ export function aiCreditsPromptText(prompt, noun = 'build') {
+    const size = prompt.likely >= prompt.ceiling ? `about ${n(prompt.ceiling)} credits` : `about ${n(prompt.likely)} credits (up to ${n(prompt.ceiling)})`;
+    const left = Math.max(0, Math.floor(prompt.left));
+    return `This ${noun} is ${size}. You have ${n(left)} left, so it will build as much as it can and pause ` + `when your credits run out. You can upgrade or resume when they renew on ${resetLabel(prompt.resetsOn)}.`;
+}
+/** The confirmation a door keeps on the job for the prompt the person confirmed, or `null` when there was none. */ export function aiCreditsConfirmation(prompt, by, at) {
+    if (!prompt) return null;
+    return {
+        by,
+        at,
+        left: prompt.left,
+        likely: prompt.likely,
+        p90: prompt.p90,
+        ceiling: prompt.ceiling
+    };
+}
+/** The prompt a range needs against what is left, or `null` when it fits. */ export function aiCreditsPromptFor(range, credits, smaller = null) {
+    if (!credits || !aiCreditsNeedConfirm(range, credits.left)) return null;
+    return _extends({}, range, {
+        left: Math.max(0, Math.floor(credits.left)),
+        resetsOn: credits.resetsOn,
+        smaller
+    });
+}
+
+//# sourceMappingURL=ai-credit-estimate.js.map

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

@@ -0,0 +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 * 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  page: { median: 30, p90: 40 },\n  form: { median: 29, p90: 31 },\n  layout: { median: 23, p90: 24 },\n  theme: { median: 4, p90: 8 },\n  plan: { median: 21, p90: 70 },\n} as const satisfies Record<string, AiMeasuredCredits>\n\n/** When the table above was read, and from when its jobs ran. */\nexport const AI_MEASURED_AT = { read: '2026-10-09', since: '2026-10-01' } as const\n\n/** What a whole Free two-page site job measured at, in credits, in the same window. */\nexport const AI_MEASURED_FREE_SITE_CREDITS = { low: 148, high: 160 } 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 40 (p90 78), a 5-section 46 (p90 90).\n */\nexport const AI_MEASURED_STANDALONE_PAGE = {\n  fixed: { median: 16, p90: 30 },\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_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-job-cancel-copy.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { AiJobSummary } from './ai-jobs.types';
+/**
+ * What every surface that cancels an AI job says (AGL-3616): the job's page,
+ * a row of the site's AI jobs list, and the AI jobs list the top-bar chip
+ * opens. One wording, so a person reads the same promise wherever they stop
+ * a job.
+ */
+/** The confirm dialog's title. */
+export declare const AI_JOB_CANCEL_TITLE = "Cancel this AI job?";
+/** What canceling does, said before it is done. */
+export declare const AI_JOB_CANCEL_CONFIRM_COPY = "Stop building. Pages already built stay as drafts; you won\u2019t be charged for steps that haven\u2019t run.";
+/** While the step in flight finishes or stops. */
+export declare const AI_JOB_CANCELING_COPY = "Stopping. The step in progress finishes or stops first, and nothing after it runs.";
+/** What a canceled job's page says under its heading. */
+export declare const AI_JOB_CANCELED_LEDE = "You canceled this job. Anything it already built stays as an unpublished draft, and nothing was published.";
+/**
+ * Why a job cannot be canceled, or `null` when it can: one that is done,
+ * failed or already canceled has nothing left to stop, and one already
+ * stopping needs no second cancel. The button stays, disabled, with this as
+ * its reason.
+ */
+export declare function aiJobCancelBlockedReason(job: Pick<AiJobSummary, 'status'> & Partial<Pick<AiJobSummary, 'cancelRequested'>>): string | null;
+/**
+ * What a canceled job cost (AGL-3616): the credits its finished steps used,
+ * which stay charged, less anything given back. "This job used 42 credits
+ * before it stopped." — or that it used none.
+ */
+export declare function aiJobCanceledCreditsCopy(job: Partial<Pick<AiJobSummary, 'creditsSpent' | 'refundedCredits'>>): string;