@aglyn/plugins-ai 1.0.0-beta.261 → 1.0.0-beta.262

package/src/lib/model/ai-create-view.js

@@ -0,0 +1,263 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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 { pluginRecordHref } from "@aglyn/aglyn/plugin-manager/plugin-record-routes";
+import { AI_JOB_BESIGNER_SEGMENT } from "./ai-job-notice.js";
+import { AI_BRIEF_COPY, AI_BRIEF_MAX_CHARS, AI_TEMPLATE_SUBJECT_LABELS } from "./ai-brief-copy.js";
+import { aiJobCreditRange } from "./ai-build-job.js";
+import { aiCreditRangeText } from "./ai-credit-estimate.js";
+import { AI_JOB_FOLLOW_PHASE_LINES, AI_JOB_PHASE_LABELS, AI_SITE_BUILD_IN_FLIGHT_COPY, aiJobConfirmingOwnPlan, aiJobPhase, aiJobProblem } from "./ai-job-activity.js";
+import { aiJobPlanHeading, aiJobPlanLines } from "./ai-job-plan-lines.js";
+import { AI_JOB_TERMINAL_STATUSES } from "./ai-jobs.types.js";
+import { AI_PAGE_TYPES } from "./ai-page-job.js";
+import { aiFreeCreditsResetLabel } from "./ai-site-job.js";
+import { AI_TEMPLATE_SUBJECTS } from "./ai-template-subjects.js";
+import { AI_UPSELL_COPY, AI_UPSELL_CREATE_LABEL, aiUpsellOffer } from "./ai-upsell-copy.js";
+/**
+ * "CREATE WITH AI" AS THE NATIVE APPS DRAW IT (AGL-3854): the door a list's
+ * Create with AI button reads, and the follow view of the job it starts.
+ *
+ * The console decides each entry from gates its shell already resolved — the
+ * plan and the add-on it could buy, `ai.generate`, the release flag and the
+ * site's AI switch — and draws the brief and the job from the plugin's own
+ * components. An app has neither the shell nor the components, so the AI
+ * plugin's `/api/ai/create` door answers both as data: whether the entry is
+ * drawn and as what, every word the brief dialog says, and the job as the
+ * dialog's follow card reads it, in sentences built here from the same models
+ * the console's components read. Nothing here decides what a request may do:
+ * the jobs route's own ladder still decides each start, confirm and cancel.
+ */ /** The lists the apps offer Create with AI on, beside their own create action. */ export const AI_CREATE_KINDS = [
+    'page',
+    'template',
+    'layout',
+    'form',
+    'component'
+];
+export function isAiCreateKind(value) {
+    return typeof value === 'string' && AI_CREATE_KINDS.includes(value);
+}
+const n = (value)=>Math.max(0, Math.round(value)).toLocaleString('en-US');
+/** The credits line above the brief, or `null` where the workspace has no band to read. */ export function aiCreateCreditsView(facts) {
+    if (facts.kind === 'unlimited') return {
+        text: 'AI credits are not capped on this workspace.',
+        exhausted: false
+    };
+    if (facts.kind === 'free') {
+        const until = aiFreeCreditsResetLabel(facts.left.resetsOn);
+        return facts.left.left > 0 ? {
+            text: `You have ${n(facts.left.left)} of your ${n(facts.left.total)} free AI credits left this month, until ${until}.`,
+            exhausted: false
+        } : {
+            text: `You have used your free AI credits for this month. They come back on ${until}.`,
+            exhausted: true
+        };
+    }
+    if (facts.kind === 'band') {
+        if (facts.remaining > 0) {
+            return {
+                text: `${n(facts.remaining)} of ${n(facts.limit)} AI credits left this month.`,
+                exhausted: false
+            };
+        }
+        return facts.stopsAtBand ? {
+            text: 'This workspace used its AI credits for the month.',
+            exhausted: true
+        } : {
+            text: `This workspace used its ${n(facts.limit)} AI credits for the month; more are billed as overage.`,
+            exhausted: false
+        };
+    }
+    return null;
+}
+/** The chips each kind offers beside its brief, as the console's dialog draws them. */ export function aiCreateChoices(kind) {
+    if (kind === 'page') {
+        return [
+            {
+                key: 'pageType',
+                label: 'Page type (optional)',
+                required: false,
+                options: AI_PAGE_TYPES.map((type)=>({
+                        id: type.id,
+                        label: type.label
+                    }))
+            }
+        ];
+    }
+    if (kind === 'template') {
+        return [
+            {
+                key: 'subject',
+                label: 'One page for each (required)',
+                required: true,
+                options: AI_TEMPLATE_SUBJECTS.map((subject)=>({
+                        id: subject,
+                        label: AI_TEMPLATE_SUBJECT_LABELS[subject]
+                    }))
+            }
+        ];
+    }
+    return [];
+}
+const HIDDEN = (kind)=>({
+        kind,
+        door: 'hidden',
+        label: AI_UPSELL_CREATE_LABEL,
+        copy: null,
+        briefMaxChars: AI_BRIEF_MAX_CHARS,
+        choices: [],
+        collections: null,
+        credits: null,
+        building: null,
+        upsell: null
+    });
+/** The door one list's Create with AI reads. */ export function aiCreateDoorView(input) {
+    const { kind } = input;
+    if (!input.shown) return HIDDEN(kind);
+    if (!input.entitled) {
+        if (!input.purchasable) return HIDDEN(kind);
+        const copy = AI_UPSELL_COPY[kind];
+        return _extends({}, HIDDEN(kind), {
+            door: 'upsell',
+            upsell: {
+                title: copy.title,
+                does: copy.does,
+                offer: aiUpsellOffer(input.canManageBilling),
+                canManageBilling: input.canManageBilling,
+                action: input.canManageBilling ? `Add ${input.addonName}` : null,
+                dismiss: input.canManageBilling ? 'Not now' : 'Close'
+            }
+        });
+    }
+    const collections = kind === 'template' && input.collections ? {
+        when: 'entry',
+        label: 'Collection',
+        options: input.collections.options,
+        helper: input.collections.status === 'error' ? 'This site’s collections could not be loaded. Close this and try again.' : input.collections.options.length ? 'Each page shows one entry of this collection.' : 'This site has no content collections yet. Add one in Content first.'
+    } : null;
+    return _extends({}, HIDDEN(kind), {
+        door: 'create',
+        copy: AI_BRIEF_COPY[kind],
+        choices: aiCreateChoices(kind),
+        collections,
+        credits: aiCreateCreditsView(input.credits),
+        building: kind === 'page' && input.buildInFlight ? AI_SITE_BUILD_IN_FLIGHT_COPY : null
+    });
+}
+// ── The job it started ──────────────────────────────────────────────────
+export { AI_JOB_FOLLOW_PHASE_LINES };
+/**
+ * Where one output opens in an app, as the console addresses the apps' link
+ * resolver answers natively: a page opens its page (the console's preview
+ * address, which the apps' Pages claims), a component, layout or template its
+ * details, and anything else the page its owner publishes through the
+ * record-route seam (a form's own page). `besigner` is the version the job
+ * wrote, opened in the Besigner. `null` where the output has no page of its own,
+ * names no site, or its owner is not loaded.
+ */ export function aiJobOutputAppLinks(output, orgSlug) {
+    const host = output.hostSubdomain;
+    if (!host || !orgSlug) return null;
+    const site = `/${orgSlug}/hosts/${host}`;
+    const id = encodeURIComponent(output.id);
+    const segment = AI_JOB_BESIGNER_SEGMENT[output.resource];
+    if (segment) {
+        const version = output.versionId ? encodeURIComponent(output.versionId) : null;
+        const besigner = version ? `${site}/${segment}/${id}/versions/${version}/besigner` : null;
+        if (output.resource === 'screen' || output.resource === 'emailScreen') {
+            return {
+                detail: version ? `${site}/screens/${id}/versions/${version}/view` : `${site}/screens`,
+                besigner
+            };
+        }
+        return {
+            detail: `${site}/${segment}/${id}`,
+            besigner
+        };
+    }
+    // A new form has no version to design yet: it opens on its own page.
+    const record = pluginRecordHref(output.resource, {
+        orgSlug,
+        host
+    }, output.id);
+    return record ? {
+        detail: record,
+        besigner: null
+    } : null;
+}
+export function aiJobFollowOpen(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 {
+            label: 'Open your draft pages',
+            detail: `/${orgSlug}/hosts/${screens[0].hostSubdomain}/screens`,
+            besigner: null
+        };
+    }
+    for (const output of job.outputs){
+        const links = aiJobOutputAppLinks(output, orgSlug);
+        if (links) {
+            return _extends({
+                label: output.resource === 'screen' ? 'Open the draft page' : `Open ${output.label}`
+            }, links);
+        }
+    }
+    return null;
+}
+/** The follow card's view of one job, for the apps (the console's `AiJobFollow` and `AiJobPlan`). */ export function aiJobFollowView(job, options = {}) {
+    var _ref, _options_orgSlug;
+    const phase = aiJobPhase(job);
+    const line = AI_JOB_FOLLOW_PHASE_LINES[phase];
+    const { plan, review } = job;
+    const waiting = job.status === 'needs_review' && review !== null && !aiJobConfirmingOwnPlan(job, options.now);
+    const range = plan && waiting && review.reason === 'plan' ? aiJobCreditRange(job.kind, plan) : null;
+    const freeCredits = (_ref = review == null ? void 0 : review.freeCredits) != null ? _ref : null;
+    const estimate = range && range.ceiling > 0 ? `Estimated cost: ${aiCreditRangeText(range)}. What it costs is what its steps spend.` + (freeCredits ? ` You have ${freeCredits.left.toLocaleString('en-US')} of your free AI credits left this month, until ${aiFreeCreditsResetLabel(freeCredits.resetsOn)}.` : '') : null;
+    const stepsDone = job.steps.filter((step)=>step.status === 'done').length;
+    const problem = phase === 'attention' || phase === 'failed' ? aiJobProblem(job, line.text) : null;
+    return {
+        id: job.id,
+        kind: job.kind,
+        status: job.status,
+        hostId: job.hostId,
+        phase,
+        phaseLabel: AI_JOB_PHASE_LABELS[phase],
+        line: {
+            tone: line.severity,
+            text: problem != null ? problem : line.text
+        },
+        moving: phase === 'queued' || phase === 'planning' || phase === 'building',
+        settled: AI_JOB_TERMINAL_STATUSES.includes(job.status),
+        steps: job.steps.length > 1 ? `${stepsDone} of ${job.steps.length} steps` : null,
+        plan: plan ? {
+            heading: aiJobPlanHeading(plan),
+            lines: aiJobPlanLines(plan).map((entry)=>entry.text)
+        } : null,
+        findings: (review == null ? void 0 : review.reason) === 'doctrine' && review.findings.length > 0 && (options.staff || !review.detail) ? review.findings.map((finding)=>finding.message) : [],
+        detail: options.staff && (review == null ? void 0 : review.detail) ? review.detail : null,
+        estimate,
+        retryRefusal: waiting && review.retryRefusal && review.reason !== 'plan' ? review.retryRefusal : null,
+        confirm: waiting ? {
+            label: review.reason === 'plan' ? 'Confirm plan' : 'Try again',
+            enabled: review.reason === 'plan' || !review.retryRefusal
+        } : null,
+        building: waiting && review.reason === 'plan' && options.buildInFlight ? AI_SITE_BUILD_IN_FLIGHT_COPY : null,
+        problem,
+        spent: job.creditsSpent > 0 ? `Used ${n(job.creditsSpent)} ${job.creditsSpent === 1 ? 'credit' : 'credits'}${phase === 'done' || AI_JOB_TERMINAL_STATUSES.includes(job.status) ? '' : ' so far'}.` : null,
+        open: aiJobFollowOpen(job, (_options_orgSlug = options.orgSlug) != null ? _options_orgSlug : '')
+    };
+}
+
+//# sourceMappingURL=ai-create-view.js.map

