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

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

@@ -0,0 +1,112 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type AiJobKind, type AiJobReviewReason, type AiJobStatus, type AiJobStepStatus } from './ai-jobs.types';
+/**
+ * WHAT A JOB IS DOING, IN THE WORDS EVERY SURFACE SHOWS (AGL-3593).
+ *
+ * A job's `status` is the machine's word: `needs_review` covers both a plan
+ * waiting to be confirmed and an answer that broke a building rule twice, and
+ * `queued`/`running` say nothing about whether the job is still planning or
+ * already building. The console's surfaces — the AI jobs drawer's header and
+ * rows, the top-bar indicator, the Assist launcher's badge, the dialog that
+ * started the job, and the notification the machine raises — each tell a
+ * person the same thing, so they read it from here and nowhere else. A drawer
+ * that counted a refused plan as "running" while the chip said "needs you" is
+ * the disagreement this exists to rule out.
+ *
+ * Pure, and over the fields a stored job and its wire form share, so the
+ * server's notifier and the console read the same answer.
+ */
+/** The fields a phase is read from: a stored job and its wire summary both carry them. */
+export interface AiJobPhaseSource {
+    status: AiJobStatus;
+    review?: {
+        reason: AiJobReviewReason;
+    } | null;
+    steps: ReadonlyArray<{
+        name: string;
+        status: AiJobStepStatus;
+    }>;
+}
+/**
+ * Where one job stands, as a person reads it:
+ *
+ * - `queued` — created, no step has started.
+ * - `planning` — its plan step is the one running or next.
+ * - `plan-ready` — its plan waits for the person to confirm it.
+ * - `building` — a step after the plan (or a kind with no plan) is running or next.
+ * - `attention` — it stopped for something only a person can change: an
+ *   answer that broke a building rule, a site at an allowance, the
+ *   workspace's credits or a switch.
+ * - `done`, `failed`, `canceled` — settled.
+ */
+export type AiJobPhase = 'queued' | 'planning' | 'plan-ready' | 'building' | 'attention' | 'done' | 'failed' | 'canceled';
+export declare function aiJobPhase(job: AiJobPhaseSource): AiJobPhase;
+/** Each phase in the words a status line and a chip use. */
+export declare const AI_JOB_PHASE_LABELS: Readonly<Record<AiJobPhase, string>>;
+/**
+ * What the top-bar indicator, the launcher badge and the drawer's header
+ * count a job as, or `null` for a settled job, which none of them count.
+ *
+ * - `needs-you` — a plan waits to be confirmed: the one decision that, left
+ *   alone, leaves the person's site unbuilt.
+ * - `attention` — stopped for something a person must change, which is not a
+ *   plan to confirm.
+ * - `running` — queued, planning or building. Never a stopped job.
+ */
+export type AiJobActivityState = 'needs-you' | 'attention' | 'running';
+/** Loudest first: the order the indicator picks its one state by. */
+export declare const AI_JOB_ACTIVITY_PRECEDENCE: readonly AiJobActivityState[];
+export declare function aiJobActivityState(job: AiJobPhaseSource): AiJobActivityState | null;
+/**
+ * The statuses a job the indicator counts can have: every one that is not in
+ * `AI_JOB_TERMINAL_STATUSES`. The jobs route's `status=active` list asks
+ * Firestore for exactly these, under the (status, createdAt) index.
+ */
+export declare const AI_JOB_ACTIVE_STATUSES: readonly AiJobStatus[];
+/** How many of a list's jobs stand in each state. */
+export type AiJobActivityCounts = Readonly<Record<AiJobActivityState, number>>;
+export declare function aiJobActivityCounts(jobs: readonly AiJobPhaseSource[]): AiJobActivityCounts;
+/**
+ * What the indicator and the launcher show for a list of jobs: the loudest
+ * state any of them is in, how many are in it, and the job the indicator
+ * opens — the oldest of them, which has waited longest. `null` when none is
+ * moving or waiting, which is when both show nothing.
+ */
+export interface AiJobsActivity<T> {
+    state: AiJobActivityState;
+    count: number;
+    /** The job a click targets. */
+    job: T;
+    /** Planning rather than building, for the running chip's word. */
+    planning: boolean;
+}
+export declare function aiJobsActivity<T extends AiJobPhaseSource>(jobs: readonly T[]): AiJobsActivity<T> | null;
+/** The chip's words: `AI · plan ready`, `AI · 2 need attention`, `AI · planning`. */
+export declare function aiJobsActivityLabel(activity: AiJobsActivity<unknown>): string;
+/**
+ * The launcher's accessible name: what the button opens, and what waits in it.
+ * `Aglyn Assist, 1 AI job needs you`.
+ */
+export declare function aiJobsLauncherLabel(productName: string, activity: AiJobsActivity<unknown> | null): string;
+/** The drawer header's chips, one per state that has a job, loudest first. */
+export declare function aiJobsHeaderChips(counts: AiJobActivityCounts): Array<{
+    state: AiJobActivityState;
+    label: string;
+}>;
+/** The noun for what a job of this kind makes, or `AI job` for a kind with none. */
+export declare function aiJobKindNoun(kind: AiJobKind): string;

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

