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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/plugins-ai",
-  "version": "1.0.0-beta.236",
+  "version": "1.0.0-beta.238",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -25,22 +25,22 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/aglyn": "1.0.0-beta.236",
-    "@aglyn/shared-data-enums": "1.0.0-beta.236",
-    "@aglyn/shared-data-mdi": "1.0.0-beta.236",
-    "@aglyn/shared-data-types": "1.0.0-beta.236",
-    "@aglyn/shared-ui-email-campaigns": "1.0.0-beta.236",
-    "@aglyn/shared-ui-jsx": "1.0.0-beta.236",
-    "@aglyn/shared-ui-snackstack": "1.0.0-beta.236",
-    "@aglyn/shared-ui-theme": "1.0.0-beta.236",
-    "@aglyn/shared-util-email": "1.0.0-beta.236",
-    "@aglyn/shared-util-errors": "1.0.0-beta.236",
-    "@aglyn/shared-util-http": "1.0.0-beta.236",
-    "@aglyn/shared-util-timestamp": "1.0.0-beta.236",
-    "@aglyn/shared-util-tools": "1.0.0-beta.236",
-    "@aglyn/tenant-data-admin": "1.0.0-beta.236",
-    "@aglyn/tenant-feature-instance": "1.0.0-beta.236",
-    "@aglyn/tenant-runtime": "1.0.0-beta.236",
+    "@aglyn/aglyn": "1.0.0-beta.238",
+    "@aglyn/shared-data-enums": "1.0.0-beta.238",
+    "@aglyn/shared-data-mdi": "1.0.0-beta.238",
+    "@aglyn/shared-data-types": "1.0.0-beta.238",
+    "@aglyn/shared-ui-email-campaigns": "1.0.0-beta.238",
+    "@aglyn/shared-ui-jsx": "1.0.0-beta.238",
+    "@aglyn/shared-ui-snackstack": "1.0.0-beta.238",
+    "@aglyn/shared-ui-theme": "1.0.0-beta.238",
+    "@aglyn/shared-util-email": "1.0.0-beta.238",
+    "@aglyn/shared-util-errors": "1.0.0-beta.238",
+    "@aglyn/shared-util-http": "1.0.0-beta.238",
+    "@aglyn/shared-util-timestamp": "1.0.0-beta.238",
+    "@aglyn/shared-util-tools": "1.0.0-beta.238",
+    "@aglyn/tenant-data-admin": "1.0.0-beta.238",
+    "@aglyn/tenant-feature-instance": "1.0.0-beta.238",
+    "@aglyn/tenant-runtime": "1.0.0-beta.238",
     "@swc/helpers": "0.5.23"
   },
   "peerDependencies": {

package/src/lib/components/ai-credits-prompt.component.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 AiCreditsPrompt } from '../model/ai-credit-estimate';
+/**
+ * What a Free job past what is left asks before it starts (AGL-3722), on the
+ * Assist build plan card, in the guided start, on a build's page and in the
+ * jobs drawer alike: the plain sentence — about what it costs, what is left,
+ * that it builds what it can and pauses — and its ways on. Only "Build what
+ * fits" (or the smaller first build) starts anything; nothing is started by
+ * showing this.
+ *
+ * The ways on are one set of option buttons (Zach, 2026-10-10): the same
+ * shape and height, full width so a long label never wraps beside another,
+ * sentence case, a short label with its figure under it, and the recommended
+ * one drawn as the primary button. Theme tokens only, so it reads the same in
+ * the Assist panel's narrow column and in light or dark.
+ */
+export interface AiCreditsPromptProps {
+    prompt: AiCreditsPrompt;
+    noun: 'build' | 'site';
+    /** The workspace's path slug, for Upgrade; Upgrade is left out without it. */
+    orgSlug?: string | null;
+    busy?: boolean;
+    /** "Build what fits": start it, to pause where the credits run out. */
+    onBuildWhatFits: () => void;
+    /** The smaller first build; offered only when the prompt has one and this is given. */
+    onSmaller?: () => void;
+}
+export declare function AiCreditsPromptNotice({ prompt, noun, orgSlug, busy, onBuildWhatFits, onSmaller, }: AiCreditsPromptProps): JSX.Element;
+export default AiCreditsPromptNotice;

package/src/lib/components/ai-credits-prompt.component.js

