@aglyn/plugins-ai 1.0.0-beta.231 → 1.0.0-beta.233

package/src/lib/components/staff-org-ai-conversations.component.js

@@ -0,0 +1,346 @@
+/**
+ * @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 { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { PLATFORM_BRAND_NAME } from "@aglyn/aglyn";
+import { pluginDocsHelp } from "@aglyn/aglyn/app-utils/docs-help";
+import { CardDisplay } from "@aglyn/shared-ui-jsx";
+import { ListPagination } from "@aglyn/shared-ui-jsx/components/list-pagination.component";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { Alert, Box, Button, Chip, Divider, Stack, ToggleButton, ToggleButtonGroup, Typography } from "@mui/material";
+import { useCallback, useRef, useState } from "react";
+import { STAFF_AI_CONVERSATIONS_PAGE } from "../usage/staff-org-ai-conversations.js";
+/**
+ * What an organization asked Aglyn AI and what it answered (AGL-3675): the
+ * Assist chat's questions and answers, and each AI job's brief and result,
+ * newest first, on the staff org page.
+ *
+ * Nothing is read until staff ask: the route writes an audited access row
+ * for every page it returns, so a card that loaded with the page would log
+ * reads nobody chose to make.
+ */ const when = (iso)=>iso ? new Date(iso).toLocaleString() : 'Unknown time';
+const who = (person)=>{
+    var _ref, _person_email;
+    return (_ref = (_person_email = person.email) != null ? _person_email : person.name) != null ? _ref : person.uid ? `uid ${person.uid}` : 'Unknown member';
+};
+const money = (value)=>value === null ? null : `$${value.toFixed(value < 1 ? 4 : 2)}`;
+/** A block of what someone typed or what came back, kept as written. */ const Words = ({ label, children })=>/*#__PURE__*/ _jsxs(Box, {
+        children: [
+            /*#__PURE__*/ _jsx(Typography, {
+                variant: "overline",
+                color: "text.secondary",
+                children: label
+            }),
+            /*#__PURE__*/ _jsx(Typography, {
+                variant: "body2",
+                sx: {
+                    whiteSpace: 'pre-wrap',
+                    overflowWrap: 'anywhere'
+                },
+                children: children || '—'
+            })
+        ]
+    });
+const Meta = ({ children })=>/*#__PURE__*/ _jsx(Stack, {
+        direction: "row",
+        useFlexGap: true,
+        sx: {
+            flexWrap: 'wrap',
+            gap: 1,
+            alignItems: 'center'
+        },
+        children: children
+    });
+const AssistRow = ({ row })=>/*#__PURE__*/ _jsxs(Stack, {
+        spacing: 1,
+        children: [
+            /*#__PURE__*/ _jsxs(Meta, {
+                children: [
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        sx: {
+                            fontWeight: 600
+                        },
+                        children: who(row.by)
+                    }),
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        children: when(row.at)
+                    }),
+                    row.route ? /*#__PURE__*/ _jsx(Chip, {
+                        size: "small",
+                        variant: "outlined",
+                        label: row.route
+                    }) : null,
+                    row.model ? /*#__PURE__*/ _jsx(Chip, {
+                        size: "small",
+                        variant: "outlined",
+                        label: row.model
+                    }) : null,
+                    money(row.estCostUsd) ? /*#__PURE__*/ _jsx(Chip, {
+                        size: "small",
+                        variant: "outlined",
+                        label: money(row.estCostUsd)
+                    }) : null,
+                    row.feedback ? /*#__PURE__*/ _jsx(Chip, {
+                        size: "small",
+                        color: row.feedback === 'up' ? 'success' : 'warning',
+                        label: `Rated ${row.feedback}`
+                    }) : null
+                ]
+            }),
+            /*#__PURE__*/ _jsx(Words, {
+                label: "Question",
+                children: row.question
+            }),
+            /*#__PURE__*/ _jsx(Words, {
+                label: "Answer",
+                children: row.answer
+            })
+        ]
+    });
+const Result = ({ result })=>{
+    switch(result.kind){
+        case 'insight':
+            return /*#__PURE__*/ _jsx(Words, {
+                label: "Answer",
+                children: [
+                    ...result.insights,
+                    ...result.gap ? [
+                        `Not answered: ${result.gap}`
+                    ] : []
+                ].join('\n\n')
+            });
+        case 'crm-record':
+            return /*#__PURE__*/ _jsx(Words, {
+                label: "Summary",
+                children: [
+                    result.summary,
+                    result.standing,
+                    result.nextStep ? `Next step: ${result.nextStep}` : null
+                ].filter(Boolean).join('\n\n')
+            });
+        case 'crm-email':
+            return /*#__PURE__*/ _jsx(Words, {
+                label: "Email draft",
+                children: `Subject: ${result.subject}\n\n${result.body}`
+            });
+        case 'crm-mapping':
+            return /*#__PURE__*/ _jsx(Words, {
+                label: "Column matches",
+                children: result.matches.join('\n')
+            });
+    }
+};
+const JobRow = ({ row })=>/*#__PURE__*/ _jsxs(Stack, {
+        spacing: 1,
+        children: [
+            /*#__PURE__*/ _jsxs(Meta, {
+                children: [
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        sx: {
+                            fontWeight: 600
+                        },
+                        children: who(row.by)
+                    }),
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        children: when(row.at)
+                    }),
+                    /*#__PURE__*/ _jsx(Chip, {
+                        size: "small",
+                        variant: "outlined",
+                        label: row.kind
+                    }),
+                    /*#__PURE__*/ _jsx(Chip, {
+                        size: "small",
+                        color: row.status === 'done' ? 'success' : row.status === 'failed' ? 'error' : 'default',
+                        label: row.status
+                    }),
+                    /*#__PURE__*/ _jsx(Chip, {
+                        size: "small",
+                        variant: "outlined",
+                        label: `${row.credits.toLocaleString()} credits`
+                    })
+                ]
+            }),
+            /*#__PURE__*/ _jsx(Words, {
+                label: "Brief",
+                children: row.brief
+            }),
+            row.result ? /*#__PURE__*/ _jsx(Result, {
+                result: row.result
+            }) : null,
+            row.outputs.length ? /*#__PURE__*/ _jsx(Words, {
+                label: "Made",
+                children: row.outputs.map((output)=>[
+                        output.label,
+                        output.note
+                    ].filter(Boolean).join(' — ')).join('\n')
+            }) : null,
+            row.error ? /*#__PURE__*/ _jsx(Alert, {
+                severity: "error",
+                children: row.error
+            }) : null
+        ]
+    });
+const StaffOrgAiConversations = ({ orgId })=>{
+    const { data: user } = useUser();
+    const userRef = useRef(user);
+    userRef.current = user;
+    const [kind, setKind] = useState(null);
+    const [rows, setRows] = useState([]);
+    // The cursor that opens each page: `cursors[page]` is the `after` its
+    // request carries, so Previous re-reads a page rather than keeping every
+    // page read so far in memory.
+    const [cursors, setCursors] = useState([
+        null
+    ]);
+    const [page, setPage] = useState(0);
+    const [next, setNext] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const load = useCallback(async (target, targetPage, after)=>{
+        const current = userRef.current;
+        if (!current || !orgId) return;
+        setLoading(true);
+        setError(null);
+        try {
+            const params = new URLSearchParams({
+                orgId,
+                kind: target
+            });
+            if (after) params.set('after', after);
+            const response = await authorizedFetch(current, `/api/ai/admin/conversations?${params}`);
+            const payload = await response.json().catch(()=>null);
+            if (!response.ok || !payload) {
+                var _ref;
+                setError((_ref = payload == null ? void 0 : payload.error) != null ? _ref : 'The conversations could not be read.');
+                return;
+            }
+            setRows(payload.rows);
+            setPage(targetPage);
+            setNext(payload.next);
+            setCursors((existing)=>{
+                const kept = existing.slice(0, targetPage + 1);
+                return payload.next ? [
+                    ...kept,
+                    payload.next
+                ] : kept;
+            });
+        } catch (unused) {
+            setError('The conversations could not be read.');
+        } finally{
+            setLoading(false);
+        }
+    }, [
+        orgId
+    ]);
+    const show = useCallback((target)=>{
+        setKind(target);
+        setRows([]);
+        setNext(null);
+        setPage(0);
+        setCursors([
+            null
+        ]);
+        void load(target, 0, null);
+    }, [
+        load
+    ]);
+    return /*#__PURE__*/ _jsx(CardDisplay, {
+        header: "AI conversations",
+        help: pluginDocsHelp('aiMonitoring', {
+            anchor: '#ai-conversations',
+            excerpt: `What this organization asked ${PLATFORM_BRAND_NAME} AI and what it answered: Assist chat questions and answers, and each AI job’s brief and result. Each page staff read is recorded in the audit log, without the text.`
+        }),
+        HeaderProps: {
+            action: kind === null ? /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                onClick: ()=>show('assist'),
+                children: 'Show conversations'
+            }) : /*#__PURE__*/ _jsxs(ToggleButtonGroup, {
+                size: "small",
+                exclusive: true,
+                value: kind,
+                onChange: (_, value)=>value && show(value),
+                "aria-label": "Which conversations",
+                children: [
+                    /*#__PURE__*/ _jsx(ToggleButton, {
+                        value: "assist",
+                        children: 'Assist chat'
+                    }),
+                    /*#__PURE__*/ _jsx(ToggleButton, {
+                        value: "jobs",
+                        children: 'AI jobs'
+                    })
+                ]
+            })
+        },
+        contentGutterX: true,
+        contentGutterY: true,
+        children: kind === null ? /*#__PURE__*/ _jsx(Typography, {
+            variant: "body2",
+            color: "text.secondary",
+            children: `What people in this organization typed to ${PLATFORM_BRAND_NAME} AI, and what it answered. Opening it is recorded in the audit log.`
+        }) : /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 2,
+            divider: /*#__PURE__*/ _jsx(Divider, {
+                flexItem: true
+            }),
+            children: [
+                error ? /*#__PURE__*/ _jsx(Alert, {
+                    severity: "warning",
+                    children: error
+                }) : null,
+                !loading && !error && !rows.length ? /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    color: "text.secondary",
+                    children: kind === 'assist' ? 'No Assist chat in the last 180 days.' : 'No AI jobs yet.'
+                }) : null,
+                rows.map((row)=>kind === 'assist' ? /*#__PURE__*/ _jsx(AssistRow, {
+                        row: row
+                    }, row.id) : /*#__PURE__*/ _jsx(JobRow, {
+                        row: row
+                    }, row.id)),
+                loading ? /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    color: "text.secondary",
+                    children: 'Loading…'
+                }) : null,
+                rows.length || page > 0 ? /*#__PURE__*/ _jsx(ListPagination, {
+                    page: page,
+                    pageSize: STAFF_AI_CONVERSATIONS_PAGE,
+                    rowCount: rows.length,
+                    hasMore: Boolean(next),
+                    disabled: loading,
+                    onPageChange: (target)=>{
+                        var _cursors_target;
+                        return void load(kind, target, (_cursors_target = cursors[target]) != null ? _cursors_target : null);
+                    }
+                }) : null
+            ]
+        })
+    });
+};
+StaffOrgAiConversations.displayName = 'StaffOrgAiConversations';
+export default StaffOrgAiConversations;
+
+//# sourceMappingURL=staff-org-ai-conversations.component.js.map