package/src/lib/model/ai-create-view.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-create-view.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\nimport { pluginRecordHref } from '@aglyn/aglyn/plugin-manager/plugin-record-routes'\nimport { AI_JOB_BESIGNER_SEGMENT } from './ai-job-notice'\nimport {\n  AI_BRIEF_COPY,\n  AI_BRIEF_MAX_CHARS,\n  AI_TEMPLATE_SUBJECT_LABELS,\n  type AiBriefCopy,\n} from './ai-brief-copy'\nimport { aiJobCreditRange } from './ai-build-job'\nimport { aiCreditRangeText } from './ai-credit-estimate'\nimport {\n  AI_JOB_FOLLOW_PHASE_LINES,\n  AI_JOB_PHASE_LABELS,\n  AI_SITE_BUILD_IN_FLIGHT_COPY,\n  aiJobConfirmingOwnPlan,\n  aiJobPhase,\n  aiJobProblem,\n  type AiFollowTone,\n  type AiJobPhase,\n} from './ai-job-activity'\nimport { aiJobPlanHeading, aiJobPlanLines } from './ai-job-plan-lines'\nimport { AI_JOB_TERMINAL_STATUSES, type AiJobOutput, type AiJobSummary } from './ai-jobs.types'\nimport { AI_PAGE_TYPES } from './ai-page-job'\nimport { aiFreeCreditsResetLabel, type AiFreeCreditsLeft } from './ai-site-job'\nimport { AI_TEMPLATE_SUBJECTS } from './ai-template-subjects'\nimport type { AiTemplateCollectionOption } from './ai-template-collections'\nimport { AI_UPSELL_COPY, AI_UPSELL_CREATE_LABEL, aiUpsellOffer } from './ai-upsell-copy'\n\n/**\n * \"CREATE WITH AI\" AS THE NATIVE APPS DRAW IT (AGL-3854): the door a list's\n * Create with AI button reads, and the follow view of the job it starts.\n *\n * The console decides each entry from gates its shell already resolved — the\n * plan and the add-on it could buy, `ai.generate`, the release flag and the\n * site's AI switch — and draws the brief and the job from the plugin's own\n * components. An app has neither the shell nor the components, so the AI\n * plugin's `/api/ai/create` door answers both as data: whether the entry is\n * drawn and as what, every word the brief dialog says, and the job as the\n * dialog's follow card reads it, in sentences built here from the same models\n * the console's components read. Nothing here decides what a request may do:\n * the jobs route's own ladder still decides each start, confirm and cancel.\n */\n\n/** The lists the apps offer Create with AI on, beside their own create action. */\nexport const AI_CREATE_KINDS = ['page', 'template', 'layout', 'form', 'component'] as const\n\nexport type AiCreateKind = (typeof AI_CREATE_KINDS)[number]\n\nexport function isAiCreateKind(value: unknown): value is AiCreateKind {\n  return typeof value === 'string' && (AI_CREATE_KINDS as readonly string[]).includes(value)\n}\n\n/** One row of chips beside the brief, and the input the pick is sent as. */\nexport interface AiCreateChoiceView {\n  /** The `inputs` key the pick is sent under. */\n  key: 'pageType' | 'subject'\n  label: string\n  /** A required pick keeps the start disabled until one is made; an optional one clears when pressed again. */\n  required: boolean\n  options: Array<{ id: string; label: string }>\n}\n\n/** A template's collection field, shown once \"Collection entry\" is picked. */\nexport interface AiCreateCollectionsView {\n  /** The subject the field belongs to. */\n  when: 'entry'\n  label: string\n  options: AiTemplateCollectionOption[]\n  helper: string\n}\n\n/** What is left of the month's AI credits, said before a brief is sent. */\nexport interface AiCreateCreditsView {\n  text: string\n  /** Nothing is left and the workspace stops at its band, so a start is refused until credits return. */\n  exhausted: boolean\n}\n\n/** The add-on's offer, on a plan that could buy it and has not (AGL-3601). */\nexport interface AiCreateUpsellView {\n  title: string\n  does: string\n  offer: string\n  /** The reader may add the add-on (`billing.manage`); the action is drawn only then. */\n  canManageBilling: boolean\n  /** \"Add Aglyn AI\", or `null` for a reader who cannot. */\n  action: string | null\n  dismiss: string\n}\n\nexport interface AiCreateDoorView {\n  kind: AiCreateKind\n  /** `create`: the brief; `upsell`: the add-on's offer; `hidden`: the entry is not drawn. */\n  door: 'create' | 'upsell' | 'hidden'\n  /** The entry's label, \"Create with AI\". */\n  label: string\n  copy: AiBriefCopy | null\n  briefMaxChars: number\n  choices: AiCreateChoiceView[]\n  collections: AiCreateCollectionsView | null\n  credits: AiCreateCreditsView | null\n  /** Another page already being built on this site (AGL-3765): a warning, not a stop. */\n  building: string | null\n  upsell: AiCreateUpsellView | null\n}\n\n/** What the door knows about the month's credits. */\nexport type AiCreateCreditsFacts =\n  | { kind: 'free'; left: AiFreeCreditsLeft }\n  | { kind: 'band'; used: number; limit: number; remaining: number; stopsAtBand: boolean }\n  | { kind: 'unlimited' }\n  | { kind: 'none' }\n\nconst n = (value: number) => Math.max(0, Math.round(value)).toLocaleString('en-US')\n\n/** The credits line above the brief, or `null` where the workspace has no band to read. */\nexport function aiCreateCreditsView(facts: AiCreateCreditsFacts): AiCreateCreditsView | null {\n  if (facts.kind === 'unlimited') return { text: 'AI credits are not capped on this workspace.', exhausted: false }\n  if (facts.kind === 'free') {\n    const until = aiFreeCreditsResetLabel(facts.left.resetsOn)\n    return facts.left.left > 0\n      ? {\n          text: `You have ${n(facts.left.left)} of your ${n(facts.left.total)} free AI credits left this month, until ${until}.`,\n          exhausted: false,\n        }\n      : { text: `You have used your free AI credits for this month. They come back on ${until}.`, exhausted: true }\n  }\n  if (facts.kind === 'band') {\n    if (facts.remaining > 0) {\n      return { text: `${n(facts.remaining)} of ${n(facts.limit)} AI credits left this month.`, exhausted: false }\n    }\n    return facts.stopsAtBand\n      ? { text: 'This workspace used its AI credits for the month.', exhausted: true }\n      : {\n          text: `This workspace used its ${n(facts.limit)} AI credits for the month; more are billed as overage.`,\n          exhausted: false,\n        }\n  }\n  return null\n}\n\n/** The chips each kind offers beside its brief, as the console's dialog draws them. */\nexport function aiCreateChoices(kind: AiCreateKind): AiCreateChoiceView[] {\n  if (kind === 'page') {\n    return [\n      {\n        key: 'pageType',\n        label: 'Page type (optional)',\n        required: false,\n        options: AI_PAGE_TYPES.map((type) => ({ id: type.id, label: type.label })),\n      },\n    ]\n  }\n  if (kind === 'template') {\n    return [\n      {\n        key: 'subject',\n        label: 'One page for each (required)',\n        required: true,\n        options: AI_TEMPLATE_SUBJECTS.map((subject) => ({ id: subject, label: AI_TEMPLATE_SUBJECT_LABELS[subject] })),\n      },\n    ]\n  }\n  return []\n}\n\nexport interface AiCreateDoorInput {\n  kind: AiCreateKind\n  /** The gates that draw no entry at all: `ai.generate`, the release flag, the site's AI switch. */\n  shown: boolean\n  /** The plan carries `aiGenerative`. */\n  entitled: boolean\n  /** The workspace could buy the add-on that grants it, and the add-on store is open to it. */\n  purchasable: boolean\n  canManageBilling: boolean\n  credits: AiCreateCreditsFacts\n  /** The site's content collections, read only for a template's door. */\n  collections?: { status: 'success' | 'error'; options: AiTemplateCollectionOption[] } | null\n  /** Another page build in flight on the site, for a page's door. */\n  buildInFlight?: boolean\n  addonName: string\n}\n\nconst HIDDEN = (kind: AiCreateKind): AiCreateDoorView => ({\n  kind,\n  door: 'hidden',\n  label: AI_UPSELL_CREATE_LABEL,\n  copy: null,\n  briefMaxChars: AI_BRIEF_MAX_CHARS,\n  choices: [],\n  collections: null,\n  credits: null,\n  building: null,\n  upsell: null,\n})\n\n/** The door one list's Create with AI reads. */\nexport function aiCreateDoorView(input: AiCreateDoorInput): AiCreateDoorView {\n  const { kind } = input\n  if (!input.shown) return HIDDEN(kind)\n  if (!input.entitled) {\n    if (!input.purchasable) return HIDDEN(kind)\n    const copy = AI_UPSELL_COPY[kind]\n    return {\n      ...HIDDEN(kind),\n      door: 'upsell',\n      upsell: {\n        title: copy.title,\n        does: copy.does,\n        offer: aiUpsellOffer(input.canManageBilling),\n        canManageBilling: input.canManageBilling,\n        action: input.canManageBilling ? `Add ${input.addonName}` : null,\n        dismiss: input.canManageBilling ? 'Not now' : 'Close',\n      },\n    }\n  }\n  const collections =\n    kind === 'template' && input.collections\n      ? {\n          when: 'entry' as const,\n          label: 'Collection',\n          options: input.collections.options,\n          helper:\n            input.collections.status === 'error'\n              ? 'This site’s collections could not be loaded. Close this and try again.'\n              : input.collections.options.length\n                ? 'Each page shows one entry of this collection.'\n                : 'This site has no content collections yet. Add one in Content first.',\n        }\n      : null\n  return {\n    ...HIDDEN(kind),\n    door: 'create',\n    copy: AI_BRIEF_COPY[kind],\n    choices: aiCreateChoices(kind),\n    collections,\n    credits: aiCreateCreditsView(input.credits),\n    building: kind === 'page' && input.buildInFlight ? AI_SITE_BUILD_IN_FLIGHT_COPY : null,\n  }\n}\n\n// ── The job it started ──────────────────────────────────────────────────\n\nexport { AI_JOB_FOLLOW_PHASE_LINES, type AiFollowTone }\n\n/**\n * Where one output opens in an app, as the console addresses the apps' link\n * resolver answers natively: a page opens its page (the console's preview\n * address, which the apps' Pages claims), a component, layout or template its\n * details, and anything else the page its owner publishes through the\n * record-route seam (a form's own page). `besigner` is the version the job\n * wrote, opened in the Besigner. `null` where the output has no page of its own,\n * names no site, or its owner is not loaded.\n */\nexport function aiJobOutputAppLinks(\n  output: Pick<AiJobOutput, 'resource' | 'id' | 'versionId' | 'hostSubdomain'>,\n  orgSlug: string,\n): { detail: string; besigner: string | null } | null {\n  const host = output.hostSubdomain\n  if (!host || !orgSlug) return null\n  const site = `/${orgSlug}/hosts/${host}`\n  const id = encodeURIComponent(output.id)\n  const segment = AI_JOB_BESIGNER_SEGMENT[output.resource]\n  if (segment) {\n    const version = output.versionId ? encodeURIComponent(output.versionId) : null\n    const besigner = version ? `${site}/${segment}/${id}/versions/${version}/besigner` : null\n    if (output.resource === 'screen' || output.resource === 'emailScreen') {\n      return { detail: version ? `${site}/screens/${id}/versions/${version}/view` : `${site}/screens`, besigner }\n    }\n    return { detail: `${site}/${segment}/${id}`, besigner }\n  }\n  // A new form has no version to design yet: it opens on its own page.\n  const record = pluginRecordHref(output.resource, { orgSlug, host }, output.id)\n  return record ? { detail: record, besigner: null } : null\n}\n\n/** The one thing a finished job leads with, as the console's `aiJobPrimaryLink` picks it. */\nexport interface AiJobFollowOpen {\n  label: string\n  detail: string\n  besigner: string | null\n}\n\nexport function aiJobFollowOpen(\n  job: Pick<AiJobSummary, 'status' | 'outputs'>,\n  orgSlug: string,\n): AiJobFollowOpen | null {\n  if (job.status !== 'done' || !orgSlug) return null\n  const screens = job.outputs.filter((output) => output.resource === 'screen' && output.hostSubdomain)\n  if (screens.length > 1) {\n    return {\n      label: 'Open your draft pages',\n      detail: `/${orgSlug}/hosts/${screens[0].hostSubdomain}/screens`,\n      besigner: null,\n    }\n  }\n  for (const output of job.outputs) {\n    const links = aiJobOutputAppLinks(output, orgSlug)\n    if (links) {\n      return { label: output.resource === 'screen' ? 'Open the draft page' : `Open ${output.label}`, ...links }\n    }\n  }\n  return null\n}\n\nexport interface AiJobFollowView {\n  id: string\n  kind: string\n  status: string\n  hostId: string | null\n  phase: AiJobPhase\n  phaseLabel: string\n  line: { tone: AiFollowTone; text: string }\n  /** Still moving, so the apps read it again shortly. */\n  moving: boolean\n  /** Finished, failed or canceled: nothing more happens to it. */\n  settled: boolean\n  /** \"2 of 3 steps\", for a job of more than one step. */\n  steps: string | null\n  plan: { heading: string; lines: string[] } | null\n  /** The building rules a refused answer broke, as a member reads them. */\n  findings: string[]\n  /** The checks' own sentence on a refused answer, for staff. */\n  detail: string | null\n  /** The plan's estimated cost, read before it is confirmed. */\n  estimate: string | null\n  retryRefusal: string | null\n  /** \"Confirm plan\" or \"Try again\" while the job waits for the person. */\n  confirm: { label: string; enabled: boolean } | null\n  /** Another page build in flight on the site, said beside Confirm (AGL-3765). */\n  building: string | null\n  /** Why a stopped job has nothing to show. */\n  problem: string | null\n  /** What the job spent so far. */\n  spent: string | null\n  open: AiJobFollowOpen | null\n}\n\n/** The follow card's view of one job, for the apps (the console's `AiJobFollow` and `AiJobPlan`). */\nexport function aiJobFollowView(\n  job: AiJobSummary,\n  options: { orgSlug?: string | null; staff?: boolean; buildInFlight?: boolean; now?: number } = {},\n): AiJobFollowView {\n  const phase = aiJobPhase(job)\n  const line = AI_JOB_FOLLOW_PHASE_LINES[phase]\n  const { plan, review } = job\n  const waiting = job.status === 'needs_review' && review !== null && !aiJobConfirmingOwnPlan(job, options.now)\n  const range = plan && waiting && review.reason === 'plan' ? aiJobCreditRange(job.kind, plan) : null\n  const freeCredits = review?.freeCredits ?? null\n  const estimate =\n    range && range.ceiling > 0\n      ? `Estimated cost: ${aiCreditRangeText(range)}. What it costs is what its steps spend.` +\n        (freeCredits\n          ? ` You have ${freeCredits.left.toLocaleString('en-US')} of your free AI credits left this month, until ${aiFreeCreditsResetLabel(freeCredits.resetsOn)}.`\n          : '')\n      : null\n  const stepsDone = job.steps.filter((step) => step.status === 'done').length\n  const problem = phase === 'attention' || phase === 'failed' ? aiJobProblem(job, line.text) : null\n  return {\n    id: job.id,\n    kind: job.kind,\n    status: job.status,\n    hostId: job.hostId,\n    phase,\n    phaseLabel: AI_JOB_PHASE_LABELS[phase],\n    line: { tone: line.severity, text: problem ?? line.text },\n    moving: phase === 'queued' || phase === 'planning' || phase === 'building',\n    settled: AI_JOB_TERMINAL_STATUSES.includes(job.status),\n    steps: job.steps.length > 1 ? `${stepsDone} of ${job.steps.length} steps` : null,\n    plan: plan ? { heading: aiJobPlanHeading(plan), lines: aiJobPlanLines(plan).map((entry) => entry.text) } : null,\n    findings:\n      review?.reason === 'doctrine' && review.findings.length > 0 && (options.staff || !review.detail)\n        ? review.findings.map((finding) => finding.message)\n        : [],\n    detail: options.staff && review?.detail ? review.detail : null,\n    estimate,\n    retryRefusal: waiting && review.retryRefusal && review.reason !== 'plan' ? review.retryRefusal : null,\n    confirm: waiting\n      ? {\n          label: review.reason === 'plan' ? 'Confirm plan' : 'Try again',\n          enabled: review.reason === 'plan' || !review.retryRefusal,\n        }\n      : null,\n    building: waiting && review.reason === 'plan' && options.buildInFlight ? AI_SITE_BUILD_IN_FLIGHT_COPY : null,\n    problem,\n    spent:\n      job.creditsSpent > 0\n        ? `Used ${n(job.creditsSpent)} ${job.creditsSpent === 1 ? 'credit' : 'credits'}${phase === 'done' || AI_JOB_TERMINAL_STATUSES.includes(job.status) ? '' : ' so far'}.`\n        : null,\n    open: aiJobFollowOpen(job, options.orgSlug ?? ''),\n  }\n}\n"],"names":["pluginRecordHref","AI_JOB_BESIGNER_SEGMENT","AI_BRIEF_COPY","AI_BRIEF_MAX_CHARS","AI_TEMPLATE_SUBJECT_LABELS","aiJobCreditRange","aiCreditRangeText","AI_JOB_FOLLOW_PHASE_LINES","AI_JOB_PHASE_LABELS","AI_SITE_BUILD_IN_FLIGHT_COPY","aiJobConfirmingOwnPlan","aiJobPhase","aiJobProblem","aiJobPlanHeading","aiJobPlanLines","AI_JOB_TERMINAL_STATUSES","AI_PAGE_TYPES","aiFreeCreditsResetLabel","AI_TEMPLATE_SUBJECTS","AI_UPSELL_COPY","AI_UPSELL_CREATE_LABEL","aiUpsellOffer","AI_CREATE_KINDS","isAiCreateKind","value","includes","n","Math","max","round","toLocaleString","aiCreateCreditsView","facts","kind","text","exhausted","until","left","resetsOn","total","remaining","limit","stopsAtBand","aiCreateChoices","key","label","required","options","map","type","id","subject","HIDDEN","door","copy","briefMaxChars","choices","collections","credits","building","upsell","aiCreateDoorView","input","shown","entitled","purchasable","title","does","offer","canManageBilling","action","addonName","dismiss","when","helper","status","length","buildInFlight","aiJobOutputAppLinks","output","orgSlug","host","hostSubdomain","site","encodeURIComponent","segment","resource","version","versionId","besigner","detail","record","aiJobFollowOpen","job","screens","outputs","filter","links","aiJobFollowView","phase","line","plan","review","waiting","now","range","reason","freeCredits","estimate","ceiling","stepsDone","steps","step","problem","hostId","phaseLabel","tone","severity","moving","settled","heading","lines","entry","findings","staff","finding","message","retryRefusal","confirm","enabled","spent","creditsSpent","open"],"mappings":"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"}

