@aglyn/plugins-ai 1.0.0-beta.225 → 1.0.0-beta.227

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

@@ -0,0 +1,210 @@
+/**
+ * @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 } from "react/jsx-runtime";
+import { AppLink } from "@aglyn/shared-ui-jsx";
+import { Alert, Box, Button, Chip, CircularProgress, Stack, Typography } from "@mui/material";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { AI_JOB_PHASE_LABELS, aiJobPhase } from "../model/ai-job-activity.js";
+import { AI_JOB_TERMINAL_STATUSES } from "../model/ai-jobs.types.js";
+import { AiJobPlan } from "./ai-job-plan.component.js";
+import { cancelAiJobRequest, resumeAiJobRequest } from "./ai-job-requests.js";
+import { openAiJobs, publishAiJob } from "./ai-jobs-store.js";
+import { followAiJobEvents } from "./ai-job-events.js";
+import { aiJobPrimaryLink } from "./ai-job-links.js";
+import { aiJobProblem } from "./use-ai-job-run.js";
+/** What the status line says in each phase, and how loudly. */ const PHASE_LINE = {
+    queued: {
+        severity: 'info',
+        text: 'Queued. It starts in a moment.'
+    },
+    planning: {
+        severity: 'info',
+        text: 'Planning. The plan appears here when it is ready.'
+    },
+    'plan-ready': {
+        severity: 'warning',
+        text: 'Your plan is ready. Read it below and confirm it to build — nothing is built until you do.'
+    },
+    building: {
+        severity: 'info',
+        text: 'Building. Everything it builds is an unpublished draft.'
+    },
+    attention: {
+        severity: 'warning',
+        text: 'The job stopped and needs you.'
+    },
+    done: {
+        severity: 'success',
+        text: 'Done. Your drafts are ready to open.'
+    },
+    failed: {
+        severity: 'error',
+        text: 'The job stopped before it finished.'
+    },
+    canceled: {
+        severity: 'info',
+        text: 'The job was canceled.'
+    }
+};
+/** The org slug a console address names: its first segment. */ function orgSlugFromLocation() {
+    var _path_split_;
+    var _globalThis_location;
+    const path = typeof ((_globalThis_location = globalThis.location) == null ? void 0 : _globalThis_location.pathname) === 'string' ? globalThis.location.pathname : '';
+    return (_path_split_ = path.split('/')[1]) != null ? _path_split_ : '';
+}
+/** Follows `initial` through the events route while mounted, and lets a decision replace it. */ export function useFollowedAiJob(user, orgId, initial) {
+    const userRef = useRef(user);
+    userRef.current = user;
+    const [job, setJob] = useState(initial);
+    useEffect(()=>setJob(initial), [
+        initial
+    ]);
+    // One stream while the job is moving. A job parked for the person settles
+    // the stream; confirming moves it again, and the status change re-opens it.
+    const moving = job.status === 'queued' || job.status === 'running';
+    useEffect(()=>{
+        if (!moving) return undefined;
+        const controller = new AbortController();
+        void followAiJobEvents(()=>userRef.current, orgId, job.id, controller.signal, setJob);
+        return ()=>controller.abort();
+    }, [
+        moving,
+        orgId,
+        job.id
+    ]);
+    const replace = useCallback((next)=>{
+        publishAiJob(next);
+        setJob(next);
+    }, []);
+    return [
+        job,
+        replace
+    ];
+}
+export function AiJobFollow({ job: initial, orgId, orgSlug, user, intro, onOpenJobs, staff = false }) {
+    const [job, replace] = useFollowedAiJob(user, orgId, initial);
+    const [busy, setBusy] = useState(false);
+    const [notice, setNotice] = useState(null);
+    const phase = aiJobPhase(job);
+    const line = PHASE_LINE[phase];
+    const moving = phase === 'queued' || phase === 'planning' || phase === 'building';
+    const settled = AI_JOB_TERMINAL_STATUSES.includes(job.status);
+    const primary = aiJobPrimaryLink(job, orgSlug || orgSlugFromLocation());
+    const problem = phase === 'attention' || phase === 'failed' ? aiJobProblem(job, line.text) : null;
+    const stepsDone = job.steps.filter((step)=>step.status === 'done').length;
+    const decide = useCallback(async (request)=>{
+        setBusy(true);
+        setNotice(null);
+        const { job: next, error } = await request();
+        if (next) replace(next);
+        if (error) setNotice(error);
+        setBusy(false);
+    }, [
+        replace
+    ]);
+    const openJobs = ()=>{
+        openAiJobs({
+            jobId: job.id
+        });
+        onOpenJobs == null ? void 0 : onOpenJobs();
+    };
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 2,
+        "aria-live": "polite",
+        children: [
+            /*#__PURE__*/ _jsx(Typography, {
+                variant: "body2",
+                color: "text.secondary",
+                children: intro
+            }),
+            /*#__PURE__*/ _jsxs(Alert, {
+                severity: line.severity,
+                icon: moving ? /*#__PURE__*/ _jsx(CircularProgress, {
+                    size: 18,
+                    "aria-label": AI_JOB_PHASE_LABELS[phase]
+                }) : undefined,
+                action: /*#__PURE__*/ _jsx(Button, {
+                    color: "inherit",
+                    size: "small",
+                    variant: "outlined",
+                    onClick: openJobs,
+                    children: 'Open AI jobs'
+                }),
+                children: [
+                    /*#__PURE__*/ _jsxs(Stack, {
+                        direction: "row",
+                        spacing: 1,
+                        sx: {
+                            alignItems: 'center',
+                            flexWrap: 'wrap',
+                            rowGap: 0.5
+                        },
+                        children: [
+                            /*#__PURE__*/ _jsx(Chip, {
+                                size: "small",
+                                label: AI_JOB_PHASE_LABELS[phase]
+                            }),
+                            job.steps.length > 1 ? /*#__PURE__*/ _jsx(Typography, {
+                                variant: "caption",
+                                color: "text.secondary",
+                                children: `${stepsDone} of ${job.steps.length} steps`
+                            }) : null
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        sx: {
+                            mt: 0.5
+                        },
+                        children: problem != null ? problem : line.text
+                    })
+                ]
+            }),
+            primary ? /*#__PURE__*/ _jsx(Box, {
+                children: /*#__PURE__*/ _jsx(Button, {
+                    variant: "contained",
+                    component: AppLink,
+                    href: primary.href,
+                    children: primary.label
+                })
+            }) : null,
+            /*#__PURE__*/ _jsx(AiJobPlan, {
+                job: job,
+                onResume: (target)=>void decide(()=>resumeAiJobRequest(user, orgId, target)),
+                busy: busy,
+                staff: staff,
+                // "Use the starter site instead" on a guided start that did not work out (AGL-3594).
+                user: user != null ? user : undefined
+            }),
+            !settled ? /*#__PURE__*/ _jsx(Box, {
+                children: /*#__PURE__*/ _jsx(Button, {
+                    size: "small",
+                    disabled: busy,
+                    onClick: ()=>void decide(()=>cancelAiJobRequest(user, orgId, job.id)),
+                    children: 'Cancel job'
+                })
+            }) : null,
+            notice ? /*#__PURE__*/ _jsx(Alert, {
+                severity: "warning",
+                children: notice
+            }) : null
+        ]
+    });
+}
+export default AiJobFollow;
+
+//# sourceMappingURL=ai-job-follow.component.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-job-follow.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 { AppLink } from '@aglyn/shared-ui-jsx'\nimport type { MaybeTokenSource } from '@aglyn/shared-util-http/authorized-token'\nimport { Alert, Box, Button, Chip, CircularProgress, Stack, Typography } from '@mui/material'\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport {\n  AI_JOB_PHASE_LABELS,\n  aiJobPhase,\n  type AiJobPhase,\n} from '../model/ai-job-activity'\nimport { AI_JOB_TERMINAL_STATUSES, type AiJobSummary } from '../model/ai-jobs.types'\nimport { AiJobPlan } from './ai-job-plan.component'\nimport { cancelAiJobRequest, resumeAiJobRequest } from './ai-job-requests'\nimport { openAiJobs, publishAiJob } from './ai-jobs-store'\nimport { followAiJobEvents } from './ai-job-events'\nimport { aiJobPrimaryLink } from './ai-job-links'\nimport { aiJobProblem } from './use-ai-job-run'\n\n/**\n * A JOB, WATCHED AND DECIDED WHERE IT WAS STARTED (AGL-3593).\n *\n * The dialog that starts a planned job — \"Plan my site\", \"Plan the page\" —\n * used to end on a sentence pointing at a drawer a person had to go and find,\n * and a person who could not find it never got their site built. This is\n * what such a dialog shows instead, once its job exists:\n *\n *  - where the job stands, live — queued, planning, plan ready, building,\n *    then done or failed — read from the same events route the AI jobs\n *    drawer follows;\n *  - the plan, once it is ready, with the drawer's own plan component and its\n *    Confirm, through the same request the drawer sends\n *    ({@link resumeAiJobRequest}), and Cancel beside it;\n *  - once it is done, the one action that opens what it built;\n *  - and always \"Open AI jobs\", which follows the job anywhere else in the\n *    console.\n *\n * Closing the dialog stops following; the job carries on, and the top-bar\n * indicator, the Assist launcher and the notification the machine raises say\n * when it needs the person again.\n */\n\nexport interface AiJobFollowProps {\n  /** The job as the create door answered with it. */\n  job: AiJobSummary\n  orgId: string\n  /**\n   * Path slug for the link to what the job built. A dialog mounted on a\n   * console page that names its org can leave it out: the slug is the first\n   * segment of every org-scoped console address.\n   */\n  orgSlug?: string | null\n  user: MaybeTokenSource\n  /** What the dialog says about the job it started, above its live status. */\n  intro: string\n  /**\n   * Closes the dialog. Called beside opening AI jobs, because a dialog\n   * covers the panel AI jobs opens in.\n   */\n  onOpenJobs?: () => void\n  /** The viewer is staff (AGL-3078): a refused answer's details are theirs to open. */\n  staff?: boolean\n}\n\n/** What the status line says in each phase, and how loudly. */\nconst PHASE_LINE: Readonly<\n  Record<AiJobPhase, { severity: 'info' | 'warning' | 'success' | 'error'; text: string }>\n> = {\n  queued: { severity: 'info', text: 'Queued. It starts in a moment.' },\n  planning: { severity: 'info', text: 'Planning. The plan appears here when it is ready.' },\n  'plan-ready': {\n    severity: 'warning',\n    text: 'Your plan is ready. Read it below and confirm it to build — nothing is built until you do.',\n  },\n  building: { severity: 'info', text: 'Building. Everything it builds is an unpublished draft.' },\n  attention: { severity: 'warning', text: 'The job stopped and needs you.' },\n  done: { severity: 'success', text: 'Done. Your drafts are ready to open.' },\n  failed: { severity: 'error', text: 'The job stopped before it finished.' },\n  canceled: { severity: 'info', text: 'The job was canceled.' },\n}\n\n/** The org slug a console address names: its first segment. */\nfunction orgSlugFromLocation(): string {\n  const path = typeof globalThis.location?.pathname === 'string' ? globalThis.location.pathname : ''\n  return path.split('/')[1] ?? ''\n}\n\n/** Follows `initial` through the events route while mounted, and lets a decision replace it. */\nexport function useFollowedAiJob(\n  user: MaybeTokenSource,\n  orgId: string,\n  initial: AiJobSummary,\n): [AiJobSummary, (job: AiJobSummary) => void] {\n  const userRef = useRef(user)\n  userRef.current = user\n  const [job, setJob] = useState(initial)\n  useEffect(() => setJob(initial), [initial])\n\n  // One stream while the job is moving. A job parked for the person settles\n  // the stream; confirming moves it again, and the status change re-opens it.\n  const moving = job.status === 'queued' || job.status === 'running'\n  useEffect(() => {\n    if (!moving) return undefined\n    const controller = new AbortController()\n    void followAiJobEvents(() => userRef.current, orgId, job.id, controller.signal, setJob)\n    return () => controller.abort()\n  }, [moving, orgId, job.id])\n\n  const replace = useCallback((next: AiJobSummary) => {\n    publishAiJob(next)\n    setJob(next)\n  }, [])\n  return [job, replace]\n}\n\nexport function AiJobFollow({\n  job: initial,\n  orgId,\n  orgSlug,\n  user,\n  intro,\n  onOpenJobs,\n  staff = false,\n}: AiJobFollowProps) {\n  const [job, replace] = useFollowedAiJob(user, orgId, initial)\n  const [busy, setBusy] = useState(false)\n  const [notice, setNotice] = useState<string | null>(null)\n  const phase = aiJobPhase(job)\n  const line = PHASE_LINE[phase]\n  const moving = phase === 'queued' || phase === 'planning' || phase === 'building'\n  const settled = AI_JOB_TERMINAL_STATUSES.includes(job.status)\n  const primary = aiJobPrimaryLink(job, orgSlug || orgSlugFromLocation())\n  const problem = phase === 'attention' || phase === 'failed' ? aiJobProblem(job, line.text) : null\n  const stepsDone = job.steps.filter((step) => step.status === 'done').length\n\n  const decide = useCallback(\n    async (request: () => ReturnType<typeof resumeAiJobRequest>) => {\n      setBusy(true)\n      setNotice(null)\n      const { job: next, error } = await request()\n      if (next) replace(next)\n      if (error) setNotice(error)\n      setBusy(false)\n    },\n    [replace],\n  )\n\n  const openJobs = () => {\n    openAiJobs({ jobId: job.id })\n    onOpenJobs?.()\n  }\n\n  return (\n    <Stack spacing={2} aria-live=\"polite\">\n      <Typography variant=\"body2\" color=\"text.secondary\">\n        {intro}\n      </Typography>\n      <Alert\n        severity={line.severity}\n        icon={moving ? <CircularProgress size={18} aria-label={AI_JOB_PHASE_LABELS[phase]} /> : undefined}\n        action={\n          <Button color=\"inherit\" size=\"small\" variant=\"outlined\" onClick={openJobs}>\n            {'Open AI jobs'}\n          </Button>\n        }\n      >\n        <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center', flexWrap: 'wrap', rowGap: 0.5 }}>\n          <Chip size=\"small\" label={AI_JOB_PHASE_LABELS[phase]} />\n          {job.steps.length > 1 ? (\n            <Typography variant=\"caption\" color=\"text.secondary\">\n              {`${stepsDone} of ${job.steps.length} steps`}\n            </Typography>\n          ) : null}\n        </Stack>\n        <Typography variant=\"body2\" sx={{ mt: 0.5 }}>\n          {problem ?? line.text}\n        </Typography>\n      </Alert>\n      {primary ? (\n        <Box>\n          <Button variant=\"contained\" component={AppLink} href={primary.href}>\n            {primary.label}\n          </Button>\n        </Box>\n      ) : null}\n      {/* The drawer's own plan and its Confirm, on the drawer's request. */}\n      <AiJobPlan\n        job={job}\n        onResume={(target) => void decide(() => resumeAiJobRequest(user, orgId, target))}\n        busy={busy}\n        staff={staff}\n        // \"Use the starter site instead\" on a guided start that did not work out (AGL-3594).\n        user={user ?? undefined}\n      />\n      {!settled ? (\n        <Box>\n          <Button\n            size=\"small\"\n            disabled={busy}\n            onClick={() => void decide(() => cancelAiJobRequest(user, orgId, job.id))}\n          >\n            {'Cancel job'}\n          </Button>\n        </Box>\n      ) : null}\n      {notice ? <Alert severity=\"warning\">{notice}</Alert> : null}\n    </Stack>\n  )\n}\n\nexport default AiJobFollow\n"],"names":["AppLink","Alert","Box","Button","Chip","CircularProgress","Stack","Typography","useCallback","useEffect","useRef","useState","AI_JOB_PHASE_LABELS","aiJobPhase","AI_JOB_TERMINAL_STATUSES","AiJobPlan","cancelAiJobRequest","resumeAiJobRequest","openAiJobs","publishAiJob","followAiJobEvents","aiJobPrimaryLink","aiJobProblem","PHASE_LINE","queued","severity","text","planning","building","attention","done","failed","canceled","orgSlugFromLocation","path","globalThis","location","pathname","split","useFollowedAiJob","user","orgId","initial","userRef","current","job","setJob","moving","status","undefined","controller","AbortController","id","signal","abort","replace","next","AiJobFollow","orgSlug","intro","onOpenJobs","staff","busy","setBusy","notice","setNotice","phase","line","settled","includes","primary","problem","stepsDone","steps","filter","step","length","decide","request","error","openJobs","jobId","spacing","aria-live","variant","color","icon","size","aria-label","action","onClick","direction","sx","alignItems","flexWrap","rowGap","label","mt","component","href","onResume","target","disabled"],"mappings":"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"}

