@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/components/use-ai-job-run.js

@@ -0,0 +1,176 @@
+'use client';
+/**
+ * @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 { lockdownRefusalText, parseLockdownRefusal } from "@aglyn/aglyn";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { AI_JOB_TERMINAL_STATUSES } from "../model/ai-jobs.types.js";
+import { readEventFrames } from "./assist-jobs-drawer.component.js";
+/**
+ * One answer per member and workspace, however many controls ask. The
+ * automation run history draws a control on every failed run, and each asking
+ * the route would be a request a row.
+ */ const verdicts = new Map();
+/** Forgets every answer, so the next control to mount asks the route again. */ export function forgetAiJobsVerdicts() {
+    verdicts.clear();
+}
+function askJobsRoute(user, uid, orgId) {
+    const key = `${uid}\n${orgId}`;
+    const known = verdicts.get(key);
+    if (known) return known;
+    const answer = authorizedFetch(user, `/api/ai/jobs?orgId=${encodeURIComponent(orgId)}&limit=1`)// The release flag off (404) and a plan or member without generation
+    // (403): the feature is not this workspace's, so the control is absent.
+    .then((response)=>response.status === 404 || response.status === 403 ? 'hidden' : 'ready').catch(()=>{
+        // A request that never arrived is no answer, so the next control asks again.
+        verdicts.delete(key);
+        return 'hidden';
+    });
+    verdicts.set(key, answer);
+    return answer;
+}
+/**
+ * Whether a control that starts a job should be drawn. The shell decided the
+ * plan and the member's permission before mounting it; the release flag is the
+ * route's to decide.
+ */ export function useAiJobsVerdict(user, orgId) {
+    var _ref;
+    // Held in a ref so the question keys on WHO is signed in, never on the
+    // identity of the object that says so.
+    const userRef = useRef(user);
+    userRef.current = user;
+    const uid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    const [verdict, setVerdict] = useState('checking');
+    useEffect(()=>{
+        if (!orgId || !uid) return;
+        let active = true;
+        setVerdict('checking');
+        void askJobsRoute(userRef.current, uid, orgId).then((answer)=>{
+            if (active) setVerdict(answer);
+        });
+        return ()=>{
+            active = false;
+        };
+    }, [
+        orgId,
+        uid
+    ]);
+    return verdict;
+}
+/** 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;
+}
+export function useAiJobRun(user, failed) {
+    const userRef = useRef(user);
+    userRef.current = user;
+    const [job, setJob] = useState(null);
+    const [starting, setStarting] = useState(false);
+    const [notice, setNotice] = useState(null);
+    const watchRef = useRef(null);
+    useEffect(()=>()=>{
+            var _watchRef_current;
+            return (_watchRef_current = watchRef.current) == null ? void 0 : _watchRef_current.abort();
+        }, []);
+    /** Follows a job through the events route until it settles or the control goes. */ const watch = useCallback(async (jobId, orgId)=>{
+        var _watchRef_current;
+        (_watchRef_current = watchRef.current) == null ? void 0 : _watchRef_current.abort();
+        const controller = new AbortController();
+        watchRef.current = controller;
+        let again = true;
+        while(again && !controller.signal.aborted){
+            again = false;
+            try {
+                const response = await authorizedFetch(userRef.current, `/api/ai/jobs/${encodeURIComponent(jobId)}/events?orgId=${encodeURIComponent(orgId)}`, {
+                    signal: controller.signal
+                });
+                if (!response.ok || !response.body) return;
+                await readEventFrames(response.body, (event)=>{
+                    if (controller.signal.aborted) return;
+                    if (event['type'] === 'state') setJob(event['job']);
+                    else if (event['type'] === 'reconnect') again = true;
+                });
+            } catch (unused) {
+                return;
+            }
+        }
+    }, []);
+    const start = useCallback(async (request)=>{
+        var _watchRef_current;
+        (_watchRef_current = watchRef.current) == null ? void 0 : _watchRef_current.abort();
+        setStarting(true);
+        setNotice(null);
+        setJob(null);
+        let next;
+        try {
+            const response = await authorizedFetch(userRef.current, '/api/ai/jobs', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(request)
+            });
+            const payload = await response.json().catch(()=>null);
+            if (!response.ok) {
+                var _ref;
+                const locked = parseLockdownRefusal(response.status, payload);
+                setNotice(locked ? lockdownRefusalText(locked) : String((_ref = payload == null ? void 0 : payload.error) != null ? _ref : failed));
+                return false;
+            }
+            next = payload == null ? void 0 : payload.job;
+            if (!next) {
+                setNotice(failed);
+                return false;
+            }
+            setJob(next);
+        } catch (unused) {
+            setNotice(failed);
+            return false;
+        } finally{
+            setStarting(false);
+        }
+        if (!aiJobSettled(next)) void watch(next.id, request.orgId);
+        return true;
+    }, [
+        failed,
+        watch
+    ]);
+    const reset = useCallback(()=>{
+        var _watchRef_current;
+        (_watchRef_current = watchRef.current) == null ? void 0 : _watchRef_current.abort();
+        setJob(null);
+        setNotice(null);
+    }, []);
+    return {
+        job,
+        starting,
+        running: Boolean(job && !aiJobSettled(job)),
+        notice,
+        start,
+        reset
+    };
+}
+
+//# sourceMappingURL=use-ai-job-run.js.map

