@aglyn/plugins-ai 1.0.0-beta.226 → 1.0.0-beta.228

package/src/lib/components/ai-jobs-store.js

@@ -0,0 +1,218 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useEffect, useMemo, useRef, useSyncExternalStore } from "react";
+import { aiJobsActivity } from "../model/ai-job-activity.js";
+import { AI_JOB_TERMINAL_STATUSES } from "../model/ai-jobs.types.js";
+let openRequest = {
+    seq: 0,
+    jobId: null
+};
+const openListeners = new Set();
+/**
+ * Opens the Assist panel on its AI jobs drawer, expanded, scrolled to
+ * `jobId` when one is named. A surface that covers the panel — a dialog —
+ * closes itself beside the call; this opens, it does not close anything.
+ */ export function openAiJobs(options = {}) {
+    var _options_jobId;
+    openRequest = {
+        seq: openRequest.seq + 1,
+        jobId: (_options_jobId = options.jobId) != null ? _options_jobId : null
+    };
+    for (const listener of openListeners)listener();
+}
+function subscribeOpen(listener) {
+    openListeners.add(listener);
+    return ()=>{
+        openListeners.delete(listener);
+    };
+}
+const readOpen = ()=>openRequest;
+/** The latest open request, for the panel; a new `seq` is a new request. */ export function useAiJobsOpenRequest() {
+    return useSyncExternalStore(subscribeOpen, readOpen, readOpen);
+}
+/**
+ * The query parameter a notification's link carries: a console page opened
+ * with `?aiJob={id}` opens AI jobs on that job, the way pressing the
+ * indicator does.
+ */ export { AI_JOB_LINK_PARAM } from "../model/ai-job-notice.js";
+// ── The workspace's unsettled jobs ────────────────────────────────────────
+/** How often a list with something in it is read again, while the tab is in view. */ export const AI_JOBS_ACTIVE_POLL_MS = 15000;
+/** The most unsettled jobs one read lists; a glance, not an archive. */ const ACTIVE_LIMIT = 20;
+const NONE = Object.freeze([]);
+const entries = new Map();
+const keyOf = (uid, orgId)=>`${uid}\n${orgId}`;
+function emit(entry) {
+    for (const listener of entry.listeners)listener();
+}
+function isSettled(job) {
+    return AI_JOB_TERMINAL_STATUSES.includes(job.status);
+}
+function schedule(entry) {
+    if (entry.timer) clearTimeout(entry.timer);
+    entry.timer = null;
+    if (entry.closed || entry.subscribers === 0 || entry.jobs.length === 0) return;
+    entry.timer = setTimeout(()=>{
+        entry.timer = null;
+        const hidden = typeof document !== 'undefined' && document.visibilityState === 'hidden';
+        // A hidden tab reads nothing; coming back into view reads at once.
+        if (hidden) return;
+        void read(entry);
+    }, AI_JOBS_ACTIVE_POLL_MS);
+}
+async function read(entry) {
+    if (entry.inflight || entry.closed) return;
+    entry.inflight = true;
+    try {
+        var _ref;
+        const response = await authorizedFetch(entry.user, `/api/ai/jobs?orgId=${encodeURIComponent(entry.orgId)}&status=active&limit=${ACTIVE_LIMIT}`);
+        if (response.status === 404 || response.status === 403) {
+            // The release flag off, or a plan or member without generation: there
+            // is nothing to count, now or on the next tick.
+            entry.closed = true;
+            entry.jobs = NONE;
+            emit(entry);
+            return;
+        }
+        if (!response.ok) return;
+        const payload = await response.json().catch(()=>null);
+        entry.jobs = Object.freeze(((_ref = payload == null ? void 0 : payload.jobs) != null ? _ref : []).filter((job)=>!isSettled(job)));
+        emit(entry);
+    } catch (unused) {
+    // An unreachable route keeps what was last read; the next tick asks again.
+    } finally{
+        entry.inflight = false;
+        schedule(entry);
+    }
+}
+function entryFor(uid, orgId, user) {
+    const key = keyOf(uid, orgId);
+    let entry = entries.get(key);
+    if (!entry) {
+        entry = {
+            jobs: NONE,
+            user,
+            orgId,
+            subscribers: 0,
+            inflight: false,
+            timer: null,
+            closed: false,
+            listeners: new Set()
+        };
+        entries.set(key, entry);
+    }
+    return entry;
+}
+/**
+ * Hands a job's latest state to every surface counting this workspace's jobs:
+ * a new job joins the list, a settled one leaves it. Keyed on the job's own
+ * workspace, for every person whose list holds that workspace in this tab.
+ */ export function publishAiJob(job) {
+    if (!(job == null ? void 0 : job.orgId)) return;
+    for (const entry of entries.values()){
+        if (entry.orgId !== job.orgId || entry.closed) continue;
+        const index = entry.jobs.findIndex((known)=>known.id === job.id);
+        let next;
+        if (isSettled(job)) {
+            if (index === -1) continue;
+            next = entry.jobs.filter((known)=>known.id !== job.id);
+        } else if (index === -1) {
+            next = [
+                job,
+                ...entry.jobs
+            ];
+        } else {
+            next = [
+                ...entry.jobs
+            ];
+            next[index] = job;
+        }
+        entry.jobs = Object.freeze(next);
+        emit(entry);
+        // A list that just gained its first job starts its timer.
+        if (!entry.timer && !entry.inflight) schedule(entry);
+    }
+}
+/** Forget every list and request; specs start each case from nothing. */ export function resetAiJobsStoreForTests() {
+    for (const entry of entries.values()){
+        if (entry.timer) clearTimeout(entry.timer);
+    }
+    entries.clear();
+    openListeners.clear();
+    openRequest = {
+        seq: 0,
+        jobId: null
+    };
+}
+/**
+ * The workspace's jobs that are not yet settled, newest first, for the
+ * signed-in person — empty while the first read is in flight, where the
+ * route refuses, and when `enabled` is false (a surface whose own gates have
+ * not passed reads nothing at all).
+ */ export function useAiJobsInFlight(user, orgId, enabled = true) {
+    var _ref;
+    const uid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    const userRef = useRef(user);
+    userRef.current = user;
+    const entry = useMemo(()=>enabled && uid && orgId ? entryFor(uid, orgId, userRef.current) : null, [
+        enabled,
+        uid,
+        orgId
+    ]);
+    useEffect(()=>{
+        if (!entry) return undefined;
+        entry.user = userRef.current;
+        entry.subscribers += 1;
+        if (entry.subscribers === 1) void read(entry);
+        const onVisible = ()=>{
+            if (document.visibilityState === 'visible' && entry.jobs.length > 0) void read(entry);
+        };
+        document.addEventListener('visibilitychange', onVisible);
+        return ()=>{
+            document.removeEventListener('visibilitychange', onVisible);
+            entry.subscribers -= 1;
+            if (entry.subscribers === 0 && entry.timer) {
+                clearTimeout(entry.timer);
+                entry.timer = null;
+            }
+        };
+    }, [
+        entry
+    ]);
+    const subscribe = useMemo(()=>(listener)=>{
+            if (!entry) return ()=>undefined;
+            entry.listeners.add(listener);
+            return ()=>{
+                entry.listeners.delete(listener);
+            };
+        }, [
+        entry
+    ]);
+    const snapshot = ()=>{
+        var _ref;
+        return (_ref = entry == null ? void 0 : entry.jobs) != null ? _ref : NONE;
+    };
+    return useSyncExternalStore(subscribe, snapshot, snapshot);
+}
+/** What the indicator and the launcher show for the workspace, or `null` for nothing. */ export function useAiJobsActivity(user, orgId, enabled = true) {
+    const jobs = useAiJobsInFlight(user, orgId, enabled);
+    return useMemo(()=>aiJobsActivity(jobs), [
+        jobs
+    ]);
+}
+
+//# sourceMappingURL=ai-jobs-store.js.map