@@ -0,0 +1,144 @@
+/**
+ * @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 { AI_JOB_PLAN_STEP } from "./ai-jobs.types.js";
+export function aiJobPhase(job) {
+    if (job.status === 'done' || job.status === 'failed' || job.status === 'canceled') {
+        return job.status;
+    }
+    if (job.status === 'needs_review') {
+        var _job_review;
+        return ((_job_review = job.review) == null ? void 0 : _job_review.reason) === 'plan' ? 'plan-ready' : 'attention';
+    }
+    if (job.status === 'needs_input') return 'attention';
+    // Moving: the first step that has not finished says which half it is in.
+    const next = job.steps.find((step)=>step.status === 'running' || step.status === 'pending');
+    if ((next == null ? void 0 : next.name) === AI_JOB_PLAN_STEP) return 'planning';
+    if (job.status === 'queued' && job.steps.every((step)=>step.status === 'pending')) {
+        return 'queued';
+    }
+    return 'building';
+}
+/** Each phase in the words a status line and a chip use. */ export const AI_JOB_PHASE_LABELS = {
+    queued: 'Queued',
+    planning: 'Planning',
+    'plan-ready': 'Plan ready',
+    building: 'Building',
+    attention: 'Needs attention',
+    done: 'Done',
+    failed: 'Failed',
+    canceled: 'Canceled'
+};
+/** Loudest first: the order the indicator picks its one state by. */ export const AI_JOB_ACTIVITY_PRECEDENCE = [
+    'needs-you',
+    'attention',
+    'running'
+];
+export function aiJobActivityState(job) {
+    const phase = aiJobPhase(job);
+    if (phase === 'plan-ready') return 'needs-you';
+    if (phase === 'attention') return 'attention';
+    if (phase === 'queued' || phase === 'planning' || phase === 'building') return 'running';
+    return null;
+}
+/**
+ * The statuses a job the indicator counts can have: every one that is not in
+ * `AI_JOB_TERMINAL_STATUSES`. The jobs route's `status=active` list asks
+ * Firestore for exactly these, under the (status, createdAt) index.
+ */ export const AI_JOB_ACTIVE_STATUSES = [
+    'queued',
+    'running',
+    'needs_input',
+    'needs_review'
+];
+export function aiJobActivityCounts(jobs) {
+    const counts = {
+        'needs-you': 0,
+        attention: 0,
+        running: 0
+    };
+    for (const job of jobs){
+        const state = aiJobActivityState(job);
+        if (state) counts[state] += 1;
+    }
+    return counts;
+}
+export function aiJobsActivity(jobs) {
+    for (const state of AI_JOB_ACTIVITY_PRECEDENCE){
+        const matching = jobs.filter((job)=>aiJobActivityState(job) === state);
+        if (!matching.length) continue;
+        return {
+            state,
+            count: matching.length,
+            // Lists arrive newest first.
+            job: matching[matching.length - 1],
+            planning: state === 'running' && matching.every((job)=>{
+                const phase = aiJobPhase(job);
+                return phase === 'planning' || phase === 'queued';
+            })
+        };
+    }
+    return null;
+}
+/** The chip's words: `AI · plan ready`, `AI · 2 need attention`, `AI · planning`. */ export function aiJobsActivityLabel(activity) {
+    const { state, count } = activity;
+    if (state === 'needs-you') {
+        return count === 1 ? 'AI · plan ready' : `AI · ${count} plans ready`;
+    }
+    if (state === 'attention') {
+        return count === 1 ? 'AI · needs attention' : `AI · ${count} need attention`;
+    }
+    const verb = activity.planning ? 'planning' : 'working';
+    return count === 1 ? `AI · ${verb}` : `AI · ${count} ${verb}`;
+}
+/**
+ * The launcher's accessible name: what the button opens, and what waits in it.
+ * `Aglyn Assist, 1 AI job needs you`.
+ */ export function aiJobsLauncherLabel(productName, activity) {
+    const base = `Open ${productName} Assist`;
+    if (!activity) return base;
+    const jobs = activity.count === 1 ? '1 AI job' : `${activity.count} AI jobs`;
+    const verb = activity.count === 1 ? 'needs' : 'need';
+    if (activity.state === 'needs-you') return `${base}, ${jobs} ${verb} you`;
+    if (activity.state === 'attention') return `${base}, ${jobs} ${verb} attention`;
+    return `${base}, ${jobs} running`;
+}
+/** The drawer header's chips, one per state that has a job, loudest first. */ export function aiJobsHeaderChips(counts) {
+    return AI_JOB_ACTIVITY_PRECEDENCE.filter((state)=>counts[state] > 0).map((state)=>({
+            state,
+            label: state === 'needs-you' ? `${counts[state]} ${counts[state] === 1 ? 'needs' : 'need'} you` : state === 'attention' ? `${counts[state]} ${counts[state] === 1 ? 'needs' : 'need'} attention` : `${counts[state]} running`
+        }));
+}
+/** What a job makes, as a sentence's subject: `Your site`, `Your page`. */ const KIND_NOUNS = {
+    site: 'site',
+    page: 'page',
+    template: 'page template',
+    layout: 'layout',
+    form: 'form',
+    component: 'component',
+    email: 'email',
+    campaign: 'campaign',
+    workflow: 'automation',
+    theme: 'theme',
+    products: 'products',
+    experiment: 'experiment',
+    insight: 'answer'
+};
+/** The noun for what a job of this kind makes, or `AI job` for a kind with none. */ export function aiJobKindNoun(kind) {
+    var _KIND_NOUNS_kind;
+    return (_KIND_NOUNS_kind = KIND_NOUNS[kind]) != null ? _KIND_NOUNS_kind : 'AI job';
+}
+
+//# sourceMappingURL=ai-job-activity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-job-activity.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  AI_JOB_PLAN_STEP,\n  type AiJobKind,\n  type AiJobReviewReason,\n  type AiJobStatus,\n  type AiJobStepStatus,\n} from './ai-jobs.types'\n\n/**\n * WHAT A JOB IS DOING, IN THE WORDS EVERY SURFACE SHOWS (AGL-3593).\n *\n * A job's `status` is the machine's word: `needs_review` covers both a plan\n * waiting to be confirmed and an answer that broke a building rule twice, and\n * `queued`/`running` say nothing about whether the job is still planning or\n * already building. The console's surfaces — the AI jobs drawer's header and\n * rows, the top-bar indicator, the Assist launcher's badge, the dialog that\n * started the job, and the notification the machine raises — each tell a\n * person the same thing, so they read it from here and nowhere else. A drawer\n * that counted a refused plan as \"running\" while the chip said \"needs you\" is\n * the disagreement this exists to rule out.\n *\n * Pure, and over the fields a stored job and its wire form share, so the\n * server's notifier and the console read the same answer.\n */\n\n/** The fields a phase is read from: a stored job and its wire summary both carry them. */\nexport interface AiJobPhaseSource {\n  status: AiJobStatus\n  review?: { reason: AiJobReviewReason } | null\n  steps: ReadonlyArray<{ name: string; status: AiJobStepStatus }>\n}\n\n/**\n * Where one job stands, as a person reads it:\n *\n * - `queued` — created, no step has started.\n * - `planning` — its plan step is the one running or next.\n * - `plan-ready` — its plan waits for the person to confirm it.\n * - `building` — a step after the plan (or a kind with no plan) is running or next.\n * - `attention` — it stopped for something only a person can change: an\n *   answer that broke a building rule, a site at an allowance, the\n *   workspace's credits or a switch.\n * - `done`, `failed`, `canceled` — settled.\n */\nexport type AiJobPhase =\n  | 'queued'\n  | 'planning'\n  | 'plan-ready'\n  | 'building'\n  | 'attention'\n  | 'done'\n  | 'failed'\n  | 'canceled'\n\nexport function aiJobPhase(job: AiJobPhaseSource): AiJobPhase {\n  if (job.status === 'done' || job.status === 'failed' || job.status === 'canceled') {\n    return job.status\n  }\n  if (job.status === 'needs_review') {\n    return job.review?.reason === 'plan' ? 'plan-ready' : 'attention'\n  }\n  if (job.status === 'needs_input') return 'attention'\n  // Moving: the first step that has not finished says which half it is in.\n  const next = job.steps.find((step) => step.status === 'running' || step.status === 'pending')\n  if (next?.name === AI_JOB_PLAN_STEP) return 'planning'\n  if (job.status === 'queued' && job.steps.every((step) => step.status === 'pending')) {\n    return 'queued'\n  }\n  return 'building'\n}\n\n/** Each phase in the words a status line and a chip use. */\nexport const AI_JOB_PHASE_LABELS: Readonly<Record<AiJobPhase, string>> = {\n  queued: 'Queued',\n  planning: 'Planning',\n  'plan-ready': 'Plan ready',\n  building: 'Building',\n  attention: 'Needs attention',\n  done: 'Done',\n  failed: 'Failed',\n  canceled: 'Canceled',\n}\n\n/**\n * What the top-bar indicator, the launcher badge and the drawer's header\n * count a job as, or `null` for a settled job, which none of them count.\n *\n * - `needs-you` — a plan waits to be confirmed: the one decision that, left\n *   alone, leaves the person's site unbuilt.\n * - `attention` — stopped for something a person must change, which is not a\n *   plan to confirm.\n * - `running` — queued, planning or building. Never a stopped job.\n */\nexport type AiJobActivityState = 'needs-you' | 'attention' | 'running'\n\n/** Loudest first: the order the indicator picks its one state by. */\nexport const AI_JOB_ACTIVITY_PRECEDENCE: readonly AiJobActivityState[] = [\n  'needs-you',\n  'attention',\n  'running',\n]\n\nexport function aiJobActivityState(job: AiJobPhaseSource): AiJobActivityState | null {\n  const phase = aiJobPhase(job)\n  if (phase === 'plan-ready') return 'needs-you'\n  if (phase === 'attention') return 'attention'\n  if (phase === 'queued' || phase === 'planning' || phase === 'building') return 'running'\n  return null\n}\n\n/**\n * The statuses a job the indicator counts can have: every one that is not in\n * `AI_JOB_TERMINAL_STATUSES`. The jobs route's `status=active` list asks\n * Firestore for exactly these, under the (status, createdAt) index.\n */\nexport const AI_JOB_ACTIVE_STATUSES: readonly AiJobStatus[] = [\n  'queued',\n  'running',\n  'needs_input',\n  'needs_review',\n]\n\n/** How many of a list's jobs stand in each state. */\nexport type AiJobActivityCounts = Readonly<Record<AiJobActivityState, number>>\n\nexport function aiJobActivityCounts(jobs: readonly AiJobPhaseSource[]): AiJobActivityCounts {\n  const counts: Record<AiJobActivityState, number> = { 'needs-you': 0, attention: 0, running: 0 }\n  for (const job of jobs) {\n    const state = aiJobActivityState(job)\n    if (state) counts[state] += 1\n  }\n  return counts\n}\n\n/**\n * What the indicator and the launcher show for a list of jobs: the loudest\n * state any of them is in, how many are in it, and the job the indicator\n * opens — the oldest of them, which has waited longest. `null` when none is\n * moving or waiting, which is when both show nothing.\n */\nexport interface AiJobsActivity<T> {\n  state: AiJobActivityState\n  count: number\n  /** The job a click targets. */\n  job: T\n  /** Planning rather than building, for the running chip's word. */\n  planning: boolean\n}\n\nexport function aiJobsActivity<T extends AiJobPhaseSource>(\n  jobs: readonly T[],\n): AiJobsActivity<T> | null {\n  for (const state of AI_JOB_ACTIVITY_PRECEDENCE) {\n    const matching = jobs.filter((job) => aiJobActivityState(job) === state)\n    if (!matching.length) continue\n    return {\n      state,\n      count: matching.length,\n      // Lists arrive newest first.\n      job: matching[matching.length - 1],\n      planning:\n        state === 'running' &&\n        matching.every((job) => {\n          const phase = aiJobPhase(job)\n          return phase === 'planning' || phase === 'queued'\n        }),\n    }\n  }\n  return null\n}\n\n/** The chip's words: `AI · plan ready`, `AI · 2 need attention`, `AI · planning`. */\nexport function aiJobsActivityLabel(activity: AiJobsActivity<unknown>): string {\n  const { state, count } = activity\n  if (state === 'needs-you') {\n    return count === 1 ? 'AI · plan ready' : `AI · ${count} plans ready`\n  }\n  if (state === 'attention') {\n    return count === 1 ? 'AI · needs attention' : `AI · ${count} need attention`\n  }\n  const verb = activity.planning ? 'planning' : 'working'\n  return count === 1 ? `AI · ${verb}` : `AI · ${count} ${verb}`\n}\n\n/**\n * The launcher's accessible name: what the button opens, and what waits in it.\n * `Aglyn Assist, 1 AI job needs you`.\n */\nexport function aiJobsLauncherLabel(\n  productName: string,\n  activity: AiJobsActivity<unknown> | null,\n): string {\n  const base = `Open ${productName} Assist`\n  if (!activity) return base\n  const jobs = activity.count === 1 ? '1 AI job' : `${activity.count} AI jobs`\n  const verb = activity.count === 1 ? 'needs' : 'need'\n  if (activity.state === 'needs-you') return `${base}, ${jobs} ${verb} you`\n  if (activity.state === 'attention') return `${base}, ${jobs} ${verb} attention`\n  return `${base}, ${jobs} running`\n}\n\n/** The drawer header's chips, one per state that has a job, loudest first. */\nexport function aiJobsHeaderChips(\n  counts: AiJobActivityCounts,\n): Array<{ state: AiJobActivityState; label: string }> {\n  return AI_JOB_ACTIVITY_PRECEDENCE.filter((state) => counts[state] > 0).map((state) => ({\n    state,\n    label:\n      state === 'needs-you'\n        ? `${counts[state]} ${counts[state] === 1 ? 'needs' : 'need'} you`\n        : state === 'attention'\n          ? `${counts[state]} ${counts[state] === 1 ? 'needs' : 'need'} attention`\n          : `${counts[state]} running`,\n  }))\n}\n\n/** What a job makes, as a sentence's subject: `Your site`, `Your page`. */\nconst KIND_NOUNS: Partial<Record<AiJobKind, string>> = {\n  site: 'site',\n  page: 'page',\n  template: 'page template',\n  layout: 'layout',\n  form: 'form',\n  component: 'component',\n  email: 'email',\n  campaign: 'campaign',\n  workflow: 'automation',\n  theme: 'theme',\n  products: 'products',\n  experiment: 'experiment',\n  insight: 'answer',\n}\n\n/** The noun for what a job of this kind makes, or `AI job` for a kind with none. */\nexport function aiJobKindNoun(kind: AiJobKind): string {\n  return KIND_NOUNS[kind] ?? 'AI job'\n}\n"],"names":["AI_JOB_PLAN_STEP","aiJobPhase","job","status","review","reason","next","steps","find","step","name","every","AI_JOB_PHASE_LABELS","queued","planning","building","attention","done","failed","canceled","AI_JOB_ACTIVITY_PRECEDENCE","aiJobActivityState","phase","AI_JOB_ACTIVE_STATUSES","aiJobActivityCounts","jobs","counts","running","state","aiJobsActivity","matching","filter","length","count","aiJobsActivityLabel","activity","verb","aiJobsLauncherLabel","productName","base","aiJobsHeaderChips","map","label","KIND_NOUNS","site","page","template","layout","form","component","email","campaign","workflow","theme","products","experiment","insight","aiJobKindNoun","kind"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,gBAAgB,QAKX,qBAAiB;AAgDxB,OAAO,SAASC,WAAWC,GAAqB;IAC9C,IAAIA,IAAIC,MAAM,KAAK,UAAUD,IAAIC,MAAM,KAAK,YAAYD,IAAIC,MAAM,KAAK,YAAY;QACjF,OAAOD,IAAIC,MAAM;IACnB;IACA,IAAID,IAAIC,MAAM,KAAK,gBAAgB;YAC1BD;QAAP,OAAOA,EAAAA,cAAAA,IAAIE,MAAM,qBAAVF,YAAYG,MAAM,MAAK,SAAS,eAAe;IACxD;IACA,IAAIH,IAAIC,MAAM,KAAK,eAAe,OAAO;IACzC,yEAAyE;IACzE,MAAMG,OAAOJ,IAAIK,KAAK,CAACC,IAAI,CAAC,CAACC,OAASA,KAAKN,MAAM,KAAK,aAAaM,KAAKN,MAAM,KAAK;IACnF,IAAIG,CAAAA,wBAAAA,KAAMI,IAAI,MAAKV,kBAAkB,OAAO;IAC5C,IAAIE,IAAIC,MAAM,KAAK,YAAYD,IAAIK,KAAK,CAACI,KAAK,CAAC,CAACF,OAASA,KAAKN,MAAM,KAAK,YAAY;QACnF,OAAO;IACT;IACA,OAAO;AACT;AAEA,0DAA0D,GAC1D,OAAO,MAAMS,sBAA4D;IACvEC,QAAQ;IACRC,UAAU;IACV,cAAc;IACdC,UAAU;IACVC,WAAW;IACXC,MAAM;IACNC,QAAQ;IACRC,UAAU;AACZ,EAAC;AAcD,mEAAmE,GACnE,OAAO,MAAMC,6BAA4D;IACvE;IACA;IACA;CACD,CAAA;AAED,OAAO,SAASC,mBAAmBnB,GAAqB;IACtD,MAAMoB,QAAQrB,WAAWC;IACzB,IAAIoB,UAAU,cAAc,OAAO;IACnC,IAAIA,UAAU,aAAa,OAAO;IAClC,IAAIA,UAAU,YAAYA,UAAU,cAAcA,UAAU,YAAY,OAAO;IAC/E,OAAO;AACT;AAEA;;;;CAIC,GACD,OAAO,MAAMC,yBAAiD;IAC5D;IACA;IACA;IACA;CACD,CAAA;AAKD,OAAO,SAASC,oBAAoBC,IAAiC;IACnE,MAAMC,SAA6C;QAAE,aAAa;QAAGV,WAAW;QAAGW,SAAS;IAAE;IAC9F,KAAK,MAAMzB,OAAOuB,KAAM;QACtB,MAAMG,QAAQP,mBAAmBnB;QACjC,IAAI0B,OAAOF,MAAM,CAACE,MAAM,IAAI;IAC9B;IACA,OAAOF;AACT;AAiBA,OAAO,SAASG,eACdJ,IAAkB;IAElB,KAAK,MAAMG,SAASR,2BAA4B;QAC9C,MAAMU,WAAWL,KAAKM,MAAM,CAAC,CAAC7B,MAAQmB,mBAAmBnB,SAAS0B;QAClE,IAAI,CAACE,SAASE,MAAM,EAAE;QACtB,OAAO;YACLJ;YACAK,OAAOH,SAASE,MAAM;YACtB,6BAA6B;YAC7B9B,KAAK4B,QAAQ,CAACA,SAASE,MAAM,GAAG,EAAE;YAClClB,UACEc,UAAU,aACVE,SAASnB,KAAK,CAAC,CAACT;gBACd,MAAMoB,QAAQrB,WAAWC;gBACzB,OAAOoB,UAAU,cAAcA,UAAU;YAC3C;QACJ;IACF;IACA,OAAO;AACT;AAEA,mFAAmF,GACnF,OAAO,SAASY,oBAAoBC,QAAiC;IACnE,MAAM,EAAEP,KAAK,EAAEK,KAAK,EAAE,GAAGE;IACzB,IAAIP,UAAU,aAAa;QACzB,OAAOK,UAAU,IAAI,oBAAoB,CAAC,KAAK,EAAEA,MAAM,YAAY,CAAC;IACtE;IACA,IAAIL,UAAU,aAAa;QACzB,OAAOK,UAAU,IAAI,yBAAyB,CAAC,KAAK,EAAEA,MAAM,eAAe,CAAC;IAC9E;IACA,MAAMG,OAAOD,SAASrB,QAAQ,GAAG,aAAa;IAC9C,OAAOmB,UAAU,IAAI,CAAC,KAAK,EAAEG,MAAM,GAAG,CAAC,KAAK,EAAEH,MAAM,CAAC,EAAEG,MAAM;AAC/D;AAEA;;;CAGC,GACD,OAAO,SAASC,oBACdC,WAAmB,EACnBH,QAAwC;IAExC,MAAMI,OAAO,CAAC,KAAK,EAAED,YAAY,OAAO,CAAC;IACzC,IAAI,CAACH,UAAU,OAAOI;IACtB,MAAMd,OAAOU,SAASF,KAAK,KAAK,IAAI,aAAa,GAAGE,SAASF,KAAK,CAAC,QAAQ,CAAC;IAC5E,MAAMG,OAAOD,SAASF,KAAK,KAAK,IAAI,UAAU;IAC9C,IAAIE,SAASP,KAAK,KAAK,aAAa,OAAO,GAAGW,KAAK,EAAE,EAAEd,KAAK,CAAC,EAAEW,KAAK,IAAI,CAAC;IACzE,IAAID,SAASP,KAAK,KAAK,aAAa,OAAO,GAAGW,KAAK,EAAE,EAAEd,KAAK,CAAC,EAAEW,KAAK,UAAU,CAAC;IAC/E,OAAO,GAAGG,KAAK,EAAE,EAAEd,KAAK,QAAQ,CAAC;AACnC;AAEA,4EAA4E,GAC5E,OAAO,SAASe,kBACdd,MAA2B;IAE3B,OAAON,2BAA2BW,MAAM,CAAC,CAACH,QAAUF,MAAM,CAACE,MAAM,GAAG,GAAGa,GAAG,CAAC,CAACb,QAAW,CAAA;YACrFA;YACAc,OACEd,UAAU,cACN,GAAGF,MAAM,CAACE,MAAM,CAAC,CAAC,EAAEF,MAAM,CAACE,MAAM,KAAK,IAAI,UAAU,OAAO,IAAI,CAAC,GAChEA,UAAU,cACR,GAAGF,MAAM,CAACE,MAAM,CAAC,CAAC,EAAEF,MAAM,CAACE,MAAM,KAAK,IAAI,UAAU,OAAO,UAAU,CAAC,GACtE,GAAGF,MAAM,CAACE,MAAM,CAAC,QAAQ,CAAC;QACpC,CAAA;AACF;AAEA,yEAAyE,GACzE,MAAMe,aAAiD;IACrDC,MAAM;IACNC,MAAM;IACNC,UAAU;IACVC,QAAQ;IACRC,MAAM;IACNC,WAAW;IACXC,OAAO;IACPC,UAAU;IACVC,UAAU;IACVC,OAAO;IACPC,UAAU;IACVC,YAAY;IACZC,SAAS;AACX;AAEA,kFAAkF,GAClF,OAAO,SAASC,cAAcC,IAAe;QACpCf;IAAP,QAAOA,mBAAAA,UAAU,CAACe,KAAK,YAAhBf,mBAAoB;AAC7B"}

