@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/components/use-ai-allotments.d.ts

@@ -0,0 +1,49 @@
+import { authorizedFetch } from '@aglyn/shared-util-http/authorized-token';
+import type { AiAllotmentMode } from '../model/ai-allotments';
+import type { AiAllotmentsWire } from '../usage/ai-usage-wire';
+/**
+ * The AI allotments a card shows, through `/api/ai/allotments` (AGL-2942).
+ *
+ * Loading, answered, refused or failed — four states, for the reason
+ * `use-org-ai-usage.ts` gives: the member page and the collaborators card are
+ * open to people who may not read billing, and for them a 403 is the
+ * ordinary answer, rendered as no card rather than a warning.
+ *
+ * One read per reader and question, shared by every mount that asks it — a
+ * collaborators column mounts once per ROW — and every read is taken again
+ * after a save, so the column, the site card and the Billing section agree
+ * the moment one of them writes.
+ */
+export type AiAllotmentsStatus = 'loading' | 'ready' | 'refused' | 'error';
+export interface AiAllotmentsState {
+    status: AiAllotmentsStatus;
+    data: AiAllotmentsWire | null;
+    reload: () => void;
+}
+/** Forget every shared read; specs start each case from nothing. */
+export declare function resetAiAllotmentReadsForTests(): void;
+/** Read every allotments question again — after a save. */
+export declare function reloadAllAiAllotments(): void;
+export declare function useAiAllotments(input: {
+    orgId?: string | null;
+    hostId?: string | null;
+    uid?: string | null;
+    enabled?: boolean;
+}): AiAllotmentsState;
+/** One allotment a save sets. */
+export interface AiAllotmentSetInput {
+    subject: string;
+    credits: number | null;
+    mode: AiAllotmentMode;
+    models: string[] | null;
+}
+/** Set, remove, or set on every site — then every card reads again. */
+export declare function saveAiAllotments(user: Parameters<typeof authorizedFetch>[0], body: {
+    orgId: string;
+    set?: AiAllotmentSetInput[];
+    remove?: string[];
+    everySite?: Omit<AiAllotmentSetInput, 'subject'> | null;
+}): Promise<{
+    ok: boolean;
+    error: string | null;
+}>;

package/src/lib/components/use-ai-allotments.js

@@ -0,0 +1,171 @@
+/**
+ * @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, useMemo, useRef, useState } from "react";
+const LOADING = {
+    status: 'loading',
+    data: null
+};
+const sharedReads = new Map();
+/** Forget every shared read; specs start each case from nothing. */ export function resetAiAllotmentReadsForTests() {
+    sharedReads.clear();
+}
+function publish(entry, read) {
+    entry.read = read;
+    for (const listener of entry.listeners)listener(read);
+}
+async function readInto(entry) {
+    entry.generation += 1;
+    const generation = entry.generation;
+    publish(entry, {
+        status: 'loading',
+        data: entry.read.data
+    });
+    try {
+        const response = await authorizedFetch(entry.user, `/api/ai/allotments?${entry.query}`);
+        if (generation !== entry.generation) return;
+        if (response.status === 403 || response.status === 404) {
+            publish(entry, {
+                status: 'refused',
+                data: null
+            });
+            return;
+        }
+        const payload = await response.json().catch(()=>null);
+        if (generation !== entry.generation) return;
+        publish(entry, response.ok && payload ? {
+            status: 'ready',
+            data: payload
+        } : {
+            status: 'error',
+            data: null
+        });
+    } catch (unused) {
+        if (generation === entry.generation) publish(entry, {
+            status: 'error',
+            data: null
+        });
+    }
+}
+/** Read every allotments question again — after a save. */ export function reloadAllAiAllotments() {
+    for (const entry of sharedReads.values()){
+        if (entry.listeners.size) void readInto(entry);
+    }
+}
+export function useAiAllotments(input) {
+    var _ref, _input_orgId, _input_hostId, _input_uid;
+    const { data: user } = useUser();
+    const signedInUid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    const userRef = useRef(user);
+    userRef.current = user;
+    const orgId = (_input_orgId = input.orgId) != null ? _input_orgId : '';
+    const hostId = (_input_hostId = input.hostId) != null ? _input_hostId : '';
+    const subjectUid = (_input_uid = input.uid) != null ? _input_uid : '';
+    const enabled = input.enabled !== false && Boolean(orgId || hostId);
+    const key = signedInUid && enabled ? [
+        signedInUid,
+        orgId,
+        hostId,
+        subjectUid
+    ].join('\x00') : null;
+    const query = useMemo(()=>{
+        const params = new URLSearchParams();
+        if (orgId) params.set('orgId', orgId);
+        if (hostId) params.set('hostId', hostId);
+        if (subjectUid) params.set('uid', subjectUid);
+        return params.toString();
+    }, [
+        orgId,
+        hostId,
+        subjectUid
+    ]);
+    const [read, setRead] = useState(()=>{
+        var _ref;
+        var _sharedReads_get;
+        return (_ref = key ? (_sharedReads_get = sharedReads.get(key)) == null ? void 0 : _sharedReads_get.read : undefined) != null ? _ref : LOADING;
+    });
+    useEffect(()=>{
+        const signedIn = userRef.current;
+        if (!key || !signedIn) return undefined;
+        let entry = sharedReads.get(key);
+        if (!entry) {
+            entry = {
+                read: LOADING,
+                listeners: new Set(),
+                generation: 0,
+                query,
+                user: signedIn
+            };
+            sharedReads.set(key, entry);
+        }
+        const shared = entry;
+        shared.user = signedIn;
+        const first = shared.listeners.size === 0;
+        shared.listeners.add(setRead);
+        setRead(shared.read);
+        if (first) void readInto(shared);
+        return ()=>{
+            shared.listeners.delete(setRead);
+        };
+    }, [
+        key,
+        query
+    ]);
+    const reload = useCallback(()=>{
+        const entry = key ? sharedReads.get(key) : undefined;
+        if (entry) void readInto(entry);
+    }, [
+        key
+    ]);
+    return {
+        status: key ? read.status : 'loading',
+        data: key ? read.data : null,
+        reload
+    };
+}
+/** Set, remove, or set on every site — then every card reads again. */ export async function saveAiAllotments(user, body) {
+    try {
+        const response = await authorizedFetch(user, '/api/ai/allotments', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(body)
+        });
+        const payload = await response.json().catch(()=>null);
+        if (!response.ok) {
+            var _ref;
+            return {
+                ok: false,
+                error: (_ref = payload == null ? void 0 : payload.error) != null ? _ref : 'The allotment could not be saved — try again.'
+            };
+        }
+        reloadAllAiAllotments();
+        return {
+            ok: true,
+            error: null
+        };
+    } catch (unused) {
+        return {
+            ok: false,
+            error: 'The allotment could not be saved — check your connection and try again.'
+        };
+    }
+}
+
+//# sourceMappingURL=use-ai-allotments.js.map