package/src/lib/components/ai-job-links.d.ts

@@ -0,0 +1,42 @@
+import { AI_SITE_BUILD_HREF } from '../model/ai-job-notice';
+import type { AiJobOutput, AiJobSummary } from '../model/ai-jobs.types';
+/**
+ * Where "open draft" goes, or `null` when the output has no page of its
+ * own — a `text` output carries its copy on the job and is shown inline.
+ * A versioned resource opens in the besigner on the version the job wrote;
+ * one the console lists without a detail page opens its list; a `theme`
+ * proposal opens the site's Theme section, where it is put in the editor.
+ *
+ * A console URL names a site by its SUBDOMAIN: the `[host]` segment resolves
+ * through the member's host projection by subdomain, never by document id.
+ * So an output that carries no `hostSubdomain` gets no link rather than one
+ * that opens no site.
+ */
+export declare function aiJobOutputHref(output: AiJobOutput, orgSlug: string): string | null;
+/**
+ * The ONE action a finished job's row, its notification and the dialog that
+ * started it lead with (AGL-3593): what the job built. Several pages from one
+ * job — a site's — open the site's Pages list, where they wait as drafts; one
+ * output with a page of its own opens that page; anything else has no single
+ * place to go, and the row's own links stand. `null` until the job is done.
+ */
+export declare function aiJobPrimaryLink(job: Pick<AiJobSummary, 'status' | 'outputs'>, orgSlug: string): {
+    href: string;
+    label: string;
+} | null;
+export { AI_SITE_BUILD_HREF };
+/**
+ * The "Building your site" page for one site job (AGL-3594): linkable, so the
+ * guided start lands on it, a reload keeps it and a notification opens it.
+ * `null` without the org slug or the site's subdomain a console URL needs.
+ */
+export declare function aiSiteBuildHref(orgSlug: string | null | undefined, hostSubdomain: string | null | undefined, jobId: string): string | null;
+/**
+ * A finished site's two ways in (AGL-3594): its first page's draft, opened in
+ * the console's preview of that version, and the Pages list every draft waits
+ * in. Either is `null` where the job reported nothing to open.
+ */
+export declare function aiSiteBuildDoneLinks(job: Pick<AiJobSummary, 'outputs'>, orgSlug: string): {
+    view: string | null;
+    pages: string | null;
+};