package/src/lib/model/ai-job-failure-copy.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { AiJobKind, AiJobSummary } from './ai-jobs.types';
+/**
+ * What a member reads when a plan could not be made (AGL-3594): one plain
+ * sentence and one thing to do, never a rule number or a validator's words.
+ *
+ * The plan step's own checks refuse an answer in the doctrine's vocabulary —
+ * "Rule 10 (Navigation and SEO travel with a page): A page reuses an
+ * address…" — which is what the one re-ask is told and what staff read to
+ * tell a rule that should bend from a model that ignored it. Shown to the
+ * person who asked for a site, the same words read as the product breaking.
+ * So the review a refused plan stops for carries this sentence as its
+ * `message`, and the doctrine's sentence and findings ride beside it as
+ * `detail` and `findings`, which the job document keeps and only staff are
+ * shown.
+ *
+ * Pure: no React, no Admin SDK. The drawer's plan card and the plan step read
+ * the same words.
+ */
+/** The violation code the Free wall refuses a plan with. */
+export declare const AI_PLAN_FREE_WALL_CODE = "plan-over-free-wall";
+export interface AiPlanFailureCopyInput {
+    /** The job kind whose plan was refused. */
+    kind: AiJobKind | string;
+    /** The codes of the violations its last answer broke. */
+    codes: readonly string[];
+    /** The step's credits went back to the Free allowance (AGL-3594). */
+    refunded: boolean;
+}
+/**
+ * The sentence a refused plan stops its job with. Over the Free wall, the way
+ * out is fewer pages or a paid plan; anything else is ours to have got wrong,
+ * and the way out is trying again — said to cost nothing only when it did.
+ */
+export declare function aiPlanFailureCopy(input: AiPlanFailureCopyInput): string;
+/**
+ * Why trying a refused plan again cannot work yet, or `null` when it can: the
+ * Free allowance left this month is less than a plan of this kind can cost at
+ * its worst. Said with the figures, and with the two ways out.
+ */
+export declare function aiPlanRetryRefusal(input: {
+    creditsLeft: number;
+    planCredits: number;
+}): string | null;
+/** The guided start's way back to the starter (AGL-3594). */
+export declare const AI_SITE_STARTER_FALLBACK_LABEL = "Use the starter site instead";
+/**
+ * Whether a job is a guided start that did not work out and can still be
+ * traded for the starter (AGL-3594): a site job that failed, was canceled, or
+ * stopped for a person on a refused step — never one waiting on its plan,
+ * which is a plan to confirm — and that has built nothing, since the starter
+ * is written only to a site with no page or layout.
+ */
+export declare function aiSiteStarterFallbackOffered(job: Pick<AiJobSummary, 'kind' | 'status' | 'hostId' | 'outputs' | 'review'>): boolean;