package/src/lib/components/ai-jobs-store.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-jobs-store.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'use client'\n\nimport {\n  authorizedFetch,\n  type MaybeTokenSource,\n  type TokenSource,\n} from '@aglyn/shared-util-http/authorized-token'\nimport { useEffect, useMemo, useRef, useSyncExternalStore } from 'react'\nimport { aiJobsActivity, type AiJobsActivity } from '../model/ai-job-activity'\nimport { AI_JOB_TERMINAL_STATUSES, type AiJobSummary } from '../model/ai-jobs.types'\n\n/**\n * WHERE A PERSON FINDS THEIR AI JOBS (AGL-3593).\n *\n * Two things every AI surface in the console shares, kept in this module\n * rather than in any one component because the surfaces that need them — a\n * brief dialog on the Screens page, the guided start's full-screen dialog,\n * the top-bar indicator, the Assist launcher and the drawer inside the\n * panel — are mounted in different zones and know nothing of one another.\n * All of them are this plugin's, so no shell, zone or event bus carries it.\n *\n * ── Opening AI jobs ──────────────────────────────────────────────────────\n *\n * {@link openAiJobs} is the one action every \"Open AI jobs\" button, the\n * indicator and a notification's link take: the Assist panel subscribes, opens\n * itself, expands its AI jobs drawer, and scrolls to and highlights the job\n * named. A request is a sequence number as well as a job, so asking twice for\n * the same job opens it twice.\n *\n * ── The workspace's unsettled jobs ───────────────────────────────────────\n *\n * The indicator, the launcher's badge and the drawer's open-by-default rule\n * read the same list: the workspace's jobs that are not yet settled, from\n * the jobs route's `status=active` (a Firestore `in` query under the\n * (status, createdAt) index, never a filter of a loaded window). ONE list per\n * person and workspace however many surfaces read it, re-read on a timer only\n * while something in it is still moving or waiting and the tab is in view —\n * a workspace with nothing running costs one read per page load and no more.\n *\n * Every surface that learns a job's state some other way — the dialog that\n * created it, the drawer's event stream, the in-dialog confirm — hands it in\n * through {@link publishAiJob}, so the indicator moves the moment the job\n * does rather than on the next read.\n */\n\n// ── Opening AI jobs ───────────────────────────────────────────────────────\n\n/** The latest request to open AI jobs; `seq` is 0 until anything asked. */\nexport interface AiJobsOpenRequest {\n  seq: number\n  /** The job to scroll to and highlight, or `null` for the drawer alone. */\n  jobId: string | null\n}\n\nlet openRequest: AiJobsOpenRequest = { seq: 0, jobId: null }\nconst openListeners = new Set<() => void>()\n\n/**\n * Opens the Assist panel on its AI jobs drawer, expanded, scrolled to\n * `jobId` when one is named. A surface that covers the panel — a dialog —\n * closes itself beside the call; this opens, it does not close anything.\n */\nexport function openAiJobs(options: { jobId?: string | null } = {}): void {\n  openRequest = { seq: openRequest.seq + 1, jobId: options.jobId ?? null }\n  for (const listener of openListeners) listener()\n}\n\nfunction subscribeOpen(listener: () => void): () => void {\n  openListeners.add(listener)\n  return () => {\n    openListeners.delete(listener)\n  }\n}\n\nconst readOpen = (): AiJobsOpenRequest => openRequest\n\n/** The latest open request, for the panel; a new `seq` is a new request. */\nexport function useAiJobsOpenRequest(): AiJobsOpenRequest {\n  return useSyncExternalStore(subscribeOpen, readOpen, readOpen)\n}\n\n/**\n * The query parameter a notification's link carries: a console page opened\n * with `?aiJob={id}` opens AI jobs on that job, the way pressing the\n * indicator does.\n */\nexport { AI_JOB_LINK_PARAM } from '../model/ai-job-notice'\n\n// ── The workspace's unsettled jobs ────────────────────────────────────────\n\n/** How often a list with something in it is read again, while the tab is in view. */\nexport const AI_JOBS_ACTIVE_POLL_MS = 15_000\n\n/** The most unsettled jobs one read lists; a glance, not an archive. */\nconst ACTIVE_LIMIT = 20\n\nconst NONE: readonly AiJobSummary[] = Object.freeze([])\n\ninterface Entry {\n  jobs: readonly AiJobSummary[]\n  /** Who reads it, kept current by whichever surface subscribed last. */\n  user: MaybeTokenSource\n  orgId: string\n  subscribers: number\n  inflight: boolean\n  timer: ReturnType<typeof setTimeout> | null\n  /** The route said the feature is not this workspace's: nothing is read again. */\n  closed: boolean\n  listeners: Set<() => void>\n}\n\nconst entries = new Map<string, Entry>()\n\nconst keyOf = (uid: string, orgId: string): string => `${uid}\\n${orgId}`\n\nfunction emit(entry: Entry): void {\n  for (const listener of entry.listeners) listener()\n}\n\nfunction isSettled(job: AiJobSummary): boolean {\n  return AI_JOB_TERMINAL_STATUSES.includes(job.status)\n}\n\nfunction schedule(entry: Entry): void {\n  if (entry.timer) clearTimeout(entry.timer)\n  entry.timer = null\n  if (entry.closed || entry.subscribers === 0 || entry.jobs.length === 0) return\n  entry.timer = setTimeout(() => {\n    entry.timer = null\n    const hidden = typeof document !== 'undefined' && document.visibilityState === 'hidden'\n    // A hidden tab reads nothing; coming back into view reads at once.\n    if (hidden) return\n    void read(entry)\n  }, AI_JOBS_ACTIVE_POLL_MS)\n}\n\nasync function read(entry: Entry): Promise<void> {\n  if (entry.inflight || entry.closed) return\n  entry.inflight = true\n  try {\n    const response = await authorizedFetch(\n      entry.user,\n      `/api/ai/jobs?orgId=${encodeURIComponent(entry.orgId)}&status=active&limit=${ACTIVE_LIMIT}`,\n    )\n    if (response.status === 404 || response.status === 403) {\n      // The release flag off, or a plan or member without generation: there\n      // is nothing to count, now or on the next tick.\n      entry.closed = true\n      entry.jobs = NONE\n      emit(entry)\n      return\n    }\n    if (!response.ok) return\n    const payload = (await response.json().catch(() => null)) as { jobs?: AiJobSummary[] } | null\n    entry.jobs = Object.freeze((payload?.jobs ?? []).filter((job) => !isSettled(job)))\n    emit(entry)\n  } catch {\n    // An unreachable route keeps what was last read; the next tick asks again.\n  } finally {\n    entry.inflight = false\n    schedule(entry)\n  }\n}\n\nfunction entryFor(uid: string, orgId: string, user: MaybeTokenSource): Entry {\n  const key = keyOf(uid, orgId)\n  let entry = entries.get(key)\n  if (!entry) {\n    entry = {\n      jobs: NONE,\n      user,\n      orgId,\n      subscribers: 0,\n      inflight: false,\n      timer: null,\n      closed: false,\n      listeners: new Set(),\n    }\n    entries.set(key, entry)\n  }\n  return entry\n}\n\n/**\n * Hands a job's latest state to every surface counting this workspace's jobs:\n * a new job joins the list, a settled one leaves it. Keyed on the job's own\n * workspace, for every person whose list holds that workspace in this tab.\n */\nexport function publishAiJob(job: AiJobSummary | null | undefined): void {\n  if (!job?.orgId) return\n  for (const entry of entries.values()) {\n    if (entry.orgId !== job.orgId || entry.closed) continue\n    const index = entry.jobs.findIndex((known) => known.id === job.id)\n    let next: AiJobSummary[]\n    if (isSettled(job)) {\n      if (index === -1) continue\n      next = entry.jobs.filter((known) => known.id !== job.id)\n    } else if (index === -1) {\n      next = [job, ...entry.jobs]\n    } else {\n      next = [...entry.jobs]\n      next[index] = job\n    }\n    entry.jobs = Object.freeze(next)\n    emit(entry)\n    // A list that just gained its first job starts its timer.\n    if (!entry.timer && !entry.inflight) schedule(entry)\n  }\n}\n\n/** Forget every list and request; specs start each case from nothing. */\nexport function resetAiJobsStoreForTests(): void {\n  for (const entry of entries.values()) {\n    if (entry.timer) clearTimeout(entry.timer)\n  }\n  entries.clear()\n  openListeners.clear()\n  openRequest = { seq: 0, jobId: null }\n}\n\n/**\n * The workspace's jobs that are not yet settled, newest first, for the\n * signed-in person — empty while the first read is in flight, where the\n * route refuses, and when `enabled` is false (a surface whose own gates have\n * not passed reads nothing at all).\n */\nexport function useAiJobsInFlight(\n  user: (TokenSource & { uid?: string | null }) | null | undefined,\n  orgId: string | null | undefined,\n  enabled = true,\n): readonly AiJobSummary[] {\n  const uid = user?.uid ?? null\n  const userRef = useRef<MaybeTokenSource>(user)\n  userRef.current = user\n  const entry = useMemo(\n    () => (enabled && uid && orgId ? entryFor(uid, orgId, userRef.current) : null),\n    [enabled, uid, orgId],\n  )\n\n  useEffect(() => {\n    if (!entry) return undefined\n    entry.user = userRef.current\n    entry.subscribers += 1\n    if (entry.subscribers === 1) void read(entry)\n    const onVisible = () => {\n      if (document.visibilityState === 'visible' && entry.jobs.length > 0) void read(entry)\n    }\n    document.addEventListener('visibilitychange', onVisible)\n    return () => {\n      document.removeEventListener('visibilitychange', onVisible)\n      entry.subscribers -= 1\n      if (entry.subscribers === 0 && entry.timer) {\n        clearTimeout(entry.timer)\n        entry.timer = null\n      }\n    }\n  }, [entry])\n\n  const subscribe = useMemo(\n    () => (listener: () => void) => {\n      if (!entry) return () => undefined\n      entry.listeners.add(listener)\n      return () => {\n        entry.listeners.delete(listener)\n      }\n    },\n    [entry],\n  )\n  const snapshot = (): readonly AiJobSummary[] => entry?.jobs ?? NONE\n  return useSyncExternalStore(subscribe, snapshot, snapshot)\n}\n\n/** What the indicator and the launcher show for the workspace, or `null` for nothing. */\nexport function useAiJobsActivity(\n  user: (TokenSource & { uid?: string | null }) | null | undefined,\n  orgId: string | null | undefined,\n  enabled = true,\n): AiJobsActivity<AiJobSummary> | null {\n  const jobs = useAiJobsInFlight(user, orgId, enabled)\n  return useMemo(() => aiJobsActivity(jobs), [jobs])\n}\n"],"names":["authorizedFetch","useEffect","useMemo","useRef","useSyncExternalStore","aiJobsActivity","AI_JOB_TERMINAL_STATUSES","openRequest","seq","jobId","openListeners","Set","openAiJobs","options","listener","subscribeOpen","add","delete","readOpen","useAiJobsOpenRequest","AI_JOB_LINK_PARAM","AI_JOBS_ACTIVE_POLL_MS","ACTIVE_LIMIT","NONE","Object","freeze","entries","Map","keyOf","uid","orgId","emit","entry","listeners","isSettled","job","includes","status","schedule","timer","clearTimeout","closed","subscribers","jobs","length","setTimeout","hidden","document","visibilityState","read","inflight","response","user","encodeURIComponent","ok","payload","json","catch","filter","entryFor","key","get","set","publishAiJob","values","index","findIndex","known","id","next","resetAiJobsStoreForTests","clear","useAiJobsInFlight","enabled","userRef","current","undefined","onVisible","addEventListener","removeEventListener","subscribe","snapshot","useAiJobsActivity"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SACEA,eAAe,QAGV,2CAA0C;AACjD,SAASC,SAAS,EAAEC,OAAO,EAAEC,MAAM,EAAEC,oBAAoB,QAAQ,QAAO;AACxE,SAASC,cAAc,QAA6B,8BAA0B;AAC9E,SAASC,wBAAwB,QAA2B,4BAAwB;AA6CpF,IAAIC,cAAiC;IAAEC,KAAK;IAAGC,OAAO;AAAK;AAC3D,MAAMC,gBAAgB,IAAIC;AAE1B;;;;CAIC,GACD,OAAO,SAASC,WAAWC,UAAqC,CAAC,CAAC;QACfA;IAAjDN,cAAc;QAAEC,KAAKD,YAAYC,GAAG,GAAG;QAAGC,KAAK,GAAEI,iBAAAA,QAAQJ,KAAK,YAAbI,iBAAiB;IAAK;IACvE,KAAK,MAAMC,YAAYJ,cAAeI;AACxC;AAEA,SAASC,cAAcD,QAAoB;IACzCJ,cAAcM,GAAG,CAACF;IAClB,OAAO;QACLJ,cAAcO,MAAM,CAACH;IACvB;AACF;AAEA,MAAMI,WAAW,IAAyBX;AAE1C,0EAA0E,GAC1E,OAAO,SAASY;IACd,OAAOf,qBAAqBW,eAAeG,UAAUA;AACvD;AAEA;;;;CAIC,GACD,SAASE,iBAAiB,QAAQ,4BAAwB;AAE1D,6EAA6E;AAE7E,mFAAmF,GACnF,OAAO,MAAMC,yBAAyB,MAAM;AAE5C,sEAAsE,GACtE,MAAMC,eAAe;AAErB,MAAMC,OAAgCC,OAAOC,MAAM,CAAC,EAAE;AAetD,MAAMC,UAAU,IAAIC;AAEpB,MAAMC,QAAQ,CAACC,KAAaC,QAA0B,GAAGD,IAAI,EAAE,EAAEC,OAAO;AAExE,SAASC,KAAKC,KAAY;IACxB,KAAK,MAAMlB,YAAYkB,MAAMC,SAAS,CAAEnB;AAC1C;AAEA,SAASoB,UAAUC,GAAiB;IAClC,OAAO7B,yBAAyB8B,QAAQ,CAACD,IAAIE,MAAM;AACrD;AAEA,SAASC,SAASN,KAAY;IAC5B,IAAIA,MAAMO,KAAK,EAAEC,aAAaR,MAAMO,KAAK;IACzCP,MAAMO,KAAK,GAAG;IACd,IAAIP,MAAMS,MAAM,IAAIT,MAAMU,WAAW,KAAK,KAAKV,MAAMW,IAAI,CAACC,MAAM,KAAK,GAAG;IACxEZ,MAAMO,KAAK,GAAGM,WAAW;QACvBb,MAAMO,KAAK,GAAG;QACd,MAAMO,SAAS,OAAOC,aAAa,eAAeA,SAASC,eAAe,KAAK;QAC/E,mEAAmE;QACnE,IAAIF,QAAQ;QACZ,KAAKG,KAAKjB;IACZ,GAAGX;AACL;AAEA,eAAe4B,KAAKjB,KAAY;IAC9B,IAAIA,MAAMkB,QAAQ,IAAIlB,MAAMS,MAAM,EAAE;IACpCT,MAAMkB,QAAQ,GAAG;IACjB,IAAI;;QACF,MAAMC,WAAW,MAAMnD,gBACrBgC,MAAMoB,IAAI,EACV,CAAC,mBAAmB,EAAEC,mBAAmBrB,MAAMF,KAAK,EAAE,qBAAqB,EAAER,cAAc;QAE7F,IAAI6B,SAASd,MAAM,KAAK,OAAOc,SAASd,MAAM,KAAK,KAAK;YACtD,sEAAsE;YACtE,gDAAgD;YAChDL,MAAMS,MAAM,GAAG;YACfT,MAAMW,IAAI,GAAGpB;YACbQ,KAAKC;YACL;QACF;QACA,IAAI,CAACmB,SAASG,EAAE,EAAE;QAClB,MAAMC,UAAW,MAAMJ,SAASK,IAAI,GAAGC,KAAK,CAAC,IAAM;QACnDzB,MAAMW,IAAI,GAAGnB,OAAOC,MAAM,CAAC,SAAC8B,2BAAAA,QAASZ,IAAI,mBAAI,EAAE,EAAEe,MAAM,CAAC,CAACvB,MAAQ,CAACD,UAAUC;QAC5EJ,KAAKC;IACP,EAAE,eAAM;IACN,2EAA2E;IAC7E,SAAU;QACRA,MAAMkB,QAAQ,GAAG;QACjBZ,SAASN;IACX;AACF;AAEA,SAAS2B,SAAS9B,GAAW,EAAEC,KAAa,EAAEsB,IAAsB;IAClE,MAAMQ,MAAMhC,MAAMC,KAAKC;IACvB,IAAIE,QAAQN,QAAQmC,GAAG,CAACD;IACxB,IAAI,CAAC5B,OAAO;QACVA,QAAQ;YACNW,MAAMpB;YACN6B;YACAtB;YACAY,aAAa;YACbQ,UAAU;YACVX,OAAO;YACPE,QAAQ;YACRR,WAAW,IAAItB;QACjB;QACAe,QAAQoC,GAAG,CAACF,KAAK5B;IACnB;IACA,OAAOA;AACT;AAEA;;;;CAIC,GACD,OAAO,SAAS+B,aAAa5B,GAAoC;IAC/D,IAAI,EAACA,uBAAAA,IAAKL,KAAK,GAAE;IACjB,KAAK,MAAME,SAASN,QAAQsC,MAAM,GAAI;QACpC,IAAIhC,MAAMF,KAAK,KAAKK,IAAIL,KAAK,IAAIE,MAAMS,MAAM,EAAE;QAC/C,MAAMwB,QAAQjC,MAAMW,IAAI,CAACuB,SAAS,CAAC,CAACC,QAAUA,MAAMC,EAAE,KAAKjC,IAAIiC,EAAE;QACjE,IAAIC;QACJ,IAAInC,UAAUC,MAAM;YAClB,IAAI8B,UAAU,CAAC,GAAG;YAClBI,OAAOrC,MAAMW,IAAI,CAACe,MAAM,CAAC,CAACS,QAAUA,MAAMC,EAAE,KAAKjC,IAAIiC,EAAE;QACzD,OAAO,IAAIH,UAAU,CAAC,GAAG;YACvBI,OAAO;gBAAClC;mBAAQH,MAAMW,IAAI;aAAC;QAC7B,OAAO;YACL0B,OAAO;mBAAIrC,MAAMW,IAAI;aAAC;YACtB0B,IAAI,CAACJ,MAAM,GAAG9B;QAChB;QACAH,MAAMW,IAAI,GAAGnB,OAAOC,MAAM,CAAC4C;QAC3BtC,KAAKC;QACL,0DAA0D;QAC1D,IAAI,CAACA,MAAMO,KAAK,IAAI,CAACP,MAAMkB,QAAQ,EAAEZ,SAASN;IAChD;AACF;AAEA,uEAAuE,GACvE,OAAO,SAASsC;IACd,KAAK,MAAMtC,SAASN,QAAQsC,MAAM,GAAI;QACpC,IAAIhC,MAAMO,KAAK,EAAEC,aAAaR,MAAMO,KAAK;IAC3C;IACAb,QAAQ6C,KAAK;IACb7D,cAAc6D,KAAK;IACnBhE,cAAc;QAAEC,KAAK;QAAGC,OAAO;IAAK;AACtC;AAEA;;;;;CAKC,GACD,OAAO,SAAS+D,kBACdpB,IAAgE,EAChEtB,KAAgC,EAChC2C,UAAU,IAAI;;IAEd,MAAM5C,cAAMuB,wBAAAA,KAAMvB,GAAG,mBAAI;IACzB,MAAM6C,UAAUvE,OAAyBiD;IACzCsB,QAAQC,OAAO,GAAGvB;IAClB,MAAMpB,QAAQ9B,QACZ,IAAOuE,WAAW5C,OAAOC,QAAQ6B,SAAS9B,KAAKC,OAAO4C,QAAQC,OAAO,IAAI,MACzE;QAACF;QAAS5C;QAAKC;KAAM;IAGvB7B,UAAU;QACR,IAAI,CAAC+B,OAAO,OAAO4C;QACnB5C,MAAMoB,IAAI,GAAGsB,QAAQC,OAAO;QAC5B3C,MAAMU,WAAW,IAAI;QACrB,IAAIV,MAAMU,WAAW,KAAK,GAAG,KAAKO,KAAKjB;QACvC,MAAM6C,YAAY;YAChB,IAAI9B,SAASC,eAAe,KAAK,aAAahB,MAAMW,IAAI,CAACC,MAAM,GAAG,GAAG,KAAKK,KAAKjB;QACjF;QACAe,SAAS+B,gBAAgB,CAAC,oBAAoBD;QAC9C,OAAO;YACL9B,SAASgC,mBAAmB,CAAC,oBAAoBF;YACjD7C,MAAMU,WAAW,IAAI;YACrB,IAAIV,MAAMU,WAAW,KAAK,KAAKV,MAAMO,KAAK,EAAE;gBAC1CC,aAAaR,MAAMO,KAAK;gBACxBP,MAAMO,KAAK,GAAG;YAChB;QACF;IACF,GAAG;QAACP;KAAM;IAEV,MAAMgD,YAAY9E,QAChB,IAAM,CAACY;YACL,IAAI,CAACkB,OAAO,OAAO,IAAM4C;YACzB5C,MAAMC,SAAS,CAACjB,GAAG,CAACF;YACpB,OAAO;gBACLkB,MAAMC,SAAS,CAAChB,MAAM,CAACH;YACzB;QACF,GACA;QAACkB;KAAM;IAET,MAAMiD,WAAW;;uBAA+BjD,yBAAAA,MAAOW,IAAI,mBAAIpB;;IAC/D,OAAOnB,qBAAqB4E,WAAWC,UAAUA;AACnD;AAEA,uFAAuF,GACvF,OAAO,SAASC,kBACd9B,IAAgE,EAChEtB,KAAgC,EAChC2C,UAAU,IAAI;IAEd,MAAM9B,OAAO6B,kBAAkBpB,MAAMtB,OAAO2C;IAC5C,OAAOvE,QAAQ,IAAMG,eAAesC,OAAO;QAACA;KAAK;AACnD"}