package/src/lib/model/ai-insight.d.ts

@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { PluginFigureTable } from '@aglyn/aglyn/plugin-manager/plugin-figures';
+import { type PluginFigureTable } from '@aglyn/aglyn/plugin-manager/plugin-figures';
 import type { AiJob, AiJobOutput } from './ai-jobs.types';
 /**
  * Insights (AGL-2915): what an `insight` job answers, in the shape the step

package/src/lib/model/ai-insight.js

@@ -13,7 +13,8 @@
  * 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.
- */ export const AI_INSIGHT_SURFACES = [
+ */ import { pluginFigureCellText, pluginFigureIsoWeek } from "@aglyn/aglyn/plugin-manager/plugin-figures";
+export const AI_INSIGHT_SURFACES = [
     'analytics',
     'datasets',
     'crm-reports',
@@ -214,37 +215,7 @@
     return where.host ? `/${where.orgSlug}/hosts/${where.host}/${path}` : null;
 }
 /** How a cell reads to a person, by its column's kind; `null` is "—". */ export function aiInsightCellText(table, key, value) {
-    if (value === null || value === undefined || value === '') return '—';
-    const column = table.columns.find((entry)=>entry.key === key);
-    if (typeof value === 'string' || !column) return String(value);
-    switch(column.kind){
-        case 'money':
-            var _column_currency;
-            return new Intl.NumberFormat('en-US', {
-                style: 'currency',
-                currency: (_column_currency = column.currency) != null ? _column_currency : 'USD'
-            }).format(value);
-        case 'percent':
-            return `${value.toLocaleString('en-US', {
-                maximumFractionDigits: 1
-            })}%`;
-        case 'change':
-            return `${value > 0 ? '+' : ''}${value.toLocaleString('en-US', {
-                maximumFractionDigits: 1
-            })}%`;
-        case 'duration':
-            {
-                const seconds = Math.round(value);
-                if (seconds < 60) return `${seconds}s`;
-                const minutes = Math.floor(seconds / 60);
-                if (minutes < 60) return `${minutes}m ${String(seconds % 60).padStart(2, '0')}s`;
-                return `${Math.floor(minutes / 60)}h ${String(minutes % 60).padStart(2, '0')}m`;
-            }
-        default:
-            return value.toLocaleString('en-US', {
-                maximumFractionDigits: 2
-            });
-    }
+    return pluginFigureCellText(table, key, value);
 }
 /** One cited row as a line a person reads: every column, labeled. */ export function aiInsightRowText(table, index) {
     const row = table.rows[index];
@@ -252,13 +223,7 @@
     return table.columns.map((column)=>`${column.label}: ${aiInsightCellText(table, column.key, row[column.key])}`).join(' · ');
 }
 /** The ISO 8601 week an instant falls in, in UTC (`2026-W38`). */ export function aiInsightIsoWeek(at) {
-    const date = new Date(Date.UTC(at.getUTCFullYear(), at.getUTCMonth(), at.getUTCDate()));
-    // Thursday decides the week's year.
-    const weekday = date.getUTCDay() || 7;
-    date.setUTCDate(date.getUTCDate() + 4 - weekday);
-    const yearStart = Date.UTC(date.getUTCFullYear(), 0, 1);
-    const week = Math.ceil(((date.getTime() - yearStart) / 86400000 + 1) / 7);
-    return `${date.getUTCFullYear()}-W${String(week).padStart(2, '0')}`;
+    return pluginFigureIsoWeek(at);
 }
 
 //# sourceMappingURL=ai-insight.js.map

package/src/lib/model/ai-insight.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-insight.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { PluginFigureTable } from '@aglyn/aglyn/plugin-manager/plugin-figures'\nimport type { AiJob, AiJobOutput } from './ai-jobs.types'\n\n/**\n * Insights (AGL-2915): what an `insight` job answers, in the shape the step\n * writes and the console reads. Pure data — no server import — so the answer\n * card and the digest email type what they render from the module the step\n * writes it with.\n *\n * ## A number is read, never written\n *\n * The model never runs a query and never sees a record. Code reads figures —\n * traffic, orders, bookings, forms, campaigns, datasets, experiments — through\n * fixed, typed readers, each answering with one compact table that says where\n * its figures come from. The model picks the readers and phrases what their\n * tables say, and every insight it writes cites the rows its figures come from.\n * An insight whose numbers cannot be found in the rows it cites is left out\n * (`runtime/ai-insight-check.ts`), so each one a person reads can be traced to\n * a number they can open in the console.\n *\n * ## Read-only, and kept apart from the job\n *\n * An insight job writes one document besides its own record: the answer, at\n * `orgs/{orgId}/aiInsights/{jobId}`, which no rule lets a client read. The\n * job's output names it and carries no figure, because a job document is\n * readable by every member of the workspace and the figures are not: a\n * collaborator on one site may not see another site's revenue. The answer is\n * served by `GET /api/ai/insights/{jobId}` to the member who asked and, for a\n * weekly digest, to the members who reach its site.\n */\n\n/**\n * Where an insight was asked: the console page whose Assist panel — or\n * whose \"Ask AI about these numbers\" card — asked it, or the weekly digest,\n * which no person asked. A site's Marketing, Automation and Bookings pages\n * and the workspace's own pages joined at AGL-3603.\n */\nexport type AiInsightSurface =\n  | 'analytics'\n  | 'datasets'\n  | 'crm-reports'\n  | 'marketing'\n  | 'automations'\n  | 'bookings'\n  | 'workspace'\n  | 'digest'\n\nexport const AI_INSIGHT_SURFACES: readonly AiInsightSurface[] = [\n  'analytics',\n  'datasets',\n  'crm-reports',\n  'marketing',\n  'automations',\n  'bookings',\n  'workspace',\n  'digest',\n]\n\n/** The surfaces a person asks from. */\nexport const AI_INSIGHT_ASK_SURFACES: readonly AiInsightSurface[] = [\n  'analytics',\n  'datasets',\n  'crm-reports',\n  'marketing',\n  'automations',\n  'bookings',\n  'workspace',\n]\n\n/** The surface an insight job's inputs name, or `null` for one no insight job is asked from. */\nexport function aiInsightSurface(inputs: Readonly<Record<string, unknown>> | null | undefined): AiInsightSurface | null {\n  const surface = inputs?.['surface']\n  return typeof surface === 'string' && (AI_INSIGHT_SURFACES as readonly string[]).includes(surface)\n    ? (surface as AiInsightSurface)\n    : null\n}\n\n/**\n * The readers a surface may offer, by the first word of a reader's id. The\n * Analytics page — and a site's dashboard — answers about the site's traffic,\n * what it sold, took and collected, its automations' runs and its CRM\n * pipeline; a Data page about its datasets; CRM Reports about where people\n * came from, what they did and the pipeline; the Marketing page about what\n * its campaigns, overlays and tests caused and earned, beside the traffic and\n * the forms they drove; the Automation page about its runs; the Bookings page\n * about its bookings; and the workspace's own pages about its pipeline and\n * its datasets.\n */\nexport const AI_INSIGHT_SURFACE_READERS: Readonly<Record<AiInsightSurface, readonly string[]>> = {\n  // `funnels` (AGL-3605): a site's funnels, step by step, beside its traffic.\n  analytics: ['automations', 'bookings', 'commerce', 'crm', 'forms', 'funnels', 'marketing', 'traffic'],\n  datasets: ['datasets'],\n  'crm-reports': ['bookings', 'commerce', 'crm', 'forms', 'marketing', 'traffic'],\n  marketing: ['commerce', 'forms', 'marketing', 'traffic'],\n  automations: ['automations'],\n  bookings: ['bookings'],\n  workspace: ['crm', 'datasets'],\n  digest: ['bookings', 'commerce', 'forms', 'marketing', 'traffic'],\n}\n\n/** Whether a surface answers about one site; the Data page and the workspace's pages may answer about the whole workspace. */\nexport function aiInsightSurfaceNeedsSite(surface: AiInsightSurface): boolean {\n  return surface !== 'datasets' && surface !== 'workspace'\n}\n\n/**\n * The readers a weekly digest reads, in the order the digest names them:\n * the traffic change, the top page, the days that stood out, the forms, the\n * campaigns, and what the site sold and took. Code reads these; no model\n * picks them.\n */\nexport const AI_INSIGHT_DIGEST_READERS: readonly string[] = [\n  'traffic.summary',\n  'traffic.pages',\n  'traffic.daily',\n  'forms.performance',\n  'marketing.campaigns',\n  'commerce.sales',\n  'bookings.services',\n]\n\n/** The windows, in days, an insight reads: the Traffic card's own ranges. */\nexport const AI_INSIGHT_WINDOWS: readonly number[] = [7, 14, 30, 90]\n\n/** The window a question that names none reads: the Traffic card's default. */\nexport const AI_INSIGHT_DEFAULT_DAYS = 14\n\n/** The window a weekly digest reads. */\nexport const AI_INSIGHT_DIGEST_DAYS = 7\n\n/** A window an insight's inputs or a read names, held to the readers' own ranges. */\nexport function aiInsightDays(value: unknown): number {\n  const days = typeof value === 'number' ? value : Number(value)\n  return AI_INSIGHT_WINDOWS.includes(days) ? days : AI_INSIGHT_DEFAULT_DAYS\n}\n\n/** The most insights one answer carries: a person reads them at a glance. */\nexport const AI_INSIGHT_MAX_INSIGHTS = 5\n\n/** The longest one insight may run, in characters. */\nexport const AI_INSIGHT_MAX_CHARS = 280\n\n/** The longest the sentence about what the figures could not answer may run. */\nexport const AI_INSIGHT_GAP_MAX_CHARS = 200\n\n/** The most tables one citation list names. */\nexport const AI_INSIGHT_MAX_CITES = 3\n\n/** The most rows one citation names. */\nexport const AI_INSIGHT_MAX_CITED_ROWS = 10\n\n/** The most readers one answer reads. */\nexport const AI_INSIGHT_MAX_READS = 4\n\n/** The longest question an insight job admits. */\nexport const AI_INSIGHT_QUESTION_MAX_CHARS = 1_000\n\n/**\n * A table as an insight job keeps it: the figures a reader returned, the\n * handle the model cites them by, and the reader they came from.\n */\nexport interface AiInsightTable extends PluginFigureTable {\n  /** `t1`, `t2`, …, in the order the job read them. */\n  ref: string\n  /** The reader's id (`commerce.sales`). */\n  reader: string\n  /** The window the reader was asked for, in days; 0 for a reader of current counts. */\n  days: number\n  /** Whether the table is about one site (its path under that site) or the workspace. */\n  scope: 'site' | 'org'\n}\n\n/** The rows of one table an insight's figures come from, by index. */\nexport interface AiInsightCitation {\n  table: string\n  rows: number[]\n}\n\nexport interface AiInsight {\n  /** One or two plain sentences. */\n  text: string\n  cites: AiInsightCitation[]\n}\n\n/** What the model answers with. */\nexport interface AiInsightAnswer {\n  insights: AiInsight[]\n  /** What the figures could not answer, in one sentence without numbers; `null` when nothing. */\n  gap: string | null\n}\n\n/** The answer collection under the org: server-written, and read through the insights door alone. */\nexport const AI_INSIGHTS_COLLECTION = 'aiInsights'\n\n/** An insight job's answer, as the step stores it. */\nexport interface AiInsightRecord {\n  jobId: string\n  orgId: string\n  hostId: string | null\n  surface: AiInsightSurface\n  /** The member whose question it answers; for a digest, the member it was made for. */\n  createdBy: string\n  /** The question, verbatim; a digest's is the digest's own title. */\n  question: string\n  /** The window the answer was asked about, in days. */\n  days: number\n  /** The insights that trace to the rows they cite; every other one was left out. */\n  insights: AiInsight[]\n  gap: string | null\n  /** Every table the job read, so each citation opens the figures it names. */\n  tables: AiInsightTable[]\n  /** How many insights the answer carried that were left out as not traceable. */\n  left: number\n  /** The ISO week a digest covers (`2026-W38`); `null` on a question. */\n  week: string | null\n  createdAtMs: number\n}\n\n/** The output id an answer is named by. */\nexport const AI_INSIGHT_OUTPUT_LABEL = 'Answer'\n\n/**\n * The output an insight job records: the answer's address and how many\n * insights it holds, and no figure. The count is a statement about the\n * answer rather than about the site, so every member may read it.\n */\nexport function aiInsightOutput(\n  job: Pick<AiJob, '$id' | 'hostId'>,\n  record: Pick<AiInsightRecord, 'insights' | 'surface'>,\n  hostSubdomain: string | null,\n): AiJobOutput {\n  const count = record.insights.length\n  return {\n    resource: 'insight',\n    id: job.$id,\n    versionId: null,\n    hostId: job.hostId ?? null,\n    hostSubdomain,\n    label: record.surface === 'digest' ? 'Weekly insights' : AI_INSIGHT_OUTPUT_LABEL,\n    note: count\n      ? `${count} ${count === 1 ? 'insight' : 'insights'}, each traced to the figures it cites.`\n      : 'The figures did not answer this question.',\n  }\n}\n\n/** The answer on the wire: the stored record, with nothing a client does not render. */\nexport type AiInsightAnswerWire = AiInsightRecord\n\n/**\n * The Assist panel's insight surface for a console path, or `null` off one:\n * a site's dashboard, Analytics, Data, CRM Reports, Marketing, Automation and\n * Bookings pages; the workspace's Data page; and the workspace's sites page\n * and CRM Reports, which read the workspace's pipeline and datasets. The\n * organization's Marketing page reads site figures, so it is not one — it\n * asks about the site it is showing, through its own in-page entry.\n */\nexport function aiInsightSurfaceForPath(\n  pathname: string | null | undefined,\n): { surface: Exclude<AiInsightSurface, 'digest'>; host: string | null } | null {\n  const segments = String(pathname ?? '')\n    .split('?')[0]\n    .split('/')\n    .filter(Boolean)\n  // `/{org}/hosts/{host}/…` on a site, `/{org}/…` on the workspace.\n  if (segments[1] === 'hosts' && segments.length >= 4) {\n    const host = segments[2]\n    const rest = segments.slice(3)\n    if (rest[0] === 'analytics') return { surface: 'analytics', host }\n    if (rest[0] === 'data') return { surface: 'datasets', host }\n    if (rest[0] === 'crm' && rest[1] === 'reports') return { surface: 'crm-reports', host }\n    if (rest[0] === 'marketing') return { surface: 'marketing', host }\n    if (rest[0] === 'automation') return { surface: 'automations', host }\n    if (rest[0] === 'bookings') return { surface: 'bookings', host }\n    return null\n  }\n  // The site's dashboard is `/{org}/hosts/{host}`.\n  if (segments[1] === 'hosts' && segments.length === 3) return { surface: 'analytics', host: segments[2] }\n  if (segments.length >= 2 && segments[1] === 'data') return { surface: 'datasets', host: null }\n  // The workspace's sites page, `/{org}/hosts`, which carries its dashboard row.\n  if (segments.length === 2 && segments[1] === 'hosts') return { surface: 'workspace', host: null }\n  if (segments[1] === 'crm' && segments[2] === 'reports') return { surface: 'workspace', host: null }\n  return null\n}\n\n/** The console page a table's figures come from, or `null` when the table names none. */\nexport function aiInsightSourceHref(\n  table: Pick<AiInsightTable, 'source' | 'scope'>,\n  where: { orgSlug: string; host: string | null },\n): string | null {\n  const path = table.source.path\n  if (!path || !where.orgSlug) return null\n  if (table.scope === 'org') return `/${where.orgSlug}/${path}`\n  return where.host ? `/${where.orgSlug}/hosts/${where.host}/${path}` : null\n}\n\n/** How a cell reads to a person, by its column's kind; `null` is \"—\". */\nexport function aiInsightCellText(\n  table: Pick<AiInsightTable, 'columns'>,\n  key: string,\n  value: string | number | null | undefined,\n): string {\n  if (value === null || value === undefined || value === '') return '—'\n  const column = table.columns.find((entry) => entry.key === key)\n  if (typeof value === 'string' || !column) return String(value)\n  switch (column.kind) {\n    case 'money':\n      return new Intl.NumberFormat('en-US', {\n        style: 'currency',\n        currency: column.currency ?? 'USD',\n      }).format(value)\n    case 'percent':\n      return `${value.toLocaleString('en-US', { maximumFractionDigits: 1 })}%`\n    case 'change':\n      return `${value > 0 ? '+' : ''}${value.toLocaleString('en-US', { maximumFractionDigits: 1 })}%`\n    case 'duration': {\n      const seconds = Math.round(value)\n      if (seconds < 60) return `${seconds}s`\n      const minutes = Math.floor(seconds / 60)\n      if (minutes < 60) return `${minutes}m ${String(seconds % 60).padStart(2, '0')}s`\n      return `${Math.floor(minutes / 60)}h ${String(minutes % 60).padStart(2, '0')}m`\n    }\n    default:\n      return value.toLocaleString('en-US', { maximumFractionDigits: 2 })\n  }\n}\n\n/** One cited row as a line a person reads: every column, labeled. */\nexport function aiInsightRowText(table: Pick<AiInsightTable, 'columns' | 'rows'>, index: number): string {\n  const row = table.rows[index]\n  if (!row) return ''\n  return table.columns\n    .map((column) => `${column.label}: ${aiInsightCellText(table, column.key, row[column.key])}`)\n    .join(' · ')\n}\n\n/** The ISO 8601 week an instant falls in, in UTC (`2026-W38`). */\nexport function aiInsightIsoWeek(at: Date): string {\n  const date = new Date(Date.UTC(at.getUTCFullYear(), at.getUTCMonth(), at.getUTCDate()))\n  // Thursday decides the week's year.\n  const weekday = date.getUTCDay() || 7\n  date.setUTCDate(date.getUTCDate() + 4 - weekday)\n  const yearStart = Date.UTC(date.getUTCFullYear(), 0, 1)\n  const week = Math.ceil(((date.getTime() - yearStart) / 86_400_000 + 1) / 7)\n  return `${date.getUTCFullYear()}-W${String(week).padStart(2, '0')}`\n}\n"],"names":["AI_INSIGHT_SURFACES","AI_INSIGHT_ASK_SURFACES","aiInsightSurface","inputs","surface","includes","AI_INSIGHT_SURFACE_READERS","analytics","datasets","marketing","automations","bookings","workspace","digest","aiInsightSurfaceNeedsSite","AI_INSIGHT_DIGEST_READERS","AI_INSIGHT_WINDOWS","AI_INSIGHT_DEFAULT_DAYS","AI_INSIGHT_DIGEST_DAYS","aiInsightDays","value","days","Number","AI_INSIGHT_MAX_INSIGHTS","AI_INSIGHT_MAX_CHARS","AI_INSIGHT_GAP_MAX_CHARS","AI_INSIGHT_MAX_CITES","AI_INSIGHT_MAX_CITED_ROWS","AI_INSIGHT_MAX_READS","AI_INSIGHT_QUESTION_MAX_CHARS","AI_INSIGHTS_COLLECTION","AI_INSIGHT_OUTPUT_LABEL","aiInsightOutput","job","record","hostSubdomain","count","insights","length","resource","id","$id","versionId","hostId","label","note","aiInsightSurfaceForPath","pathname","segments","String","split","filter","Boolean","host","rest","slice","aiInsightSourceHref","table","where","path","source","orgSlug","scope","aiInsightCellText","key","undefined","column","columns","find","entry","kind","Intl","NumberFormat","style","currency","format","toLocaleString","maximumFractionDigits","seconds","Math","round","minutes","floor","padStart","aiInsightRowText","index","row","rows","map","join","aiInsightIsoWeek","at","date","Date","UTC","getUTCFullYear","getUTCMonth","getUTCDate","weekday","getUTCDay","setUTCDate","yearStart","week","ceil","getTime"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAiDD,OAAO,MAAMA,sBAAmD;IAC9D;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA;AAED,qCAAqC,GACrC,OAAO,MAAMC,0BAAuD;IAClE;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA;AAED,8FAA8F,GAC9F,OAAO,SAASC,iBAAiBC,MAA4D;IAC3F,MAAMC,UAAUD,0BAAAA,MAAQ,CAAC,UAAU;IACnC,OAAO,OAAOC,YAAY,YAAY,AAACJ,oBAA0CK,QAAQ,CAACD,WACrFA,UACD;AACN;AAEA;;;;;;;;;;CAUC,GACD,OAAO,MAAME,6BAAoF;IAC/F,4EAA4E;IAC5EC,WAAW;QAAC;QAAe;QAAY;QAAY;QAAO;QAAS;QAAW;QAAa;KAAU;IACrGC,UAAU;QAAC;KAAW;IACtB,eAAe;QAAC;QAAY;QAAY;QAAO;QAAS;QAAa;KAAU;IAC/EC,WAAW;QAAC;QAAY;QAAS;QAAa;KAAU;IACxDC,aAAa;QAAC;KAAc;IAC5BC,UAAU;QAAC;KAAW;IACtBC,WAAW;QAAC;QAAO;KAAW;IAC9BC,QAAQ;QAAC;QAAY;QAAY;QAAS;QAAa;KAAU;AACnE,EAAC;AAED,4HAA4H,GAC5H,OAAO,SAASC,0BAA0BV,OAAyB;IACjE,OAAOA,YAAY,cAAcA,YAAY;AAC/C;AAEA;;;;;CAKC,GACD,OAAO,MAAMW,4BAA+C;IAC1D;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA;AAED,2EAA2E,GAC3E,OAAO,MAAMC,qBAAwC;IAAC;IAAG;IAAI;IAAI;CAAG,CAAA;AAEpE,6EAA6E,GAC7E,OAAO,MAAMC,0BAA0B,GAAE;AAEzC,sCAAsC,GACtC,OAAO,MAAMC,yBAAyB,EAAC;AAEvC,mFAAmF,GACnF,OAAO,SAASC,cAAcC,KAAc;IAC1C,MAAMC,OAAO,OAAOD,UAAU,WAAWA,QAAQE,OAAOF;IACxD,OAAOJ,mBAAmBX,QAAQ,CAACgB,QAAQA,OAAOJ;AACpD;AAEA,2EAA2E,GAC3E,OAAO,MAAMM,0BAA0B,EAAC;AAExC,oDAAoD,GACpD,OAAO,MAAMC,uBAAuB,IAAG;AAEvC,8EAA8E,GAC9E,OAAO,MAAMC,2BAA2B,IAAG;AAE3C,6CAA6C,GAC7C,OAAO,MAAMC,uBAAuB,EAAC;AAErC,sCAAsC,GACtC,OAAO,MAAMC,4BAA4B,GAAE;AAE3C,uCAAuC,GACvC,OAAO,MAAMC,uBAAuB,EAAC;AAErC,gDAAgD,GAChD,OAAO,MAAMC,gCAAgC,KAAK;AAoClD,mGAAmG,GACnG,OAAO,MAAMC,yBAAyB,aAAY;AA0BlD,yCAAyC,GACzC,OAAO,MAAMC,0BAA0B,SAAQ;AAE/C;;;;CAIC,GACD,OAAO,SAASC,gBACdC,GAAkC,EAClCC,MAAqD,EACrDC,aAA4B;QAOlBF;IALV,MAAMG,QAAQF,OAAOG,QAAQ,CAACC,MAAM;IACpC,OAAO;QACLC,UAAU;QACVC,IAAIP,IAAIQ,GAAG;QACXC,WAAW;QACXC,MAAM,GAAEV,cAAAA,IAAIU,MAAM,YAAVV,cAAc;QACtBE;QACAS,OAAOV,OAAO9B,OAAO,KAAK,WAAW,oBAAoB2B;QACzDc,MAAMT,QACF,GAAGA,MAAM,CAAC,EAAEA,UAAU,IAAI,YAAY,WAAW,sCAAsC,CAAC,GACxF;IACN;AACF;AAKA;;;;;;;CAOC,GACD,OAAO,SAASU,wBACdC,QAAmC;IAEnC,MAAMC,WAAWC,OAAOF,mBAAAA,WAAY,IACjCG,KAAK,CAAC,IAAI,CAAC,EAAE,CACbA,KAAK,CAAC,KACNC,MAAM,CAACC;IACV,kEAAkE;IAClE,IAAIJ,QAAQ,CAAC,EAAE,KAAK,WAAWA,SAASV,MAAM,IAAI,GAAG;QACnD,MAAMe,OAAOL,QAAQ,CAAC,EAAE;QACxB,MAAMM,OAAON,SAASO,KAAK,CAAC;QAC5B,IAAID,IAAI,CAAC,EAAE,KAAK,aAAa,OAAO;YAAElD,SAAS;YAAaiD;QAAK;QACjE,IAAIC,IAAI,CAAC,EAAE,KAAK,QAAQ,OAAO;YAAElD,SAAS;YAAYiD;QAAK;QAC3D,IAAIC,IAAI,CAAC,EAAE,KAAK,SAASA,IAAI,CAAC,EAAE,KAAK,WAAW,OAAO;YAAElD,SAAS;YAAeiD;QAAK;QACtF,IAAIC,IAAI,CAAC,EAAE,KAAK,aAAa,OAAO;YAAElD,SAAS;YAAaiD;QAAK;QACjE,IAAIC,IAAI,CAAC,EAAE,KAAK,cAAc,OAAO;YAAElD,SAAS;YAAeiD;QAAK;QACpE,IAAIC,IAAI,CAAC,EAAE,KAAK,YAAY,OAAO;YAAElD,SAAS;YAAYiD;QAAK;QAC/D,OAAO;IACT;IACA,iDAAiD;IACjD,IAAIL,QAAQ,CAAC,EAAE,KAAK,WAAWA,SAASV,MAAM,KAAK,GAAG,OAAO;QAAElC,SAAS;QAAaiD,MAAML,QAAQ,CAAC,EAAE;IAAC;IACvG,IAAIA,SAASV,MAAM,IAAI,KAAKU,QAAQ,CAAC,EAAE,KAAK,QAAQ,OAAO;QAAE5C,SAAS;QAAYiD,MAAM;IAAK;IAC7F,+EAA+E;IAC/E,IAAIL,SAASV,MAAM,KAAK,KAAKU,QAAQ,CAAC,EAAE,KAAK,SAAS,OAAO;QAAE5C,SAAS;QAAaiD,MAAM;IAAK;IAChG,IAAIL,QAAQ,CAAC,EAAE,KAAK,SAASA,QAAQ,CAAC,EAAE,KAAK,WAAW,OAAO;QAAE5C,SAAS;QAAaiD,MAAM;IAAK;IAClG,OAAO;AACT;AAEA,uFAAuF,GACvF,OAAO,SAASG,oBACdC,KAA+C,EAC/CC,KAA+C;IAE/C,MAAMC,OAAOF,MAAMG,MAAM,CAACD,IAAI;IAC9B,IAAI,CAACA,QAAQ,CAACD,MAAMG,OAAO,EAAE,OAAO;IACpC,IAAIJ,MAAMK,KAAK,KAAK,OAAO,OAAO,CAAC,CAAC,EAAEJ,MAAMG,OAAO,CAAC,CAAC,EAAEF,MAAM;IAC7D,OAAOD,MAAML,IAAI,GAAG,CAAC,CAAC,EAAEK,MAAMG,OAAO,CAAC,OAAO,EAAEH,MAAML,IAAI,CAAC,CAAC,EAAEM,MAAM,GAAG;AACxE;AAEA,uEAAuE,GACvE,OAAO,SAASI,kBACdN,KAAsC,EACtCO,GAAW,EACX5C,KAAyC;IAEzC,IAAIA,UAAU,QAAQA,UAAU6C,aAAa7C,UAAU,IAAI,OAAO;IAClE,MAAM8C,SAAST,MAAMU,OAAO,CAACC,IAAI,CAAC,CAACC,QAAUA,MAAML,GAAG,KAAKA;IAC3D,IAAI,OAAO5C,UAAU,YAAY,CAAC8C,QAAQ,OAAOjB,OAAO7B;IACxD,OAAQ8C,OAAOI,IAAI;QACjB,KAAK;gBAGSJ;YAFZ,OAAO,IAAIK,KAAKC,YAAY,CAAC,SAAS;gBACpCC,OAAO;gBACPC,QAAQ,GAAER,mBAAAA,OAAOQ,QAAQ,YAAfR,mBAAmB;YAC/B,GAAGS,MAAM,CAACvD;QACZ,KAAK;YACH,OAAO,GAAGA,MAAMwD,cAAc,CAAC,SAAS;gBAAEC,uBAAuB;YAAE,GAAG,CAAC,CAAC;QAC1E,KAAK;YACH,OAAO,GAAGzD,QAAQ,IAAI,MAAM,KAAKA,MAAMwD,cAAc,CAAC,SAAS;gBAAEC,uBAAuB;YAAE,GAAG,CAAC,CAAC;QACjG,KAAK;YAAY;gBACf,MAAMC,UAAUC,KAAKC,KAAK,CAAC5D;gBAC3B,IAAI0D,UAAU,IAAI,OAAO,GAAGA,QAAQ,CAAC,CAAC;gBACtC,MAAMG,UAAUF,KAAKG,KAAK,CAACJ,UAAU;gBACrC,IAAIG,UAAU,IAAI,OAAO,GAAGA,QAAQ,EAAE,EAAEhC,OAAO6B,UAAU,IAAIK,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC;gBAChF,OAAO,GAAGJ,KAAKG,KAAK,CAACD,UAAU,IAAI,EAAE,EAAEhC,OAAOgC,UAAU,IAAIE,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC;YACjF;QACA;YACE,OAAO/D,MAAMwD,cAAc,CAAC,SAAS;gBAAEC,uBAAuB;YAAE;IACpE;AACF;AAEA,mEAAmE,GACnE,OAAO,SAASO,iBAAiB3B,KAA+C,EAAE4B,KAAa;IAC7F,MAAMC,MAAM7B,MAAM8B,IAAI,CAACF,MAAM;IAC7B,IAAI,CAACC,KAAK,OAAO;IACjB,OAAO7B,MAAMU,OAAO,CACjBqB,GAAG,CAAC,CAACtB,SAAW,GAAGA,OAAOtB,KAAK,CAAC,EAAE,EAAEmB,kBAAkBN,OAAOS,OAAOF,GAAG,EAAEsB,GAAG,CAACpB,OAAOF,GAAG,CAAC,GAAG,EAC3FyB,IAAI,CAAC;AACV;AAEA,gEAAgE,GAChE,OAAO,SAASC,iBAAiBC,EAAQ;IACvC,MAAMC,OAAO,IAAIC,KAAKA,KAAKC,GAAG,CAACH,GAAGI,cAAc,IAAIJ,GAAGK,WAAW,IAAIL,GAAGM,UAAU;IACnF,oCAAoC;IACpC,MAAMC,UAAUN,KAAKO,SAAS,MAAM;IACpCP,KAAKQ,UAAU,CAACR,KAAKK,UAAU,KAAK,IAAIC;IACxC,MAAMG,YAAYR,KAAKC,GAAG,CAACF,KAAKG,cAAc,IAAI,GAAG;IACrD,MAAMO,OAAOvB,KAAKwB,IAAI,CAAC,AAAC,CAAA,AAACX,CAAAA,KAAKY,OAAO,KAAKH,SAAQ,IAAK,WAAa,CAAA,IAAK;IACzE,OAAO,GAAGT,KAAKG,cAAc,GAAG,EAAE,EAAE9C,OAAOqD,MAAMnB,QAAQ,CAAC,GAAG,MAAM;AACrE"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-insight.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  pluginFigureCellText,\n  pluginFigureIsoWeek,\n  type PluginFigureTable,\n} from '@aglyn/aglyn/plugin-manager/plugin-figures'\nimport type { AiJob, AiJobOutput } from './ai-jobs.types'\n\n/**\n * Insights (AGL-2915): what an `insight` job answers, in the shape the step\n * writes and the console reads. Pure data — no server import — so the answer\n * card and the digest email type what they render from the module the step\n * writes it with.\n *\n * ## A number is read, never written\n *\n * The model never runs a query and never sees a record. Code reads figures —\n * traffic, orders, bookings, forms, campaigns, datasets, experiments — through\n * fixed, typed readers, each answering with one compact table that says where\n * its figures come from. The model picks the readers and phrases what their\n * tables say, and every insight it writes cites the rows its figures come from.\n * An insight whose numbers cannot be found in the rows it cites is left out\n * (`runtime/ai-insight-check.ts`), so each one a person reads can be traced to\n * a number they can open in the console.\n *\n * ## Read-only, and kept apart from the job\n *\n * An insight job writes one document besides its own record: the answer, at\n * `orgs/{orgId}/aiInsights/{jobId}`, which no rule lets a client read. The\n * job's output names it and carries no figure, because a job document is\n * readable by every member of the workspace and the figures are not: a\n * collaborator on one site may not see another site's revenue. The answer is\n * served by `GET /api/ai/insights/{jobId}` to the member who asked and, for a\n * weekly digest, to the members who reach its site.\n */\n\n/**\n * Where an insight was asked: the console page whose Assist panel — or\n * whose \"Ask AI about these numbers\" card — asked it, or the weekly digest,\n * which no person asked. A site's Marketing, Automation and Bookings pages\n * and the workspace's own pages joined at AGL-3603.\n */\nexport type AiInsightSurface =\n  | 'analytics'\n  | 'datasets'\n  | 'crm-reports'\n  | 'marketing'\n  | 'automations'\n  | 'bookings'\n  | 'workspace'\n  | 'digest'\n\nexport const AI_INSIGHT_SURFACES: readonly AiInsightSurface[] = [\n  'analytics',\n  'datasets',\n  'crm-reports',\n  'marketing',\n  'automations',\n  'bookings',\n  'workspace',\n  'digest',\n]\n\n/** The surfaces a person asks from. */\nexport const AI_INSIGHT_ASK_SURFACES: readonly AiInsightSurface[] = [\n  'analytics',\n  'datasets',\n  'crm-reports',\n  'marketing',\n  'automations',\n  'bookings',\n  'workspace',\n]\n\n/** The surface an insight job's inputs name, or `null` for one no insight job is asked from. */\nexport function aiInsightSurface(inputs: Readonly<Record<string, unknown>> | null | undefined): AiInsightSurface | null {\n  const surface = inputs?.['surface']\n  return typeof surface === 'string' && (AI_INSIGHT_SURFACES as readonly string[]).includes(surface)\n    ? (surface as AiInsightSurface)\n    : null\n}\n\n/**\n * The readers a surface may offer, by the first word of a reader's id. The\n * Analytics page — and a site's dashboard — answers about the site's traffic,\n * what it sold, took and collected, its automations' runs and its CRM\n * pipeline; a Data page about its datasets; CRM Reports about where people\n * came from, what they did and the pipeline; the Marketing page about what\n * its campaigns, overlays and tests caused and earned, beside the traffic and\n * the forms they drove; the Automation page about its runs; the Bookings page\n * about its bookings; and the workspace's own pages about its pipeline and\n * its datasets.\n */\nexport const AI_INSIGHT_SURFACE_READERS: Readonly<Record<AiInsightSurface, readonly string[]>> = {\n  // `funnels` (AGL-3605): a site's funnels, step by step, beside its traffic.\n  analytics: ['automations', 'bookings', 'commerce', 'crm', 'forms', 'funnels', 'marketing', 'traffic'],\n  datasets: ['datasets'],\n  'crm-reports': ['bookings', 'commerce', 'crm', 'forms', 'marketing', 'traffic'],\n  marketing: ['commerce', 'forms', 'marketing', 'traffic'],\n  automations: ['automations'],\n  bookings: ['bookings'],\n  workspace: ['crm', 'datasets'],\n  digest: ['bookings', 'commerce', 'forms', 'marketing', 'traffic'],\n}\n\n/** Whether a surface answers about one site; the Data page and the workspace's pages may answer about the whole workspace. */\nexport function aiInsightSurfaceNeedsSite(surface: AiInsightSurface): boolean {\n  return surface !== 'datasets' && surface !== 'workspace'\n}\n\n/**\n * The readers a weekly digest reads, in the order the digest names them:\n * the traffic change, the top page, the days that stood out, the forms, the\n * campaigns, and what the site sold and took. Code reads these; no model\n * picks them.\n */\nexport const AI_INSIGHT_DIGEST_READERS: readonly string[] = [\n  'traffic.summary',\n  'traffic.pages',\n  'traffic.daily',\n  'forms.performance',\n  'marketing.campaigns',\n  'commerce.sales',\n  'bookings.services',\n]\n\n/** The windows, in days, an insight reads: the Traffic card's own ranges. */\nexport const AI_INSIGHT_WINDOWS: readonly number[] = [7, 14, 30, 90]\n\n/** The window a question that names none reads: the Traffic card's default. */\nexport const AI_INSIGHT_DEFAULT_DAYS = 14\n\n/** The window a weekly digest reads. */\nexport const AI_INSIGHT_DIGEST_DAYS = 7\n\n/** A window an insight's inputs or a read names, held to the readers' own ranges. */\nexport function aiInsightDays(value: unknown): number {\n  const days = typeof value === 'number' ? value : Number(value)\n  return AI_INSIGHT_WINDOWS.includes(days) ? days : AI_INSIGHT_DEFAULT_DAYS\n}\n\n/** The most insights one answer carries: a person reads them at a glance. */\nexport const AI_INSIGHT_MAX_INSIGHTS = 5\n\n/** The longest one insight may run, in characters. */\nexport const AI_INSIGHT_MAX_CHARS = 280\n\n/** The longest the sentence about what the figures could not answer may run. */\nexport const AI_INSIGHT_GAP_MAX_CHARS = 200\n\n/** The most tables one citation list names. */\nexport const AI_INSIGHT_MAX_CITES = 3\n\n/** The most rows one citation names. */\nexport const AI_INSIGHT_MAX_CITED_ROWS = 10\n\n/** The most readers one answer reads. */\nexport const AI_INSIGHT_MAX_READS = 4\n\n/** The longest question an insight job admits. */\nexport const AI_INSIGHT_QUESTION_MAX_CHARS = 1_000\n\n/**\n * A table as an insight job keeps it: the figures a reader returned, the\n * handle the model cites them by, and the reader they came from.\n */\nexport interface AiInsightTable extends PluginFigureTable {\n  /** `t1`, `t2`, …, in the order the job read them. */\n  ref: string\n  /** The reader's id (`commerce.sales`). */\n  reader: string\n  /** The window the reader was asked for, in days; 0 for a reader of current counts. */\n  days: number\n  /** Whether the table is about one site (its path under that site) or the workspace. */\n  scope: 'site' | 'org'\n}\n\n/** The rows of one table an insight's figures come from, by index. */\nexport interface AiInsightCitation {\n  table: string\n  rows: number[]\n}\n\nexport interface AiInsight {\n  /** One or two plain sentences. */\n  text: string\n  cites: AiInsightCitation[]\n}\n\n/** What the model answers with. */\nexport interface AiInsightAnswer {\n  insights: AiInsight[]\n  /** What the figures could not answer, in one sentence without numbers; `null` when nothing. */\n  gap: string | null\n}\n\n/** The answer collection under the org: server-written, and read through the insights door alone. */\nexport const AI_INSIGHTS_COLLECTION = 'aiInsights'\n\n/** An insight job's answer, as the step stores it. */\nexport interface AiInsightRecord {\n  jobId: string\n  orgId: string\n  hostId: string | null\n  surface: AiInsightSurface\n  /** The member whose question it answers; for a digest, the member it was made for. */\n  createdBy: string\n  /** The question, verbatim; a digest's is the digest's own title. */\n  question: string\n  /** The window the answer was asked about, in days. */\n  days: number\n  /** The insights that trace to the rows they cite; every other one was left out. */\n  insights: AiInsight[]\n  gap: string | null\n  /** Every table the job read, so each citation opens the figures it names. */\n  tables: AiInsightTable[]\n  /** How many insights the answer carried that were left out as not traceable. */\n  left: number\n  /** The ISO week a digest covers (`2026-W38`); `null` on a question. */\n  week: string | null\n  createdAtMs: number\n}\n\n/** The output id an answer is named by. */\nexport const AI_INSIGHT_OUTPUT_LABEL = 'Answer'\n\n/**\n * The output an insight job records: the answer's address and how many\n * insights it holds, and no figure. The count is a statement about the\n * answer rather than about the site, so every member may read it.\n */\nexport function aiInsightOutput(\n  job: Pick<AiJob, '$id' | 'hostId'>,\n  record: Pick<AiInsightRecord, 'insights' | 'surface'>,\n  hostSubdomain: string | null,\n): AiJobOutput {\n  const count = record.insights.length\n  return {\n    resource: 'insight',\n    id: job.$id,\n    versionId: null,\n    hostId: job.hostId ?? null,\n    hostSubdomain,\n    label: record.surface === 'digest' ? 'Weekly insights' : AI_INSIGHT_OUTPUT_LABEL,\n    note: count\n      ? `${count} ${count === 1 ? 'insight' : 'insights'}, each traced to the figures it cites.`\n      : 'The figures did not answer this question.',\n  }\n}\n\n/** The answer on the wire: the stored record, with nothing a client does not render. */\nexport type AiInsightAnswerWire = AiInsightRecord\n\n/**\n * The Assist panel's insight surface for a console path, or `null` off one:\n * a site's dashboard, Analytics, Data, CRM Reports, Marketing, Automation and\n * Bookings pages; the workspace's Data page; and the workspace's sites page\n * and CRM Reports, which read the workspace's pipeline and datasets. The\n * organization's Marketing page reads site figures, so it is not one — it\n * asks about the site it is showing, through its own in-page entry.\n */\nexport function aiInsightSurfaceForPath(\n  pathname: string | null | undefined,\n): { surface: Exclude<AiInsightSurface, 'digest'>; host: string | null } | null {\n  const segments = String(pathname ?? '')\n    .split('?')[0]\n    .split('/')\n    .filter(Boolean)\n  // `/{org}/hosts/{host}/…` on a site, `/{org}/…` on the workspace.\n  if (segments[1] === 'hosts' && segments.length >= 4) {\n    const host = segments[2]\n    const rest = segments.slice(3)\n    if (rest[0] === 'analytics') return { surface: 'analytics', host }\n    if (rest[0] === 'data') return { surface: 'datasets', host }\n    if (rest[0] === 'crm' && rest[1] === 'reports') return { surface: 'crm-reports', host }\n    if (rest[0] === 'marketing') return { surface: 'marketing', host }\n    if (rest[0] === 'automation') return { surface: 'automations', host }\n    if (rest[0] === 'bookings') return { surface: 'bookings', host }\n    return null\n  }\n  // The site's dashboard is `/{org}/hosts/{host}`.\n  if (segments[1] === 'hosts' && segments.length === 3) return { surface: 'analytics', host: segments[2] }\n  if (segments.length >= 2 && segments[1] === 'data') return { surface: 'datasets', host: null }\n  // The workspace's sites page, `/{org}/hosts`, which carries its dashboard row.\n  if (segments.length === 2 && segments[1] === 'hosts') return { surface: 'workspace', host: null }\n  if (segments[1] === 'crm' && segments[2] === 'reports') return { surface: 'workspace', host: null }\n  return null\n}\n\n/** The console page a table's figures come from, or `null` when the table names none. */\nexport function aiInsightSourceHref(\n  table: Pick<AiInsightTable, 'source' | 'scope'>,\n  where: { orgSlug: string; host: string | null },\n): string | null {\n  const path = table.source.path\n  if (!path || !where.orgSlug) return null\n  if (table.scope === 'org') return `/${where.orgSlug}/${path}`\n  return where.host ? `/${where.orgSlug}/hosts/${where.host}/${path}` : null\n}\n\n/** How a cell reads to a person, by its column's kind; `null` is \"—\". */\nexport function aiInsightCellText(\n  table: Pick<AiInsightTable, 'columns'>,\n  key: string,\n  value: string | number | null | undefined,\n): string {\n  return pluginFigureCellText(table, key, value)\n}\n\n/** One cited row as a line a person reads: every column, labeled. */\nexport function aiInsightRowText(table: Pick<AiInsightTable, 'columns' | 'rows'>, index: number): string {\n  const row = table.rows[index]\n  if (!row) return ''\n  return table.columns\n    .map((column) => `${column.label}: ${aiInsightCellText(table, column.key, row[column.key])}`)\n    .join(' · ')\n}\n\n/** The ISO 8601 week an instant falls in, in UTC (`2026-W38`). */\nexport function aiInsightIsoWeek(at: Date): string {\n  return pluginFigureIsoWeek(at)\n}\n"],"names":["pluginFigureCellText","pluginFigureIsoWeek","AI_INSIGHT_SURFACES","AI_INSIGHT_ASK_SURFACES","aiInsightSurface","inputs","surface","includes","AI_INSIGHT_SURFACE_READERS","analytics","datasets","marketing","automations","bookings","workspace","digest","aiInsightSurfaceNeedsSite","AI_INSIGHT_DIGEST_READERS","AI_INSIGHT_WINDOWS","AI_INSIGHT_DEFAULT_DAYS","AI_INSIGHT_DIGEST_DAYS","aiInsightDays","value","days","Number","AI_INSIGHT_MAX_INSIGHTS","AI_INSIGHT_MAX_CHARS","AI_INSIGHT_GAP_MAX_CHARS","AI_INSIGHT_MAX_CITES","AI_INSIGHT_MAX_CITED_ROWS","AI_INSIGHT_MAX_READS","AI_INSIGHT_QUESTION_MAX_CHARS","AI_INSIGHTS_COLLECTION","AI_INSIGHT_OUTPUT_LABEL","aiInsightOutput","job","record","hostSubdomain","count","insights","length","resource","id","$id","versionId","hostId","label","note","aiInsightSurfaceForPath","pathname","segments","String","split","filter","Boolean","host","rest","slice","aiInsightSourceHref","table","where","path","source","orgSlug","scope","aiInsightCellText","key","aiInsightRowText","index","row","rows","columns","map","column","join","aiInsightIsoWeek","at"],"mappings":"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"}

package/src/lib/model/ai-job-activity.d.ts

@@ -162,3 +162,27 @@ export declare function aiSiteBuildInFlight<T extends AiJobPhaseSource & {
     exceptJobId?: string | null;
     now?: number;
 }): T | null;
+/** The fields of a job {@link aiJobSettled} and {@link aiJobProblem} read. */
+export interface AiJobSettleSource {
+    status: AiJobStatus;
+    error?: string | null;
+    review?: {
+        message?: string | null;
+    } | null;
+}
+/** Whether a job has stopped moving: finished, or waiting on something only a person can change. */
+export declare function aiJobSettled(job: AiJobSettleSource | null): boolean;
+/**
+ * Why a settled job has no result to show, in words a person can act on, or
+ * `null` for a job that finished.
+ */
+export declare function aiJobProblem(job: AiJobSettleSource | null, failed: string): string | null;
+export type AiFollowTone = 'info' | 'warning' | 'success' | 'error';
+/**
+ * What the follow card's status line says in each phase, and how loudly
+ * (AGL-3593): the dialog that started a job, and the apps' follow view.
+ */
+export declare const AI_JOB_FOLLOW_PHASE_LINES: Readonly<Record<AiJobPhase, {
+    severity: AiFollowTone;
+    text: string;
+}>>;

package/src/lib/model/ai-job-activity.js

@@ -13,7 +13,7 @@
  * 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 { AI_JOB_PLAN_STEP } from "./ai-jobs.types.js";
+ */ import { AI_JOB_PLAN_STEP, AI_JOB_TERMINAL_STATUSES } from "./ai-jobs.types.js";
 /**
  * How long a self-confirming plan may sit parked before it reads as waiting
  * for a person after all: a confirmation that never came.
@@ -204,5 +204,56 @@ export function aiJobsActivity(jobs) {
         return Number.isFinite(at) && now - at < AI_SITE_BUILD_PLAN_FRESH_MS;
     })) != null ? _jobs_find : null;
 }
+/** Whether a job has stopped moving: finished, or waiting on something only a person can change. */ export function aiJobSettled(job) {
+    if (!job) return false;
+    return AI_JOB_TERMINAL_STATUSES.includes(job.status) || job.status === 'needs_input' || job.status === 'needs_review';
+}
+/**
+ * Why a settled job has no result to show, in words a person can act on, or
+ * `null` for a job that finished.
+ */ export function aiJobProblem(job, failed) {
+    var _job_review;
+    if (!job || !aiJobSettled(job) || job.status === 'done') return null;
+    if (job.status === 'canceled') return 'The job was canceled.';
+    if (job.status === 'needs_review') return ((_job_review = job.review) == null ? void 0 : _job_review.message) || job.error || failed;
+    return job.error || failed;
+}
+/**
+ * What the follow card's status line says in each phase, and how loudly
+ * (AGL-3593): the dialog that started a job, and the apps' follow view.
+ */ export const AI_JOB_FOLLOW_PHASE_LINES = {
+    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.'
+    }
+};
 
 //# sourceMappingURL=ai-job-activity.js.map