package/src/lib/model/ai-job-failure-copy.js

@@ -0,0 +1,78 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * What a member reads when a plan could not be made (AGL-3594): one plain
+ * sentence and one thing to do, never a rule number or a validator's words.
+ *
+ * The plan step's own checks refuse an answer in the doctrine's vocabulary —
+ * "Rule 10 (Navigation and SEO travel with a page): A page reuses an
+ * address…" — which is what the one re-ask is told and what staff read to
+ * tell a rule that should bend from a model that ignored it. Shown to the
+ * person who asked for a site, the same words read as the product breaking.
+ * So the review a refused plan stops for carries this sentence as its
+ * `message`, and the doctrine's sentence and findings ride beside it as
+ * `detail` and `findings`, which the job document keeps and only staff are
+ * shown.
+ *
+ * Pure: no React, no Admin SDK. The drawer's plan card and the plan step read
+ * the same words.
+ */ /** The violation code the Free wall refuses a plan with. */ export const AI_PLAN_FREE_WALL_CODE = 'plan-over-free-wall';
+/** What the plan was for, as the sentence names it. */ function planningWhat(kind) {
+    switch(kind){
+        case 'site':
+            return 'your site';
+        case 'page':
+            return 'this page';
+        default:
+            return 'this';
+    }
+}
+/**
+ * The sentence a refused plan stops its job with. Over the Free wall, the way
+ * out is fewer pages or a paid plan; anything else is ours to have got wrong,
+ * and the way out is trying again — said to cost nothing only when it did.
+ */ export function aiPlanFailureCopy(input) {
+    const spent = input.refunded ? ', and it did not use any of your AI credits' : '';
+    if (input.codes.includes(AI_PLAN_FREE_WALL_CODE)) {
+        return `We couldn't fit this plan into your Free AI credits${spent}. Try fewer pages, or upgrade for more.`;
+    }
+    return `Something went wrong planning ${planningWhat(input.kind)}${spent}. Try again.`;
+}
+/**
+ * Why trying a refused plan again cannot work yet, or `null` when it can: the
+ * Free allowance left this month is less than a plan of this kind can cost at
+ * its worst. Said with the figures, and with the two ways out.
+ */ export function aiPlanRetryRefusal(input) {
+    const left = Math.max(0, Math.floor(input.creditsLeft));
+    if (left >= input.planCredits) return null;
+    return `You have ${left} AI ${left === 1 ? 'credit' : 'credits'} left this month, and a plan needs up to ${input.planCredits}. Your credits refresh next month, or upgrade for more.`;
+}
+/** The guided start's way back to the starter (AGL-3594). */ export const AI_SITE_STARTER_FALLBACK_LABEL = 'Use the starter site instead';
+/**
+ * Whether a job is a guided start that did not work out and can still be
+ * traded for the starter (AGL-3594): a site job that failed, was canceled, or
+ * stopped for a person on a refused step — never one waiting on its plan,
+ * which is a plan to confirm — and that has built nothing, since the starter
+ * is written only to a site with no page or layout.
+ */ export function aiSiteStarterFallbackOffered(job) {
+    var _job_review;
+    if (job.kind !== 'site' || !job.hostId) return false;
+    if (job.outputs.length > 0) return false;
+    if (job.status === 'failed' || job.status === 'canceled') return true;
+    return job.status === 'needs_review' && ((_job_review = job.review) == null ? void 0 : _job_review.reason) === 'doctrine';
+}
+
+//# sourceMappingURL=ai-job-failure-copy.js.map