package/src/lib/components/ai-page-brief-dialog.component.d.ts

@@ -17,12 +17,12 @@
 import { type AiBriefDialogProps } from './ai-brief-dialog.component';
 /**
  * "Describe a page" (AGL-2907): the brief dialog both page entry points open,
- * the Screens page's "Describe it" and the Assist panel's AI jobs.
+ * the Screens page's "Create with AI" and the Assist panel's AI jobs.
  *
  * It is the shared brief dialog for a `page` job (AGL-3043): one text box and
- * an optional page type. The job plans first and waits in AI jobs, where the
- * member confirms the plan and opens the draft once it is built; nothing here
- * builds or writes anything.
+ * an optional page type. The job plans first; the dialog then follows it and
+ * offers its plan to confirm, as AI jobs does (AGL-3593). Nothing is built
+ * until the member confirms.
  */
 export type AiPageBriefDialogProps = Omit<AiBriefDialogProps, 'kind'>;
 export declare function AiPageBriefDialog(props: AiPageBriefDialogProps): import("react").JSX.Element;

package/src/lib/components/ai-page-brief-dialog.component.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-page-brief-dialog.component.tsx"],"sourcesContent":["'use client'\n\n/**\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 { AiBriefDialog, type AiBriefDialogProps } from './ai-brief-dialog.component'\n\n/**\n * \"Describe a page\" (AGL-2907): the brief dialog both page entry points open,\n * the Screens page's \"Describe it\" and the Assist panel's AI jobs.\n *\n * It is the shared brief dialog for a `page` job (AGL-3043): one text box and\n * an optional page type. The job plans first and waits in AI jobs, where the\n * member confirms the plan and opens the draft once it is built; nothing here\n * builds or writes anything.\n */\n\nexport type AiPageBriefDialogProps = Omit<AiBriefDialogProps, 'kind'>\n\nexport function AiPageBriefDialog(props: AiPageBriefDialogProps) {\n  return <AiBriefDialog {...props} kind=\"page\" />\n}\n\nexport default AiPageBriefDialog\n"],"names":["AiBriefDialog","AiPageBriefDialog","props","kind"],"mappings":"AAAA;;;AAEA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,QAAiC,iCAA6B;AAcpF,OAAO,SAASC,kBAAkBC,KAA6B;IAC7D,qBAAO,KAACF,4BAAkBE;QAAOC,MAAK;;AACxC;AAEA,eAAeF,kBAAiB"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-page-brief-dialog.component.tsx"],"sourcesContent":["'use client'\n\n/**\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 { AiBriefDialog, type AiBriefDialogProps } from './ai-brief-dialog.component'\n\n/**\n * \"Describe a page\" (AGL-2907): the brief dialog both page entry points open,\n * the Screens page's \"Create with AI\" and the Assist panel's AI jobs.\n *\n * It is the shared brief dialog for a `page` job (AGL-3043): one text box and\n * an optional page type. The job plans first; the dialog then follows it and\n * offers its plan to confirm, as AI jobs does (AGL-3593). Nothing is built\n * until the member confirms.\n */\n\nexport type AiPageBriefDialogProps = Omit<AiBriefDialogProps, 'kind'>\n\nexport function AiPageBriefDialog(props: AiPageBriefDialogProps) {\n  return <AiBriefDialog {...props} kind=\"page\" />\n}\n\nexport default AiPageBriefDialog\n"],"names":["AiBriefDialog","AiPageBriefDialog","props","kind"],"mappings":"AAAA;;;AAEA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,QAAiC,iCAA6B;AAcpF,OAAO,SAASC,kBAAkBC,KAA6B;IAC7D,qBAAO,KAACF,4BAAkBE;QAAOC,MAAK;;AACxC;AAEA,eAAeF,kBAAiB"}