package/src/lib/components/use-ai-job-run.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/use-ai-job-run.ts"],"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 { lockdownRefusalText, parseLockdownRefusal } from '@aglyn/aglyn'\nimport {\n  authorizedFetch,\n  type MaybeTokenSource,\n  type TokenSource,\n} from '@aglyn/shared-util-http/authorized-token'\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport {\n  AI_JOB_TERMINAL_STATUSES,\n  type AiJobKind,\n  type AiJobSummary,\n} from '../model/ai-jobs.types'\nimport { readEventFrames } from './assist-jobs-drawer.component'\n\n/**\n * Starting one AI job from a console control, and following it until it\n * settles (AGL-2919): the jobs route's create door, then its events door, the\n * way the SEO card follows its jobs. A control that starts a job the beat\n * runs shows its progress here and its result when it arrives; closing the\n * control stops following, and the job carries on in AI jobs.\n */\n\n/** Whether the jobs route serves a workspace: still asking, yes, or no. */\nexport type AiJobsVerdict = 'checking' | 'ready' | 'hidden'\n\n/**\n * One answer per member and workspace, however many controls ask. The\n * automation run history draws a control on every failed run, and each asking\n * the route would be a request a row.\n */\nconst verdicts = new Map<string, Promise<Exclude<AiJobsVerdict, 'checking'>>>()\n\n/** Forgets every answer, so the next control to mount asks the route again. */\nexport function forgetAiJobsVerdicts(): void {\n  verdicts.clear()\n}\n\nfunction askJobsRoute(\n  user: MaybeTokenSource,\n  uid: string,\n  orgId: string,\n): Promise<Exclude<AiJobsVerdict, 'checking'>> {\n  const key = `${uid}\\n${orgId}`\n  const known = verdicts.get(key)\n  if (known) return known\n  const answer = authorizedFetch(user, `/api/ai/jobs?orgId=${encodeURIComponent(orgId)}&limit=1`)\n    // The release flag off (404) and a plan or member without generation\n    // (403): the feature is not this workspace's, so the control is absent.\n    .then((response): Exclude<AiJobsVerdict, 'checking'> =>\n      response.status === 404 || response.status === 403 ? 'hidden' : 'ready',\n    )\n    .catch((): Exclude<AiJobsVerdict, 'checking'> => {\n      // A request that never arrived is no answer, so the next control asks again.\n      verdicts.delete(key)\n      return 'hidden'\n    })\n  verdicts.set(key, answer)\n  return answer\n}\n\n/**\n * Whether a control that starts a job should be drawn. The shell decided the\n * plan and the member's permission before mounting it; the release flag is the\n * route's to decide.\n */\nexport function useAiJobsVerdict(\n  user: (TokenSource & { uid?: string | null }) | null | undefined,\n  orgId: string | undefined,\n): AiJobsVerdict {\n  // Held in a ref so the question keys on WHO is signed in, never on the\n  // identity of the object that says so.\n  const userRef = useRef(user)\n  userRef.current = user\n  const uid = user?.uid ?? null\n  const [verdict, setVerdict] = useState<AiJobsVerdict>('checking')\n\n  useEffect(() => {\n    if (!orgId || !uid) return\n    let active = true\n    setVerdict('checking')\n    void askJobsRoute(userRef.current, uid, orgId).then((answer) => {\n      if (active) setVerdict(answer)\n    })\n    return () => {\n      active = false\n    }\n  }, [orgId, uid])\n\n  return verdict\n}\n\n/** What a control asks the create door for. */\nexport interface AiJobRequest {\n  orgId: string\n  hostId: string\n  kind: AiJobKind\n  brief: string\n  inputs: Record<string, string>\n}\n\n/** Whether a job has stopped moving: finished, or waiting on something only a person can change. */\nexport function aiJobSettled(job: AiJobSummary | null): boolean {\n  if (!job) return false\n  return (\n    AI_JOB_TERMINAL_STATUSES.includes(job.status) ||\n    job.status === 'needs_input' ||\n    job.status === 'needs_review'\n  )\n}\n\n/**\n * Why a settled job has no result to show, in words a person can act on, or\n * `null` for a job that finished.\n */\nexport function aiJobProblem(job: AiJobSummary | null, failed: string): string | null {\n  if (!job || !aiJobSettled(job) || job.status === 'done') return null\n  if (job.status === 'canceled') return 'The job was canceled.'\n  if (job.status === 'needs_review') return job.review?.message || job.error || failed\n  return job.error || failed\n}\n\nexport interface AiJobRun {\n  /** The job as it last arrived; `null` before one is started. */\n  job: AiJobSummary | null\n  /** The create door is being asked. */\n  starting: boolean\n  /** The job exists and has not settled. */\n  running: boolean\n  /** Why the create door refused, or could not be reached. */\n  notice: string | null\n  /** Starts the job, `true` once it exists, and follows it from there; `false` when the door refused. */\n  start: (request: AiJobRequest) => Promise<boolean>\n  /** Stops following and forgets the job, for a control asked again. */\n  reset: () => void\n}\n\nexport function useAiJobRun(user: MaybeTokenSource, failed: string): AiJobRun {\n  const userRef = useRef(user)\n  userRef.current = user\n  const [job, setJob] = useState<AiJobSummary | null>(null)\n  const [starting, setStarting] = useState(false)\n  const [notice, setNotice] = useState<string | null>(null)\n  const watchRef = useRef<AbortController | null>(null)\n\n  useEffect(() => () => watchRef.current?.abort(), [])\n\n  /** Follows a job through the events route until it settles or the control goes. */\n  const watch = useCallback(async (jobId: string, orgId: string) => {\n    watchRef.current?.abort()\n    const controller = new AbortController()\n    watchRef.current = controller\n    let again = true\n    while (again && !controller.signal.aborted) {\n      again = false\n      try {\n        const response = await authorizedFetch(\n          userRef.current,\n          `/api/ai/jobs/${encodeURIComponent(jobId)}/events?orgId=${encodeURIComponent(orgId)}`,\n          { signal: controller.signal },\n        )\n        if (!response.ok || !response.body) return\n        await readEventFrames(response.body, (event) => {\n          if (controller.signal.aborted) return\n          if (event['type'] === 'state') setJob(event['job'] as AiJobSummary)\n          else if (event['type'] === 'reconnect') again = true\n        })\n      } catch {\n        return\n      }\n    }\n  }, [])\n\n  const start = useCallback(\n    async (request: AiJobRequest) => {\n      watchRef.current?.abort()\n      setStarting(true)\n      setNotice(null)\n      setJob(null)\n      let next: AiJobSummary | undefined\n      try {\n        const response = await authorizedFetch(userRef.current, '/api/ai/jobs', {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify(request),\n        })\n        const payload = await response.json().catch(() => null)\n        if (!response.ok) {\n          const locked = parseLockdownRefusal(response.status, payload)\n          setNotice(locked ? lockdownRefusalText(locked) : String(payload?.error ?? failed))\n          return false\n        }\n        next = payload?.job as AiJobSummary | undefined\n        if (!next) {\n          setNotice(failed)\n          return false\n        }\n        setJob(next)\n      } catch {\n        setNotice(failed)\n        return false\n      } finally {\n        setStarting(false)\n      }\n      if (!aiJobSettled(next)) void watch(next.id, request.orgId)\n      return true\n    },\n    [failed, watch],\n  )\n\n  const reset = useCallback(() => {\n    watchRef.current?.abort()\n    setJob(null)\n    setNotice(null)\n  }, [])\n\n  return { job, starting, running: Boolean(job && !aiJobSettled(job)), notice, start, reset }\n}\n"],"names":["lockdownRefusalText","parseLockdownRefusal","authorizedFetch","useCallback","useEffect","useRef","useState","AI_JOB_TERMINAL_STATUSES","readEventFrames","verdicts","Map","forgetAiJobsVerdicts","clear","askJobsRoute","user","uid","orgId","key","known","get","answer","encodeURIComponent","then","response","status","catch","delete","set","useAiJobsVerdict","userRef","current","verdict","setVerdict","active","aiJobSettled","job","includes","aiJobProblem","failed","review","message","error","useAiJobRun","setJob","starting","setStarting","notice","setNotice","watchRef","abort","watch","jobId","controller","AbortController","again","signal","aborted","ok","body","event","start","request","next","method","headers","JSON","stringify","payload","json","locked","String","id","reset","running","Boolean"],"mappings":"AAAA;AAEA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,mBAAmB,EAAEC,oBAAoB,QAAQ,eAAc;AACxE,SACEC,eAAe,QAGV,2CAA0C;AACjD,SAASC,WAAW,EAAEC,SAAS,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,QAAO;AAChE,SACEC,wBAAwB,QAGnB,4BAAwB;AAC/B,SAASC,eAAe,QAAQ,oCAAgC;AAahE;;;;CAIC,GACD,MAAMC,WAAW,IAAIC;AAErB,6EAA6E,GAC7E,OAAO,SAASC;IACdF,SAASG,KAAK;AAChB;AAEA,SAASC,aACPC,IAAsB,EACtBC,GAAW,EACXC,KAAa;IAEb,MAAMC,MAAM,GAAGF,IAAI,EAAE,EAAEC,OAAO;IAC9B,MAAME,QAAQT,SAASU,GAAG,CAACF;IAC3B,IAAIC,OAAO,OAAOA;IAClB,MAAME,SAASlB,gBAAgBY,MAAM,CAAC,mBAAmB,EAAEO,mBAAmBL,OAAO,QAAQ,CAAC,CAC5F,qEAAqE;IACrE,wEAAwE;KACvEM,IAAI,CAAC,CAACC,WACLA,SAASC,MAAM,KAAK,OAAOD,SAASC,MAAM,KAAK,MAAM,WAAW,SAEjEC,KAAK,CAAC;QACL,6EAA6E;QAC7EhB,SAASiB,MAAM,CAACT;QAChB,OAAO;IACT;IACFR,SAASkB,GAAG,CAACV,KAAKG;IAClB,OAAOA;AACT;AAEA;;;;CAIC,GACD,OAAO,SAASQ,iBACdd,IAAgE,EAChEE,KAAyB;;IAEzB,uEAAuE;IACvE,uCAAuC;IACvC,MAAMa,UAAUxB,OAAOS;IACvBe,QAAQC,OAAO,GAAGhB;IAClB,MAAMC,cAAMD,wBAAAA,KAAMC,GAAG,mBAAI;IACzB,MAAM,CAACgB,SAASC,WAAW,GAAG1B,SAAwB;IAEtDF,UAAU;QACR,IAAI,CAACY,SAAS,CAACD,KAAK;QACpB,IAAIkB,SAAS;QACbD,WAAW;QACX,KAAKnB,aAAagB,QAAQC,OAAO,EAAEf,KAAKC,OAAOM,IAAI,CAAC,CAACF;YACnD,IAAIa,QAAQD,WAAWZ;QACzB;QACA,OAAO;YACLa,SAAS;QACX;IACF,GAAG;QAACjB;QAAOD;KAAI;IAEf,OAAOgB;AACT;AAWA,kGAAkG,GAClG,OAAO,SAASG,aAAaC,GAAwB;IACnD,IAAI,CAACA,KAAK,OAAO;IACjB,OACE5B,yBAAyB6B,QAAQ,CAACD,IAAIX,MAAM,KAC5CW,IAAIX,MAAM,KAAK,iBACfW,IAAIX,MAAM,KAAK;AAEnB;AAEA;;;CAGC,GACD,OAAO,SAASa,aAAaF,GAAwB,EAAEG,MAAc;QAGzBH;IAF1C,IAAI,CAACA,OAAO,CAACD,aAAaC,QAAQA,IAAIX,MAAM,KAAK,QAAQ,OAAO;IAChE,IAAIW,IAAIX,MAAM,KAAK,YAAY,OAAO;IACtC,IAAIW,IAAIX,MAAM,KAAK,gBAAgB,OAAOW,EAAAA,cAAAA,IAAII,MAAM,qBAAVJ,YAAYK,OAAO,KAAIL,IAAIM,KAAK,IAAIH;IAC9E,OAAOH,IAAIM,KAAK,IAAIH;AACtB;AAiBA,OAAO,SAASI,YAAY5B,IAAsB,EAAEwB,MAAc;IAChE,MAAMT,UAAUxB,OAAOS;IACvBe,QAAQC,OAAO,GAAGhB;IAClB,MAAM,CAACqB,KAAKQ,OAAO,GAAGrC,SAA8B;IACpD,MAAM,CAACsC,UAAUC,YAAY,GAAGvC,SAAS;IACzC,MAAM,CAACwC,QAAQC,UAAU,GAAGzC,SAAwB;IACpD,MAAM0C,WAAW3C,OAA+B;IAEhDD,UAAU,IAAM;gBAAM4C;oBAAAA,oBAAAA,SAASlB,OAAO,qBAAhBkB,kBAAkBC,KAAK;WAAI,EAAE;IAEnD,iFAAiF,GACjF,MAAMC,QAAQ/C,YAAY,OAAOgD,OAAenC;YAC9CgC;SAAAA,oBAAAA,SAASlB,OAAO,qBAAhBkB,kBAAkBC,KAAK;QACvB,MAAMG,aAAa,IAAIC;QACvBL,SAASlB,OAAO,GAAGsB;QACnB,IAAIE,QAAQ;QACZ,MAAOA,SAAS,CAACF,WAAWG,MAAM,CAACC,OAAO,CAAE;YAC1CF,QAAQ;YACR,IAAI;gBACF,MAAM/B,WAAW,MAAMrB,gBACrB2B,QAAQC,OAAO,EACf,CAAC,aAAa,EAAET,mBAAmB8B,OAAO,cAAc,EAAE9B,mBAAmBL,QAAQ,EACrF;oBAAEuC,QAAQH,WAAWG,MAAM;gBAAC;gBAE9B,IAAI,CAAChC,SAASkC,EAAE,IAAI,CAAClC,SAASmC,IAAI,EAAE;gBACpC,MAAMlD,gBAAgBe,SAASmC,IAAI,EAAE,CAACC;oBACpC,IAAIP,WAAWG,MAAM,CAACC,OAAO,EAAE;oBAC/B,IAAIG,KAAK,CAAC,OAAO,KAAK,SAAShB,OAAOgB,KAAK,CAAC,MAAM;yBAC7C,IAAIA,KAAK,CAAC,OAAO,KAAK,aAAaL,QAAQ;gBAClD;YACF,EAAE,eAAM;gBACN;YACF;QACF;IACF,GAAG,EAAE;IAEL,MAAMM,QAAQzD,YACZ,OAAO0D;YACLb;SAAAA,oBAAAA,SAASlB,OAAO,qBAAhBkB,kBAAkBC,KAAK;QACvBJ,YAAY;QACZE,UAAU;QACVJ,OAAO;QACP,IAAImB;QACJ,IAAI;YACF,MAAMvC,WAAW,MAAMrB,gBAAgB2B,QAAQC,OAAO,EAAE,gBAAgB;gBACtEiC,QAAQ;gBACRC,SAAS;oBAAE,gBAAgB;gBAAmB;gBAC9CN,MAAMO,KAAKC,SAAS,CAACL;YACvB;YACA,MAAMM,UAAU,MAAM5C,SAAS6C,IAAI,GAAG3C,KAAK,CAAC,IAAM;YAClD,IAAI,CAACF,SAASkC,EAAE,EAAE;;gBAChB,MAAMY,SAASpE,qBAAqBsB,SAASC,MAAM,EAAE2C;gBACrDpB,UAAUsB,SAASrE,oBAAoBqE,UAAUC,eAAOH,2BAAAA,QAAS1B,KAAK,mBAAIH;gBAC1E,OAAO;YACT;YACAwB,OAAOK,2BAAAA,QAAShC,GAAG;YACnB,IAAI,CAAC2B,MAAM;gBACTf,UAAUT;gBACV,OAAO;YACT;YACAK,OAAOmB;QACT,EAAE,eAAM;YACNf,UAAUT;YACV,OAAO;QACT,SAAU;YACRO,YAAY;QACd;QACA,IAAI,CAACX,aAAa4B,OAAO,KAAKZ,MAAMY,KAAKS,EAAE,EAAEV,QAAQ7C,KAAK;QAC1D,OAAO;IACT,GACA;QAACsB;QAAQY;KAAM;IAGjB,MAAMsB,QAAQrE,YAAY;YACxB6C;SAAAA,oBAAAA,SAASlB,OAAO,qBAAhBkB,kBAAkBC,KAAK;QACvBN,OAAO;QACPI,UAAU;IACZ,GAAG,EAAE;IAEL,OAAO;QAAEZ;QAAKS;QAAU6B,SAASC,QAAQvC,OAAO,CAACD,aAAaC;QAAOW;QAAQc;QAAOY;IAAM;AAC5F"}

package/src/lib/components/use-ai-model-choice.d.ts

@@ -0,0 +1,47 @@
+import type { AiStepKind } from '../providers/catalog';
+import type { AiModelOption } from '../providers/model-choice';
+/**
+ * THE MODEL SWITCH'S STATE (AGL-2942): the reader's pick for one surface,
+ * remembered per person per workspace per surface, and the options the
+ * server lists for it — fetched when the switch is OPENED, never on mount,
+ * because the panel mounts on every console page.
+ *
+ * `null` is Auto. A remembered pick the server no longer lists — the plan
+ * changed, a manager narrowed an allowlist — falls back to Auto the moment
+ * the options arrive, and a door would have run the request on Auto anyway:
+ * the server decides again inside each request, so the remembered value is
+ * a preference, never a grant.
+ */
+/** Where a pick is remembered: the chat, the copy rewrite, a section, a job. */
+export type AiModelSurface = 'assist' | 'copy' | 'section' | 'jobs';
+export interface AiModelOptionsWire {
+    kind: AiStepKind;
+    auto: (AiModelOption & {
+        model: string;
+    }) | null;
+    options: AiModelOption[];
+    measured: boolean;
+}
+export type AiModelOptionsStatus = 'idle' | 'loading' | 'ready' | 'refused' | 'error';
+/** Forget every read; specs start each case from nothing. */
+export declare function resetAiModelOptionReadsForTests(): void;
+export interface AiModelChoiceState {
+    /** The pick to send, or `null` for Auto. */
+    model: string | null;
+    /** The pick's label as last listed, for the button before options load. */
+    label: string;
+    options: AiModelOptionsWire | null;
+    status: AiModelOptionsStatus;
+    /** Read the options — the switch calls this when it opens. */
+    load: () => void;
+    select: (option: {
+        id: string;
+        label: string;
+    } | null) => void;
+}
+export declare function useAiModelChoice(input: {
+    orgId?: string | null;
+    hostId?: string | null;
+    surface: AiModelSurface;
+    kind: AiStepKind;
+}): AiModelChoiceState;

package/src/lib/components/use-ai-model-choice.js

@@ -0,0 +1,150 @@
+/**
+ * @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 { useUser } from "@aglyn/tenant-feature-instance";
+import { useCallback, useEffect, useRef, useState } from "react";
+const storageKey = (uid, orgId, surface)=>`aglyn-ai-model:${uid}:${orgId}:${surface}`;
+function readRemembered(uid, orgId, surface) {
+    try {
+        var _globalThis_localStorage;
+        const raw = (_globalThis_localStorage = globalThis.localStorage) == null ? void 0 : _globalThis_localStorage.getItem(storageKey(uid, orgId, surface));
+        const parsed = raw ? JSON.parse(raw) : null;
+        return parsed && typeof parsed.id === 'string' && typeof parsed.label === 'string' ? {
+            id: parsed.id,
+            label: parsed.label
+        } : null;
+    } catch (unused) {
+        return null;
+    }
+}
+function writeRemembered(uid, orgId, surface, value) {
+    try {
+        var _globalThis_localStorage, _globalThis_localStorage1;
+        const key = storageKey(uid, orgId, surface);
+        if (value) (_globalThis_localStorage = globalThis.localStorage) == null ? void 0 : _globalThis_localStorage.setItem(key, JSON.stringify(value));
+        else (_globalThis_localStorage1 = globalThis.localStorage) == null ? void 0 : _globalThis_localStorage1.removeItem(key);
+    } catch (unused) {
+    // A pick that cannot be remembered still applies to this page.
+    }
+}
+/** One options read per reader, workspace, site and kind, shared by every mount. */ const optionReads = new Map();
+/** Forget every read; specs start each case from nothing. */ export function resetAiModelOptionReadsForTests() {
+    optionReads.clear();
+}
+export function useAiModelChoice(input) {
+    var _input_hostId, _ref, _ref1, _ref2;
+    const { orgId, surface, kind } = input;
+    const hostId = (_input_hostId = input.hostId) != null ? _input_hostId : '';
+    const { data: user } = useUser();
+    const uid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    const userRef = useRef(user);
+    userRef.current = user;
+    const [remembered, setRemembered] = useState(null);
+    const [options, setOptions] = useState(null);
+    const [status, setStatus] = useState('idle');
+    useEffect(()=>{
+        setRemembered(uid && orgId ? readRemembered(uid, orgId, surface) : null);
+        setOptions(null);
+        setStatus('idle');
+    }, [
+        uid,
+        orgId,
+        surface
+    ]);
+    const select = useCallback((option)=>{
+        const value = option ? {
+            id: option.id,
+            label: option.label
+        } : null;
+        setRemembered(value);
+        if (uid && orgId) writeRemembered(uid, orgId, surface, value);
+    }, [
+        uid,
+        orgId,
+        surface
+    ]);
+    const load = useCallback(()=>{
+        const signedIn = userRef.current;
+        if (!uid || !orgId || !signedIn) return;
+        const key = [
+            uid,
+            orgId,
+            hostId,
+            kind
+        ].join('\x00');
+        let read = optionReads.get(key);
+        if (!read) {
+            const params = new URLSearchParams({
+                orgId,
+                kind
+            });
+            if (hostId) params.set('hostId', hostId);
+            read = authorizedFetch(signedIn, `/api/ai/models?${params.toString()}`).then(async (response)=>{
+                if (response.status === 403) return {
+                    status: 'refused',
+                    data: null
+                };
+                const payload = await response.json().catch(()=>null);
+                return response.ok && payload ? {
+                    status: 'ready',
+                    data: payload
+                } : {
+                    status: 'error',
+                    data: null
+                };
+            }).catch(()=>({
+                    status: 'error',
+                    data: null
+                }));
+            optionReads.set(key, read);
+            // A failed read is not cached: the next open asks again.
+            void read.then((result)=>{
+                if (result.status === 'error') optionReads.delete(key);
+            });
+        }
+        setStatus((current)=>current === 'ready' ? current : 'loading');
+        void read.then((result)=>{
+            setStatus(result.status);
+            setOptions(result.data);
+        });
+    }, [
+        uid,
+        orgId,
+        hostId,
+        kind
+    ]);
+    // A remembered pick the server no longer lists is Auto again.
+    useEffect(()=>{
+        if (status !== 'ready' || !options || !remembered) return;
+        if (!options.options.some((option)=>option.id === remembered.id)) select(null);
+    }, [
+        status,
+        options,
+        remembered,
+        select
+    ]);
+    return {
+        model: (_ref1 = remembered == null ? void 0 : remembered.id) != null ? _ref1 : null,
+        label: (_ref2 = remembered == null ? void 0 : remembered.label) != null ? _ref2 : 'Auto',
+        options,
+        status,
+        load,
+        select
+    };
+}
+
+//# sourceMappingURL=use-ai-model-choice.js.map

package/src/lib/components/use-ai-model-choice.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/use-ai-model-choice.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 { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport type { AiStepKind } from '../providers/catalog'\nimport type { AiModelOption } from '../providers/model-choice'\n\n/**\n * THE MODEL SWITCH'S STATE (AGL-2942): the reader's pick for one surface,\n * remembered per person per workspace per surface, and the options the\n * server lists for it — fetched when the switch is OPENED, never on mount,\n * because the panel mounts on every console page.\n *\n * `null` is Auto. A remembered pick the server no longer lists — the plan\n * changed, a manager narrowed an allowlist — falls back to Auto the moment\n * the options arrive, and a door would have run the request on Auto anyway:\n * the server decides again inside each request, so the remembered value is\n * a preference, never a grant.\n */\n\n/** Where a pick is remembered: the chat, the copy rewrite, a section, a job. */\nexport type AiModelSurface = 'assist' | 'copy' | 'section' | 'jobs'\n\nexport interface AiModelOptionsWire {\n  kind: AiStepKind\n  auto: (AiModelOption & { model: string }) | null\n  options: AiModelOption[]\n  measured: boolean\n}\n\nexport type AiModelOptionsStatus = 'idle' | 'loading' | 'ready' | 'refused' | 'error'\n\ninterface Remembered {\n  id: string\n  label: string\n}\n\nconst storageKey = (uid: string, orgId: string, surface: AiModelSurface) =>\n  `aglyn-ai-model:${uid}:${orgId}:${surface}`\n\nfunction readRemembered(uid: string, orgId: string, surface: AiModelSurface): Remembered | null {\n  try {\n    const raw = globalThis.localStorage?.getItem(storageKey(uid, orgId, surface))\n    const parsed = raw ? (JSON.parse(raw) as Partial<Remembered>) : null\n    return parsed && typeof parsed.id === 'string' && typeof parsed.label === 'string'\n      ? { id: parsed.id, label: parsed.label }\n      : null\n  } catch {\n    return null\n  }\n}\n\nfunction writeRemembered(\n  uid: string,\n  orgId: string,\n  surface: AiModelSurface,\n  value: Remembered | null,\n): void {\n  try {\n    const key = storageKey(uid, orgId, surface)\n    if (value) globalThis.localStorage?.setItem(key, JSON.stringify(value))\n    else globalThis.localStorage?.removeItem(key)\n  } catch {\n    // A pick that cannot be remembered still applies to this page.\n  }\n}\n\n/** One options read per reader, workspace, site and kind, shared by every mount. */\nconst optionReads = new Map<string, Promise<{ status: AiModelOptionsStatus; data: AiModelOptionsWire | null }>>()\n\n/** Forget every read; specs start each case from nothing. */\nexport function resetAiModelOptionReadsForTests(): void {\n  optionReads.clear()\n}\n\nexport interface AiModelChoiceState {\n  /** The pick to send, or `null` for Auto. */\n  model: string | null\n  /** The pick's label as last listed, for the button before options load. */\n  label: string\n  options: AiModelOptionsWire | null\n  status: AiModelOptionsStatus\n  /** Read the options — the switch calls this when it opens. */\n  load: () => void\n  select: (option: { id: string; label: string } | null) => void\n}\n\nexport function useAiModelChoice(input: {\n  orgId?: string | null\n  hostId?: string | null\n  surface: AiModelSurface\n  kind: AiStepKind\n}): AiModelChoiceState {\n  const { orgId, surface, kind } = input\n  const hostId = input.hostId ?? ''\n  const { data: user } = useUser()\n  const uid = user?.uid ?? null\n  const userRef = useRef(user)\n  userRef.current = user\n  const [remembered, setRemembered] = useState<Remembered | null>(null)\n  const [options, setOptions] = useState<AiModelOptionsWire | null>(null)\n  const [status, setStatus] = useState<AiModelOptionsStatus>('idle')\n\n  useEffect(() => {\n    setRemembered(uid && orgId ? readRemembered(uid, orgId, surface) : null)\n    setOptions(null)\n    setStatus('idle')\n  }, [uid, orgId, surface])\n\n  const select = useCallback(\n    (option: { id: string; label: string } | null) => {\n      const value = option ? { id: option.id, label: option.label } : null\n      setRemembered(value)\n      if (uid && orgId) writeRemembered(uid, orgId, surface, value)\n    },\n    [uid, orgId, surface],\n  )\n\n  const load = useCallback(() => {\n    const signedIn = userRef.current\n    if (!uid || !orgId || !signedIn) return\n    const key = [uid, orgId, hostId, kind].join('\\x00')\n    let read = optionReads.get(key)\n    if (!read) {\n      const params = new URLSearchParams({ orgId, kind })\n      if (hostId) params.set('hostId', hostId)\n      read = authorizedFetch(signedIn, `/api/ai/models?${params.toString()}`)\n        .then(async (response) => {\n          if (response.status === 403) return { status: 'refused' as const, data: null }\n          const payload = (await response.json().catch(() => null)) as AiModelOptionsWire | null\n          return response.ok && payload\n            ? { status: 'ready' as const, data: payload }\n            : { status: 'error' as const, data: null }\n        })\n        .catch(() => ({ status: 'error' as const, data: null }))\n      optionReads.set(key, read)\n      // A failed read is not cached: the next open asks again.\n      void read.then((result) => {\n        if (result.status === 'error') optionReads.delete(key)\n      })\n    }\n    setStatus((current) => (current === 'ready' ? current : 'loading'))\n    void read.then((result) => {\n      setStatus(result.status)\n      setOptions(result.data)\n    })\n  }, [uid, orgId, hostId, kind])\n\n  // A remembered pick the server no longer lists is Auto again.\n  useEffect(() => {\n    if (status !== 'ready' || !options || !remembered) return\n    if (!options.options.some((option) => option.id === remembered.id)) select(null)\n  }, [status, options, remembered, select])\n\n  return {\n    model: remembered?.id ?? null,\n    label: remembered?.label ?? 'Auto',\n    options,\n    status,\n    load,\n    select,\n  }\n}\n"],"names":["authorizedFetch","useUser","useCallback","useEffect","useRef","useState","storageKey","uid","orgId","surface","readRemembered","globalThis","raw","localStorage","getItem","parsed","JSON","parse","id","label","writeRemembered","value","key","setItem","stringify","removeItem","optionReads","Map","resetAiModelOptionReadsForTests","clear","useAiModelChoice","input","kind","hostId","data","user","userRef","current","remembered","setRemembered","options","setOptions","status","setStatus","select","option","load","signedIn","join","read","get","params","URLSearchParams","set","toString","then","response","payload","json","catch","ok","result","delete","some","model"],"mappings":"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"}

package/src/lib/components/use-ai-products-jobs.d.ts

@@ -0,0 +1,36 @@
+import { type AiJobSummary } from '../model/ai-jobs.types';
+/**
+ * The jobs route, as a commerce card asks it (AGL-2916): whether the feature
+ * is this workspace's at all, the site's recent `products` jobs, starting one,
+ * and following each until it settles.
+ *
+ * The shell has already decided the plan and the member's permission before a
+ * card mounts; the release flag is the route's, so a 404 or 403 from the list
+ * is the card staying absent. A card follows more than one job at a time — a
+ * bulk copy job and a catalog, say — so each job has its own watch: every job
+ * it starts, and of the jobs it finds already moving, the ones `follows`
+ * names as its own.
+ */
+/** How many recent jobs a card reads to find this site's products jobs. */
+export declare const AI_PRODUCTS_RECENT_JOBS_READ = 20;
+export type AiProductsJobsVerdict = 'checking' | 'ready' | 'hidden';
+export interface AiProductsJobs {
+    /** The org the jobs are metered against: the zone's, or the site's. */
+    orgId: string | undefined;
+    verdict: AiProductsJobsVerdict;
+    /** The site's recent `products` jobs, newest first, kept current while followed. */
+    jobs: AiJobSummary[];
+    notice: string | null;
+    setNotice: (notice: string | null) => void;
+    /** Starts a job and follows it; resolves with the job as created, or `null` with a notice. */
+    start: (brief: string, inputs: Record<string, string>) => Promise<AiJobSummary | null>;
+}
+export declare const isAiJobSettled: (job: AiJobSummary | null | undefined) => boolean;
+/** Whether a job is moving now: queued or running, rather than settled or waiting for a person. */
+export declare const isAiJobMoving: (job: AiJobSummary | null | undefined) => boolean;
+export declare function useAiProductsJobs(input: {
+    hostId: string;
+    orgId: string | undefined;
+    /** Which of the site's moving jobs this card shows, and so follows; none when absent. */
+    follows?: (job: AiJobSummary) => boolean;
+}): AiProductsJobs;

package/src/lib/components/use-ai-products-jobs.js

@@ -0,0 +1,190 @@
+/**
+ * @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 { lockdownRefusalText, parseLockdownRefusal } from "@aglyn/aglyn";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useHostOrgId, useUser } from "@aglyn/tenant-feature-instance";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { AI_JOB_TERMINAL_STATUSES } from "../model/ai-jobs.types.js";
+import { readEventFrames } from "./assist-jobs-drawer.component.js";
+/**
+ * The jobs route, as a commerce card asks it (AGL-2916): whether the feature
+ * is this workspace's at all, the site's recent `products` jobs, starting one,
+ * and following each until it settles.
+ *
+ * The shell has already decided the plan and the member's permission before a
+ * card mounts; the release flag is the route's, so a 404 or 403 from the list
+ * is the card staying absent. A card follows more than one job at a time — a
+ * bulk copy job and a catalog, say — so each job has its own watch: every job
+ * it starts, and of the jobs it finds already moving, the ones `follows`
+ * names as its own.
+ */ /** How many recent jobs a card reads to find this site's products jobs. */ export const AI_PRODUCTS_RECENT_JOBS_READ = 20;
+export const isAiJobSettled = (job)=>Boolean(job && AI_JOB_TERMINAL_STATUSES.includes(job.status));
+/** Whether a job is moving now: queued or running, rather than settled or waiting for a person. */ export const isAiJobMoving = (job)=>(job == null ? void 0 : job.status) === 'queued' || (job == null ? void 0 : job.status) === 'running';
+const START_FAILED_COPY = 'The AI job could not be started. Try again.';
+const LIST_FAILED_COPY = 'Recent AI proposals could not be loaded.';
+export function useAiProductsJobs(input) {
+    var _ref, _input_orgId, _ref1;
+    const { hostId } = input;
+    // Read through a ref: a card passes a fresh function each render, and the
+    // list is read once for who is signed in, not once for each.
+    const followsRef = useRef(input.follows);
+    followsRef.current = input.follows;
+    // A plugin-hosted zone may not know the org; the site does.
+    const hostOrgId = useHostOrgId(input.orgId ? undefined : hostId);
+    const orgId = (_ref = (_input_orgId = input.orgId) != null ? _input_orgId : hostOrgId) != null ? _ref : undefined;
+    const { data: user } = useUser();
+    // Held in a ref so the reads key on WHO is signed in, never on the identity
+    // of the object that says so.
+    const userRef = useRef(user);
+    userRef.current = user;
+    const uid = (_ref1 = user == null ? void 0 : user.uid) != null ? _ref1 : null;
+    const [verdict, setVerdict] = useState('checking');
+    const [jobs, setJobs] = useState([]);
+    const [notice, setNotice] = useState(null);
+    const watches = useRef(new Map());
+    useEffect(()=>{
+        const open = watches.current;
+        return ()=>{
+            for (const controller of open.values())controller.abort();
+            open.clear();
+        };
+    }, []);
+    const put = useCallback((job)=>{
+        setJobs((current)=>[
+                job,
+                ...current.filter((entry)=>entry.id !== job.id)
+            ].sort((a, b)=>b.createdAt.localeCompare(a.createdAt)));
+    }, []);
+    /** Follows one job through the events route until it settles. */ const follow = useCallback(async (job, org)=>{
+        if (!isAiJobMoving(job) || watches.current.has(job.id)) return;
+        const controller = new AbortController();
+        watches.current.set(job.id, controller);
+        try {
+            let again = true;
+            while(again && !controller.signal.aborted){
+                again = false;
+                const response = await authorizedFetch(userRef.current, `/api/ai/jobs/${encodeURIComponent(job.id)}/events?orgId=${encodeURIComponent(org)}`, {
+                    signal: controller.signal
+                });
+                if (!response.ok || !response.body) return;
+                await readEventFrames(response.body, (event)=>{
+                    if (event['type'] === 'state') put(event['job']);
+                    else if (event['type'] === 'reconnect') again = true;
+                });
+            }
+        } catch (unused) {
+        // An aborted or dropped watch leaves the last state shown.
+        } finally{
+            watches.current.delete(job.id);
+        }
+    }, [
+        put
+    ]);
+    useEffect(()=>{
+        if (!orgId || !hostId || !uid) return;
+        let active = true;
+        setVerdict('checking');
+        void (async ()=>{
+            try {
+                const response = await authorizedFetch(userRef.current, `/api/ai/jobs?orgId=${encodeURIComponent(orgId)}&limit=${AI_PRODUCTS_RECENT_JOBS_READ}`);
+                if (!active) return;
+                // The flag off (404) and the plan without generation (403): the
+                // feature is not this workspace's, so the card is not here at all.
+                if (response.status === 404 || response.status === 403) {
+                    setVerdict('hidden');
+                    return;
+                }
+                const payload = await response.json().catch(()=>null);
+                if (!active) return;
+                if (!response.ok) {
+                    var _ref;
+                    const locked = parseLockdownRefusal(response.status, payload);
+                    setNotice(locked ? lockdownRefusalText(locked) : String((_ref = payload == null ? void 0 : payload.error) != null ? _ref : LIST_FAILED_COPY));
+                } else {
+                    var _ref1;
+                    const recent = ((_ref1 = payload == null ? void 0 : payload.jobs) != null ? _ref1 : []).filter((entry)=>entry.kind === 'products' && entry.hostId === hostId);
+                    setJobs(recent);
+                    for (const job of recent){
+                        if (followsRef.current == null ? void 0 : followsRef.current.call(followsRef, job)) void follow(job, orgId);
+                    }
+                }
+                setVerdict('ready');
+            } catch (unused) {
+                if (!active) return;
+                setNotice(LIST_FAILED_COPY);
+                setVerdict('ready');
+            }
+        })();
+        return ()=>{
+            active = false;
+        };
+    }, [
+        orgId,
+        hostId,
+        uid,
+        follow
+    ]);
+    const start = useCallback(async (brief, inputs)=>{
+        if (!orgId) return null;
+        setNotice(null);
+        try {
+            const response = await authorizedFetch(userRef.current, '/api/ai/jobs', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    orgId,
+                    hostId,
+                    kind: 'products',
+                    brief,
+                    inputs
+                })
+            });
+            const payload = await response.json().catch(()=>null);
+            if (!response.ok) {
+                var _ref;
+                const locked = parseLockdownRefusal(response.status, payload);
+                setNotice(locked ? lockdownRefusalText(locked) : String((_ref = payload == null ? void 0 : payload.error) != null ? _ref : START_FAILED_COPY));
+                return null;
+            }
+            const job = payload == null ? void 0 : payload.job;
+            if (!job) return null;
+            put(job);
+            void follow(job, orgId);
+            return job;
+        } catch (unused) {
+            setNotice(START_FAILED_COPY);
+            return null;
+        }
+    }, [
+        orgId,
+        hostId,
+        put,
+        follow
+    ]);
+    return {
+        orgId,
+        verdict,
+        jobs,
+        notice,
+        setNotice,
+        start
+    };
+}
+
+//# sourceMappingURL=use-ai-products-jobs.js.map