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

package/src/lib/components/ai-job-plan.component.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-job-plan.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\nimport {\n  AI_BUILD_PLAN_CREATION_NOUNS,\n  AI_BUILD_PLAN_EMBED_HOST_NAMES,\n  isAiPlanNewRef,\n  type AiBuildPlanEmbed,\n} from '../model/ai-build-plan'\nimport type { AiJobReview, AiJobSummary } from '../model/ai-jobs.types'\nimport { aiJobPlanCreditEstimate } from '../model/ai-site-job'\nimport { Box, Button, Collapse, Stack, Typography } from '@mui/material'\nimport { useState } from 'react'\n\n/**\n * A job's plan and what it waits for (AGL-2935), inside the AI jobs drawer:\n * what the job reuses from the site, what it creates and why, the screens it\n * builds — and, while the job waits for a person, the one button that\n * confirms the plan or tries a refused step again. The drawer owns the\n * request; this renders.\n */\nexport interface AiJobPlanProps {\n  job: AiJobSummary\n  /** Confirms the plan, or tries the refused step again. */\n  onResume: (job: AiJobSummary) => void\n  /** A resume for this job is in flight. */\n  busy?: boolean\n  /**\n   * The viewer is staff (AGL-3078), who can open where a refused answer broke\n   * its rules and the outline of those parts, to tell a shape the rules should\n   * allow from an answer that ignored its re-ask. A member reads the findings.\n   */\n  staff?: boolean\n}\n\n/**\n * Where a refused answer broke its rules, and the outline of those parts, as\n * lines staff read (AGL-3078): each finding with the nodes or plan entries it\n * names, then each outlined node indented by its depth, with its element, a\n * Grid's layout as written, and the names of what it sets and holds.\n */\nexport function aiJobReviewDetails(review: AiJobReview | null): string[] {\n  if (review?.reason !== 'doctrine') return []\n  const lines = review.findings.flatMap((finding) => {\n    const where = finding.nodeIds?.length\n      ? `nodes ${finding.nodeIds.join(', ')}`\n      : finding.paths?.length\n        ? `at ${finding.paths.join(', ')}`\n        : null\n    return where ? [`${finding.rule === null ? '' : `Rule ${finding.rule} `}${finding.code}: ${where}`] : []\n  })\n  for (const node of review.outline ?? []) {\n    lines.push(\n      [\n        `${'  '.repeat(node.depth)}${node.id} ${node.componentId}`,\n        ...Object.entries(node.grid ?? {}).map(([name, value]) => `${name}=${JSON.stringify(value)}`),\n        ...(node.props.length ? [`props ${node.props.join(', ')}`] : []),\n        ...(node.sx?.length ? [`sx ${node.sx.join(', ')}`] : []),\n        ...(node.children.length ? [`holds ${node.children.join(', ')}`] : []),\n      ].join(' · '),\n    )\n  }\n  return lines\n}\n\n/**\n * A third-party player the plan lists, with what it costs the page, read\n * before the member confirms it (rule 16, AGL-3433). The cost is the\n * platform's sentence, never the model's: the player is framed lazily, so its\n * host's code loads when a visitor reaches it, whether or not they press play.\n */\nexport function aiPlanEmbedLine(\n  embed: AiBuildPlanEmbed,\n  named: (ref: string) => string,\n): string {\n  const host = AI_BUILD_PLAN_EMBED_HOST_NAMES[embed.host]\n  const where = isAiPlanNewRef(embed.where) ? `the component ${named(embed.where)}` : embed.where\n  const link = embed.url ? ` playing ${embed.url}` : ', its link left for you to paste'\n  return `Embeds a ${host} player on ${where}${link}, as you asked (“${embed.asked}”). It loads ${host}’s own code when a visitor reaches it, whether or not they press play.`\n}\n\nexport function AiJobPlan({\n  job,\n  onResume,\n  busy = false,\n  staff = false,\n}: AiJobPlanProps): JSX.Element | null {\n  const [detailsOpen, setDetailsOpen] = useState(false)\n  const { plan, review } = job\n  if (!plan && !review) return null\n  const details = staff ? aiJobReviewDetails(review) : []\n  /** A reference as a person reads it: the record's name, or what the plan creates. */\n  const named = (ref: string | null): string =>\n    !ref\n      ? ''\n      : isAiPlanNewRef(ref)\n        ? ref.slice('new:'.length)\n        : (plan?.labels[ref] ?? ref)\n  const waiting = job.status === 'needs_review' && review !== null\n  // The guard rail (AGL-2911): what the plan is estimated to cost is read\n  // before it is confirmed, not after it has been spent. An estimate, and\n  // said to be one — the plan's own passes at the nominal credits a step\n  // holds, where what a step really costs is its model's tokens. A page job\n  // counts the creations it builds before its page (AGL-3031).\n  const estimate =\n    plan && waiting && review.reason === 'plan' ? aiJobPlanCreditEstimate(job.kind, plan) : 0\n  return (\n    <Box sx={{ mt: 1 }}>\n      {plan && (\n        <Stack spacing={0.5} role=\"list\" aria-label=\"Plan\">\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {plan.status === 'confirmed' ? 'Confirmed plan' : 'Proposed plan'}\n          </Typography>\n          {plan.reuse.map((entry, index) => (\n            <Typography key={`reuse-${index}`} variant=\"body2\" role=\"listitem\">\n              Reuses the {entry.kind === 'screen' ? 'page' : entry.kind} {named(entry.id)} — {entry.purpose}\n            </Typography>\n          ))}\n          {plan.create.map((entry, index) => (\n            <Typography key={`create-${index}`} variant=\"body2\" role=\"listitem\">\n              Creates the {AI_BUILD_PLAN_CREATION_NOUNS[entry.kind].noun} {entry.name}\n              {entry.duplicateOf\n                ? `, from a copy of ${named(entry.duplicateOf)}`\n                : ''}{' '}\n              — {entry.why}\n            </Typography>\n          ))}\n          {plan.screens.map((screen, index) => (\n            <Typography key={`screen-${index}`} variant=\"body2\" role=\"listitem\">\n              {screen.record\n                ? `Builds the record template ${screen.title}, a page per record of ${named(screen.record.dataset)} at /${screen.record.base}/…`\n                : `Builds the page ${screen.title} at ${screen.slug}`}\n              {screen.duplicateOf\n                ? `, from a copy of ${named(screen.duplicateOf)}`\n                : ''}\n              {screen.layout ? ` in ${named(screen.layout)}` : ''}\n              {screen.sections.length\n                ? `: ${screen.sections.map((section) => section.name).join(', ')}`\n                : ''}\n            </Typography>\n          ))}\n          {(plan.embeds ?? []).map((embed, index) => (\n            <Typography key={`embed-${index}`} variant=\"body2\" role=\"listitem\">\n              {aiPlanEmbedLine(embed, named)}\n            </Typography>\n          ))}\n        </Stack>\n      )}\n      {review?.reason === 'doctrine' && review.findings.length > 0 && (\n        <Box\n          component=\"ul\"\n          sx={{ my: 0.5, pl: 2.5 }}\n          aria-label=\"Building rules broken\"\n        >\n          {review.findings.map((finding, index) => (\n            <Typography\n              key={`finding-${index}`}\n              component=\"li\"\n              variant=\"caption\"\n            >\n              {finding.message}\n            </Typography>\n          ))}\n        </Box>\n      )}\n      {details.length > 0 && (\n        <Box sx={{ mt: 0.5 }}>\n          <Button\n            size=\"small\"\n            aria-expanded={detailsOpen}\n            onClick={() => setDetailsOpen((prior) => !prior)}\n          >\n            {detailsOpen ? 'Hide what was refused' : 'Show what was refused'}\n          </Button>\n          <Collapse in={detailsOpen} unmountOnExit>\n            <Typography\n              variant=\"caption\"\n              component=\"pre\"\n              aria-label=\"What was refused\"\n              sx={{ m: 0, fontFamily: 'monospace', whiteSpace: 'pre', overflowX: 'auto' }}\n            >\n              {details.join('\\n')}\n            </Typography>\n          </Collapse>\n        </Box>\n      )}\n      {estimate > 0 && (\n        <Typography\n          variant=\"caption\"\n          color=\"text.secondary\"\n          sx={{ display: 'block', mt: 1 }}\n        >\n          {`Estimated cost: about ${estimate.toLocaleString('en-US')} credits. What it costs is what its steps spend.`}\n        </Typography>\n      )}\n      {waiting && (\n        <Button\n          size=\"small\"\n          variant=\"contained\"\n          disabled={busy}\n          onClick={() => onResume(job)}\n          sx={{ mt: 1 }}\n        >\n          {review.reason === 'plan' ? 'Confirm plan' : 'Try again'}\n        </Button>\n      )}\n    </Box>\n  )\n}\n\nexport default AiJobPlan\n"],"names":["AI_BUILD_PLAN_CREATION_NOUNS","AI_BUILD_PLAN_EMBED_HOST_NAMES","isAiPlanNewRef","aiJobPlanCreditEstimate","Box","Button","Collapse","Stack","Typography","useState","aiJobReviewDetails","review","reason","lines","findings","flatMap","finding","where","nodeIds","length","join","paths","rule","code","node","outline","push","repeat","depth","id","componentId","Object","entries","grid","map","name","value","JSON","stringify","props","sx","children","aiPlanEmbedLine","embed","named","host","link","url","asked","AiJobPlan","job","onResume","busy","staff","plan","detailsOpen","setDetailsOpen","details","ref","slice","labels","waiting","status","estimate","kind","mt","spacing","role","aria-label","variant","color","reuse","entry","index","purpose","create","noun","duplicateOf","why","screens","screen","record","title","dataset","base","slug","layout","sections","section","embeds","component","my","pl","message","size","aria-expanded","onClick","prior","in","unmountOnExit","m","fontFamily","whiteSpace","overflowX","display","toLocaleString","disabled"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-job-plan.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\nimport {\n  AI_BUILD_PLAN_CREATION_NOUNS,\n  AI_BUILD_PLAN_EMBED_HOST_NAMES,\n  isAiPlanNewRef,\n  type AiBuildPlanEmbed,\n} from '../model/ai-build-plan'\nimport type { AiJobReview, AiJobSummary } from '../model/ai-jobs.types'\nimport { aiJobPlanCreditEstimate } from '../model/ai-site-job'\nimport { aiSiteStarterFallbackOffered } from '../model/ai-job-failure-copy'\nimport { AiSiteStarterFallback } from './ai-site-starter-fallback.component'\nimport { Box, Button, Collapse, Stack, Typography } from '@mui/material'\nimport { useState } from 'react'\n\n/**\n * A job's plan and what it waits for (AGL-2935), inside the AI jobs drawer\n * and the dialog that started the job (AGL-3593): what the job reuses from\n * the site, what it creates and why, the screens it builds — and, while the\n * job waits for a person, the one button that confirms the plan or tries a\n * refused step again. Both send the same request (`resumeAiJobRequest`);\n * this renders.\n */\nexport interface AiJobPlanProps {\n  job: AiJobSummary\n  /** Confirms the plan, or tries the refused step again. */\n  onResume: (job: AiJobSummary) => void\n  /** A resume for this job is in flight. */\n  busy?: boolean\n  /**\n   * The viewer is staff (AGL-3078), who can open where a refused answer broke\n   * its rules and the outline of those parts, to tell a shape the rules should\n   * allow from an answer that ignored its re-ask. A member reads the findings.\n   */\n  staff?: boolean\n  /**\n   * The signed-in user, for \"Use the starter site instead\" on a guided start\n   * that did not work out (AGL-3594); the action is drawn only when given.\n   */\n  user?: Parameters<typeof AiSiteStarterFallback>[0]['user']\n}\n\n/**\n * Where a refused answer broke its rules, and the outline of those parts, as\n * lines staff read (AGL-3078): each finding with the nodes or plan entries it\n * names, then each outlined node indented by its depth, with its element, a\n * Grid's layout as written, and the names of what it sets and holds.\n */\nexport function aiJobReviewDetails(review: AiJobReview | null): string[] {\n  if (review?.reason !== 'doctrine') return []\n  const lines = review.findings.flatMap((finding) => {\n    const where = finding.nodeIds?.length\n      ? `nodes ${finding.nodeIds.join(', ')}`\n      : finding.paths?.length\n        ? `at ${finding.paths.join(', ')}`\n        : null\n    return where ? [`${finding.rule === null ? '' : `Rule ${finding.rule} `}${finding.code}: ${where}`] : []\n  })\n  for (const node of review.outline ?? []) {\n    lines.push(\n      [\n        `${'  '.repeat(node.depth)}${node.id} ${node.componentId}`,\n        ...Object.entries(node.grid ?? {}).map(([name, value]) => `${name}=${JSON.stringify(value)}`),\n        ...(node.props.length ? [`props ${node.props.join(', ')}`] : []),\n        ...(node.sx?.length ? [`sx ${node.sx.join(', ')}`] : []),\n        ...(node.children.length ? [`holds ${node.children.join(', ')}`] : []),\n      ].join(' · '),\n    )\n  }\n  return lines\n}\n\n/**\n * A third-party player the plan lists, with what it costs the page, read\n * before the member confirms it (rule 16, AGL-3433). The cost is the\n * platform's sentence, never the model's: the player is framed lazily, so its\n * host's code loads when a visitor reaches it, whether or not they press play.\n */\nexport function aiPlanEmbedLine(\n  embed: AiBuildPlanEmbed,\n  named: (ref: string) => string,\n): string {\n  const host = AI_BUILD_PLAN_EMBED_HOST_NAMES[embed.host]\n  const where = isAiPlanNewRef(embed.where) ? `the component ${named(embed.where)}` : embed.where\n  const link = embed.url ? ` playing ${embed.url}` : ', its link left for you to paste'\n  return `Embeds a ${host} player on ${where}${link}, as you asked (“${embed.asked}”). It loads ${host}’s own code when a visitor reaches it, whether or not they press play.`\n}\n\nexport function AiJobPlan({\n  job,\n  onResume,\n  busy = false,\n  staff = false,\n  user,\n}: AiJobPlanProps): JSX.Element | null {\n  const [detailsOpen, setDetailsOpen] = useState(false)\n  const { plan, review } = job\n  if (!plan && !review) return null\n  const details = staff ? aiJobReviewDetails(review) : []\n  /** A reference as a person reads it: the record's name, or what the plan creates. */\n  const named = (ref: string | null): string =>\n    !ref\n      ? ''\n      : isAiPlanNewRef(ref)\n        ? ref.slice('new:'.length)\n        : (plan?.labels[ref] ?? ref)\n  const waiting = job.status === 'needs_review' && review !== null\n  // The guard rail (AGL-2911): what the plan is estimated to cost is read\n  // before it is confirmed, not after it has been spent. An estimate, and\n  // said to be one — the plan's own passes at the nominal credits a step\n  // holds, where what a step really costs is its model's tokens. A page job\n  // counts the creations it builds before its page (AGL-3031).\n  const estimate =\n    plan && waiting && review.reason === 'plan' ? aiJobPlanCreditEstimate(job.kind, plan) : 0\n  return (\n    <Box sx={{ mt: 1 }}>\n      {plan && (\n        <Stack spacing={0.5} role=\"list\" aria-label=\"Plan\">\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {plan.status === 'confirmed' ? 'Confirmed plan' : 'Proposed plan'}\n          </Typography>\n          {plan.reuse.map((entry, index) => (\n            <Typography key={`reuse-${index}`} variant=\"body2\" role=\"listitem\">\n              Reuses the {entry.kind === 'screen' ? 'page' : entry.kind} {named(entry.id)} — {entry.purpose}\n            </Typography>\n          ))}\n          {plan.create.map((entry, index) => (\n            <Typography key={`create-${index}`} variant=\"body2\" role=\"listitem\">\n              Creates the {AI_BUILD_PLAN_CREATION_NOUNS[entry.kind].noun} {entry.name}\n              {entry.duplicateOf\n                ? `, from a copy of ${named(entry.duplicateOf)}`\n                : ''}{' '}\n              — {entry.why}\n            </Typography>\n          ))}\n          {plan.screens.map((screen, index) => (\n            <Typography key={`screen-${index}`} variant=\"body2\" role=\"listitem\">\n              {screen.record\n                ? `Builds the record template ${screen.title}, a page per record of ${named(screen.record.dataset)} at /${screen.record.base}/…`\n                : `Builds the page ${screen.title} at ${screen.slug}`}\n              {screen.duplicateOf\n                ? `, from a copy of ${named(screen.duplicateOf)}`\n                : ''}\n              {screen.layout ? ` in ${named(screen.layout)}` : ''}\n              {screen.sections.length\n                ? `: ${screen.sections.map((section) => section.name).join(', ')}`\n                : ''}\n            </Typography>\n          ))}\n          {(plan.embeds ?? []).map((embed, index) => (\n            <Typography key={`embed-${index}`} variant=\"body2\" role=\"listitem\">\n              {aiPlanEmbedLine(embed, named)}\n            </Typography>\n          ))}\n        </Stack>\n      )}\n      {/*\n        A review written for the member (AGL-3594) carries the checks' own\n        sentence as `detail`: its findings are then staff reading too, and the\n        member reads the job's one sentence alone.\n      */}\n      {staff && review?.detail && (\n        <Typography variant=\"caption\" color=\"text.secondary\" component=\"div\" sx={{ mt: 0.5 }}>\n          {review.detail}\n        </Typography>\n      )}\n      {review?.reason === 'doctrine' && review.findings.length > 0 && (staff || !review.detail) && (\n        <Box\n          component=\"ul\"\n          sx={{ my: 0.5, pl: 2.5 }}\n          aria-label=\"Building rules broken\"\n        >\n          {review.findings.map((finding, index) => (\n            <Typography\n              key={`finding-${index}`}\n              component=\"li\"\n              variant=\"caption\"\n            >\n              {finding.message}\n            </Typography>\n          ))}\n        </Box>\n      )}\n      {details.length > 0 && (\n        <Box sx={{ mt: 0.5 }}>\n          <Button\n            size=\"small\"\n            aria-expanded={detailsOpen}\n            onClick={() => setDetailsOpen((prior) => !prior)}\n          >\n            {detailsOpen ? 'Hide what was refused' : 'Show what was refused'}\n          </Button>\n          <Collapse in={detailsOpen} unmountOnExit>\n            <Typography\n              variant=\"caption\"\n              component=\"pre\"\n              aria-label=\"What was refused\"\n              sx={{ m: 0, fontFamily: 'monospace', whiteSpace: 'pre', overflowX: 'auto' }}\n            >\n              {details.join('\\n')}\n            </Typography>\n          </Collapse>\n        </Box>\n      )}\n      {estimate > 0 && (\n        <Typography\n          variant=\"caption\"\n          color=\"text.secondary\"\n          sx={{ display: 'block', mt: 1 }}\n        >\n          {`Estimated cost: about ${estimate.toLocaleString('en-US')} credits. What it costs is what its steps spend.`}\n        </Typography>\n      )}\n      {waiting && review.retryRefusal && review.reason !== 'plan' && (\n        <Typography variant=\"caption\" color=\"text.secondary\" component=\"div\" sx={{ mt: 1 }}>\n          {review.retryRefusal}\n        </Typography>\n      )}\n      {waiting && (\n        <Button\n          size=\"small\"\n          variant=\"contained\"\n          // Disabled with its reason above when the Free allowance left\n          // cannot pay for another try (AGL-3594).\n          disabled={busy || (review.reason !== 'plan' && Boolean(review.retryRefusal))}\n          onClick={() => onResume(job)}\n          sx={{ mt: 1 }}\n        >\n          {review.reason === 'plan' ? 'Confirm plan' : 'Try again'}\n        </Button>\n      )}\n      {/* A guided start that did not work out can take the starter instead (AGL-3594). */}\n      {waiting && user && aiSiteStarterFallbackOffered(job) && <AiSiteStarterFallback job={job} user={user} />}\n    </Box>\n  )\n}\n\nexport default AiJobPlan\n"],"names":["AI_BUILD_PLAN_CREATION_NOUNS","AI_BUILD_PLAN_EMBED_HOST_NAMES","isAiPlanNewRef","aiJobPlanCreditEstimate","aiSiteStarterFallbackOffered","AiSiteStarterFallback","Box","Button","Collapse","Stack","Typography","useState","aiJobReviewDetails","review","reason","lines","findings","flatMap","finding","where","nodeIds","length","join","paths","rule","code","node","outline","push","repeat","depth","id","componentId","Object","entries","grid","map","name","value","JSON","stringify","props","sx","children","aiPlanEmbedLine","embed","named","host","link","url","asked","AiJobPlan","job","onResume","busy","staff","user","plan","detailsOpen","setDetailsOpen","details","ref","slice","labels","waiting","status","estimate","kind","mt","spacing","role","aria-label","variant","color","reuse","entry","index","purpose","create","noun","duplicateOf","why","screens","screen","record","title","dataset","base","slug","layout","sections","section","embeds","detail","component","my","pl","message","size","aria-expanded","onClick","prior","in","unmountOnExit","m","fontFamily","whiteSpace","overflowX","display","toLocaleString","retryRefusal","disabled","Boolean"],"mappings":"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"}

package/src/lib/components/ai-job-requests.d.ts

@@ -0,0 +1,24 @@
+import { type MaybeTokenSource } from '@aglyn/shared-util-http/authorized-token';
+import type { AiJobSummary } from '../model/ai-jobs.types';
+/**
+ * The two decisions a person makes about a job — confirm its plan (or try a
+ * refused step again), and cancel it — as ONE request each, whichever
+ * surface they press it on (AGL-3593). The AI jobs drawer and the dialog that
+ * started the job both call these, so confirming in the dialog is the same
+ * door, the same body and the same answer as confirming in the drawer.
+ *
+ * Each hands the job it gets back to every counting surface, so the top-bar
+ * indicator stops saying "plan ready" the moment the plan is confirmed.
+ */
+/** A door's answer: the job as it now stands, and the refusal when there is one. */
+export interface AiJobDecision {
+    job: AiJobSummary | null;
+    error: string | null;
+}
+/**
+ * Confirms a plan, or tries again a step whose answer broke a building rule
+ * (AGL-2935). The door runs the next step inline and answers with the job.
+ */
+export declare function resumeAiJobRequest(user: MaybeTokenSource, orgId: string, job: Pick<AiJobSummary, 'id' | 'hostId'>): Promise<AiJobDecision>;
+/** Cancels a job that has not settled. */
+export declare function cancelAiJobRequest(user: MaybeTokenSource, orgId: string, jobId: string): Promise<AiJobDecision>;

package/src/lib/components/ai-job-requests.js

@@ -0,0 +1,76 @@
+/**
+ * @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 { publishAiJob } from "./ai-jobs-store.js";
+/**
+ * Confirms a plan, or tries again a step whose answer broke a building rule
+ * (AGL-2935). The door runs the next step inline and answers with the job.
+ */ export async function resumeAiJobRequest(user, orgId, job) {
+    try {
+        var _ref, _ref1;
+        const response = await authorizedFetch(user, `/api/ai/jobs/${encodeURIComponent(job.id)}/resume`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                orgId,
+                hostId: job.hostId
+            })
+        });
+        const payload = await response.json().catch(()=>null);
+        const next = (_ref = payload == null ? void 0 : payload.job) != null ? _ref : null;
+        publishAiJob(next);
+        return {
+            job: next,
+            error: response.ok ? null : String((_ref1 = payload == null ? void 0 : payload.error) != null ? _ref1 : 'The job could not be resumed — try again.')
+        };
+    } catch (unused) {
+        return {
+            job: null,
+            error: 'The job could not be resumed — try again.'
+        };
+    }
+}
+/** Cancels a job that has not settled. */ export async function cancelAiJobRequest(user, orgId, jobId) {
+    try {
+        var _ref, _ref1;
+        const response = await authorizedFetch(user, `/api/ai/jobs/${encodeURIComponent(jobId)}/cancel`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                orgId
+            })
+        });
+        const payload = await response.json().catch(()=>null);
+        const next = (_ref = payload == null ? void 0 : payload.job) != null ? _ref : null;
+        publishAiJob(next);
+        return {
+            job: next,
+            error: response.ok ? null : String((_ref1 = payload == null ? void 0 : payload.error) != null ? _ref1 : 'The job could not be canceled — try again.')
+        };
+    } catch (unused) {
+        return {
+            job: null,
+            error: 'The job could not be canceled — try again.'
+        };
+    }
+}
+
+//# sourceMappingURL=ai-job-requests.js.map