package/src/lib/components/ai-job-links.js

@@ -0,0 +1,140 @@
+/**
+ * @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 { buildRoute, Route } from "@aglyn/aglyn/app-utils/console-routes";
+import { pluginRecordHref, pluginRecordListHref } from "@aglyn/aglyn/plugin-manager/plugin-record-routes";
+import { AI_JOB_BESIGNER_SEGMENT as BESIGNER_SEGMENT, AI_SITE_BUILD_HREF } from "../model/ai-job-notice.js";
+// Where a job's work opens in the console (AGL-2904), shared by the AI jobs
+// drawer and every dialog that follows the job it started (AGL-3593).
+/**
+ * Where "open draft" goes, or `null` when the output has no page of its
+ * own — a `text` output carries its copy on the job and is shown inline.
+ * A versioned resource opens in the besigner on the version the job wrote;
+ * one the console lists without a detail page opens its list; a `theme`
+ * proposal opens the site's Theme section, where it is put in the editor.
+ *
+ * A console URL names a site by its SUBDOMAIN: the `[host]` segment resolves
+ * through the member's host projection by subdomain, never by document id.
+ * So an output that carries no `hostSubdomain` gets no link rather than one
+ * that opens no site.
+ */ export function aiJobOutputHref(output, orgSlug) {
+    const host = output.hostSubdomain;
+    if (!orgSlug || !host) return null;
+    const segment = BESIGNER_SEGMENT[output.resource];
+    if (segment) {
+        const base = `/${orgSlug}/hosts/${host}/${segment}/${output.id}`;
+        return output.versionId ? `${base}/versions/${output.versionId}/besigner` : base;
+    }
+    if (output.resource === 'product') {
+        // The catalog a drafted product lands in: the commerce plugin's address
+        // for it (AGL-3080), or no link where commerce is not loaded.
+        return pluginRecordListHref('product', {
+            orgSlug,
+            host
+        });
+    }
+    if (output.resource === 'workflow') {
+        // A drafted automation is an action (AGL-2919), listed switched off on
+        // the workflows plugin's list of actions, or no link where it is not loaded.
+        return pluginRecordListHref('action', {
+            orgSlug,
+            host
+        });
+    }
+    if (output.resource === 'theme') {
+        return buildRoute(Route.HOST_SETUP_THEME, {
+            orgSlug,
+            host
+        });
+    }
+    if (output.resource === 'form') {
+        // A new form has no version for the besigner to open: its own page — the
+        // forms plugin's address for it — mints the first one, and holds the
+        // routing and consent it declares.
+        return pluginRecordHref('form', {
+            orgSlug,
+            host
+        }, output.id);
+    }
+    if (output.resource === 'campaign') {
+        // A campaign's page is the marketing plugin's, under the site: its
+        // address for the campaign (AGL-3080), or no link where it is not loaded.
+        return pluginRecordHref('campaign', {
+            orgSlug,
+            host
+        }, output.id);
+    }
+    return null;
+}
+/**
+ * The ONE action a finished job's row, its notification and the dialog that
+ * started it lead with (AGL-3593): what the job built. Several pages from one
+ * job — a site's — open the site's Pages list, where they wait as drafts; one
+ * output with a page of its own opens that page; anything else has no single
+ * place to go, and the row's own links stand. `null` until the job is done.
+ */ export function aiJobPrimaryLink(job, orgSlug) {
+    if (job.status !== 'done' || !orgSlug) return null;
+    const screens = job.outputs.filter((output)=>output.resource === 'screen' && output.hostSubdomain);
+    if (screens.length > 1) {
+        return {
+            href: buildRoute(Route.HOST_SCREENS, {
+                orgSlug,
+                host: String(screens[0].hostSubdomain)
+            }),
+            label: 'Open your draft pages'
+        };
+    }
+    for (const output of job.outputs){
+        const href = aiJobOutputHref(output, orgSlug);
+        if (href) {
+            return {
+                href,
+                label: output.resource === 'screen' ? 'Open the draft page' : `Open ${output.label}`
+            };
+        }
+    }
+    return null;
+}
+export { AI_SITE_BUILD_HREF };
+/**
+ * The "Building your site" page for one site job (AGL-3594): linkable, so the
+ * guided start lands on it, a reload keeps it and a notification opens it.
+ * `null` without the org slug or the site's subdomain a console URL needs.
+ */ export function aiSiteBuildHref(orgSlug, hostSubdomain, jobId) {
+    if (!orgSlug || !hostSubdomain || !jobId) return null;
+    return `/${orgSlug}/hosts/${hostSubdomain}${AI_SITE_BUILD_HREF}/${encodeURIComponent(jobId)}`;
+}
+/**
+ * A finished site's two ways in (AGL-3594): its first page's draft, opened in
+ * the console's preview of that version, and the Pages list every draft waits
+ * in. Either is `null` where the job reported nothing to open.
+ */ export function aiSiteBuildDoneLinks(job, orgSlug) {
+    const screens = job.outputs.filter((output)=>output.resource === 'screen' && output.hostSubdomain);
+    const first = screens[0];
+    if (!first || !orgSlug) return {
+        view: null,
+        pages: null
+    };
+    const host = String(first.hostSubdomain);
+    return {
+        view: first.versionId ? `/${orgSlug}/hosts/${host}/screens/${first.id}/versions/${first.versionId}/view` : null,
+        pages: buildRoute(Route.HOST_SCREENS, {
+            orgSlug,
+            host
+        })
+    };
+}
+
+//# sourceMappingURL=ai-job-links.js.map