@@ -0,0 +1,117 @@
+/**
+ * @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.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Button, Stack, Typography } from "@mui/material";
+import { useId } from "react";
+import { aiCreditsChoices, aiCreditsPromptText } from "../model/ai-credit-estimate.js";
+import { aiCreditsBillingHref } from "./ai-job-links.js";
+function AiCreditsChoiceButton({ choice, busy, href, onClick }) {
+    const detailId = `${useId()}-detail`;
+    return /*#__PURE__*/ _jsxs(Button, _extends({
+        fullWidth: true,
+        size: "medium",
+        variant: choice.recommended ? 'contained' : 'outlined',
+        color: "primary",
+        disabled: busy && choice.key !== 'upgrade',
+        "aria-label": choice.label,
+        "aria-describedby": detailId,
+        "data-choice": choice.key
+    }, href ? {
+        href
+    } : {
+        onClick
+    }, {
+        sx: {
+            minHeight: 56,
+            px: 1.5,
+            py: 1,
+            display: 'flex',
+            flexDirection: 'column',
+            alignItems: 'flex-start',
+            justifyContent: 'center',
+            textAlign: 'left',
+            textTransform: 'none',
+            lineHeight: 1.3
+        },
+        children: [
+            /*#__PURE__*/ _jsx(Typography, {
+                component: "span",
+                variant: "body2",
+                sx: {
+                    fontWeight: 600,
+                    color: 'inherit'
+                },
+                children: choice.label
+            }),
+            /*#__PURE__*/ _jsx(Typography, {
+                id: detailId,
+                component: "span",
+                variant: "caption",
+                sx: {
+                    color: 'inherit',
+                    opacity: 0.8
+                },
+                children: choice.detail
+            })
+        ]
+    }));
+}
+export function AiCreditsPromptNotice({ prompt, noun, orgSlug, busy = false, onBuildWhatFits, onSmaller }) {
+    const choices = aiCreditsChoices(prompt, {
+        smaller: Boolean(onSmaller),
+        upgrade: Boolean(orgSlug)
+    });
+    return /*#__PURE__*/ _jsxs(Box, {
+        role: "alert",
+        "aria-label": "More than your credits left",
+        sx: {
+            mt: 1,
+            p: 1.5,
+            border: 1,
+            borderColor: 'warning.main',
+            borderRadius: 1,
+            bgcolor: 'background.paper'
+        },
+        children: [
+            /*#__PURE__*/ _jsx(Typography, {
+                variant: "body2",
+                sx: {
+                    color: 'text.primary'
+                },
+                children: aiCreditsPromptText(prompt, noun)
+            }),
+            /*#__PURE__*/ _jsx(Stack, {
+                spacing: 1,
+                sx: {
+                    mt: 1.5
+                },
+                children: choices.map((choice)=>/*#__PURE__*/ _jsx(AiCreditsChoiceButton, _extends({
+                        choice: choice,
+                        busy: busy
+                    }, choice.key === 'upgrade' && orgSlug ? {
+                        href: aiCreditsBillingHref(orgSlug)
+                    } : {
+                        onClick: choice.key === 'smaller' ? onSmaller : onBuildWhatFits
+                    }), choice.key))
+            })
+        ]
+    });
+}
+export default AiCreditsPromptNotice;
+
+//# sourceMappingURL=ai-credits-prompt.component.js.map