package/src/lib/components/staff-org-ai-conversations.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/staff-org-ai-conversations.component.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n'use client'\n\nimport { PLATFORM_BRAND_NAME } from '@aglyn/aglyn'\nimport { pluginDocsHelp } from '@aglyn/aglyn/app-utils/docs-help'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { ListPagination } from '@aglyn/shared-ui-jsx/components/list-pagination.component'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport {\n  Alert,\n  Box,\n  Button,\n  Chip,\n  Divider,\n  Stack,\n  ToggleButton,\n  ToggleButtonGroup,\n  Typography,\n} from '@mui/material'\nimport { useCallback, useRef, useState, type ReactNode } from 'react'\nimport {\n  STAFF_AI_CONVERSATIONS_PAGE,\n  type StaffAiAssistRow,\n  type StaffAiConversationKind,\n  type StaffAiConversationPerson,\n  type StaffAiConversationsResponse,\n  type StaffAiJobResult,\n  type StaffAiJobRow,\n} from '../usage/staff-org-ai-conversations'\n\n/**\n * What an organization asked Aglyn AI and what it answered (AGL-3675): the\n * Assist chat's questions and answers, and each AI job's brief and result,\n * newest first, on the staff org page.\n *\n * Nothing is read until staff ask: the route writes an audited access row\n * for every page it returns, so a card that loaded with the page would log\n * reads nobody chose to make.\n */\n\nconst when = (iso: string | null) => (iso ? new Date(iso).toLocaleString() : 'Unknown time')\n\nconst who = (person: StaffAiConversationPerson) =>\n  person.email ?? person.name ?? (person.uid ? `uid ${person.uid}` : 'Unknown member')\n\nconst money = (value: number | null) => (value === null ? null : `$${value.toFixed(value < 1 ? 4 : 2)}`)\n\n/** A block of what someone typed or what came back, kept as written. */\nconst Words = ({ label, children }: { label: string; children: string }) => (\n  <Box>\n    <Typography variant=\"overline\" color=\"text.secondary\">\n      {label}\n    </Typography>\n    <Typography variant=\"body2\" sx={{ whiteSpace: 'pre-wrap', overflowWrap: 'anywhere' }}>\n      {children || '—'}\n    </Typography>\n  </Box>\n)\n\nconst Meta = ({ children }: { children: ReactNode }) => (\n  <Stack direction=\"row\" useFlexGap sx={{ flexWrap: 'wrap', gap: 1, alignItems: 'center' }}>\n    {children}\n  </Stack>\n)\n\nconst AssistRow = ({ row }: { row: StaffAiAssistRow }) => (\n  <Stack spacing={1}>\n    <Meta>\n      <Typography variant=\"body2\" sx={{ fontWeight: 600 }}>\n        {who(row.by)}\n      </Typography>\n      <Typography variant=\"body2\" color=\"text.secondary\">\n        {when(row.at)}\n      </Typography>\n      {row.route ? <Chip size=\"small\" variant=\"outlined\" label={row.route} /> : null}\n      {row.model ? <Chip size=\"small\" variant=\"outlined\" label={row.model} /> : null}\n      {money(row.estCostUsd) ? <Chip size=\"small\" variant=\"outlined\" label={money(row.estCostUsd)} /> : null}\n      {row.feedback ? (\n        <Chip size=\"small\" color={row.feedback === 'up' ? 'success' : 'warning'} label={`Rated ${row.feedback}`} />\n      ) : null}\n    </Meta>\n    <Words label=\"Question\">{row.question}</Words>\n    <Words label=\"Answer\">{row.answer}</Words>\n  </Stack>\n)\n\nconst Result = ({ result }: { result: StaffAiJobResult }) => {\n  switch (result.kind) {\n    case 'insight':\n      return (\n        <Words label=\"Answer\">\n          {[...result.insights, ...(result.gap ? [`Not answered: ${result.gap}`] : [])].join('\\n\\n')}\n        </Words>\n      )\n    case 'crm-record':\n      return (\n        <Words label=\"Summary\">\n          {[result.summary, result.standing, result.nextStep ? `Next step: ${result.nextStep}` : null]\n            .filter(Boolean)\n            .join('\\n\\n')}\n        </Words>\n      )\n    case 'crm-email':\n      return <Words label=\"Email draft\">{`Subject: ${result.subject}\\n\\n${result.body}`}</Words>\n    case 'crm-mapping':\n      return <Words label=\"Column matches\">{result.matches.join('\\n')}</Words>\n  }\n}\n\nconst JobRow = ({ row }: { row: StaffAiJobRow }) => (\n  <Stack spacing={1}>\n    <Meta>\n      <Typography variant=\"body2\" sx={{ fontWeight: 600 }}>\n        {who(row.by)}\n      </Typography>\n      <Typography variant=\"body2\" color=\"text.secondary\">\n        {when(row.at)}\n      </Typography>\n      <Chip size=\"small\" variant=\"outlined\" label={row.kind} />\n      <Chip\n        size=\"small\"\n        color={row.status === 'done' ? 'success' : row.status === 'failed' ? 'error' : 'default'}\n        label={row.status}\n      />\n      <Chip size=\"small\" variant=\"outlined\" label={`${row.credits.toLocaleString()} credits`} />\n    </Meta>\n    <Words label=\"Brief\">{row.brief}</Words>\n    {row.result ? <Result result={row.result} /> : null}\n    {row.outputs.length ? (\n      <Words label=\"Made\">\n        {row.outputs\n          .map((output) => [output.label, output.note].filter(Boolean).join(' — '))\n          .join('\\n')}\n      </Words>\n    ) : null}\n    {row.error ? <Alert severity=\"error\">{row.error}</Alert> : null}\n  </Stack>\n)\n\nconst StaffOrgAiConversations = ({ orgId }: { orgId: string }) => {\n  const { data: user } = useUser()\n  const userRef = useRef(user)\n  userRef.current = user\n  const [kind, setKind] = useState<StaffAiConversationKind | null>(null)\n  const [rows, setRows] = useState<Array<StaffAiAssistRow | StaffAiJobRow>>([])\n  // The cursor that opens each page: `cursors[page]` is the `after` its\n  // request carries, so Previous re-reads a page rather than keeping every\n  // page read so far in memory.\n  const [cursors, setCursors] = useState<Array<string | null>>([null])\n  const [page, setPage] = useState(0)\n  const [next, setNext] = useState<string | null>(null)\n  const [loading, setLoading] = useState(false)\n  const [error, setError] = useState<string | null>(null)\n\n  const load = useCallback(\n    async (target: StaffAiConversationKind, targetPage: number, after: string | null) => {\n      const current = userRef.current\n      if (!current || !orgId) return\n      setLoading(true)\n      setError(null)\n      try {\n        const params = new URLSearchParams({ orgId, kind: target })\n        if (after) params.set('after', after)\n        const response = await authorizedFetch(current, `/api/ai/admin/conversations?${params}`)\n        const payload = (await response.json().catch(() => null)) as\n          | (StaffAiConversationsResponse & { error?: string })\n          | null\n        if (!response.ok || !payload) {\n          setError(payload?.error ?? 'The conversations could not be read.')\n          return\n        }\n        setRows(payload.rows)\n        setPage(targetPage)\n        setNext(payload.next)\n        setCursors((existing) => {\n          const kept = existing.slice(0, targetPage + 1)\n          return payload.next ? [...kept, payload.next] : kept\n        })\n      } catch {\n        setError('The conversations could not be read.')\n      } finally {\n        setLoading(false)\n      }\n    },\n    [orgId],\n  )\n\n  const show = useCallback(\n    (target: StaffAiConversationKind) => {\n      setKind(target)\n      setRows([])\n      setNext(null)\n      setPage(0)\n      setCursors([null])\n      void load(target, 0, null)\n    },\n    [load],\n  )\n\n  return (\n    <CardDisplay\n      header=\"AI conversations\"\n      help={pluginDocsHelp('aiMonitoring', {\n        anchor: '#ai-conversations',\n        excerpt:\n          `What this organization asked ${PLATFORM_BRAND_NAME} AI and what it answered: Assist chat questions and answers, and each AI job’s brief and result. Each page staff read is recorded in the audit log, without the text.`,\n      })}\n      HeaderProps={{\n        action:\n          kind === null ? (\n            <Button size=\"small\" onClick={() => show('assist')}>\n              {'Show conversations'}\n            </Button>\n          ) : (\n            <ToggleButtonGroup\n              size=\"small\"\n              exclusive\n              value={kind}\n              onChange={(_, value: StaffAiConversationKind | null) => value && show(value)}\n              aria-label=\"Which conversations\"\n            >\n              <ToggleButton value=\"assist\">{'Assist chat'}</ToggleButton>\n              <ToggleButton value=\"jobs\">{'AI jobs'}</ToggleButton>\n            </ToggleButtonGroup>\n          ),\n      }}\n      contentGutterX\n      contentGutterY\n    >\n      {kind === null ? (\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {`What people in this organization typed to ${PLATFORM_BRAND_NAME} AI, and what it answered. Opening it is recorded in the audit log.`}\n        </Typography>\n      ) : (\n        <Stack spacing={2} divider={<Divider flexItem />}>\n          {error ? <Alert severity=\"warning\">{error}</Alert> : null}\n          {!loading && !error && !rows.length ? (\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {kind === 'assist'\n                ? 'No Assist chat in the last 180 days.'\n                : 'No AI jobs yet.'}\n            </Typography>\n          ) : null}\n          {rows.map((row) =>\n            kind === 'assist' ? (\n              <AssistRow key={row.id} row={row as StaffAiAssistRow} />\n            ) : (\n              <JobRow key={row.id} row={row as StaffAiJobRow} />\n            ),\n          )}\n          {loading ? (\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {'Loading…'}\n            </Typography>\n          ) : null}\n          {rows.length || page > 0 ? (\n            <ListPagination\n              page={page}\n              pageSize={STAFF_AI_CONVERSATIONS_PAGE}\n              rowCount={rows.length}\n              hasMore={Boolean(next)}\n              disabled={loading}\n              onPageChange={(target) => void load(kind, target, cursors[target] ?? null)}\n            />\n          ) : null}\n        </Stack>\n      )}\n    </CardDisplay>\n  )\n}\n\nStaffOrgAiConversations.displayName = 'StaffOrgAiConversations'\n\nexport default StaffOrgAiConversations\n"],"names":["PLATFORM_BRAND_NAME","pluginDocsHelp","CardDisplay","ListPagination","authorizedFetch","useUser","Alert","Box","Button","Chip","Divider","Stack","ToggleButton","ToggleButtonGroup","Typography","useCallback","useRef","useState","STAFF_AI_CONVERSATIONS_PAGE","when","iso","Date","toLocaleString","who","person","email","name","uid","money","value","toFixed","Words","label","children","variant","color","sx","whiteSpace","overflowWrap","Meta","direction","useFlexGap","flexWrap","gap","alignItems","AssistRow","row","spacing","fontWeight","by","at","route","size","model","estCostUsd","feedback","question","answer","Result","result","kind","insights","join","summary","standing","nextStep","filter","Boolean","subject","body","matches","JobRow","status","credits","brief","outputs","length","map","output","note","error","severity","StaffOrgAiConversations","orgId","data","user","userRef","current","setKind","rows","setRows","cursors","setCursors","page","setPage","next","setNext","loading","setLoading","setError","load","target","targetPage","after","params","URLSearchParams","set","response","payload","json","catch","ok","existing","kept","slice","show","header","help","anchor","excerpt","HeaderProps","action","onClick","exclusive","onChange","_","aria-label","contentGutterX","contentGutterY","divider","flexItem","id","pageSize","rowCount","hasMore","disabled","onPageChange","displayName"],"mappings":"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"}