package/src/lib/components/ai-job-requests.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-job-requests.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, type MaybeTokenSource } from '@aglyn/shared-util-http/authorized-token'\nimport type { AiJobSummary } from '../model/ai-jobs.types'\nimport { publishAiJob } from './ai-jobs-store'\n\n/**\n * The two decisions a person makes about a job — confirm its plan (or try a\n * refused step again), and cancel it — as ONE request each, whichever\n * surface they press it on (AGL-3593). The AI jobs drawer and the dialog that\n * started the job both call these, so confirming in the dialog is the same\n * door, the same body and the same answer as confirming in the drawer.\n *\n * Each hands the job it gets back to every counting surface, so the top-bar\n * indicator stops saying \"plan ready\" the moment the plan is confirmed.\n */\n\n/** A door's answer: the job as it now stands, and the refusal when there is one. */\nexport interface AiJobDecision {\n  job: AiJobSummary | null\n  error: string | null\n}\n\n/**\n * Confirms a plan, or tries again a step whose answer broke a building rule\n * (AGL-2935). The door runs the next step inline and answers with the job.\n */\nexport async function resumeAiJobRequest(\n  user: MaybeTokenSource,\n  orgId: string,\n  job: Pick<AiJobSummary, 'id' | 'hostId'>,\n): Promise<AiJobDecision> {\n  try {\n    const response = await authorizedFetch(\n      user,\n      `/api/ai/jobs/${encodeURIComponent(job.id)}/resume`,\n      {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ orgId, hostId: job.hostId }),\n      },\n    )\n    const payload = await response.json().catch(() => null)\n    const next = (payload?.job as AiJobSummary | undefined) ?? null\n    publishAiJob(next)\n    return {\n      job: next,\n      error: response.ok\n        ? null\n        : String(payload?.error ?? 'The job could not be resumed — try again.'),\n    }\n  } catch {\n    return { job: null, error: 'The job could not be resumed — try again.' }\n  }\n}\n\n/** Cancels a job that has not settled. */\nexport async function cancelAiJobRequest(\n  user: MaybeTokenSource,\n  orgId: string,\n  jobId: string,\n): Promise<AiJobDecision> {\n  try {\n    const response = await authorizedFetch(\n      user,\n      `/api/ai/jobs/${encodeURIComponent(jobId)}/cancel`,\n      {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ orgId }),\n      },\n    )\n    const payload = await response.json().catch(() => null)\n    const next = (payload?.job as AiJobSummary | undefined) ?? null\n    publishAiJob(next)\n    return {\n      job: next,\n      error: response.ok\n        ? null\n        : String(payload?.error ?? 'The job could not be canceled — try again.'),\n    }\n  } catch {\n    return { job: null, error: 'The job could not be canceled — try again.' }\n  }\n}\n"],"names":["authorizedFetch","publishAiJob","resumeAiJobRequest","user","orgId","job","response","encodeURIComponent","id","method","headers","body","JSON","stringify","hostId","payload","json","catch","next","error","ok","String","cancelAiJobRequest","jobId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,eAAe,QAA+B,2CAA0C;AAEjG,SAASC,YAAY,QAAQ,qBAAiB;AAmB9C;;;CAGC,GACD,OAAO,eAAeC,mBACpBC,IAAsB,EACtBC,KAAa,EACbC,GAAwC;IAExC,IAAI;;QACF,MAAMC,WAAW,MAAMN,gBACrBG,MACA,CAAC,aAAa,EAAEI,mBAAmBF,IAAIG,EAAE,EAAE,OAAO,CAAC,EACnD;YACEC,QAAQ;YACRC,SAAS;gBAAE,gBAAgB;YAAmB;YAC9CC,MAAMC,KAAKC,SAAS,CAAC;gBAAET;gBAAOU,QAAQT,IAAIS,MAAM;YAAC;QACnD;QAEF,MAAMC,UAAU,MAAMT,SAASU,IAAI,GAAGC,KAAK,CAAC,IAAM;QAClD,MAAMC,eAAQH,2BAAAA,QAASV,GAAG,mBAAiC;QAC3DJ,aAAaiB;QACb,OAAO;YACLb,KAAKa;YACLC,OAAOb,SAASc,EAAE,GACd,OACAC,gBAAON,2BAAAA,QAASI,KAAK,oBAAI;QAC/B;IACF,EAAE,eAAM;QACN,OAAO;YAAEd,KAAK;YAAMc,OAAO;QAA4C;IACzE;AACF;AAEA,wCAAwC,GACxC,OAAO,eAAeG,mBACpBnB,IAAsB,EACtBC,KAAa,EACbmB,KAAa;IAEb,IAAI;;QACF,MAAMjB,WAAW,MAAMN,gBACrBG,MACA,CAAC,aAAa,EAAEI,mBAAmBgB,OAAO,OAAO,CAAC,EAClD;YACEd,QAAQ;YACRC,SAAS;gBAAE,gBAAgB;YAAmB;YAC9CC,MAAMC,KAAKC,SAAS,CAAC;gBAAET;YAAM;QAC/B;QAEF,MAAMW,UAAU,MAAMT,SAASU,IAAI,GAAGC,KAAK,CAAC,IAAM;QAClD,MAAMC,eAAQH,2BAAAA,QAASV,GAAG,mBAAiC;QAC3DJ,aAAaiB;QACb,OAAO;YACLb,KAAKa;YACLC,OAAOb,SAASc,EAAE,GACd,OACAC,gBAAON,2BAAAA,QAASI,KAAK,oBAAI;QAC/B;IACF,EAAE,eAAM;QACN,OAAO;YAAEd,KAAK;YAAMc,OAAO;QAA6C;IAC1E;AACF"}