package/src/lib/model/ai-job-failure-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-job-failure-copy.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 { AiJobKind, AiJobSummary } from './ai-jobs.types'\n\n/**\n * What a member reads when a plan could not be made (AGL-3594): one plain\n * sentence and one thing to do, never a rule number or a validator's words.\n *\n * The plan step's own checks refuse an answer in the doctrine's vocabulary —\n * \"Rule 10 (Navigation and SEO travel with a page): A page reuses an\n * address…\" — which is what the one re-ask is told and what staff read to\n * tell a rule that should bend from a model that ignored it. Shown to the\n * person who asked for a site, the same words read as the product breaking.\n * So the review a refused plan stops for carries this sentence as its\n * `message`, and the doctrine's sentence and findings ride beside it as\n * `detail` and `findings`, which the job document keeps and only staff are\n * shown.\n *\n * Pure: no React, no Admin SDK. The drawer's plan card and the plan step read\n * the same words.\n */\n\n/** The violation code the Free wall refuses a plan with. */\nexport const AI_PLAN_FREE_WALL_CODE = 'plan-over-free-wall'\n\n/** What the plan was for, as the sentence names it. */\nfunction planningWhat(kind: AiJobKind | string): string {\n  switch (kind) {\n    case 'site':\n      return 'your site'\n    case 'page':\n      return 'this page'\n    default:\n      return 'this'\n  }\n}\n\nexport interface AiPlanFailureCopyInput {\n  /** The job kind whose plan was refused. */\n  kind: AiJobKind | string\n  /** The codes of the violations its last answer broke. */\n  codes: readonly string[]\n  /** The step's credits went back to the Free allowance (AGL-3594). */\n  refunded: boolean\n}\n\n/**\n * The sentence a refused plan stops its job with. Over the Free wall, the way\n * out is fewer pages or a paid plan; anything else is ours to have got wrong,\n * and the way out is trying again — said to cost nothing only when it did.\n */\nexport function aiPlanFailureCopy(input: AiPlanFailureCopyInput): string {\n  const spent = input.refunded ? ', and it did not use any of your AI credits' : ''\n  if (input.codes.includes(AI_PLAN_FREE_WALL_CODE)) {\n    return `We couldn't fit this plan into your Free AI credits${spent}. Try fewer pages, or upgrade for more.`\n  }\n  return `Something went wrong planning ${planningWhat(input.kind)}${spent}. Try again.`\n}\n\n/**\n * Why trying a refused plan again cannot work yet, or `null` when it can: the\n * Free allowance left this month is less than a plan of this kind can cost at\n * its worst. Said with the figures, and with the two ways out.\n */\nexport function aiPlanRetryRefusal(input: { creditsLeft: number; planCredits: number }): string | null {\n  const left = Math.max(0, Math.floor(input.creditsLeft))\n  if (left >= input.planCredits) return null\n  return `You have ${left} AI ${left === 1 ? 'credit' : 'credits'} left this month, and a plan needs up to ${input.planCredits}. Your credits refresh next month, or upgrade for more.`\n}\n\n/** The guided start's way back to the starter (AGL-3594). */\nexport const AI_SITE_STARTER_FALLBACK_LABEL = 'Use the starter site instead'\n\n/**\n * Whether a job is a guided start that did not work out and can still be\n * traded for the starter (AGL-3594): a site job that failed, was canceled, or\n * stopped for a person on a refused step — never one waiting on its plan,\n * which is a plan to confirm — and that has built nothing, since the starter\n * is written only to a site with no page or layout.\n */\nexport function aiSiteStarterFallbackOffered(\n  job: Pick<AiJobSummary, 'kind' | 'status' | 'hostId' | 'outputs' | 'review'>,\n): boolean {\n  if (job.kind !== 'site' || !job.hostId) return false\n  if (job.outputs.length > 0) return false\n  if (job.status === 'failed' || job.status === 'canceled') return true\n  return job.status === 'needs_review' && job.review?.reason === 'doctrine'\n}\n"],"names":["AI_PLAN_FREE_WALL_CODE","planningWhat","kind","aiPlanFailureCopy","input","spent","refunded","codes","includes","aiPlanRetryRefusal","left","Math","max","floor","creditsLeft","planCredits","AI_SITE_STARTER_FALLBACK_LABEL","aiSiteStarterFallbackOffered","job","hostId","outputs","length","status","review","reason"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID;;;;;;;;;;;;;;;;CAgBC,GAED,0DAA0D,GAC1D,OAAO,MAAMA,yBAAyB,sBAAqB;AAE3D,qDAAqD,GACrD,SAASC,aAAaC,IAAwB;IAC5C,OAAQA;QACN,KAAK;YACH,OAAO;QACT,KAAK;YACH,OAAO;QACT;YACE,OAAO;IACX;AACF;AAWA;;;;CAIC,GACD,OAAO,SAASC,kBAAkBC,KAA6B;IAC7D,MAAMC,QAAQD,MAAME,QAAQ,GAAG,gDAAgD;IAC/E,IAAIF,MAAMG,KAAK,CAACC,QAAQ,CAACR,yBAAyB;QAChD,OAAO,CAAC,mDAAmD,EAAEK,MAAM,uCAAuC,CAAC;IAC7G;IACA,OAAO,CAAC,8BAA8B,EAAEJ,aAAaG,MAAMF,IAAI,IAAIG,MAAM,YAAY,CAAC;AACxF;AAEA;;;;CAIC,GACD,OAAO,SAASI,mBAAmBL,KAAmD;IACpF,MAAMM,OAAOC,KAAKC,GAAG,CAAC,GAAGD,KAAKE,KAAK,CAACT,MAAMU,WAAW;IACrD,IAAIJ,QAAQN,MAAMW,WAAW,EAAE,OAAO;IACtC,OAAO,CAAC,SAAS,EAAEL,KAAK,IAAI,EAAEA,SAAS,IAAI,WAAW,UAAU,yCAAyC,EAAEN,MAAMW,WAAW,CAAC,uDAAuD,CAAC;AACvL;AAEA,2DAA2D,GAC3D,OAAO,MAAMC,iCAAiC,+BAA8B;AAE5E;;;;;;CAMC,GACD,OAAO,SAASC,6BACdC,GAA4E;QAKpCA;IAHxC,IAAIA,IAAIhB,IAAI,KAAK,UAAU,CAACgB,IAAIC,MAAM,EAAE,OAAO;IAC/C,IAAID,IAAIE,OAAO,CAACC,MAAM,GAAG,GAAG,OAAO;IACnC,IAAIH,IAAII,MAAM,KAAK,YAAYJ,IAAII,MAAM,KAAK,YAAY,OAAO;IACjE,OAAOJ,IAAII,MAAM,KAAK,kBAAkBJ,EAAAA,cAAAA,IAAIK,MAAM,qBAAVL,YAAYM,MAAM,MAAK;AACjE"}

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