package/src/lib/components/use-ai-allotments.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/use-ai-allotments.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, useMemo, useRef, useState } from 'react'\nimport type { AiAllotmentMode } from '../model/ai-allotments'\nimport type { AiAllotmentsWire } from '../usage/ai-usage-wire'\n\n/**\n * The AI allotments a card shows, through `/api/ai/allotments` (AGL-2942).\n *\n * Loading, answered, refused or failed — four states, for the reason\n * `use-org-ai-usage.ts` gives: the member page and the collaborators card are\n * open to people who may not read billing, and for them a 403 is the\n * ordinary answer, rendered as no card rather than a warning.\n *\n * One read per reader and question, shared by every mount that asks it — a\n * collaborators column mounts once per ROW — and every read is taken again\n * after a save, so the column, the site card and the Billing section agree\n * the moment one of them writes.\n */\n\nexport type AiAllotmentsStatus = 'loading' | 'ready' | 'refused' | 'error'\n\nexport interface AiAllotmentsState {\n  status: AiAllotmentsStatus\n  data: AiAllotmentsWire | null\n  reload: () => void\n}\n\ninterface Read {\n  status: AiAllotmentsStatus\n  data: AiAllotmentsWire | null\n}\n\ninterface SharedRead {\n  read: Read\n  listeners: Set<(read: Read) => void>\n  generation: number\n  query: string\n  user: Parameters<typeof authorizedFetch>[0]\n}\n\nconst LOADING: Read = { status: 'loading', data: null }\nconst sharedReads = new Map<string, SharedRead>()\n\n/** Forget every shared read; specs start each case from nothing. */\nexport function resetAiAllotmentReadsForTests(): void {\n  sharedReads.clear()\n}\n\nfunction publish(entry: SharedRead, read: Read): void {\n  entry.read = read\n  for (const listener of entry.listeners) listener(read)\n}\n\nasync function readInto(entry: SharedRead): Promise<void> {\n  entry.generation += 1\n  const generation = entry.generation\n  publish(entry, { status: 'loading', data: entry.read.data })\n  try {\n    const response = await authorizedFetch(entry.user, `/api/ai/allotments?${entry.query}`)\n    if (generation !== entry.generation) return\n    if (response.status === 403 || response.status === 404) {\n      publish(entry, { status: 'refused', data: null })\n      return\n    }\n    const payload = (await response.json().catch(() => null)) as AiAllotmentsWire | null\n    if (generation !== entry.generation) return\n    publish(\n      entry,\n      response.ok && payload ? { status: 'ready', data: payload } : { status: 'error', data: null },\n    )\n  } catch {\n    if (generation === entry.generation) publish(entry, { status: 'error', data: null })\n  }\n}\n\n/** Read every allotments question again — after a save. */\nexport function reloadAllAiAllotments(): void {\n  for (const entry of sharedReads.values()) {\n    if (entry.listeners.size) void readInto(entry)\n  }\n}\n\nexport function useAiAllotments(input: {\n  orgId?: string | null\n  hostId?: string | null\n  uid?: string | null\n  enabled?: boolean\n}): AiAllotmentsState {\n  const { data: user } = useUser()\n  const signedInUid = user?.uid ?? null\n  const userRef = useRef(user)\n  userRef.current = user\n  const orgId = input.orgId ?? ''\n  const hostId = input.hostId ?? ''\n  const subjectUid = input.uid ?? ''\n  const enabled = input.enabled !== false && Boolean(orgId || hostId)\n  const key =\n    signedInUid && enabled ? [signedInUid, orgId, hostId, subjectUid].join('\\x00') : null\n  const query = useMemo(() => {\n    const params = new URLSearchParams()\n    if (orgId) params.set('orgId', orgId)\n    if (hostId) params.set('hostId', hostId)\n    if (subjectUid) params.set('uid', subjectUid)\n    return params.toString()\n  }, [orgId, hostId, subjectUid])\n  const [read, setRead] = useState<Read>(() => (key ? sharedReads.get(key)?.read : undefined) ?? LOADING)\n\n  useEffect(() => {\n    const signedIn = userRef.current\n    if (!key || !signedIn) return undefined\n    let entry = sharedReads.get(key)\n    if (!entry) {\n      entry = { read: LOADING, listeners: new Set(), generation: 0, query, user: signedIn }\n      sharedReads.set(key, entry)\n    }\n    const shared = entry\n    shared.user = signedIn\n    const first = shared.listeners.size === 0\n    shared.listeners.add(setRead)\n    setRead(shared.read)\n    if (first) void readInto(shared)\n    return () => {\n      shared.listeners.delete(setRead)\n    }\n  }, [key, query])\n\n  const reload = useCallback(() => {\n    const entry = key ? sharedReads.get(key) : undefined\n    if (entry) void readInto(entry)\n  }, [key])\n\n  return { status: key ? read.status : 'loading', data: key ? read.data : null, reload }\n}\n\n/** One allotment a save sets. */\nexport interface AiAllotmentSetInput {\n  subject: string\n  credits: number | null\n  mode: AiAllotmentMode\n  models: string[] | null\n}\n\n/** Set, remove, or set on every site — then every card reads again. */\nexport async function saveAiAllotments(\n  user: Parameters<typeof authorizedFetch>[0],\n  body: {\n    orgId: string\n    set?: AiAllotmentSetInput[]\n    remove?: string[]\n    everySite?: Omit<AiAllotmentSetInput, 'subject'> | null\n  },\n): Promise<{ ok: boolean; error: string | null }> {\n  try {\n    const response = await authorizedFetch(user, '/api/ai/allotments', {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify(body),\n    })\n    const payload = (await response.json().catch(() => null)) as { error?: string } | null\n    if (!response.ok) {\n      return { ok: false, error: payload?.error ?? 'The allotment could not be saved — try again.' }\n    }\n    reloadAllAiAllotments()\n    return { ok: true, error: null }\n  } catch {\n    return { ok: false, error: 'The allotment could not be saved — check your connection and try again.' }\n  }\n}\n"],"names":["authorizedFetch","useUser","useCallback","useEffect","useMemo","useRef","useState","LOADING","status","data","sharedReads","Map","resetAiAllotmentReadsForTests","clear","publish","entry","read","listener","listeners","readInto","generation","response","user","query","payload","json","catch","ok","reloadAllAiAllotments","values","size","useAiAllotments","input","signedInUid","uid","userRef","current","orgId","hostId","subjectUid","enabled","Boolean","key","join","params","URLSearchParams","set","toString","setRead","get","undefined","signedIn","Set","shared","first","add","delete","reload","saveAiAllotments","body","method","headers","JSON","stringify","error"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,OAAO,QAAQ,iCAAgC;AACxD,SAASC,WAAW,EAAEC,SAAS,EAAEC,OAAO,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,QAAO;AAuCzE,MAAMC,UAAgB;IAAEC,QAAQ;IAAWC,MAAM;AAAK;AACtD,MAAMC,cAAc,IAAIC;AAExB,kEAAkE,GAClE,OAAO,SAASC;IACdF,YAAYG,KAAK;AACnB;AAEA,SAASC,QAAQC,KAAiB,EAAEC,IAAU;IAC5CD,MAAMC,IAAI,GAAGA;IACb,KAAK,MAAMC,YAAYF,MAAMG,SAAS,CAAED,SAASD;AACnD;AAEA,eAAeG,SAASJ,KAAiB;IACvCA,MAAMK,UAAU,IAAI;IACpB,MAAMA,aAAaL,MAAMK,UAAU;IACnCN,QAAQC,OAAO;QAAEP,QAAQ;QAAWC,MAAMM,MAAMC,IAAI,CAACP,IAAI;IAAC;IAC1D,IAAI;QACF,MAAMY,WAAW,MAAMrB,gBAAgBe,MAAMO,IAAI,EAAE,CAAC,mBAAmB,EAAEP,MAAMQ,KAAK,EAAE;QACtF,IAAIH,eAAeL,MAAMK,UAAU,EAAE;QACrC,IAAIC,SAASb,MAAM,KAAK,OAAOa,SAASb,MAAM,KAAK,KAAK;YACtDM,QAAQC,OAAO;gBAAEP,QAAQ;gBAAWC,MAAM;YAAK;YAC/C;QACF;QACA,MAAMe,UAAW,MAAMH,SAASI,IAAI,GAAGC,KAAK,CAAC,IAAM;QACnD,IAAIN,eAAeL,MAAMK,UAAU,EAAE;QACrCN,QACEC,OACAM,SAASM,EAAE,IAAIH,UAAU;YAAEhB,QAAQ;YAASC,MAAMe;QAAQ,IAAI;YAAEhB,QAAQ;YAASC,MAAM;QAAK;IAEhG,EAAE,eAAM;QACN,IAAIW,eAAeL,MAAMK,UAAU,EAAEN,QAAQC,OAAO;YAAEP,QAAQ;YAASC,MAAM;QAAK;IACpF;AACF;AAEA,yDAAyD,GACzD,OAAO,SAASmB;IACd,KAAK,MAAMb,SAASL,YAAYmB,MAAM,GAAI;QACxC,IAAId,MAAMG,SAAS,CAACY,IAAI,EAAE,KAAKX,SAASJ;IAC1C;AACF;AAEA,OAAO,SAASgB,gBAAgBC,KAK/B;cAKeA,cACCA,eACIA;IANnB,MAAM,EAAEvB,MAAMa,IAAI,EAAE,GAAGrB;IACvB,MAAMgC,sBAAcX,wBAAAA,KAAMY,GAAG,mBAAI;IACjC,MAAMC,UAAU9B,OAAOiB;IACvBa,QAAQC,OAAO,GAAGd;IAClB,MAAMe,SAAQL,eAAAA,MAAMK,KAAK,YAAXL,eAAe;IAC7B,MAAMM,UAASN,gBAAAA,MAAMM,MAAM,YAAZN,gBAAgB;IAC/B,MAAMO,cAAaP,aAAAA,MAAME,GAAG,YAATF,aAAa;IAChC,MAAMQ,UAAUR,MAAMQ,OAAO,KAAK,SAASC,QAAQJ,SAASC;IAC5D,MAAMI,MACJT,eAAeO,UAAU;QAACP;QAAaI;QAAOC;QAAQC;KAAW,CAACI,IAAI,CAAC,UAAU;IACnF,MAAMpB,QAAQnB,QAAQ;QACpB,MAAMwC,SAAS,IAAIC;QACnB,IAAIR,OAAOO,OAAOE,GAAG,CAAC,SAAST;QAC/B,IAAIC,QAAQM,OAAOE,GAAG,CAAC,UAAUR;QACjC,IAAIC,YAAYK,OAAOE,GAAG,CAAC,OAAOP;QAClC,OAAOK,OAAOG,QAAQ;IACxB,GAAG;QAACV;QAAOC;QAAQC;KAAW;IAC9B,MAAM,CAACvB,MAAMgC,QAAQ,GAAG1C,SAAe;YAAOoC;YAAMhC;gBAANgC,OAAAA,OAAMhC,mBAAAA,YAAYuC,GAAG,CAACP,yBAAhBhC,iBAAsBM,IAAI,GAAGkC,qBAAnCR,OAAiDnC;;IAE/FJ,UAAU;QACR,MAAMgD,WAAWhB,QAAQC,OAAO;QAChC,IAAI,CAACM,OAAO,CAACS,UAAU,OAAOD;QAC9B,IAAInC,QAAQL,YAAYuC,GAAG,CAACP;QAC5B,IAAI,CAAC3B,OAAO;YACVA,QAAQ;gBAAEC,MAAMT;gBAASW,WAAW,IAAIkC;gBAAOhC,YAAY;gBAAGG;gBAAOD,MAAM6B;YAAS;YACpFzC,YAAYoC,GAAG,CAACJ,KAAK3B;QACvB;QACA,MAAMsC,SAAStC;QACfsC,OAAO/B,IAAI,GAAG6B;QACd,MAAMG,QAAQD,OAAOnC,SAAS,CAACY,IAAI,KAAK;QACxCuB,OAAOnC,SAAS,CAACqC,GAAG,CAACP;QACrBA,QAAQK,OAAOrC,IAAI;QACnB,IAAIsC,OAAO,KAAKnC,SAASkC;QACzB,OAAO;YACLA,OAAOnC,SAAS,CAACsC,MAAM,CAACR;QAC1B;IACF,GAAG;QAACN;QAAKnB;KAAM;IAEf,MAAMkC,SAASvD,YAAY;QACzB,MAAMa,QAAQ2B,MAAMhC,YAAYuC,GAAG,CAACP,OAAOQ;QAC3C,IAAInC,OAAO,KAAKI,SAASJ;IAC3B,GAAG;QAAC2B;KAAI;IAER,OAAO;QAAElC,QAAQkC,MAAM1B,KAAKR,MAAM,GAAG;QAAWC,MAAMiC,MAAM1B,KAAKP,IAAI,GAAG;QAAMgD;IAAO;AACvF;AAUA,qEAAqE,GACrE,OAAO,eAAeC,iBACpBpC,IAA2C,EAC3CqC,IAKC;IAED,IAAI;QACF,MAAMtC,WAAW,MAAMrB,gBAAgBsB,MAAM,sBAAsB;YACjEsC,QAAQ;YACRC,SAAS;gBAAE,gBAAgB;YAAmB;YAC9CF,MAAMG,KAAKC,SAAS,CAACJ;QACvB;QACA,MAAMnC,UAAW,MAAMH,SAASI,IAAI,GAAGC,KAAK,CAAC,IAAM;QACnD,IAAI,CAACL,SAASM,EAAE,EAAE;;YAChB,OAAO;gBAAEA,IAAI;gBAAOqC,KAAK,UAAExC,2BAAAA,QAASwC,KAAK,mBAAI;YAAgD;QAC/F;QACApC;QACA,OAAO;YAAED,IAAI;YAAMqC,OAAO;QAAK;IACjC,EAAE,eAAM;QACN,OAAO;YAAErC,IAAI;YAAOqC,OAAO;QAA0E;IACvG;AACF"}