package/src/lib/components/ai-job-site.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The site a site's AI jobs pages are about (AGL-3596): its workspace, which
+ * every jobs request names, and its display name. Read once off the site
+ * document the reader may already read.
+ *
+ * It always settles. A read that fails, a document without a workspace, or a
+ * read still out after {@link AI_JOB_SITE_TIMEOUT_MS} is `error`, so a page
+ * waiting on it says so instead of spinning: without a workspace there is no
+ * job to ask for, and nothing would ever arrive to end the wait.
+ */
+export type AiJobSite = {
+    status: 'loading';
+} | {
+    status: 'ready';
+    orgId: string;
+    name: string;
+} | {
+    status: 'error';
+};
+/** How long the site's read may take before the page says it could not be read. */
+export declare const AI_JOB_SITE_TIMEOUT_MS = 15000;
+export declare function useAiJobSite(hostId: string | null | undefined): AiJobSite;

package/src/lib/components/ai-job-site.js

@@ -0,0 +1,73 @@
+/**
+ * @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 { useFirestore } from "@aglyn/tenant-feature-instance";
+import { doc, getDoc } from "firebase/firestore";
+import { useEffect, useRef, useState } from "react";
+/** How long the site's read may take before the page says it could not be read. */ export const AI_JOB_SITE_TIMEOUT_MS = 15000;
+export function useAiJobSite(hostId) {
+    // Read through a ref: the read is keyed on the site alone, so a provider
+    // that hands back a new handle each render does not read it again.
+    const firestore = useFirestore();
+    const firestoreRef = useRef(firestore);
+    firestoreRef.current = firestore;
+    const [site, setSite] = useState({
+        status: 'loading'
+    });
+    useEffect(()=>{
+        if (!hostId) {
+            setSite({
+                status: 'error'
+            });
+            return undefined;
+        }
+        let active = true;
+        setSite((current)=>current.status === 'loading' ? current : {
+                status: 'loading'
+            });
+        const settle = (next)=>{
+            if (!active) return;
+            active = false;
+            setSite(next);
+        };
+        const timer = setTimeout(()=>settle({
+                status: 'error'
+            }), AI_JOB_SITE_TIMEOUT_MS);
+        void getDoc(doc(firestoreRef.current, 'hosts', hostId)).then((snapshot)=>{
+            var _snapshot_data;
+            const data = (_snapshot_data = snapshot.data()) != null ? _snapshot_data : {};
+            const orgId = typeof data.orgId === 'string' ? data.orgId : '';
+            settle(orgId ? {
+                status: 'ready',
+                orgId,
+                name: typeof data.displayName === 'string' ? data.displayName : ''
+            } : {
+                status: 'error'
+            });
+        }).catch(()=>settle({
+                status: 'error'
+            }));
+        return ()=>{
+            active = false;
+            clearTimeout(timer);
+        };
+    }, [
+        hostId
+    ]);
+    return site;
+}
+
+//# sourceMappingURL=ai-job-site.js.map