@@ -0,0 +1,61 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { AglynNotification } from '@aglyn/aglyn/app-utils/notifications';
+import type { AiJobKind, AiJobOutput, AiJobReviewReason } from './ai-jobs.types';
+/** The besigner segment each versioned resource lives under. */
+export declare const AI_JOB_BESIGNER_SEGMENT: Partial<Record<AiJobOutput['resource'], string>>;
+/**
+ * The query parameter a console address carries to open AI jobs on one job
+ * (AGL-3593): the Assist panel reads it on arrival.
+ */
+export declare const AI_JOB_LINK_PARAM = "aiJob";
+/** Where a site's "Building your site" page lives, under the site (AGL-3594). */
+export declare const AI_SITE_BUILD_HREF = "/ai-jobs";
+/** A change the person who started a job is told about. */
+export type AiJobNoticeTransition = 'needs-review' | 'done' | 'failed';
+/** The fields of a stored job a notice is written from. */
+export interface AiJobNoticeSource {
+    $id: string;
+    orgId: string;
+    hostId?: string | null;
+    kind: AiJobKind;
+    review?: {
+        reason: AiJobReviewReason;
+        message?: string | null;
+    } | null;
+    outputs?: readonly AiJobOutput[] | null;
+    error?: string | null;
+}
+export type AiJobNotice = Pick<AglynNotification, 'type' | 'title' | 'body' | 'link' | 'orgId' | 'hostId' | 'level'>;
+/**
+ * Where a notice's link goes, in the stored form the console rewrites when it
+ * is followed (`normalizeNotificationLink`): `/{hostId}/…` for the job's site,
+ * `/org…` for a job of the workspace's.
+ *
+ * A job that is done leads to what it built (AGL-3593): several pages of the
+ * job's site open that site's Pages list, one versioned output opens in the
+ * editor on the version the job wrote. Everything else — a plan to confirm, a
+ * job that stopped, a done job with nothing of its own to open — opens AI
+ * jobs on the job.
+ */
+export declare function aiJobNoticeLink(job: AiJobNoticeSource, to: AiJobNoticeTransition): string;
+/**
+ * The in-app notification for one change of one job (AGL-3593), for the
+ * person who created it. Customer-safe throughout: a stopped job's sentence is
+ * the job's own `error`, which the machine writes as a fixed sentence.
+ */
+export declare function aiJobNotice(job: AiJobNoticeSource, to: AiJobNoticeTransition): AiJobNotice;

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