package/src/lib/components/ai-credits-prompt.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-credits-prompt.component.tsx"],"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'use client'\n\nimport { Box, Button, Stack, Typography } from '@mui/material'\nimport { useId } from 'react'\nimport {\n  aiCreditsChoices,\n  aiCreditsPromptText,\n  type AiCreditsChoice,\n  type AiCreditsPrompt,\n} from '../model/ai-credit-estimate'\nimport { aiCreditsBillingHref } from './ai-job-links'\n\n/**\n * What a Free job past what is left asks before it starts (AGL-3722), on the\n * Assist build plan card, in the guided start, on a build's page and in the\n * jobs drawer alike: the plain sentence — about what it costs, what is left,\n * that it builds what it can and pauses — and its ways on. Only \"Build what\n * fits\" (or the smaller first build) starts anything; nothing is started by\n * showing this.\n *\n * The ways on are one set of option buttons (Zach, 2026-10-10): the same\n * shape and height, full width so a long label never wraps beside another,\n * sentence case, a short label with its figure under it, and the recommended\n * one drawn as the primary button. Theme tokens only, so it reads the same in\n * the Assist panel's narrow column and in light or dark.\n */\nexport interface AiCreditsPromptProps {\n  prompt: AiCreditsPrompt\n  noun: 'build' | 'site'\n  /** The workspace's path slug, for Upgrade; Upgrade is left out without it. */\n  orgSlug?: string | null\n  busy?: boolean\n  /** \"Build what fits\": start it, to pause where the credits run out. */\n  onBuildWhatFits: () => void\n  /** The smaller first build; offered only when the prompt has one and this is given. */\n  onSmaller?: () => void\n}\n\nfunction AiCreditsChoiceButton({\n  choice,\n  busy,\n  href,\n  onClick,\n}: {\n  choice: AiCreditsChoice\n  busy: boolean\n  href?: string\n  onClick?: () => void\n}): JSX.Element {\n  const detailId = `${useId()}-detail`\n  return (\n    <Button\n      fullWidth\n      size=\"medium\"\n      variant={choice.recommended ? 'contained' : 'outlined'}\n      color=\"primary\"\n      disabled={busy && choice.key !== 'upgrade'}\n      aria-label={choice.label}\n      aria-describedby={detailId}\n      data-choice={choice.key}\n      {...(href ? { href } : { onClick })}\n      sx={{\n        minHeight: 56,\n        px: 1.5,\n        py: 1,\n        display: 'flex',\n        flexDirection: 'column',\n        alignItems: 'flex-start',\n        justifyContent: 'center',\n        textAlign: 'left',\n        textTransform: 'none',\n        lineHeight: 1.3,\n      }}\n    >\n      <Typography component=\"span\" variant=\"body2\" sx={{ fontWeight: 600, color: 'inherit' }}>\n        {choice.label}\n      </Typography>\n      <Typography id={detailId} component=\"span\" variant=\"caption\" sx={{ color: 'inherit', opacity: 0.8 }}>\n        {choice.detail}\n      </Typography>\n    </Button>\n  )\n}\n\nexport function AiCreditsPromptNotice({\n  prompt,\n  noun,\n  orgSlug,\n  busy = false,\n  onBuildWhatFits,\n  onSmaller,\n}: AiCreditsPromptProps): JSX.Element {\n  const choices = aiCreditsChoices(prompt, { smaller: Boolean(onSmaller), upgrade: Boolean(orgSlug) })\n  return (\n    <Box\n      role=\"alert\"\n      aria-label=\"More than your credits left\"\n      sx={{\n        mt: 1,\n        p: 1.5,\n        border: 1,\n        borderColor: 'warning.main',\n        borderRadius: 1,\n        bgcolor: 'background.paper',\n      }}\n    >\n      <Typography variant=\"body2\" sx={{ color: 'text.primary' }}>\n        {aiCreditsPromptText(prompt, noun)}\n      </Typography>\n      <Stack spacing={1} sx={{ mt: 1.5 }}>\n        {choices.map((choice) => (\n          <AiCreditsChoiceButton\n            key={choice.key}\n            choice={choice}\n            busy={busy}\n            {...(choice.key === 'upgrade' && orgSlug\n              ? { href: aiCreditsBillingHref(orgSlug) }\n              : { onClick: choice.key === 'smaller' ? onSmaller : onBuildWhatFits })}\n          />\n        ))}\n      </Stack>\n    </Box>\n  )\n}\n\nexport default AiCreditsPromptNotice\n"],"names":["Box","Button","Stack","Typography","useId","aiCreditsChoices","aiCreditsPromptText","aiCreditsBillingHref","AiCreditsChoiceButton","choice","busy","href","onClick","detailId","fullWidth","size","variant","recommended","color","disabled","key","aria-label","label","aria-describedby","data-choice","sx","minHeight","px","py","display","flexDirection","alignItems","justifyContent","textAlign","textTransform","lineHeight","component","fontWeight","id","opacity","detail","AiCreditsPromptNotice","prompt","noun","orgSlug","onBuildWhatFits","onSmaller","choices","smaller","Boolean","upgrade","role","mt","p","border","borderColor","borderRadius","bgcolor","spacing","map"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;AAEA,SAASA,GAAG,EAAEC,MAAM,EAAEC,KAAK,EAAEC,UAAU,QAAQ,gBAAe;AAC9D,SAASC,KAAK,QAAQ,QAAO;AAC7B,SACEC,gBAAgB,EAChBC,mBAAmB,QAGd,iCAA6B;AACpC,SAASC,oBAAoB,QAAQ,oBAAgB;AA4BrD,SAASC,sBAAsB,EAC7BC,MAAM,EACNC,IAAI,EACJC,IAAI,EACJC,OAAO,EAMR;IACC,MAAMC,WAAW,GAAGT,QAAQ,OAAO,CAAC;IACpC,qBACE,MAACH;QACCa,SAAS;QACTC,MAAK;QACLC,SAASP,OAAOQ,WAAW,GAAG,cAAc;QAC5CC,OAAM;QACNC,UAAUT,QAAQD,OAAOW,GAAG,KAAK;QACjCC,cAAYZ,OAAOa,KAAK;QACxBC,oBAAkBV;QAClBW,eAAaf,OAAOW,GAAG;OAClBT,OAAO;QAAEA;IAAK,IAAI;QAAEC;IAAQ;QACjCa,IAAI;YACFC,WAAW;YACXC,IAAI;YACJC,IAAI;YACJC,SAAS;YACTC,eAAe;YACfC,YAAY;YACZC,gBAAgB;YAChBC,WAAW;YACXC,eAAe;YACfC,YAAY;QACd;;0BAEA,KAAChC;gBAAWiC,WAAU;gBAAOpB,SAAQ;gBAAQS,IAAI;oBAAEY,YAAY;oBAAKnB,OAAO;gBAAU;0BAClFT,OAAOa,KAAK;;0BAEf,KAACnB;gBAAWmC,IAAIzB;gBAAUuB,WAAU;gBAAOpB,SAAQ;gBAAUS,IAAI;oBAAEP,OAAO;oBAAWqB,SAAS;gBAAI;0BAC/F9B,OAAO+B,MAAM;;;;AAItB;AAEA,OAAO,SAASC,sBAAsB,EACpCC,MAAM,EACNC,IAAI,EACJC,OAAO,EACPlC,OAAO,KAAK,EACZmC,eAAe,EACfC,SAAS,EACY;IACrB,MAAMC,UAAU1C,iBAAiBqC,QAAQ;QAAEM,SAASC,QAAQH;QAAYI,SAASD,QAAQL;IAAS;IAClG,qBACE,MAAC5C;QACCmD,MAAK;QACL9B,cAAW;QACXI,IAAI;YACF2B,IAAI;YACJC,GAAG;YACHC,QAAQ;YACRC,aAAa;YACbC,cAAc;YACdC,SAAS;QACX;;0BAEA,KAACtD;gBAAWa,SAAQ;gBAAQS,IAAI;oBAAEP,OAAO;gBAAe;0BACrDZ,oBAAoBoC,QAAQC;;0BAE/B,KAACzC;gBAAMwD,SAAS;gBAAGjC,IAAI;oBAAE2B,IAAI;gBAAI;0BAC9BL,QAAQY,GAAG,CAAC,CAAClD,uBACZ,KAACD;wBAECC,QAAQA;wBACRC,MAAMA;uBACDD,OAAOW,GAAG,KAAK,aAAawB,UAC7B;wBAAEjC,MAAMJ,qBAAqBqC;oBAAS,IACtC;wBAAEhC,SAASH,OAAOW,GAAG,KAAK,YAAY0B,YAAYD;oBAAgB,IALjEpC,OAAOW,GAAG;;;;AAW3B;AAEA,eAAeqB,sBAAqB"}

package/src/lib/components/ai-job-cancel.component.d.ts

@@ -0,0 +1,38 @@
+import type { MaybeTokenSource } from '@aglyn/shared-util-http/authorized-token';
+import { type ButtonProps } from '@mui/material';
+import { type ReactNode } from 'react';
+import { type AiJobSummary } from '../model/ai-jobs.types';
+/**
+ * Cancel an AI job, after saying what it does (AGL-3616). One confirm dialog
+ * and one request for every surface that offers Cancel — the job's page, a
+ * row of the site's AI jobs list, and the AI jobs list the top-bar chip
+ * opens — through the cancel door the Assist panel's list always used.
+ *
+ * `useAiJobCancel` owns the dialog: `ask(job)` opens it, Keep building
+ * closes it, and Cancel job posts the cancel and hands the job the door
+ * answered with to `onJob`, so the surface shows "Stopping…" or "Canceled"
+ * without waiting for its stream. A refusal stays in the dialog, in the
+ * door's own words.
+ */
+export declare function useAiJobCancel({ user, orgId, onJob, }: {
+    user: MaybeTokenSource;
+    orgId: string | null;
+    onJob?: (job: AiJobSummary) => void;
+}): {
+    ask: (job: AiJobSummary) => void;
+    busyJobId: string | null;
+    dialog: ReactNode;
+};
+/**
+ * The Cancel button: enabled while the job can still be stopped, and
+ * disabled with the reason as its tooltip once it is done, failed, canceled
+ * or already stopping.
+ */
+export declare function AiJobCancelButton({ job, user, orgId, onJob, size, variant, }: {
+    job: AiJobSummary;
+    user: MaybeTokenSource;
+    orgId: string | null;
+    onJob?: (job: AiJobSummary) => void;
+    size?: ButtonProps['size'];
+    variant?: ButtonProps['variant'];
+}): import("react").JSX.Element;

package/src/lib/components/ai-job-cancel.component.js

@@ -0,0 +1,156 @@
+/**
+ * @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.
+ */ 'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Alert, Box, Button, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, Tooltip } from "@mui/material";
+import { useCallback, useRef, useState } from "react";
+import { AI_JOB_CANCEL_CONFIRM_COPY, AI_JOB_CANCEL_TITLE, aiJobCancelBlockedReason } from "../model/ai-job-cancel-copy.js";
+import { AI_JOB_TERMINAL_STATUSES } from "../model/ai-jobs.types.js";
+import { cancelAiJobRequest } from "./ai-job-requests.js";
+/**
+ * Cancel an AI job, after saying what it does (AGL-3616). One confirm dialog
+ * and one request for every surface that offers Cancel — the job's page, a
+ * row of the site's AI jobs list, and the AI jobs list the top-bar chip
+ * opens — through the cancel door the Assist panel's list always used.
+ *
+ * `useAiJobCancel` owns the dialog: `ask(job)` opens it, Keep building
+ * closes it, and Cancel job posts the cancel and hands the job the door
+ * answered with to `onJob`, so the surface shows "Stopping…" or "Canceled"
+ * without waiting for its stream. A refusal stays in the dialog, in the
+ * door's own words.
+ */ export function useAiJobCancel({ user, orgId, onJob }) {
+    var _ref;
+    const [target, setTarget] = useState(null);
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState(null);
+    const onJobRef = useRef(onJob);
+    onJobRef.current = onJob;
+    const ask = useCallback((job)=>{
+        if (aiJobCancelBlockedReason(job)) return;
+        setError(null);
+        setTarget(job);
+    }, []);
+    const close = useCallback(()=>{
+        if (busy) return;
+        setTarget(null);
+        setError(null);
+    }, [
+        busy
+    ]);
+    const confirm = useCallback(async ()=>{
+        if (!target || !orgId) return;
+        setBusy(true);
+        setError(null);
+        const { job, error: refused } = await cancelAiJobRequest(user, orgId, target.id);
+        setBusy(false);
+        if (job) onJobRef.current == null ? void 0 : onJobRef.current.call(onJobRef, job);
+        if (refused) {
+            setError(refused);
+            return;
+        }
+        setTarget(null);
+    }, [
+        target,
+        orgId,
+        user
+    ]);
+    const dialog = /*#__PURE__*/ _jsxs(Dialog, {
+        open: target !== null,
+        onClose: close,
+        "aria-labelledby": "ai-job-cancel-title",
+        maxWidth: "xs",
+        fullWidth: true,
+        children: [
+            /*#__PURE__*/ _jsx(DialogTitle, {
+                id: "ai-job-cancel-title",
+                children: AI_JOB_CANCEL_TITLE
+            }),
+            /*#__PURE__*/ _jsxs(DialogContent, {
+                children: [
+                    /*#__PURE__*/ _jsx(DialogContentText, {
+                        children: AI_JOB_CANCEL_CONFIRM_COPY
+                    }),
+                    error ? /*#__PURE__*/ _jsx(Alert, {
+                        severity: "warning",
+                        sx: {
+                            mt: 2
+                        },
+                        children: error
+                    }) : null
+                ]
+            }),
+            /*#__PURE__*/ _jsxs(DialogActions, {
+                children: [
+                    /*#__PURE__*/ _jsx(Button, {
+                        onClick: close,
+                        disabled: busy,
+                        children: 'Keep building'
+                    }),
+                    /*#__PURE__*/ _jsx(Button, {
+                        color: "error",
+                        variant: "contained",
+                        onClick: ()=>void confirm(),
+                        disabled: busy || !orgId,
+                        children: busy ? 'Canceling…' : 'Cancel job'
+                    })
+                ]
+            })
+        ]
+    });
+    return {
+        ask,
+        busyJobId: busy ? (_ref = target == null ? void 0 : target.id) != null ? _ref : null : null,
+        dialog
+    };
+}
+/**
+ * The Cancel button: enabled while the job can still be stopped, and
+ * disabled with the reason as its tooltip once it is done, failed, canceled
+ * or already stopping.
+ */ export function AiJobCancelButton({ job, user, orgId, onJob, size = 'medium', variant = 'outlined' }) {
+    const { ask, busyJobId, dialog } = useAiJobCancel({
+        user,
+        orgId,
+        onJob
+    });
+    const blocked = aiJobCancelBlockedReason(job);
+    const stopping = Boolean(job.cancelRequested) && !AI_JOB_TERMINAL_STATUSES.includes(job.status);
+    const button = /*#__PURE__*/ _jsx(Button, {
+        size: size,
+        variant: variant,
+        color: "error",
+        disabled: Boolean(blocked) || busyJobId === job.id || !orgId,
+        onClick: ()=>ask(job),
+        children: stopping ? 'Stopping…' : 'Cancel'
+    });
+    return /*#__PURE__*/ _jsxs(_Fragment, {
+        children: [
+            blocked ? /*#__PURE__*/ _jsx(Tooltip, {
+                title: blocked,
+                children: /*#__PURE__*/ _jsx(Box, {
+                    component: "span",
+                    sx: {
+                        display: 'inline-flex'
+                    },
+                    children: button
+                })
+            }) : button,
+            dialog
+        ]
+    });
+}
+
+//# sourceMappingURL=ai-job-cancel.component.js.map

package/src/lib/components/ai-job-cancel.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-job-cancel.component.tsx"],"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'use client'\n\nimport type { MaybeTokenSource } from '@aglyn/shared-util-http/authorized-token'\nimport {\n  Alert,\n  Box,\n  Button,\n  type ButtonProps,\n  Dialog,\n  DialogActions,\n  DialogContent,\n  DialogContentText,\n  DialogTitle,\n  Tooltip,\n} from '@mui/material'\nimport { type ReactNode, useCallback, useRef, useState } from 'react'\nimport {\n  AI_JOB_CANCEL_CONFIRM_COPY,\n  AI_JOB_CANCEL_TITLE,\n  aiJobCancelBlockedReason,\n} from '../model/ai-job-cancel-copy'\nimport { AI_JOB_TERMINAL_STATUSES, type AiJobSummary } from '../model/ai-jobs.types'\nimport { cancelAiJobRequest } from './ai-job-requests'\n\n/**\n * Cancel an AI job, after saying what it does (AGL-3616). One confirm dialog\n * and one request for every surface that offers Cancel — the job's page, a\n * row of the site's AI jobs list, and the AI jobs list the top-bar chip\n * opens — through the cancel door the Assist panel's list always used.\n *\n * `useAiJobCancel` owns the dialog: `ask(job)` opens it, Keep building\n * closes it, and Cancel job posts the cancel and hands the job the door\n * answered with to `onJob`, so the surface shows \"Stopping…\" or \"Canceled\"\n * without waiting for its stream. A refusal stays in the dialog, in the\n * door's own words.\n */\nexport function useAiJobCancel({\n  user,\n  orgId,\n  onJob,\n}: {\n  user: MaybeTokenSource\n  orgId: string | null\n  onJob?: (job: AiJobSummary) => void\n}): { ask: (job: AiJobSummary) => void; busyJobId: string | null; dialog: ReactNode } {\n  const [target, setTarget] = useState<AiJobSummary | null>(null)\n  const [busy, setBusy] = useState(false)\n  const [error, setError] = useState<string | null>(null)\n  const onJobRef = useRef(onJob)\n  onJobRef.current = onJob\n\n  const ask = useCallback((job: AiJobSummary) => {\n    if (aiJobCancelBlockedReason(job)) return\n    setError(null)\n    setTarget(job)\n  }, [])\n  const close = useCallback(() => {\n    if (busy) return\n    setTarget(null)\n    setError(null)\n  }, [busy])\n  const confirm = useCallback(async () => {\n    if (!target || !orgId) return\n    setBusy(true)\n    setError(null)\n    const { job, error: refused } = await cancelAiJobRequest(user, orgId, target.id)\n    setBusy(false)\n    if (job) onJobRef.current?.(job)\n    if (refused) {\n      setError(refused)\n      return\n    }\n    setTarget(null)\n  }, [target, orgId, user])\n\n  const dialog = (\n    <Dialog open={target !== null} onClose={close} aria-labelledby=\"ai-job-cancel-title\" maxWidth=\"xs\" fullWidth>\n      <DialogTitle id=\"ai-job-cancel-title\">{AI_JOB_CANCEL_TITLE}</DialogTitle>\n      <DialogContent>\n        <DialogContentText>{AI_JOB_CANCEL_CONFIRM_COPY}</DialogContentText>\n        {error ? (\n          <Alert severity=\"warning\" sx={{ mt: 2 }}>\n            {error}\n          </Alert>\n        ) : null}\n      </DialogContent>\n      <DialogActions>\n        <Button onClick={close} disabled={busy}>\n          {'Keep building'}\n        </Button>\n        <Button color=\"error\" variant=\"contained\" onClick={() => void confirm()} disabled={busy || !orgId}>\n          {busy ? 'Canceling…' : 'Cancel job'}\n        </Button>\n      </DialogActions>\n    </Dialog>\n  )\n  return { ask, busyJobId: busy ? (target?.id ?? null) : null, dialog }\n}\n\n/**\n * The Cancel button: enabled while the job can still be stopped, and\n * disabled with the reason as its tooltip once it is done, failed, canceled\n * or already stopping.\n */\nexport function AiJobCancelButton({\n  job,\n  user,\n  orgId,\n  onJob,\n  size = 'medium',\n  variant = 'outlined',\n}: {\n  job: AiJobSummary\n  user: MaybeTokenSource\n  orgId: string | null\n  onJob?: (job: AiJobSummary) => void\n  size?: ButtonProps['size']\n  variant?: ButtonProps['variant']\n}) {\n  const { ask, busyJobId, dialog } = useAiJobCancel({ user, orgId, onJob })\n  const blocked = aiJobCancelBlockedReason(job)\n  const stopping = Boolean(job.cancelRequested) && !AI_JOB_TERMINAL_STATUSES.includes(job.status)\n  const button = (\n    <Button\n      size={size}\n      variant={variant}\n      color=\"error\"\n      disabled={Boolean(blocked) || busyJobId === job.id || !orgId}\n      onClick={() => ask(job)}\n    >\n      {stopping ? 'Stopping…' : 'Cancel'}\n    </Button>\n  )\n  return (\n    <>\n      {blocked ? (\n        <Tooltip title={blocked}>\n          {/* A disabled button fires no pointer events; the span carries the tooltip. */}\n          <Box component=\"span\" sx={{ display: 'inline-flex' }}>\n            {button}\n          </Box>\n        </Tooltip>\n      ) : (\n        button\n      )}\n      {dialog}\n    </>\n  )\n}\n"],"names":["Alert","Box","Button","Dialog","DialogActions","DialogContent","DialogContentText","DialogTitle","Tooltip","useCallback","useRef","useState","AI_JOB_CANCEL_CONFIRM_COPY","AI_JOB_CANCEL_TITLE","aiJobCancelBlockedReason","AI_JOB_TERMINAL_STATUSES","cancelAiJobRequest","useAiJobCancel","user","orgId","onJob","target","setTarget","busy","setBusy","error","setError","onJobRef","current","ask","job","close","confirm","refused","id","dialog","open","onClose","aria-labelledby","maxWidth","fullWidth","severity","sx","mt","onClick","disabled","color","variant","busyJobId","AiJobCancelButton","size","blocked","stopping","Boolean","cancelRequested","includes","status","button","title","component","display"],"mappings":"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"}

package/src/lib/components/ai-job-plan.component.d.ts

@@ -16,6 +16,7 @@
  */
 import { type AiBuildPlanEmbed } from '../model/ai-build-plan';
 import type { AiJobReview, AiJobSummary } from '../model/ai-jobs.types';
+import type { AiJobResumeOptions } from './ai-job-requests';
 import { AiSiteStarterFallback } from './ai-site-starter-fallback.component';
 /**
  * A job's plan and what it waits for (AGL-2935), inside the AI jobs drawer
@@ -31,9 +32,7 @@ export interface AiJobPlanProps {
      * Confirms the plan, or tries the refused step again. A build whose request
      * asked to publish confirms with `publish` when its box is ticked (AGL-3616).
      */
-    onResume: (job: AiJobSummary, options?: {
-        publish?: boolean;
-    }) => void;
+    onResume: (job: AiJobSummary, options?: AiJobResumeOptions) => void;
     /** A resume for this job is in flight. */
     busy?: boolean;
     /**
@@ -47,6 +46,8 @@ export interface AiJobPlanProps {
      * that did not work out (AGL-3594); the action is drawn only when given.
      */
     user?: Parameters<typeof AiSiteStarterFallback>[0]['user'];
+    /** The workspace's path slug, for the Upgrade a Free build past what is left offers (AGL-3722). */
+    orgSlug?: string | null;
 }
 /**
  * Where a refused answer broke its rules, and the outline of those parts, as
@@ -62,5 +63,5 @@ export declare function aiJobReviewDetails(review: AiJobReview | null): string[]
  * host's code loads when a visitor reaches it, whether or not they press play.
  */
 export declare function aiPlanEmbedLine(embed: AiBuildPlanEmbed, named: (ref: string) => string): string;
-export declare function AiJobPlan({ job, onResume, busy, staff, user, }: AiJobPlanProps): JSX.Element | null;
+export declare function AiJobPlan({ job, onResume, busy, staff, user, orgSlug, }: AiJobPlanProps): JSX.Element | null;
 export default AiJobPlan;

package/src/lib/components/ai-job-plan.component.js

@@ -1,3 +1,4 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
  * @license
@@ -15,7 +16,10 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ import { AI_BUILD_PLAN_CREATION_NOUNS, AI_BUILD_PLAN_EMBED_HOST_NAMES, isAiPlanNewRef } from "../model/ai-build-plan.js";
-import { aiJobCreditEstimate } from "../model/ai-build-job.js";
+import { aiBuildFreePageCapNote, aiBuildSmaller, aiJobCreditRange } from "../model/ai-build-job.js";
+import { aiCreditRangeText, aiCreditsPromptFor } from "../model/ai-credit-estimate.js";
+import { aiFreeCreditsResetLabel } from "../model/ai-site-job.js";
+import { AiCreditsPromptNotice } from "./ai-credits-prompt.component.js";
 import { aiBuildOpNoun } from "../model/ai-build-progress.js";
 import { aiJobConfirmingOwnPlan } from "../model/ai-job-activity.js";
 import { aiSiteStarterFallbackOffered } from "../model/ai-job-failure-copy.js";
@@ -67,8 +71,8 @@ import { useState } from "react";
     const link = embed.url ? ` playing ${embed.url}` : ', its link left for you to paste';
     return `Embeds a ${host} player on ${where}${link}, as you asked (“${embed.asked}”). It loads ${host}’s own code when a visitor reaches it, whether or not they press play.`;
 }