package/src/lib/components/use-ai-crm-answer.d.ts

@@ -0,0 +1,50 @@
+import { authorizedFetch } from '@aglyn/shared-util-http/authorized-token';
+import { type AiCrmAnswerWanted, type AiCrmAnswerWire } from '../model/ai-crm';
+import { type AiJobSummary } from '../model/ai-jobs.types';
+/** How many recent jobs are read to find the last answer to a question. */
+export declare const AI_CRM_RECENT_JOBS_READ = 20;
+export declare const AI_CRM_LOAD_FAILED_COPY = "AI suggestions could not be loaded.";
+export declare const AI_CRM_START_FAILED_COPY = "AI could not be started. Try again.";
+export declare const AI_CRM_ANSWER_GONE_COPY = "This suggestion is no longer available. Ask again.";
+export type AiCrmVerdict = 'checking' | 'ready' | 'hidden';
+export interface AiCrmAnswerOptions {
+    orgId: string | undefined;
+    hostId: string | null;
+    /** The question a widget asks; `null` asks nothing and keeps the widget absent. */
+    wanted: AiCrmAnswerWanted | null;
+    /**
+     * Which earlier answer is shown when the widget mounts: the newest any
+     * member asked for (`any`, a record's summary), the newest this member did
+     * (`mine`), or none, for a question asked afresh each time.
+     */
+    recall: 'any' | 'mine' | 'none';
+}
+export interface AiCrmAnswerRun {
+    /** `hidden` when the jobs route says the feature is not this workspace's; the widget draws nothing. */
+    verdict: AiCrmVerdict;
+    job: AiJobSummary | null;
+    answer: AiCrmAnswerWire | null;
+    notice: string | null;
+    /** A request is on its way to the create door. */
+    busy: boolean;
+    /** The job asked is not settled yet. */
+    running: boolean;
+    /** Starts a `crm` job and settles it; the answer, or `null` when there is none to show. */
+    ask: (brief: string, inputs: Record<string, string>) => Promise<AiCrmAnswerWire | null>;
+}
+type User = Parameters<typeof authorizedFetch>[0];
+/** A kept answer through its door; `null` when the door has none for this member. */
+export declare function readAiCrmAnswer(user: User, jobId: string, orgId: string): Promise<AiCrmAnswerWire | null>;
+/**
+ * One question to a `crm` job from a console widget (AGL-2917): whether the
+ * feature is this workspace's, the last answer to it, and asking again.
+ *
+ * The jobs route decides whether a widget is here at all, as every generative
+ * card's does: a 404 (the release flag) or a 403 (the plan) keeps it absent.
+ * A job names only its question, so an answer is read from the answer door,
+ * which serves it only to a member the CRM lets read the record. A job the
+ * create door left for the beat is followed through the events route until
+ * it settles.
+ */
+export declare function useAiCrmAnswer(options: AiCrmAnswerOptions): AiCrmAnswerRun;
+export {};