@@ -0,0 +1,112 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { aiJobKindNoun } from "./ai-job-activity.js";
+/** The besigner segment each versioned resource lives under. */ export const AI_JOB_BESIGNER_SEGMENT = {
+    screen: 'screens',
+    reusableComponent: 'components',
+    layout: 'layouts',
+    template: 'templates',
+    // An email design is a screen: it opens in the screen besigner, as the
+    // Emails page's own Edit design does.
+    emailScreen: 'screens'
+};
+/**
+ * The query parameter a console address carries to open AI jobs on one job
+ * (AGL-3593): the Assist panel reads it on arrival.
+ */ export const AI_JOB_LINK_PARAM = 'aiJob';
+/** Where a site's "Building your site" page lives, under the site (AGL-3594). */ export const AI_SITE_BUILD_HREF = '/ai-jobs';
+/**
+ * Where a notice's link goes, in the stored form the console rewrites when it
+ * is followed (`normalizeNotificationLink`): `/{hostId}/…` for the job's site,
+ * `/org…` for a job of the workspace's.
+ *
+ * A job that is done leads to what it built (AGL-3593): several pages of the
+ * job's site open that site's Pages list, one versioned output opens in the
+ * editor on the version the job wrote. Everything else — a plan to confirm, a
+ * job that stopped, a done job with nothing of its own to open — opens AI
+ * jobs on the job.
+ */ export function aiJobNoticeLink(job, to) {
+    const base = job.hostId ? `/${job.hostId}` : '/org';
+    // A site job's every notice opens its "Building your site" page (AGL-3594),
+    // which leads with the next step whatever the job's state.
+    if (job.kind === 'site' && job.hostId) return `${base}${AI_SITE_BUILD_HREF}/${encodeURIComponent(job.$id)}`;
+    if (to === 'done' && job.hostId) {
+        var _job_outputs;
+        const own = ((_job_outputs = job.outputs) != null ? _job_outputs : []).filter((output)=>output.hostId === job.hostId);
+        const screens = own.filter((output)=>output.resource === 'screen');
+        if (screens.length > 1) return `${base}/screens`;
+        const versioned = own.find((output)=>AI_JOB_BESIGNER_SEGMENT[output.resource] && output.versionId);
+        if (own.length === 1 && versioned) {
+            const segment = AI_JOB_BESIGNER_SEGMENT[versioned.resource];
+            return `${base}/${segment}/${versioned.id}/versions/${versioned.versionId}/besigner`;
+        }
+    }
+    return `${base}?${AI_JOB_LINK_PARAM}=${encodeURIComponent(job.$id)}`;
+}
+/**
+ * The in-app notification for one change of one job (AGL-3593), for the
+ * person who created it. Customer-safe throughout: a stopped job's sentence is
+ * the job's own `error`, which the machine writes as a fixed sentence.
+ */ export function aiJobNotice(job, to) {
+    const noun = aiJobKindNoun(job.kind);
+    const scope = _extends({
+        orgId: job.orgId
+    }, job.hostId ? {
+        hostId: job.hostId
+    } : {});
+    const link = aiJobNoticeLink(job, to);
+    if (to === 'needs-review') {
+        var _job_review, _job_review1;
+        if (((_job_review = job.review) == null ? void 0 : _job_review.reason) === 'plan') {
+            return _extends({
+                type: 'content.aiJobNeedsYou',
+                level: 'warning',
+                title: noun === 'AI job' ? 'Your plan is ready: confirm it to build' : `Your ${noun} plan is ready: confirm it to build`,
+                body: 'Nothing is built until you confirm the plan. It waits in AI jobs.',
+                link
+            }, scope);
+        }
+        return _extends({
+            type: 'content.aiJobNeedsYou',
+            level: 'warning',
+            title: `Your ${noun === 'AI job' ? 'AI job' : `${noun} job`} needs you`,
+            body: ((_job_review1 = job.review) == null ? void 0 : _job_review1.message) || job.error || 'It stopped for your decision. It waits in AI jobs.',
+            link
+        }, scope);
+    }
+    if (to === 'done') {
+        var _job_outputs;
+        const pages = ((_job_outputs = job.outputs) != null ? _job_outputs : []).filter((output)=>output.resource === 'screen').length;
+        const title = job.kind === 'site' || pages > 1 ? 'Your site’s draft pages are ready' : job.kind === 'page' ? 'Your draft page is ready' : noun === 'AI job' ? 'Your AI job finished' : `Your ${noun} is ready`;
+        return _extends({
+            type: 'content.aiJobDone',
+            level: 'success',
+            title,
+            body: job.kind === 'insight' || job.kind === 'text' ? 'Open AI jobs to read it.' : 'Everything it built is an unpublished draft until you publish it.',
+            link
+        }, scope);
+    }
+    return _extends({
+        type: 'content.aiJobFailed',
+        level: 'warning',
+        title: `Your ${noun === 'AI job' ? 'AI job' : `${noun} job`} stopped`,
+        body: job.error || 'It stopped before it finished.',
+        link
+    }, scope);
+}
+
+//# sourceMappingURL=ai-job-notice.js.map