-export function AiJobPlan({ job, onResume, busy = false, staff = false, user }) {
-    var _plan_items, _plan_embeds;
+export function AiJobPlan({ job, onResume, busy = false, staff = false, user, orgSlug }) {
+    var _ref, _plan_items, _plan_embeds;
     const [detailsOpen, setDetailsOpen] = useState(false);
     // Unticked until the person ticks it: a build publishes only when its
     // request asked AND they confirm it here (AGL-3616).
@@ -84,11 +88,20 @@ export function AiJobPlan({ job, onResume, busy = false, staff = false, user })
     const waiting = job.status === 'needs_review' && review !== null && !aiJobConfirmingOwnPlan(job);
     // The guard rail (AGL-2911): what the plan is estimated to cost is read
     // before it is confirmed, not after it has been spent. An estimate, and
-    // said to be one — the plan's own passes at the nominal credits a step
-    // holds, where what a step really costs is its model's tokens. A page job
+    // said to be one: what it is likely to cost — what builds like it measured
+    // — and its ceiling, every pass at its reserve (AGL-3722). A page job
     // counts the creations it builds before its page (AGL-3031).
-    const estimate = plan && waiting && review.reason === 'plan' ? aiJobCreditEstimate(job.kind, plan) : 0;
+    const range = plan && waiting && review.reason === 'plan' ? aiJobCreditRange(job.kind, plan) : null;
+    // A Free build past what is left asks first (AGL-3722): build what fits,
+    // the home page first, or upgrade — never a refusal with no way on.
+    const freeCredits = (_ref = review == null ? void 0 : review.freeCredits) != null ? _ref : null;
+    const prompt = plan && range && job.kind === 'build' ? aiCreditsPromptFor(range, freeCredits, aiBuildSmaller(plan)) : null;
+    // A Free build at its page cap says so (AGL-3722): pages past it were left for a later request.
+    const pageCapNote = plan && waiting && review.reason === 'plan' && job.kind === 'build' ? aiBuildFreePageCapNote(plan, Boolean(freeCredits)) : null;
     const offersPublish = job.kind === 'build' && job.publishAsked === true && waiting && review.reason === 'plan';
+    const publishing = offersPublish && publish ? {
+        publish: true
+    } : {};
     return /*#__PURE__*/ _jsxs(Box, {
         sx: {
             mt: 1
@@ -206,14 +219,26 @@ export function AiJobPlan({ job, onResume, busy = false, staff = false, user })
                     })
                 ]
             }),