package/src/lib/components/ai-job-site.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-job-site.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 { useFirestore } from '@aglyn/tenant-feature-instance'\nimport { doc, getDoc } from 'firebase/firestore'\nimport { useEffect, useRef, useState } from 'react'\n\n/**\n * The site a site's AI jobs pages are about (AGL-3596): its workspace, which\n * every jobs request names, and its display name. Read once off the site\n * document the reader may already read.\n *\n * It always settles. A read that fails, a document without a workspace, or a\n * read still out after {@link AI_JOB_SITE_TIMEOUT_MS} is `error`, so a page\n * waiting on it says so instead of spinning: without a workspace there is no\n * job to ask for, and nothing would ever arrive to end the wait.\n */\nexport type AiJobSite =\n  | { status: 'loading' }\n  | { status: 'ready'; orgId: string; name: string }\n  | { status: 'error' }\n\n/** How long the site's read may take before the page says it could not be read. */\nexport const AI_JOB_SITE_TIMEOUT_MS = 15_000\n\nexport function useAiJobSite(hostId: string | null | undefined): AiJobSite {\n  // Read through a ref: the read is keyed on the site alone, so a provider\n  // that hands back a new handle each render does not read it again.\n  const firestore = useFirestore()\n  const firestoreRef = useRef(firestore)\n  firestoreRef.current = firestore\n  const [site, setSite] = useState<AiJobSite>({ status: 'loading' })\n  useEffect(() => {\n    if (!hostId) {\n      setSite({ status: 'error' })\n      return undefined\n    }\n    let active = true\n    setSite((current) => (current.status === 'loading' ? current : { status: 'loading' }))\n    const settle = (next: AiJobSite) => {\n      if (!active) return\n      active = false\n      setSite(next)\n    }\n    const timer = setTimeout(() => settle({ status: 'error' }), AI_JOB_SITE_TIMEOUT_MS)\n    void getDoc(doc(firestoreRef.current, 'hosts', hostId))\n      .then((snapshot) => {\n        const data = (snapshot.data() ?? {}) as { orgId?: unknown; displayName?: unknown }\n        const orgId = typeof data.orgId === 'string' ? data.orgId : ''\n        settle(\n          orgId\n            ? { status: 'ready', orgId, name: typeof data.displayName === 'string' ? data.displayName : '' }\n            : { status: 'error' },\n        )\n      })\n      .catch(() => settle({ status: 'error' }))\n    return () => {\n      active = false\n      clearTimeout(timer)\n    }\n  }, [hostId])\n  return site\n}\n"],"names":["useFirestore","doc","getDoc","useEffect","useRef","useState","AI_JOB_SITE_TIMEOUT_MS","useAiJobSite","hostId","firestore","firestoreRef","current","site","setSite","status","undefined","active","settle","next","timer","setTimeout","then","snapshot","data","orgId","name","displayName","catch","clearTimeout"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,YAAY,QAAQ,iCAAgC;AAC7D,SAASC,GAAG,EAAEC,MAAM,QAAQ,qBAAoB;AAChD,SAASC,SAAS,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,QAAO;AAiBnD,iFAAiF,GACjF,OAAO,MAAMC,yBAAyB,MAAM;AAE5C,OAAO,SAASC,aAAaC,MAAiC;IAC5D,yEAAyE;IACzE,mEAAmE;IACnE,MAAMC,YAAYT;IAClB,MAAMU,eAAeN,OAAOK;IAC5BC,aAAaC,OAAO,GAAGF;IACvB,MAAM,CAACG,MAAMC,QAAQ,GAAGR,SAAoB;QAAES,QAAQ;IAAU;IAChEX,UAAU;QACR,IAAI,CAACK,QAAQ;YACXK,QAAQ;gBAAEC,QAAQ;YAAQ;YAC1B,OAAOC;QACT;QACA,IAAIC,SAAS;QACbH,QAAQ,CAACF,UAAaA,QAAQG,MAAM,KAAK,YAAYH,UAAU;gBAAEG,QAAQ;YAAU;QACnF,MAAMG,SAAS,CAACC;YACd,IAAI,CAACF,QAAQ;YACbA,SAAS;YACTH,QAAQK;QACV;QACA,MAAMC,QAAQC,WAAW,IAAMH,OAAO;gBAAEH,QAAQ;YAAQ,IAAIR;QAC5D,KAAKJ,OAAOD,IAAIS,aAAaC,OAAO,EAAE,SAASH,SAC5Ca,IAAI,CAAC,CAACC;gBACSA;YAAd,MAAMC,QAAQD,iBAAAA,SAASC,IAAI,cAAbD,iBAAmB,CAAC;YAClC,MAAME,QAAQ,OAAOD,KAAKC,KAAK,KAAK,WAAWD,KAAKC,KAAK,GAAG;YAC5DP,OACEO,QACI;gBAAEV,QAAQ;gBAASU;gBAAOC,MAAM,OAAOF,KAAKG,WAAW,KAAK,WAAWH,KAAKG,WAAW,GAAG;YAAG,IAC7F;gBAAEZ,QAAQ;YAAQ;QAE1B,GACCa,KAAK,CAAC,IAAMV,OAAO;gBAAEH,QAAQ;YAAQ;QACxC,OAAO;YACLE,SAAS;YACTY,aAAaT;QACf;IACF,GAAG;QAACX;KAAO;IACX,OAAOI;AACT"}

package/src/lib/components/ai-jobs-indicator.component.d.ts

@@ -0,0 +1,25 @@
+import { type ConsoleTopBarZoneProps } from '@aglyn/aglyn';
+/**
+ * The AI jobs indicator in the console's top bar (AGL-3593), on the
+ * `consoleTopBar` zone: one small chip while any of the workspace's jobs is
+ * moving or waiting on a person, saying which — `AI · plan ready` before
+ * `AI · needs attention` before `AI · planning` — and how many. Pressing it
+ * opens AI jobs in the Assist panel on the job that has waited longest.
+ *
+ * Nothing at all when nothing is in flight, so a workspace with no AI work
+ * sees the bar it always had. It reads the shared list the launcher's badge
+ * and the drawer read ({@link useAiJobsActivity}): one read per page load,
+ * and a re-read only while something is moving.
+ *
+ * Gated as the plugin's other generative widgets are — the plan's
+ * `aiGenerative` and the reader's `ai.generate` at registration — and, here,
+ * on the two release flags the drawer it opens needs: `release_ai_generative`
+ * for the jobs, `release_assist` for the panel they are listed in. The
+ * reader's `ai.generate` on the site in view is asked again, because on a
+ * site's pages a collaborator's permission is the site's, not the org's.
+ */
+export declare function AiJobsTopBarIndicator({ scopedOrgId, org, orgReady, releaseVerdict, permissionsOnHost, productName, }: ConsoleTopBarZoneProps): import("react").JSX.Element;
+export declare namespace AiJobsTopBarIndicator {
+    var displayName: string;
+}
+export default AiJobsTopBarIndicator;

package/src/lib/components/ai-jobs-indicator.component.js

@@ -0,0 +1,80 @@
+/**
+ * @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 } from "react/jsx-runtime";
+import { checkEntitlement } from "@aglyn/aglyn";
+import { mdiAutoFix } from "@aglyn/shared-data-mdi";
+import { MdiIcon } from "@aglyn/shared-ui-jsx";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { Chip, CircularProgress, Tooltip } from "@mui/material";
+import { aiJobsActivityLabel } from "../model/ai-job-activity.js";
+import { aiPermissionsOf } from "../model/ai-permissions.js";
+import { openAiJobs, useAiJobsActivity } from "./ai-jobs-store.js";
+/**
+ * The AI jobs indicator in the console's top bar (AGL-3593), on the
+ * `consoleTopBar` zone: one small chip while any of the workspace's jobs is
+ * moving or waiting on a person, saying which — `AI · plan ready` before
+ * `AI · needs attention` before `AI · planning` — and how many. Pressing it
+ * opens AI jobs in the Assist panel on the job that has waited longest.
+ *
+ * Nothing at all when nothing is in flight, so a workspace with no AI work
+ * sees the bar it always had. It reads the shared list the launcher's badge
+ * and the drawer read ({@link useAiJobsActivity}): one read per page load,
+ * and a re-read only while something is moving.
+ *
+ * Gated as the plugin's other generative widgets are — the plan's
+ * `aiGenerative` and the reader's `ai.generate` at registration — and, here,
+ * on the two release flags the drawer it opens needs: `release_ai_generative`
+ * for the jobs, `release_assist` for the panel they are listed in. The
+ * reader's `ai.generate` on the site in view is asked again, because on a
+ * site's pages a collaborator's permission is the site's, not the org's.
+ */ export function AiJobsTopBarIndicator({ scopedOrgId, org, orgReady, releaseVerdict, permissionsOnHost, productName }) {
+    const { data: user } = useUser();
+    const generate = (permissionsOnHost == null ? void 0 : permissionsOnHost.loaded) === true && aiPermissionsOf(permissionsOnHost.granted)['ai.generate'] === true;
+    const visible = Boolean(scopedOrgId) && orgReady && checkEntitlement(org, 'aiGenerative') && releaseVerdict('release_ai_generative').visible && releaseVerdict('release_assist').visible && generate;
+    const activity = useAiJobsActivity(user, scopedOrgId, visible);
+    if (!visible || !activity) return null;
+    const waiting = activity.state !== 'running';
+    return /*#__PURE__*/ _jsx(Tooltip, {
+        title: `Open AI jobs in ${productName} Assist`,
+        children: /*#__PURE__*/ _jsx(Chip, {
+            size: "small",
+            clickable: true,
+            color: waiting ? 'warning' : 'primary',
+            variant: waiting ? 'filled' : 'outlined',
+            icon: waiting ? /*#__PURE__*/ _jsx(MdiIcon, {
+                path: mdiAutoFix.path
+            }) : /*#__PURE__*/ _jsx(CircularProgress, {
+                size: 12,
+                color: "inherit",
+                "aria-hidden": true
+            }),
+            label: aiJobsActivityLabel(activity),
+            "aria-label": `${aiJobsActivityLabel(activity)}. Open AI jobs`,
+            onClick: ()=>openAiJobs({
+                    jobId: activity.job.id
+                }),
+            "data-ai-jobs-state": activity.state,
+            sx: {
+                mx: 0.5
+            }
+        })
+    });
+}
+AiJobsTopBarIndicator.displayName = 'AiJobsTopBarIndicator';
+export default AiJobsTopBarIndicator;
+
+//# sourceMappingURL=ai-jobs-indicator.component.js.map

package/src/lib/components/ai-jobs-indicator.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-jobs-indicator.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'use client'\n\nimport { checkEntitlement, type ConsoleTopBarZoneProps } from '@aglyn/aglyn'\nimport { mdiAutoFix } from '@aglyn/shared-data-mdi'\nimport { MdiIcon } from '@aglyn/shared-ui-jsx'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { Chip, CircularProgress, Tooltip } from '@mui/material'\nimport { aiJobsActivityLabel } from '../model/ai-job-activity'\nimport { aiPermissionsOf } from '../model/ai-permissions'\nimport { openAiJobs, useAiJobsActivity } from './ai-jobs-store'\n\n/**\n * The AI jobs indicator in the console's top bar (AGL-3593), on the\n * `consoleTopBar` zone: one small chip while any of the workspace's jobs is\n * moving or waiting on a person, saying which — `AI · plan ready` before\n * `AI · needs attention` before `AI · planning` — and how many. Pressing it\n * opens AI jobs in the Assist panel on the job that has waited longest.\n *\n * Nothing at all when nothing is in flight, so a workspace with no AI work\n * sees the bar it always had. It reads the shared list the launcher's badge\n * and the drawer read ({@link useAiJobsActivity}): one read per page load,\n * and a re-read only while something is moving.\n *\n * Gated as the plugin's other generative widgets are — the plan's\n * `aiGenerative` and the reader's `ai.generate` at registration — and, here,\n * on the two release flags the drawer it opens needs: `release_ai_generative`\n * for the jobs, `release_assist` for the panel they are listed in. The\n * reader's `ai.generate` on the site in view is asked again, because on a\n * site's pages a collaborator's permission is the site's, not the org's.\n */\nexport function AiJobsTopBarIndicator({\n  scopedOrgId,\n  org,\n  orgReady,\n  releaseVerdict,\n  permissionsOnHost,\n  productName,\n}: ConsoleTopBarZoneProps) {\n  const { data: user } = useUser()\n  const generate =\n    permissionsOnHost?.loaded === true &&\n    aiPermissionsOf(permissionsOnHost.granted)['ai.generate'] === true\n  const visible =\n    Boolean(scopedOrgId) &&\n    orgReady &&\n    checkEntitlement(org as never, 'aiGenerative') &&\n    releaseVerdict('release_ai_generative').visible &&\n    releaseVerdict('release_assist').visible &&\n    generate\n  const activity = useAiJobsActivity(user, scopedOrgId, visible)\n  if (!visible || !activity) return null\n\n  const waiting = activity.state !== 'running'\n  return (\n    <Tooltip title={`Open AI jobs in ${productName} Assist`}>\n      <Chip\n        size=\"small\"\n        clickable\n        color={waiting ? 'warning' : 'primary'}\n        variant={waiting ? 'filled' : 'outlined'}\n        icon={\n          waiting ? (\n            <MdiIcon path={mdiAutoFix.path} />\n          ) : (\n            <CircularProgress size={12} color=\"inherit\" aria-hidden />\n          )\n        }\n        label={aiJobsActivityLabel(activity)}\n        aria-label={`${aiJobsActivityLabel(activity)}. Open AI jobs`}\n        onClick={() => openAiJobs({ jobId: activity.job.id })}\n        data-ai-jobs-state={activity.state}\n        sx={{ mx: 0.5 }}\n      />\n    </Tooltip>\n  )\n}\nAiJobsTopBarIndicator.displayName = 'AiJobsTopBarIndicator'\n\nexport default AiJobsTopBarIndicator\n"],"names":["checkEntitlement","mdiAutoFix","MdiIcon","useUser","Chip","CircularProgress","Tooltip","aiJobsActivityLabel","aiPermissionsOf","openAiJobs","useAiJobsActivity","AiJobsTopBarIndicator","scopedOrgId","org","orgReady","releaseVerdict","permissionsOnHost","productName","data","user","generate","loaded","granted","visible","Boolean","activity","waiting","state","title","size","clickable","color","variant","icon","path","aria-hidden","label","aria-label","onClick","jobId","job","id","data-ai-jobs-state","sx","mx","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAEA,SAASA,gBAAgB,QAAqC,eAAc;AAC5E,SAASC,UAAU,QAAQ,yBAAwB;AACnD,SAASC,OAAO,QAAQ,uBAAsB;AAC9C,SAASC,OAAO,QAAQ,iCAAgC;AACxD,SAASC,IAAI,EAAEC,gBAAgB,EAAEC,OAAO,QAAQ,gBAAe;AAC/D,SAASC,mBAAmB,QAAQ,8BAA0B;AAC9D,SAASC,eAAe,QAAQ,6BAAyB;AACzD,SAASC,UAAU,EAAEC,iBAAiB,QAAQ,qBAAiB;AAE/D;;;;;;;;;;;;;;;;;;CAkBC,GACD,OAAO,SAASC,sBAAsB,EACpCC,WAAW,EACXC,GAAG,EACHC,QAAQ,EACRC,cAAc,EACdC,iBAAiB,EACjBC,WAAW,EACY;IACvB,MAAM,EAAEC,MAAMC,IAAI,EAAE,GAAGhB;IACvB,MAAMiB,WACJJ,CAAAA,qCAAAA,kBAAmBK,MAAM,MAAK,QAC9Bb,gBAAgBQ,kBAAkBM,OAAO,CAAC,CAAC,cAAc,KAAK;IAChE,MAAMC,UACJC,QAAQZ,gBACRE,YACAd,iBAAiBa,KAAc,mBAC/BE,eAAe,yBAAyBQ,OAAO,IAC/CR,eAAe,kBAAkBQ,OAAO,IACxCH;IACF,MAAMK,WAAWf,kBAAkBS,MAAMP,aAAaW;IACtD,IAAI,CAACA,WAAW,CAACE,UAAU,OAAO;IAElC,MAAMC,UAAUD,SAASE,KAAK,KAAK;IACnC,qBACE,KAACrB;QAAQsB,OAAO,CAAC,gBAAgB,EAAEX,YAAY,OAAO,CAAC;kBACrD,cAAA,KAACb;YACCyB,MAAK;YACLC,SAAS;YACTC,OAAOL,UAAU,YAAY;YAC7BM,SAASN,UAAU,WAAW;YAC9BO,MACEP,wBACE,KAACxB;gBAAQgC,MAAMjC,WAAWiC,IAAI;+BAE9B,KAAC7B;gBAAiBwB,MAAM;gBAAIE,OAAM;gBAAUI,aAAW;;YAG3DC,OAAO7B,oBAAoBkB;YAC3BY,cAAY,GAAG9B,oBAAoBkB,UAAU,cAAc,CAAC;YAC5Da,SAAS,IAAM7B,WAAW;oBAAE8B,OAAOd,SAASe,GAAG,CAACC,EAAE;gBAAC;YACnDC,sBAAoBjB,SAASE,KAAK;YAClCgB,IAAI;gBAAEC,IAAI;YAAI;;;AAItB;AACAjC,sBAAsBkC,WAAW,GAAG;AAEpC,eAAelC,sBAAqB"}

package/src/lib/components/ai-jobs-list-page.component.d.ts

@@ -0,0 +1,23 @@
+import type { ConsolePluginPageProps } from '@aglyn/aglyn/plugin-manager/feature-plugins';
+import type { AiJobSummary } from '../model/ai-jobs.types';
+/**
+ * A site's AI jobs (AGL-3596), at `/ai-jobs` under the site: every job that
+ * worked on this site, newest first, each linking to its own page.
+ *
+ * Read through the jobs route, never Firestore, so the membership, flag and
+ * plan rungs that answer every other jobs read answer this one. The site is
+ * a query on the route (`hostId`), not a filter of the workspace's list.
+ *
+ * Every wait ends: the site's read and the list's each settle on content,
+ * the empty state, or a sentence with Try again.
+ */
+/** The most jobs the page lists; the newest, which is what a person comes for. */
+export declare const AI_JOBS_PAGE_LIMIT = 50;
+/** How long the list may take before the page says it could not be loaded. */
+export declare const AI_JOBS_LIST_TIMEOUT_MS = 20000;
+/** What a job cost the person: what it spent, less what we refunded. */
+export declare function aiJobNetCredits(job: Pick<AiJobSummary, 'creditsSpent' | 'refundedCredits'>): number;
+/** The kind as a row names it: `Site`, `Page`, `AI job`. */
+export declare function aiJobKindLabel(kind: AiJobSummary['kind']): string;
+export declare function AiJobsListPage({ hostId, basePath }: ConsolePluginPageProps): import("react").JSX.Element;
+export default AiJobsListPage;