@aglyn/plugins-ai 1.0.0-beta.225 → 1.0.0-beta.227

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-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-store.d.ts

@@ -0,0 +1,81 @@
+import { type TokenSource } from '@aglyn/shared-util-http/authorized-token';
+import { type AiJobsActivity } from '../model/ai-job-activity';
+import { type AiJobSummary } from '../model/ai-jobs.types';
+/**
+ * WHERE A PERSON FINDS THEIR AI JOBS (AGL-3593).
+ *
+ * Two things every AI surface in the console shares, kept in this module
+ * rather than in any one component because the surfaces that need them — a
+ * brief dialog on the Screens page, the guided start's full-screen dialog,
+ * the top-bar indicator, the Assist launcher and the drawer inside the
+ * panel — are mounted in different zones and know nothing of one another.
+ * All of them are this plugin's, so no shell, zone or event bus carries it.
+ *
+ * ── Opening AI jobs ──────────────────────────────────────────────────────
+ *
+ * {@link openAiJobs} is the one action every "Open AI jobs" button, the
+ * indicator and a notification's link take: the Assist panel subscribes, opens
+ * itself, expands its AI jobs drawer, and scrolls to and highlights the job
+ * named. A request is a sequence number as well as a job, so asking twice for
+ * the same job opens it twice.
+ *
+ * ── The workspace's unsettled jobs ───────────────────────────────────────
+ *
+ * The indicator, the launcher's badge and the drawer's open-by-default rule
+ * read the same list: the workspace's jobs that are not yet settled, from
+ * the jobs route's `status=active` (a Firestore `in` query under the
+ * (status, createdAt) index, never a filter of a loaded window). ONE list per
+ * person and workspace however many surfaces read it, re-read on a timer only
+ * while something in it is still moving or waiting and the tab is in view —
+ * a workspace with nothing running costs one read per page load and no more.
+ *
+ * Every surface that learns a job's state some other way — the dialog that
+ * created it, the drawer's event stream, the in-dialog confirm — hands it in
+ * through {@link publishAiJob}, so the indicator moves the moment the job
+ * does rather than on the next read.
+ */
+/** The latest request to open AI jobs; `seq` is 0 until anything asked. */
+export interface AiJobsOpenRequest {
+    seq: number;
+    /** The job to scroll to and highlight, or `null` for the drawer alone. */
+    jobId: string | null;
+}
+/**
+ * Opens the Assist panel on its AI jobs drawer, expanded, scrolled to
+ * `jobId` when one is named. A surface that covers the panel — a dialog —
+ * closes itself beside the call; this opens, it does not close anything.
+ */
+export declare function openAiJobs(options?: {
+    jobId?: string | null;
+}): void;
+/** The latest open request, for the panel; a new `seq` is a new request. */
+export declare function useAiJobsOpenRequest(): AiJobsOpenRequest;
+/**
+ * The query parameter a notification's link carries: a console page opened
+ * with `?aiJob={id}` opens AI jobs on that job, the way pressing the
+ * indicator does.
+ */
+export { AI_JOB_LINK_PARAM } from '../model/ai-job-notice';
+/** How often a list with something in it is read again, while the tab is in view. */
+export declare const AI_JOBS_ACTIVE_POLL_MS = 15000;
+/**
+ * Hands a job's latest state to every surface counting this workspace's jobs:
+ * a new job joins the list, a settled one leaves it. Keyed on the job's own
+ * workspace, for every person whose list holds that workspace in this tab.
+ */
+export declare function publishAiJob(job: AiJobSummary | null | undefined): void;
+/** Forget every list and request; specs start each case from nothing. */
+export declare function resetAiJobsStoreForTests(): void;
+/**
+ * The workspace's jobs that are not yet settled, newest first, for the
+ * signed-in person — empty while the first read is in flight, where the
+ * route refuses, and when `enabled` is false (a surface whose own gates have
+ * not passed reads nothing at all).
+ */
+export declare function useAiJobsInFlight(user: (TokenSource & {
+    uid?: string | null;
+}) | null | undefined, orgId: string | null | undefined, enabled?: boolean): readonly AiJobSummary[];
+/** What the indicator and the launcher show for the workspace, or `null` for nothing. */
+export declare function useAiJobsActivity(user: (TokenSource & {
+    uid?: string | null;
+}) | null | undefined, orgId: string | null | undefined, enabled?: boolean): AiJobsActivity<AiJobSummary> | null;

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

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