-            estimate > 0 && /*#__PURE__*/ _jsx(Typography, {
+            range && range.ceiling > 0 && /*#__PURE__*/ _jsxs(Typography, {
                 variant: "caption",
                 color: "text.secondary",
                 sx: {
                     display: 'block',
                     mt: 1
                 },
-                children: `Estimated cost: about ${estimate.toLocaleString('en-US')} credits. What it costs is what its steps spend.`
+                children: [
+                    `Estimated cost: ${aiCreditRangeText(range)}. What it costs is what its steps spend.`,
+                    freeCredits && !prompt ? ` You have ${freeCredits.left.toLocaleString('en-US')} of your free AI credits left this month, until ${aiFreeCreditsResetLabel(freeCredits.resetsOn)}.` : ''
+                ]
+            }),
+            pageCapNote && /*#__PURE__*/ _jsx(Typography, {
+                variant: "caption",
+                color: "text.secondary",
+                sx: {
+                    display: 'block',
+                    mt: 0.5
+                },
+                children: pageCapNote
             }),
             waiting && review.retryRefusal && review.reason !== 'plan' && /*#__PURE__*/ _jsx(Typography, {
                 variant: "caption",
@@ -239,15 +264,26 @@ export function AiJobPlan({ job, onResume, busy = false, staff = false, user })
                     children: 'Publish the new pages when they are built'
                 })
             }),
-            waiting && /*#__PURE__*/ _jsx(Button, {
+            waiting && prompt && /*#__PURE__*/ _jsx(AiCreditsPromptNotice, {
+                prompt: prompt,
+                noun: "build",
+                orgSlug: orgSlug,
+                busy: busy,
+                onBuildWhatFits: ()=>onResume(job, _extends({}, publishing, {
+                        creditsConfirmed: true
+                    })),
+                onSmaller: ()=>onResume(job, _extends({}, publishing, {
+                        creditsConfirmed: true,
+                        reduce: 'first-page'
+                    }))
+            }),
+            waiting && !prompt && /*#__PURE__*/ _jsx(Button, {
                 size: "small",
                 variant: "contained",
                 // Disabled with its reason above when the Free allowance left
                 // cannot pay for another try (AGL-3594).
                 disabled: busy || review.reason !== 'plan' && Boolean(review.retryRefusal),
-                onClick: ()=>onResume(job, offersPublish && publish ? {
-                        publish: true
-                    } : undefined),
+                onClick: ()=>onResume(job, offersPublish && publish ? publishing : undefined),
                 sx: {
                     mt: 1
                 },