package/src/lib/components/ai-site-build-page.component.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @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 { ConsolePluginPageProps } from '@aglyn/aglyn/plugin-manager/feature-plugins';
+import type { MaybeTokenSource } from '@aglyn/shared-util-http/authorized-token';
+import type { AiJobSummary } from '../model/ai-jobs.types';
+/**
+ * "Building your site" (AGL-3594): one job's page, at `/ai-jobs/{jobId}`
+ * under its site — where the guided start sends a person the moment they
+ * plan a site, and where a notification about that job opens.
+ *
+ * A guided site start confirms its own plan (`autoConfirm`), so there is no
+ * approval to make here: the page says what is happening, step by step, live
+ * from the job's events route; shows what is being built; and, when the job
+ * ends, leads with the next thing to do — the live site and the pages to
+ * edit, or, where it stopped, the plain sentence for why and what to do
+ * about it. It is linkable and survives a reload, because it reads the job by
+ * the id in its own address under the site's own route.
+ *
+ * Every wait ends (AGL-3596): a site that cannot be read, a job the route
+ * does not know, a route that fails, and a first state that never arrives
+ * each end on a sentence instead of a spinner.
+ *
+ * Mounted by `AiJobsPage`, the plugin's unlisted `/ai-jobs` route: no tab on
+ * the site's strip, an address under it.
+ */
+/** How long the job's first state may take before the page says it could not be loaded. */
+export declare const AI_JOB_FIRST_STATE_TIMEOUT_MS = 20000;
+/**
+ * One job, followed by id: its latest summary; `null` while the first state
+ * is out; `'missing'` when the route says there is no such job for this
+ * reader; `'error'` when the route failed or no state arrived in time.
+ */
+export type AiJobByIdState = AiJobSummary | 'missing' | 'error' | null;
+/** Follows one job by id. `retry` follows it again after a `'missing'` or `'error'`. */
+export declare function useAiJobById(user: MaybeTokenSource, orgId: string | null, jobId: string | null): [AiJobByIdState, (job: AiJobSummary) => void, () => void];
+export declare function AiSiteBuildPage({ hostId, segments, basePath }: ConsolePluginPageProps): import("react").JSX.Element;
+export default AiSiteBuildPage;