package/src/lib/declarations.server.js

@@ -23,7 +23,7 @@ import { listUsageAlertContributors, registerUsageAlertContributor } from "@agly
 import { registerPluginUsageMeter } from "@aglyn/aglyn/plugin-manager/plugin-usage-meters";
 import { registerOperatorAlerts } from "@aglyn/aglyn/plugin-manager/operator-alerts";
 import { AI_PLUGIN_ID, AI_USAGE_METER_ID } from "./constants.js";
-import { AI_PROVIDER_UNAVAILABLE } from "./operator-alerts.js";
+import { AI_BUILD_PARTLY_FAILED, AI_JOB_FAILED, AI_PROVIDER_UNAVAILABLE } from "./operator-alerts.js";
 import { registerAiDeclarations } from "./declarations.js";
 /** The provider-spend staff alerts' contributor id under the plugin. */ const AI_USAGE_ALERTS_ID = 'provider-spend';
 /**
@@ -134,10 +134,13 @@ import { registerAiDeclarations } from "./declarations.js";
             pluginId: AI_PLUGIN_ID
         });
     }
-    // The platform provider account alert (AGL-3377), listed on Staff →
-    // Operator alerts before the first one is ever raised.
+    // The platform provider account alert (AGL-3377), and a job failing or a
+    // build finishing with parts failed on our side (AGL-3683), listed on
+    // Staff → Operator alerts before the first one is raised.
     registerOperatorAlerts([
-        AI_PROVIDER_UNAVAILABLE
+        AI_PROVIDER_UNAVAILABLE,
+        AI_JOB_FAILED,
+        AI_BUILD_PARTLY_FAILED
     ], {
         pluginId: AI_PLUGIN_ID
     });

package/src/lib/declarations.server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/declarations.server.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Each registry from its own module, not the `@aglyn/aglyn/server` barrel:\n// boot needs three registries rather than the whole server surface, and a\n// suite that stubs that barrel wholesale still loads these declarations\n// against the real registries.\nimport {\n  listPluginEventHandlers,\n  registerPluginEventHandler,\n} from '@aglyn/aglyn/plugin-manager/plugin-events'\nimport {\n  listPluginUserErasers,\n  registerPluginUserEraser,\n} from '@aglyn/aglyn/plugin-manager/plugin-user-erasure'\nimport {\n  listUsageAlertContributors,\n  registerUsageAlertContributor,\n} from '@aglyn/aglyn/plugin-manager/usage-alert-contributors'\nimport { registerPluginUsageMeter } from '@aglyn/aglyn/plugin-manager/plugin-usage-meters'\nimport { registerOperatorAlerts } from '@aglyn/aglyn/plugin-manager/operator-alerts'\nimport { AI_PLUGIN_ID, AI_USAGE_METER_ID } from './constants'\nimport { AI_PROVIDER_UNAVAILABLE } from './operator-alerts'\nimport { registerAiDeclarations } from './declarations'\n\n/** The provider-spend staff alerts' contributor id under the plugin. */\nconst AI_USAGE_ALERTS_ID = 'provider-spend'\n\n/**\n * The plugin's SERVER declarations (AGL-2939): what the server must know\n * at boot, before any door of the plugin has been called. The two platform\n * events the plugin writes activity for — the AI add-on bought or dropped,\n * an `ai.*` permission moved — are raised by core billing and membership\n * routes that never load the plugin's API surface, so the subscriptions\n * have to be in place from the first request. So does the eraser: an\n * account erasure is a core route too, and a person's AI usage months sit\n * under each org, keyed by the uid, where no core delete reaches them. So\n * does the usage alert contributor (AGL-2984): the usage-alerts sweep is a\n * core cron, and it evaluates the plugin's staff alerts on provider spend for\n * every org it reads.\n *\n * Light at boot by construction: the writers behind the handlers are\n * imported when the first event arrives, and the alert rules when the sweep\n * first evaluates an org, not when the process starts, so the boot cost is\n * the registration and nothing that touches Firestore.\n */\nexport function registerAiServerDeclarations(): void {\n  registerAiDeclarations()\n  // Idempotent against each REGISTRY rather than a module flag, so a\n  // registry reset (a spec) or a second module instance registers again.\n  if (!listPluginEventHandlers('org.seatAddons.changed').includes(AI_PLUGIN_ID)) {\n    registerPluginEventHandler(\n      'org.seatAddons.changed',\n      async ({ orgId, actor, before, after }) => {\n        const { logAiAddonChanged } = await import('./activity/ai-activity')\n        await logAiAddonChanged(orgId, actor, { before, after })\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'org.permissions.changed',\n      async ({ orgId, actor, subject, permission, granted }) => {\n        if (!permission.startsWith('ai.')) return\n        const { logAiPermissionChanged } = await import('./activity/ai-activity')\n        await logAiPermissionChanged(orgId, actor, { subject, permission, granted })\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // THE PLATFORM'S BILLING EVENTS (AGL-3011). Subscribed at boot for the\n  // same reason as the two above: they are raised by the billing webhook,\n  // which never loads an AI door, and a workspace's overage standing moving\n  // late is a workspace charged or refused against a fact we already had.\n  //\n  // The handler modules are imported when the first event arrives, so a\n  // process that never receives one pays only for the registration.\n  if (!listPluginEventHandlers('billing.invoice.paid').includes(AI_PLUGIN_ID)) {\n    registerPluginEventHandler(\n      'billing.invoice.paid',\n      async (payload) => {\n        const { onAiBillingInvoicePaid } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoicePaid(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.invoice.failed',\n      async (payload) => {\n        const { onAiBillingInvoiceFailed } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoiceFailed(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.invoice.closed',\n      async (payload) => {\n        const { onAiBillingInvoiceClosed } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoiceClosed(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.dispute.opened',\n      async (payload) => {\n        const { onAiBillingDisputeOpened } = await import('./billing/ai-overage-events')\n        await onAiBillingDisputeOpened(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.paymentMethod.changed',\n      async (payload) => {\n        const { onAiBillingPaymentMethodChanged } = await import(\n          './billing/ai-overage-events'\n        )\n        await onAiBillingPaymentMethodChanged(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // The plugin's meter in the monthly usage sweep: the month's provider spend\n  // onto the rollup, the credits past the band onto the invoice, and — from\n  // the cutover month (AGL-3011) — the close-out of what the plugin invoices\n  // itself. Registered at boot because the sweep is a core cron, and declared\n  // in `usageAxes` so the sweep refuses to bill a month without it. The same\n  // registration again replaces itself.\n  registerPluginUsageMeter({\n    pluginId: AI_PLUGIN_ID,\n    id: AI_USAGE_METER_ID,\n    measure: async (context) => {\n      const { measureAiMonth } = await import('./billing/ai-month-meter')\n      return measureAiMonth(context)\n    },\n    closeMonth: async (context) => {\n      const { closeAiMonth } = await import('./billing/ai-month-meter')\n      await closeAiMonth(context)\n    },\n  })\n  if (!listPluginUserErasers().includes(AI_PLUGIN_ID)) {\n    registerPluginUserEraser(\n      async (request) => {\n        const { eraseAiUsageForUser } = await import('./usage/ai-usage-eraser')\n        return eraseAiUsageForUser(request)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // The platform provider account alert (AGL-3377), listed on Staff →\n  // Operator alerts before the first one is ever raised.\n  registerOperatorAlerts([AI_PROVIDER_UNAVAILABLE], { pluginId: AI_PLUGIN_ID })\n  if (\n    !listUsageAlertContributors().some(\n      (contributor) =>\n        contributor.pluginId === AI_PLUGIN_ID &&\n        contributor.id === AI_USAGE_ALERTS_ID,\n    )\n  ) {\n    registerUsageAlertContributor({\n      pluginId: AI_PLUGIN_ID,\n      id: AI_USAGE_ALERTS_ID,\n      evaluate: async (context) => {\n        const { evaluateAiUsageAlerts } = await import('./usage/ai-usage-alerts')\n        await evaluateAiUsageAlerts(context)\n      },\n      quotaChecks: async (context) => {\n        const { aiQuotaChecks } = await import('./usage/ai-quota-checks')\n        return aiQuotaChecks(context)\n      },\n    })\n  }\n}\n\nregisterAiServerDeclarations()\n"],"names":["listPluginEventHandlers","registerPluginEventHandler","listPluginUserErasers","registerPluginUserEraser","listUsageAlertContributors","registerUsageAlertContributor","registerPluginUsageMeter","registerOperatorAlerts","AI_PLUGIN_ID","AI_USAGE_METER_ID","AI_PROVIDER_UNAVAILABLE","registerAiDeclarations","AI_USAGE_ALERTS_ID","registerAiServerDeclarations","includes","orgId","actor","before","after","logAiAddonChanged","pluginId","subject","permission","granted","startsWith","logAiPermissionChanged","payload","onAiBillingInvoicePaid","onAiBillingInvoiceFailed","onAiBillingInvoiceClosed","onAiBillingDisputeOpened","onAiBillingPaymentMethodChanged","id","measure","context","measureAiMonth","closeMonth","closeAiMonth","request","eraseAiUsageForUser","some","contributor","evaluate","evaluateAiUsageAlerts","quotaChecks","aiQuotaChecks"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/declarations.server.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Each registry from its own module, not the `@aglyn/aglyn/server` barrel:\n// boot needs three registries rather than the whole server surface, and a\n// suite that stubs that barrel wholesale still loads these declarations\n// against the real registries.\nimport {\n  listPluginEventHandlers,\n  registerPluginEventHandler,\n} from '@aglyn/aglyn/plugin-manager/plugin-events'\nimport {\n  listPluginUserErasers,\n  registerPluginUserEraser,\n} from '@aglyn/aglyn/plugin-manager/plugin-user-erasure'\nimport {\n  listUsageAlertContributors,\n  registerUsageAlertContributor,\n} from '@aglyn/aglyn/plugin-manager/usage-alert-contributors'\nimport { registerPluginUsageMeter } from '@aglyn/aglyn/plugin-manager/plugin-usage-meters'\nimport { registerOperatorAlerts } from '@aglyn/aglyn/plugin-manager/operator-alerts'\nimport { AI_PLUGIN_ID, AI_USAGE_METER_ID } from './constants'\nimport { AI_BUILD_PARTLY_FAILED, AI_JOB_FAILED, AI_PROVIDER_UNAVAILABLE } from './operator-alerts'\nimport { registerAiDeclarations } from './declarations'\n\n/** The provider-spend staff alerts' contributor id under the plugin. */\nconst AI_USAGE_ALERTS_ID = 'provider-spend'\n\n/**\n * The plugin's SERVER declarations (AGL-2939): what the server must know\n * at boot, before any door of the plugin has been called. The two platform\n * events the plugin writes activity for — the AI add-on bought or dropped,\n * an `ai.*` permission moved — are raised by core billing and membership\n * routes that never load the plugin's API surface, so the subscriptions\n * have to be in place from the first request. So does the eraser: an\n * account erasure is a core route too, and a person's AI usage months sit\n * under each org, keyed by the uid, where no core delete reaches them. So\n * does the usage alert contributor (AGL-2984): the usage-alerts sweep is a\n * core cron, and it evaluates the plugin's staff alerts on provider spend for\n * every org it reads.\n *\n * Light at boot by construction: the writers behind the handlers are\n * imported when the first event arrives, and the alert rules when the sweep\n * first evaluates an org, not when the process starts, so the boot cost is\n * the registration and nothing that touches Firestore.\n */\nexport function registerAiServerDeclarations(): void {\n  registerAiDeclarations()\n  // Idempotent against each REGISTRY rather than a module flag, so a\n  // registry reset (a spec) or a second module instance registers again.\n  if (!listPluginEventHandlers('org.seatAddons.changed').includes(AI_PLUGIN_ID)) {\n    registerPluginEventHandler(\n      'org.seatAddons.changed',\n      async ({ orgId, actor, before, after }) => {\n        const { logAiAddonChanged } = await import('./activity/ai-activity')\n        await logAiAddonChanged(orgId, actor, { before, after })\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'org.permissions.changed',\n      async ({ orgId, actor, subject, permission, granted }) => {\n        if (!permission.startsWith('ai.')) return\n        const { logAiPermissionChanged } = await import('./activity/ai-activity')\n        await logAiPermissionChanged(orgId, actor, { subject, permission, granted })\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // THE PLATFORM'S BILLING EVENTS (AGL-3011). Subscribed at boot for the\n  // same reason as the two above: they are raised by the billing webhook,\n  // which never loads an AI door, and a workspace's overage standing moving\n  // late is a workspace charged or refused against a fact we already had.\n  //\n  // The handler modules are imported when the first event arrives, so a\n  // process that never receives one pays only for the registration.\n  if (!listPluginEventHandlers('billing.invoice.paid').includes(AI_PLUGIN_ID)) {\n    registerPluginEventHandler(\n      'billing.invoice.paid',\n      async (payload) => {\n        const { onAiBillingInvoicePaid } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoicePaid(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.invoice.failed',\n      async (payload) => {\n        const { onAiBillingInvoiceFailed } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoiceFailed(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.invoice.closed',\n      async (payload) => {\n        const { onAiBillingInvoiceClosed } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoiceClosed(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.dispute.opened',\n      async (payload) => {\n        const { onAiBillingDisputeOpened } = await import('./billing/ai-overage-events')\n        await onAiBillingDisputeOpened(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.paymentMethod.changed',\n      async (payload) => {\n        const { onAiBillingPaymentMethodChanged } = await import(\n          './billing/ai-overage-events'\n        )\n        await onAiBillingPaymentMethodChanged(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // The plugin's meter in the monthly usage sweep: the month's provider spend\n  // onto the rollup, the credits past the band onto the invoice, and — from\n  // the cutover month (AGL-3011) — the close-out of what the plugin invoices\n  // itself. Registered at boot because the sweep is a core cron, and declared\n  // in `usageAxes` so the sweep refuses to bill a month without it. The same\n  // registration again replaces itself.\n  registerPluginUsageMeter({\n    pluginId: AI_PLUGIN_ID,\n    id: AI_USAGE_METER_ID,\n    measure: async (context) => {\n      const { measureAiMonth } = await import('./billing/ai-month-meter')\n      return measureAiMonth(context)\n    },\n    closeMonth: async (context) => {\n      const { closeAiMonth } = await import('./billing/ai-month-meter')\n      await closeAiMonth(context)\n    },\n  })\n  if (!listPluginUserErasers().includes(AI_PLUGIN_ID)) {\n    registerPluginUserEraser(\n      async (request) => {\n        const { eraseAiUsageForUser } = await import('./usage/ai-usage-eraser')\n        return eraseAiUsageForUser(request)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // The platform provider account alert (AGL-3377), and a job failing or a\n  // build finishing with parts failed on our side (AGL-3683), listed on\n  // Staff → Operator alerts before the first one is raised.\n  registerOperatorAlerts([AI_PROVIDER_UNAVAILABLE, AI_JOB_FAILED, AI_BUILD_PARTLY_FAILED], {\n    pluginId: AI_PLUGIN_ID,\n  })\n  if (\n    !listUsageAlertContributors().some(\n      (contributor) =>\n        contributor.pluginId === AI_PLUGIN_ID &&\n        contributor.id === AI_USAGE_ALERTS_ID,\n    )\n  ) {\n    registerUsageAlertContributor({\n      pluginId: AI_PLUGIN_ID,\n      id: AI_USAGE_ALERTS_ID,\n      evaluate: async (context) => {\n        const { evaluateAiUsageAlerts } = await import('./usage/ai-usage-alerts')\n        await evaluateAiUsageAlerts(context)\n      },\n      quotaChecks: async (context) => {\n        const { aiQuotaChecks } = await import('./usage/ai-quota-checks')\n        return aiQuotaChecks(context)\n      },\n    })\n  }\n}\n\nregisterAiServerDeclarations()\n"],"names":["listPluginEventHandlers","registerPluginEventHandler","listPluginUserErasers","registerPluginUserEraser","listUsageAlertContributors","registerUsageAlertContributor","registerPluginUsageMeter","registerOperatorAlerts","AI_PLUGIN_ID","AI_USAGE_METER_ID","AI_BUILD_PARTLY_FAILED","AI_JOB_FAILED","AI_PROVIDER_UNAVAILABLE","registerAiDeclarations","AI_USAGE_ALERTS_ID","registerAiServerDeclarations","includes","orgId","actor","before","after","logAiAddonChanged","pluginId","subject","permission","granted","startsWith","logAiPermissionChanged","payload","onAiBillingInvoicePaid","onAiBillingInvoiceFailed","onAiBillingInvoiceClosed","onAiBillingDisputeOpened","onAiBillingPaymentMethodChanged","id","measure","context","measureAiMonth","closeMonth","closeAiMonth","request","eraseAiUsageForUser","some","contributor","evaluate","evaluateAiUsageAlerts","quotaChecks","aiQuotaChecks"],"mappings":"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"}

package/src/lib/jobs/ai-build-capabilities.d.ts

@@ -17,8 +17,16 @@
 import type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types';
 import { type PluginAiCapability, type ResolvedPluginAiCapability } from '@aglyn/aglyn/plugin-manager/plugin-ai-capabilities';
 import type { AiBuildOps } from '../model/ai-build-job';
+import { type AiPluginDraftOwnerLookup } from './ai-job-plugin-drafts';
 /** The operations this plugin owns, as it registers them. */
 export declare const AI_OWNED_CAPABILITIES: readonly PluginAiCapability[];
+/**
+ * The resource another plugin writes for each operation of this plugin's that
+ * cannot be built without it. The operation runs where that writer's owner
+ * runs — registered, switched on for the workspace and the site, and past its
+ * release flag — exactly as an operation that owner registered would.
+ */
+export declare const AI_OWNED_OP_WRITERS: Readonly<Partial<Record<string, string>>>;
 /** Registers this plugin's build operations; the console surface calls it. */
 export declare function registerAiBuildCapabilities(): void;
 /** What decides which operations a build may use here. */
@@ -37,11 +45,15 @@ export interface AiBuildOpsDeps {
     releasedPlugins?: (pluginIds: string[], orgId: string) => Promise<string[]>;
     /** Whether a runner is registered for a kind; the machine's otherwise. */
     hasRunner?: (kind: string) => boolean;
+    /** Which plugin writes a resource; the core's registry otherwise. */
+    writerOwner?: AiPluginDraftOwnerLookup;
 }
 /**
  * The operations a build may plan on this site, by op (AGL-3616): every
  * registered capability whose owner runs here — switched on for the
- * workspace and the site, past its release flag — whose entitlement the plan
+ * workspace and the site, past its release flag; for one of this plugin's
+ * operations another plugin writes (`AI_OWNED_OP_WRITERS`), that writer's
+ * owner, and a writer registered at all — whose entitlement the plan
  * holds, which the Free taste may use where the workspace is on it, and,
  * for an AI-run operation, whose runner this process loaded. One release-flag
  * read for every owner at once. What a member may do and what an allowance