package/src/lib/components/use-ai-crm-answer.js

@@ -0,0 +1,220 @@
+/**
+ * @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 { useUser } from "@aglyn/tenant-feature-instance";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { aiCrmJobAnswers, readAiCrmProposal } from "../model/ai-crm.js";
+import { AI_JOB_TERMINAL_STATUSES } from "../model/ai-jobs.types.js";
+import { readEventFrames } from "./assist-jobs-drawer.component.js";
+/** How many recent jobs are read to find the last answer to a question. */ export const AI_CRM_RECENT_JOBS_READ = 20;
+export const AI_CRM_LOAD_FAILED_COPY = 'AI suggestions could not be loaded.';
+export const AI_CRM_START_FAILED_COPY = 'AI could not be started. Try again.';
+export const AI_CRM_ANSWER_GONE_COPY = 'This suggestion is no longer available. Ask again.';
+const isTerminal = (job)=>AI_JOB_TERMINAL_STATUSES.includes(job.status);
+/** A kept answer through its door; `null` when the door has none for this member. */ export async function readAiCrmAnswer(user, jobId, orgId) {
+    var _payload_answer_jobId, _payload_answer_createdBy;
+    var _payload_answer;
+    const response = await authorizedFetch(user, `/api/ai/crm/${encodeURIComponent(jobId)}?orgId=${encodeURIComponent(orgId)}`);
+    if (!response.ok) return null;
+    const payload = await response.json().catch(()=>null);
+    const proposal = readAiCrmProposal(payload == null ? void 0 : (_payload_answer = payload.answer) == null ? void 0 : _payload_answer['proposal']);
+    if (!(payload == null ? void 0 : payload.answer) || !proposal) return null;
+    return {
+        jobId: String((_payload_answer_jobId = payload.answer['jobId']) != null ? _payload_answer_jobId : jobId),
+        hostId: typeof payload.answer['hostId'] === 'string' ? payload.answer['hostId'] : null,
+        createdBy: String((_payload_answer_createdBy = payload.answer['createdBy']) != null ? _payload_answer_createdBy : ''),
+        proposal
+    };
+}
+/**
+ * One question to a `crm` job from a console widget (AGL-2917): whether the
+ * feature is this workspace's, the last answer to it, and asking again.
+ *
+ * The jobs route decides whether a widget is here at all, as every generative
+ * card's does: a 404 (the release flag) or a 403 (the plan) keeps it absent.
+ * A job names only its question, so an answer is read from the answer door,
+ * which serves it only to a member the CRM lets read the record. A job the
+ * create door left for the beat is followed through the events route until
+ * it settles.
+ */ export function useAiCrmAnswer(options) {
+    var _ref;
+    const { orgId, hostId, recall } = options;
+    const { data: user } = useUser();
+    // Held in a ref so the reads below 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 = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    // By value, so a widget that builds its question each render asks once.
+    const wantedKey = options.wanted ? JSON.stringify(options.wanted) : null;
+    const [verdict, setVerdict] = useState('checking');
+    const [job, setJob] = useState(null);
+    const [answer, setAnswer] = useState(null);
+    const [notice, setNotice] = useState(null);
+    const [busy, setBusy] = useState(false);
+    const watchRef = useRef(null);
+    useEffect(()=>()=>{
+            var _watchRef_current;
+            return (_watchRef_current = watchRef.current) == null ? void 0 : _watchRef_current.abort();
+        }, []);
+    /** Follows a job until it settles, then reads its answer when it is done. */ const settle = useCallback(async (start, org)=>{
+        let current = start;
+        setJob(current);
+        if (!isTerminal(current)) {
+            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 && !isTerminal(current)){
+                again = false;
+                try {
+                    const response = await authorizedFetch(userRef.current, `/api/ai/jobs/${encodeURIComponent(current.id)}/events?orgId=${encodeURIComponent(org)}`, {
+                        signal: controller.signal
+                    });
+                    if (!response.ok || !response.body) break;
+                    await readEventFrames(response.body, (event)=>{
+                        if (event['type'] === 'state') {
+                            current = event['job'];
+                            setJob(current);
+                        } else if (event['type'] === 'reconnect') {
+                            again = true;
+                        }
+                    });
+                } catch (unused) {
+                    break;
+                }
+            }
+        }
+        if (current.status !== 'done') return null;
+        const kept = await readAiCrmAnswer(userRef.current, current.id, org).catch(()=>null);
+        setAnswer(kept);
+        if (!kept) setNotice(AI_CRM_ANSWER_GONE_COPY);
+        return kept;
+    }, []);
+    useEffect(()=>{
+        if (!orgId || !uid || !wantedKey) return;
+        let active = true;
+        setVerdict('checking');
+        setJob(null);
+        setAnswer(null);
+        setNotice(null);
+        void (async ()=>{
+            try {
+                var _ref;
+                const limit = recall === 'none' ? 1 : AI_CRM_RECENT_JOBS_READ;
+                const response = await authorizedFetch(userRef.current, `/api/ai/jobs?orgId=${encodeURIComponent(orgId)}&limit=${limit}`);
+                if (!active) return;
+                // The flag off (404) and the plan without generation (403): the
+                // feature is not this workspace's, so the widget 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 _ref1;
+                    const locked = parseLockdownRefusal(response.status, payload);
+                    setNotice(locked ? lockdownRefusalText(locked) : String((_ref1 = payload == null ? void 0 : payload.error) != null ? _ref1 : AI_CRM_LOAD_FAILED_COPY));
+                    setVerdict('ready');
+                    return;
+                }
+                setVerdict('ready');
+                if (recall === 'none') return;
+                const wanted = JSON.parse(wantedKey);
+                const found = ((_ref = payload == null ? void 0 : payload.jobs) != null ? _ref : []).find((entry)=>entry.hostId === hostId && (recall === 'any' || entry.createdBy === uid) && aiCrmJobAnswers(entry, wanted));
+                if (!found) return;
+                if (!isTerminal(found)) {
+                    await settle(found, orgId);
+                    return;
+                }
+                setJob(found);
+                if (found.status !== 'done') return;
+                const kept = await readAiCrmAnswer(userRef.current, found.id, orgId).catch(()=>null);
+                // An answer the door does not serve this member is simply not shown.
+                if (active) setAnswer(kept);
+            } catch (unused) {
+                if (!active) return;
+                setNotice(AI_CRM_LOAD_FAILED_COPY);
+                setVerdict('ready');
+            }
+        })();
+        return ()=>{
+            active = false;
+        };
+    }, [
+        orgId,
+        hostId,
+        uid,
+        wantedKey,
+        recall,
+        settle
+    ]);
+    const ask = useCallback(async (brief, inputs)=>{
+        if (!orgId) return null;
+        setBusy(true);
+        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: 'crm',
+                    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 : AI_CRM_START_FAILED_COPY));
+                return null;
+            }
+            const next = payload == null ? void 0 : payload.job;
+            if (!next) return null;
+            setAnswer(null);
+            return await settle(next, orgId);
+        } catch (unused) {
+            setNotice(AI_CRM_START_FAILED_COPY);
+            return null;
+        } finally{
+            setBusy(false);
+        }
+    }, [
+        orgId,
+        hostId,
+        settle
+    ]);
+    return {
+        verdict,
+        job,
+        answer,
+        notice,
+        busy,
+        running: Boolean(job && !isTerminal(job)),
+        ask
+    };
+}
+
+//# sourceMappingURL=use-ai-crm-answer.js.map