package/src/lib/components/ai-job-links.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-job-links.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 */\nimport { buildRoute, Route } from '@aglyn/aglyn/app-utils/console-routes'\nimport {\n  pluginRecordHref,\n  pluginRecordListHref,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-routes'\nimport { AI_JOB_BESIGNER_SEGMENT as BESIGNER_SEGMENT, AI_SITE_BUILD_HREF } from '../model/ai-job-notice'\nimport type { AiJobOutput, AiJobSummary } from '../model/ai-jobs.types'\n\n// Where a job's work opens in the console (AGL-2904), shared by the AI jobs\n// drawer and every dialog that follows the job it started (AGL-3593).\n\n/**\n * Where \"open draft\" goes, or `null` when the output has no page of its\n * own — a `text` output carries its copy on the job and is shown inline.\n * A versioned resource opens in the besigner on the version the job wrote;\n * one the console lists without a detail page opens its list; a `theme`\n * proposal opens the site's Theme section, where it is put in the editor.\n *\n * A console URL names a site by its SUBDOMAIN: the `[host]` segment resolves\n * through the member's host projection by subdomain, never by document id.\n * So an output that carries no `hostSubdomain` gets no link rather than one\n * that opens no site.\n */\nexport function aiJobOutputHref(output: AiJobOutput, orgSlug: string): string | null {\n  const host = output.hostSubdomain\n  if (!orgSlug || !host) return null\n  const segment = BESIGNER_SEGMENT[output.resource]\n  if (segment) {\n    const base = `/${orgSlug}/hosts/${host}/${segment}/${output.id}`\n    return output.versionId ? `${base}/versions/${output.versionId}/besigner` : base\n  }\n  if (output.resource === 'product') {\n    // The catalog a drafted product lands in: the commerce plugin's address\n    // for it (AGL-3080), or no link where commerce is not loaded.\n    return pluginRecordListHref('product', { orgSlug, host })\n  }\n  if (output.resource === 'workflow') {\n    // A drafted automation is an action (AGL-2919), listed switched off on\n    // the workflows plugin's list of actions, or no link where it is not loaded.\n    return pluginRecordListHref('action', { orgSlug, host })\n  }\n  if (output.resource === 'theme') {\n    return buildRoute(Route.HOST_SETUP_THEME, { orgSlug, host })\n  }\n  if (output.resource === 'form') {\n    // A new form has no version for the besigner to open: its own page — the\n    // forms plugin's address for it — mints the first one, and holds the\n    // routing and consent it declares.\n    return pluginRecordHref('form', { orgSlug, host }, output.id)\n  }\n  if (output.resource === 'campaign') {\n    // A campaign's page is the marketing plugin's, under the site: its\n    // address for the campaign (AGL-3080), or no link where it is not loaded.\n    return pluginRecordHref('campaign', { orgSlug, host }, output.id)\n  }\n  return null\n}\n\n/**\n * The ONE action a finished job's row, its notification and the dialog that\n * started it lead with (AGL-3593): what the job built. Several pages from one\n * job — a site's — open the site's Pages list, where they wait as drafts; one\n * output with a page of its own opens that page; anything else has no single\n * place to go, and the row's own links stand. `null` until the job is done.\n */\nexport function aiJobPrimaryLink(\n  job: Pick<AiJobSummary, 'status' | 'outputs'>,\n  orgSlug: string,\n): { href: string; label: string } | null {\n  if (job.status !== 'done' || !orgSlug) return null\n  const screens = job.outputs.filter(\n    (output) => output.resource === 'screen' && output.hostSubdomain,\n  )\n  if (screens.length > 1) {\n    return {\n      href: buildRoute(Route.HOST_SCREENS, { orgSlug, host: String(screens[0].hostSubdomain) }),\n      label: 'Open your draft pages',\n    }\n  }\n  for (const output of job.outputs) {\n    const href = aiJobOutputHref(output, orgSlug)\n    if (href) {\n      return {\n        href,\n        label: output.resource === 'screen' ? 'Open the draft page' : `Open ${output.label}`,\n      }\n    }\n  }\n  return null\n}\n\nexport { AI_SITE_BUILD_HREF }\n\n/**\n * The \"Building your site\" page for one site job (AGL-3594): linkable, so the\n * guided start lands on it, a reload keeps it and a notification opens it.\n * `null` without the org slug or the site's subdomain a console URL needs.\n */\nexport function aiSiteBuildHref(\n  orgSlug: string | null | undefined,\n  hostSubdomain: string | null | undefined,\n  jobId: string,\n): string | null {\n  if (!orgSlug || !hostSubdomain || !jobId) return null\n  return `/${orgSlug}/hosts/${hostSubdomain}${AI_SITE_BUILD_HREF}/${encodeURIComponent(jobId)}`\n}\n\n/**\n * A finished site's two ways in (AGL-3594): its first page's draft, opened in\n * the console's preview of that version, and the Pages list every draft waits\n * in. Either is `null` where the job reported nothing to open.\n */\nexport function aiSiteBuildDoneLinks(\n  job: Pick<AiJobSummary, 'outputs'>,\n  orgSlug: string,\n): { view: string | null; pages: string | null } {\n  const screens = job.outputs.filter((output) => output.resource === 'screen' && output.hostSubdomain)\n  const first = screens[0]\n  if (!first || !orgSlug) return { view: null, pages: null }\n  const host = String(first.hostSubdomain)\n  return {\n    view: first.versionId\n      ? `/${orgSlug}/hosts/${host}/screens/${first.id}/versions/${first.versionId}/view`\n      : null,\n    pages: buildRoute(Route.HOST_SCREENS, { orgSlug, host }),\n  }\n}\n"],"names":["buildRoute","Route","pluginRecordHref","pluginRecordListHref","AI_JOB_BESIGNER_SEGMENT","BESIGNER_SEGMENT","AI_SITE_BUILD_HREF","aiJobOutputHref","output","orgSlug","host","hostSubdomain","segment","resource","base","id","versionId","HOST_SETUP_THEME","aiJobPrimaryLink","job","status","screens","outputs","filter","length","href","HOST_SCREENS","String","label","aiSiteBuildHref","jobId","encodeURIComponent","aiSiteBuildDoneLinks","first","view","pages"],"mappings":"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"}

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

@@ -16,12 +16,14 @@
  */
 import { type AiBuildPlanEmbed } from '../model/ai-build-plan';
 import type { AiJobReview, AiJobSummary } from '../model/ai-jobs.types';
+import { AiSiteStarterFallback } from './ai-site-starter-fallback.component';
 /**
- * A job's plan and what it waits for (AGL-2935), inside the AI jobs drawer:
- * what the job reuses from the site, what it creates and why, the screens it
- * builds — and, while the job waits for a person, the one button that
- * confirms the plan or tries a refused step again. The drawer owns the
- * request; this renders.
+ * A job's plan and what it waits for (AGL-2935), inside the AI jobs drawer
+ * and the dialog that started the job (AGL-3593): what the job reuses from
+ * the site, what it creates and why, the screens it builds — and, while the
+ * job waits for a person, the one button that confirms the plan or tries a
+ * refused step again. Both send the same request (`resumeAiJobRequest`);
+ * this renders.
  */
 export interface AiJobPlanProps {
     job: AiJobSummary;
@@ -35,6 +37,11 @@ export interface AiJobPlanProps {
      * allow from an answer that ignored its re-ask. A member reads the findings.
      */
     staff?: boolean;
+    /**
+     * The signed-in user, for "Use the starter site instead" on a guided start
+     * that did not work out (AGL-3594); the action is drawn only when given.
+     */
+    user?: Parameters<typeof AiSiteStarterFallback>[0]['user'];
 }
 /**
  * Where a refused answer broke its rules, and the outline of those parts, as
@@ -50,5 +57,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, }: AiJobPlanProps): JSX.Element | null;
+export declare function AiJobPlan({ job, onResume, busy, staff, user, }: AiJobPlanProps): JSX.Element | null;
 export default AiJobPlan;

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

@@ -16,6 +16,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * limitations under the License.
  */ import { AI_BUILD_PLAN_CREATION_NOUNS, AI_BUILD_PLAN_EMBED_HOST_NAMES, isAiPlanNewRef } from "../model/ai-build-plan.js";
 import { aiJobPlanCreditEstimate } from "../model/ai-site-job.js";
+import { aiSiteStarterFallbackOffered } from "../model/ai-job-failure-copy.js";
+import { AiSiteStarterFallback } from "./ai-site-starter-fallback.component.js";
 import { Box, Button, Collapse, Stack, Typography } from "@mui/material";
 import { useState } from "react";
 /**
@@ -63,7 +65,7 @@ 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 }) {
+export function AiJobPlan({ job, onResume, busy = false, staff = false, user }) {
     var _plan_embeds;
     const [detailsOpen, setDetailsOpen] = useState(false);
     const { plan, review } = job;
@@ -138,7 +140,16 @@ export function AiJobPlan({ job, onResume, busy = false, staff = false }) {
                         }, `embed-${index}`))
                 ]
             }),
-            (review == null ? void 0 : review.reason) === 'doctrine' && review.findings.length > 0 && /*#__PURE__*/ _jsx(Box, {
+            staff && (review == null ? void 0 : review.detail) && /*#__PURE__*/ _jsx(Typography, {
+                variant: "caption",
+                color: "text.secondary",
+                component: "div",
+                sx: {
+                    mt: 0.5
+                },
+                children: review.detail
+            }),
+            (review == null ? void 0 : review.reason) === 'doctrine' && review.findings.length > 0 && (staff || !review.detail) && /*#__PURE__*/ _jsx(Box, {
                 component: "ul",
                 sx: {
                     my: 0.5,
@@ -189,15 +200,30 @@ export function AiJobPlan({ job, onResume, busy = false, staff = false }) {
                 },
                 children: `Estimated cost: about ${estimate.toLocaleString('en-US')} credits. What it costs is what its steps spend.`
             }),
+            waiting && review.retryRefusal && review.reason !== 'plan' && /*#__PURE__*/ _jsx(Typography, {
+                variant: "caption",
+                color: "text.secondary",
+                component: "div",
+                sx: {
+                    mt: 1
+                },
+                children: review.retryRefusal
+            }),
             waiting && /*#__PURE__*/ _jsx(Button, {
                 size: "small",
                 variant: "contained",
-                disabled: busy,
+                // 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),
                 sx: {
                     mt: 1
                 },
                 children: review.reason === 'plan' ? 'Confirm plan' : 'Try again'
+            }),
+            waiting && user && aiSiteStarterFallbackOffered(job) && /*#__PURE__*/ _jsx(AiSiteStarterFallback, {
+                job: job,
+                user: user
             })
         ]
     });