package/src/lib/components/use-ai-crm-answer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/use-ai-crm-answer.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 { lockdownRefusalText, parseLockdownRefusal } from '@aglyn/aglyn'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport {\n  aiCrmJobAnswers,\n  readAiCrmProposal,\n  type AiCrmAnswerWanted,\n  type AiCrmAnswerWire,\n} from '../model/ai-crm'\nimport { AI_JOB_TERMINAL_STATUSES, type AiJobSummary } from '../model/ai-jobs.types'\nimport { readEventFrames } from './assist-jobs-drawer.component'\n\n/** How many recent jobs are read to find the last answer to a question. */\nexport const AI_CRM_RECENT_JOBS_READ = 20\n\nexport const AI_CRM_LOAD_FAILED_COPY = 'AI suggestions could not be loaded.'\nexport const AI_CRM_START_FAILED_COPY = 'AI could not be started. Try again.'\nexport const AI_CRM_ANSWER_GONE_COPY = 'This suggestion is no longer available. Ask again.'\n\nexport type AiCrmVerdict = 'checking' | 'ready' | 'hidden'\n\nexport interface AiCrmAnswerOptions {\n  orgId: string | undefined\n  hostId: string | null\n  /** The question a widget asks; `null` asks nothing and keeps the widget absent. */\n  wanted: AiCrmAnswerWanted | null\n  /**\n   * Which earlier answer is shown when the widget mounts: the newest any\n   * member asked for (`any`, a record's summary), the newest this member did\n   * (`mine`), or none, for a question asked afresh each time.\n   */\n  recall: 'any' | 'mine' | 'none'\n}\n\nexport interface AiCrmAnswerRun {\n  /** `hidden` when the jobs route says the feature is not this workspace's; the widget draws nothing. */\n  verdict: AiCrmVerdict\n  job: AiJobSummary | null\n  answer: AiCrmAnswerWire | null\n  notice: string | null\n  /** A request is on its way to the create door. */\n  busy: boolean\n  /** The job asked is not settled yet. */\n  running: boolean\n  /** Starts a `crm` job and settles it; the answer, or `null` when there is none to show. */\n  ask: (brief: string, inputs: Record<string, string>) => Promise<AiCrmAnswerWire | null>\n}\n\ntype User = Parameters<typeof authorizedFetch>[0]\n\nconst isTerminal = (job: AiJobSummary) => AI_JOB_TERMINAL_STATUSES.includes(job.status)\n\n/** A kept answer through its door; `null` when the door has none for this member. */\nexport async function readAiCrmAnswer(user: User, jobId: string, orgId: string): Promise<AiCrmAnswerWire | null> {\n  const response = await authorizedFetch(\n    user,\n    `/api/ai/crm/${encodeURIComponent(jobId)}?orgId=${encodeURIComponent(orgId)}`,\n  )\n  if (!response.ok) return null\n  const payload = (await response.json().catch(() => null)) as { answer?: Record<string, unknown> } | null\n  const proposal = readAiCrmProposal(payload?.answer?.['proposal'])\n  if (!payload?.answer || !proposal) return null\n  return {\n    jobId: String(payload.answer['jobId'] ?? jobId),\n    hostId: typeof payload.answer['hostId'] === 'string' ? payload.answer['hostId'] : null,\n    createdBy: String(payload.answer['createdBy'] ?? ''),\n    proposal,\n  }\n}\n\n/**\n * One question to a `crm` job from a console widget (AGL-2917): whether the\n * feature is this workspace's, the last answer to it, and asking again.\n *\n * The jobs route decides whether a widget is here at all, as every generative\n * card's does: a 404 (the release flag) or a 403 (the plan) keeps it absent.\n * A job names only its question, so an answer is read from the answer door,\n * which serves it only to a member the CRM lets read the record. A job the\n * create door left for the beat is followed through the events route until\n * it settles.\n */\nexport function useAiCrmAnswer(options: AiCrmAnswerOptions): AiCrmAnswerRun {\n  const { orgId, hostId, recall } = options\n  const { data: user } = useUser()\n  // Held in a ref so the reads below key 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  // By value, so a widget that builds its question each render asks once.\n  const wantedKey = options.wanted ? JSON.stringify(options.wanted) : null\n\n  const [verdict, setVerdict] = useState<AiCrmVerdict>('checking')\n  const [job, setJob] = useState<AiJobSummary | null>(null)\n  const [answer, setAnswer] = useState<AiCrmAnswerWire | null>(null)\n  const [notice, setNotice] = useState<string | null>(null)\n  const [busy, setBusy] = useState(false)\n  const watchRef = useRef<AbortController | null>(null)\n\n  useEffect(() => () => watchRef.current?.abort(), [])\n\n  /** Follows a job until it settles, then reads its answer when it is done. */\n  const settle = useCallback(async (start: AiJobSummary, org: string): Promise<AiCrmAnswerWire | null> => {\n    let current = start\n    setJob(current)\n    if (!isTerminal(current)) {\n      watchRef.current?.abort()\n      const controller = new AbortController()\n      watchRef.current = controller\n      let again = true\n      while (again && !controller.signal.aborted && !isTerminal(current)) {\n        again = false\n        try {\n          const response = await authorizedFetch(\n            userRef.current,\n            `/api/ai/jobs/${encodeURIComponent(current.id)}/events?orgId=${encodeURIComponent(org)}`,\n            { signal: controller.signal },\n          )\n          if (!response.ok || !response.body) break\n          await readEventFrames(response.body, (event) => {\n            if (event['type'] === 'state') {\n              current = event['job'] as AiJobSummary\n              setJob(current)\n            } else if (event['type'] === 'reconnect') {\n              again = true\n            }\n          })\n        } catch {\n          break\n        }\n      }\n    }\n    if (current.status !== 'done') return null\n    const kept = await readAiCrmAnswer(userRef.current, current.id, org).catch(() => null)\n    setAnswer(kept)\n    if (!kept) setNotice(AI_CRM_ANSWER_GONE_COPY)\n    return kept\n  }, [])\n\n  useEffect(() => {\n    if (!orgId || !uid || !wantedKey) return\n    let active = true\n    setVerdict('checking')\n    setJob(null)\n    setAnswer(null)\n    setNotice(null)\n    void (async () => {\n      try {\n        const limit = recall === 'none' ? 1 : AI_CRM_RECENT_JOBS_READ\n        const response = await authorizedFetch(\n          userRef.current,\n          `/api/ai/jobs?orgId=${encodeURIComponent(orgId)}&limit=${limit}`,\n        )\n        if (!active) return\n        // The flag off (404) and the plan without generation (403): the\n        // feature is not this workspace's, so the widget is not here at all.\n        if (response.status === 404 || response.status === 403) {\n          setVerdict('hidden')\n          return\n        }\n        const payload = await response.json().catch(() => null)\n        if (!active) return\n        if (!response.ok) {\n          const locked = parseLockdownRefusal(response.status, payload)\n          setNotice(locked ? lockdownRefusalText(locked) : String(payload?.error ?? AI_CRM_LOAD_FAILED_COPY))\n          setVerdict('ready')\n          return\n        }\n        setVerdict('ready')\n        if (recall === 'none') return\n        const wanted = JSON.parse(wantedKey) as AiCrmAnswerWanted\n        const found = ((payload?.jobs ?? []) as AiJobSummary[]).find(\n          (entry) =>\n            entry.hostId === hostId &&\n            (recall === 'any' || entry.createdBy === uid) &&\n            aiCrmJobAnswers(entry, wanted),\n        )\n        if (!found) return\n        if (!isTerminal(found)) {\n          await settle(found, orgId)\n          return\n        }\n        setJob(found)\n        if (found.status !== 'done') return\n        const kept = await readAiCrmAnswer(userRef.current, found.id, orgId).catch(() => null)\n        // An answer the door does not serve this member is simply not shown.\n        if (active) setAnswer(kept)\n      } catch {\n        if (!active) return\n        setNotice(AI_CRM_LOAD_FAILED_COPY)\n        setVerdict('ready')\n      }\n    })()\n    return () => {\n      active = false\n    }\n  }, [orgId, hostId, uid, wantedKey, recall, settle])\n\n  const ask = useCallback(\n    async (brief: string, inputs: Record<string, string>): Promise<AiCrmAnswerWire | null> => {\n      if (!orgId) return null\n      setBusy(true)\n      setNotice(null)\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({ orgId, hostId, kind: 'crm', brief, inputs }),\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 ?? AI_CRM_START_FAILED_COPY))\n          return null\n        }\n        const next = payload?.job as AiJobSummary | undefined\n        if (!next) return null\n        setAnswer(null)\n        return await settle(next, orgId)\n      } catch {\n        setNotice(AI_CRM_START_FAILED_COPY)\n        return null\n      } finally {\n        setBusy(false)\n      }\n    },\n    [orgId, hostId, settle],\n  )\n\n  return {\n    verdict,\n    job,\n    answer,\n    notice,\n    busy,\n    running: Boolean(job && !isTerminal(job)),\n    ask,\n  }\n}\n"],"names":["lockdownRefusalText","parseLockdownRefusal","authorizedFetch","useUser","useCallback","useEffect","useRef","useState","aiCrmJobAnswers","readAiCrmProposal","AI_JOB_TERMINAL_STATUSES","readEventFrames","AI_CRM_RECENT_JOBS_READ","AI_CRM_LOAD_FAILED_COPY","AI_CRM_START_FAILED_COPY","AI_CRM_ANSWER_GONE_COPY","isTerminal","job","includes","status","readAiCrmAnswer","user","jobId","orgId","payload","response","encodeURIComponent","ok","json","catch","proposal","answer","String","hostId","createdBy","useAiCrmAnswer","options","recall","data","userRef","current","uid","wantedKey","wanted","JSON","stringify","verdict","setVerdict","setJob","setAnswer","notice","setNotice","busy","setBusy","watchRef","abort","settle","start","org","controller","AbortController","again","signal","aborted","id","body","event","kept","active","limit","locked","error","parse","found","jobs","find","entry","ask","brief","inputs","method","headers","kind","next","running","Boolean"],"mappings":"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"}

package/src/lib/components/use-ai-job-run.d.ts

@@ -0,0 +1,51 @@
+import { type MaybeTokenSource, type TokenSource } from '@aglyn/shared-util-http/authorized-token';
+import { type AiJobKind, type AiJobSummary } from '../model/ai-jobs.types';
+/**
+ * Starting one AI job from a console control, and following it until it
+ * settles (AGL-2919): the jobs route's create door, then its events door, the
+ * way the SEO card follows its jobs. A control that starts a job the beat
+ * runs shows its progress here and its result when it arrives; closing the
+ * control stops following, and the job carries on in AI jobs.
+ */
+/** Whether the jobs route serves a workspace: still asking, yes, or no. */
+export type AiJobsVerdict = 'checking' | 'ready' | 'hidden';
+/** Forgets every answer, so the next control to mount asks the route again. */
+export declare function forgetAiJobsVerdicts(): void;
+/**
+ * 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 declare function useAiJobsVerdict(user: (TokenSource & {
+    uid?: string | null;
+}) | null | undefined, orgId: string | undefined): AiJobsVerdict;
+/** What a control asks the create door for. */
+export interface AiJobRequest {
+    orgId: string;
+    hostId: string;
+    kind: AiJobKind;
+    brief: string;
+    inputs: Record<string, string>;
+}
+/** Whether a job has stopped moving: finished, or waiting on something only a person can change. */
+export declare function aiJobSettled(job: AiJobSummary | null): boolean;
+/**
+ * Why a settled job has no result to show, in words a person can act on, or
+ * `null` for a job that finished.
+ */
+export declare function aiJobProblem(job: AiJobSummary | null, failed: string): string | null;
+export interface AiJobRun {
+    /** The job as it last arrived; `null` before one is started. */
+    job: AiJobSummary | null;
+    /** The create door is being asked. */
+    starting: boolean;
+    /** The job exists and has not settled. */
+    running: boolean;
+    /** Why the create door refused, or could not be reached. */
+    notice: string | null;
+    /** Starts the job, `true` once it exists, and follows it from there; `false` when the door refused. */
+    start: (request: AiJobRequest) => Promise<boolean>;
+    /** Stops following and forgets the job, for a control asked again. */
+    reset: () => void;
+}
+export declare function useAiJobRun(user: MaybeTokenSource, failed: string): AiJobRun;