@aglyn/plugins-ai 1.0.0-beta.143

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

@@ -0,0 +1,192 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { AI_BUILD_PLAN_CREATION_NOUNS, isAiPlanNewRef } from "../model/ai-build-plan.js";
+import { aiJobPlanCreditEstimate } from "../model/ai-site-job.js";
+import { Box, Button, Collapse, Stack, Typography } from "@mui/material";
+import { useState } from "react";
+/**
+ * Where a refused answer broke its rules, and the outline of those parts, as
+ * lines staff read (AGL-3078): each finding with the nodes or plan entries it
+ * names, then each outlined node indented by its depth, with its element, a
+ * Grid's layout as written, and the names of what it sets and holds.
+ */ export function aiJobReviewDetails(review) {
+    var _review_outline;
+    if ((review == null ? void 0 : review.reason) !== 'doctrine') return [];
+    const lines = review.findings.flatMap((finding)=>{
+        var _finding_nodeIds, _finding_paths;
+        const where = ((_finding_nodeIds = finding.nodeIds) == null ? void 0 : _finding_nodeIds.length) ? `nodes ${finding.nodeIds.join(', ')}` : ((_finding_paths = finding.paths) == null ? void 0 : _finding_paths.length) ? `at ${finding.paths.join(', ')}` : null;
+        return where ? [
+            `${finding.rule === null ? '' : `Rule ${finding.rule} `}${finding.code}: ${where}`
+        ] : [];
+    });
+    for (const node of (_review_outline = review.outline) != null ? _review_outline : []){
+        var _node_grid;
+        var _node_sx;
+        lines.push([
+            `${'  '.repeat(node.depth)}${node.id} ${node.componentId}`,
+            ...Object.entries((_node_grid = node.grid) != null ? _node_grid : {}).map(([name, value])=>`${name}=${JSON.stringify(value)}`),
+            ...node.props.length ? [
+                `props ${node.props.join(', ')}`
+            ] : [],
+            ...((_node_sx = node.sx) == null ? void 0 : _node_sx.length) ? [
+                `sx ${node.sx.join(', ')}`
+            ] : [],
+            ...node.children.length ? [
+                `holds ${node.children.join(', ')}`
+            ] : []
+        ].join(' · '));
+    }
+    return lines;
+}
+export function AiJobPlan({ job, onResume, busy = false, staff = false }) {
+    const [detailsOpen, setDetailsOpen] = useState(false);
+    const { plan, review } = job;
+    if (!plan && !review) return null;
+    const details = staff ? aiJobReviewDetails(review) : [];
+    /** A reference as a person reads it: the record's name, or what the plan creates. */ const named = (ref)=>{
+        var _ref;
+        return !ref ? '' : isAiPlanNewRef(ref) ? ref.slice('new:'.length) : (_ref = plan == null ? void 0 : plan.labels[ref]) != null ? _ref : ref;
+    };
+    const waiting = job.status === 'needs_review' && review !== null;
+    // The guard rail (AGL-2911): what the plan is estimated to cost is read
+    // before it is confirmed, not after it has been spent. An estimate, and
+    // said to be one — the plan's own passes at the nominal credits a step
+    // holds, where what a step really costs is its model's tokens. A page job
+    // counts the creations it builds before its page (AGL-3031).
+    const estimate = plan && waiting && review.reason === 'plan' ? aiJobPlanCreditEstimate(job.kind, plan) : 0;
+    return /*#__PURE__*/ _jsxs(Box, {
+        sx: {
+            mt: 1
+        },
+        children: [
+            plan && /*#__PURE__*/ _jsxs(Stack, {
+                spacing: 0.5,
+                role: "list",
+                "aria-label": "Plan",
+                children: [
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "caption",
+                        color: "text.secondary",
+                        children: plan.status === 'confirmed' ? 'Confirmed plan' : 'Proposed plan'
+                    }),
+                    plan.reuse.map((entry, index)=>/*#__PURE__*/ _jsxs(Typography, {
+                            variant: "body2",
+                            role: "listitem",
+                            children: [
+                                "Reuses the ",
+                                entry.kind,
+                                " ",
+                                named(entry.id),
+                                " — ",
+                                entry.purpose
+                            ]
+                        }, `reuse-${index}`)),
+                    plan.create.map((entry, index)=>/*#__PURE__*/ _jsxs(Typography, {
+                            variant: "body2",
+                            role: "listitem",
+                            children: [
+                                "Creates the ",
+                                AI_BUILD_PLAN_CREATION_NOUNS[entry.kind].noun,
+                                " ",
+                                entry.name,
+                                entry.duplicateOf ? `, from a copy of ${named(entry.duplicateOf)}` : '',
+                                ' ',
+                                "— ",
+                                entry.why
+                            ]
+                        }, `create-${index}`)),
+                    plan.screens.map((screen, index)=>/*#__PURE__*/ _jsxs(Typography, {
+                            variant: "body2",
+                            role: "listitem",
+                            children: [
+                                "Builds the screen ",
+                                screen.title,
+                                " at ",
+                                screen.slug,
+                                screen.layout ? ` in ${named(screen.layout)}` : '',
+                                screen.sections.length ? `: ${screen.sections.map((section)=>section.name).join(', ')}` : ''
+                            ]
+                        }, `screen-${index}`))
+                ]
+            }),
+            (review == null ? void 0 : review.reason) === 'doctrine' && review.findings.length > 0 && /*#__PURE__*/ _jsx(Box, {
+                component: "ul",
+                sx: {
+                    my: 0.5,
+                    pl: 2.5
+                },
+                "aria-label": "Building rules broken",
+                children: review.findings.map((finding, index)=>/*#__PURE__*/ _jsx(Typography, {
+                        component: "li",
+                        variant: "caption",
+                        children: finding.message
+                    }, `finding-${index}`))
+            }),
+            details.length > 0 && /*#__PURE__*/ _jsxs(Box, {
+                sx: {
+                    mt: 0.5
+                },
+                children: [
+                    /*#__PURE__*/ _jsx(Button, {
+                        size: "small",
+                        "aria-expanded": detailsOpen,
+                        onClick: ()=>setDetailsOpen((prior)=>!prior),
+                        children: detailsOpen ? 'Hide what was refused' : 'Show what was refused'
+                    }),
+                    /*#__PURE__*/ _jsx(Collapse, {
+                        in: detailsOpen,
+                        unmountOnExit: true,
+                        children: /*#__PURE__*/ _jsx(Typography, {
+                            variant: "caption",
+                            component: "pre",
+                            "aria-label": "What was refused",
+                            sx: {
+                                m: 0,
+                                fontFamily: 'monospace',
+                                whiteSpace: 'pre',
+                                overflowX: 'auto'
+                            },
+                            children: details.join('\n')
+                        })
+                    })
+                ]
+            }),
+            estimate > 0 && /*#__PURE__*/ _jsx(Typography, {
+                variant: "caption",
+                color: "text.secondary",
+                sx: {
+                    display: 'block',
+                    mt: 1
+                },
+                children: `Estimated cost: about ${estimate.toLocaleString('en-US')} credits. What it costs is what its steps spend.`
+            }),
+            waiting && /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                variant: "contained",
+                disabled: busy,
+                onClick: ()=>onResume(job),
+                sx: {
+                    mt: 1
+                },
+                children: review.reason === 'plan' ? 'Confirm plan' : 'Try again'
+            })
+        ]
+    });
+}
+export default AiJobPlan;
+
+//# sourceMappingURL=ai-job-plan.component.js.map

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

@@ -0,0 +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 { AI_BUILD_PLAN_CREATION_NOUNS, isAiPlanNewRef } 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\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} {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              Builds the screen {screen.title} at {screen.slug}\n              {screen.layout ? ` in ${named(screen.layout)}` : ''}\n              {screen.sections.length\n                ? `: ${screen.sections.map((section) => section.name).join(', ')}`\n                : ''}\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","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","AiJobPlan","job","onResume","busy","staff","detailsOpen","setDetailsOpen","plan","details","named","ref","slice","labels","waiting","status","estimate","kind","mt","spacing","role","aria-label","variant","color","reuse","entry","index","purpose","create","noun","duplicateOf","why","screens","screen","title","slug","layout","sections","section","component","my","pl","message","size","aria-expanded","onClick","prior","in","unmountOnExit","m","fontFamily","whiteSpace","overflowX","display","toLocaleString","disabled"],"mappings":"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"}

package/src/lib/components/ai-model-selector.component.d.ts

@@ -0,0 +1,21 @@
+import type { AiModelChoiceState } from './use-ai-model-choice';
+export interface AiModelSelectorProps {
+    choice: AiModelChoiceState;
+    disabled?: boolean;
+}
+/**
+ * THE MODEL SWITCH (AGL-2942): Auto, and the models the reader's plan, the
+ * workspace's restriction and their allotment allow — each with what a
+ * typical request costs on it and the multiple of Auto.
+ *
+ * Every label and id comes from the provider catalog through the options
+ * route; this component names no model. The pick is remembered per person
+ * per surface (`use-ai-model-choice.ts`), and the door the request goes to
+ * decides again, so a stale pick runs on Auto rather than on a model the
+ * reader may no longer have.
+ */
+export declare function AiModelSelector({ choice, disabled }: AiModelSelectorProps): import("react").JSX.Element;
+export declare namespace AiModelSelector {
+    var displayName: string;
+}
+export default AiModelSelector;

package/src/lib/components/ai-model-selector.component.js

@@ -0,0 +1,109 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Button, ListItemText, Menu, MenuItem } from "@mui/material";
+import { useState } from "react";
+const perRequest = (credits)=>`≈ ${credits.toLocaleString()} credit${credits === 1 ? '' : 's'} a request`;
+/**
+ * THE MODEL SWITCH (AGL-2942): Auto, and the models the reader's plan, the
+ * workspace's restriction and their allotment allow — each with what a
+ * typical request costs on it and the multiple of Auto.
+ *
+ * Every label and id comes from the provider catalog through the options
+ * route; this component names no model. The pick is remembered per person
+ * per surface (`use-ai-model-choice.ts`), and the door the request goes to
+ * decides again, so a stale pick runs on Auto rather than on a model the
+ * reader may no longer have.
+ */ export function AiModelSelector({ choice, disabled }) {
+    const [anchor, setAnchor] = useState(null);
+    const open = (event)=>{
+        setAnchor(event.currentTarget);
+        choice.load();
+    };
+    const close = ()=>setAnchor(null);
+    const pick = (option)=>{
+        choice.select(option);
+        close();
+    };
+    const { options, status } = choice;
+    return /*#__PURE__*/ _jsxs(_Fragment, {
+        children: [
+            /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                color: "inherit",
+                onClick: open,
+                disabled: disabled,
+                "aria-haspopup": "menu",
+                "aria-expanded": Boolean(anchor),
+                "aria-label": `AI model: ${choice.label}`,
+                sx: {
+                    textTransform: 'none',
+                    minWidth: 0,
+                    px: 1,
+                    color: 'text.secondary'
+                },
+                children: `Model: ${choice.label}`
+            }),
+            /*#__PURE__*/ _jsxs(Menu, {
+                anchorEl: anchor,
+                open: Boolean(anchor),
+                onClose: close,
+                children: [
+                    status === 'loading' || status === 'idle' ? /*#__PURE__*/ _jsx(MenuItem, {
+                        disabled: true,
+                        children: 'Loading models…'
+                    }) : null,
+                    status === 'refused' ? /*#__PURE__*/ _jsx(MenuItem, {
+                        disabled: true,
+                        children: 'Your role does not include AI assistance'
+                    }) : null,
+                    status === 'error' ? /*#__PURE__*/ _jsx(MenuItem, {
+                        disabled: true,
+                        children: 'The models could not be loaded — try again'
+                    }) : null,
+                    status === 'ready' && (options == null ? void 0 : options.auto) ? /*#__PURE__*/ _jsx(MenuItem, {
+                        selected: choice.model === null,
+                        onClick: ()=>pick(null),
+                        children: /*#__PURE__*/ _jsx(ListItemText, {
+                            primary: options.auto.label,
+                            secondary: `${perRequest(options.auto.creditsPerRequest)} · picked for each request`
+                        })
+                    }) : null,
+                    status === 'ready' && options ? options.options.map((option)=>/*#__PURE__*/ _jsx(MenuItem, {
+                            selected: choice.model === option.id,
+                            onClick: ()=>pick({
+                                    id: option.id,
+                                    label: option.label
+                                }),
+                            children: /*#__PURE__*/ _jsx(ListItemText, {
+                                primary: option.label,
+                                secondary: `${perRequest(option.creditsPerRequest)} · ${option.multiplier}× Auto`
+                            })
+                        }, option.id)) : null,
+                    status === 'ready' && options && !options.options.length ? /*#__PURE__*/ _jsx(MenuItem, {
+                        disabled: true,
+                        children: 'This workspace runs on Auto'
+                    }) : null
+                ]
+            })
+        ]
+    });
+}
+AiModelSelector.displayName = 'AiModelSelector';
+export default AiModelSelector;
+
+//# sourceMappingURL=ai-model-selector.component.js.map

package/src/lib/components/ai-model-selector.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-model-selector.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 { Button, ListItemText, Menu, MenuItem } from '@mui/material'\nimport { useState, type MouseEvent } from 'react'\nimport type { AiModelChoiceState } from './use-ai-model-choice'\n\nexport interface AiModelSelectorProps {\n  choice: AiModelChoiceState\n  disabled?: boolean\n}\n\nconst perRequest = (credits: number): string =>\n  `≈ ${credits.toLocaleString()} credit${credits === 1 ? '' : 's'} a request`\n\n/**\n * THE MODEL SWITCH (AGL-2942): Auto, and the models the reader's plan, the\n * workspace's restriction and their allotment allow — each with what a\n * typical request costs on it and the multiple of Auto.\n *\n * Every label and id comes from the provider catalog through the options\n * route; this component names no model. The pick is remembered per person\n * per surface (`use-ai-model-choice.ts`), and the door the request goes to\n * decides again, so a stale pick runs on Auto rather than on a model the\n * reader may no longer have.\n */\nexport function AiModelSelector({ choice, disabled }: AiModelSelectorProps) {\n  const [anchor, setAnchor] = useState<HTMLElement | null>(null)\n  const open = (event: MouseEvent<HTMLElement>) => {\n    setAnchor(event.currentTarget)\n    choice.load()\n  }\n  const close = () => setAnchor(null)\n  const pick = (option: { id: string; label: string } | null) => {\n    choice.select(option)\n    close()\n  }\n  const { options, status } = choice\n  return (\n    <>\n      <Button\n        size=\"small\"\n        color=\"inherit\"\n        onClick={open}\n        disabled={disabled}\n        aria-haspopup=\"menu\"\n        aria-expanded={Boolean(anchor)}\n        aria-label={`AI model: ${choice.label}`}\n        sx={{ textTransform: 'none', minWidth: 0, px: 1, color: 'text.secondary' }}\n      >\n        {`Model: ${choice.label}`}\n      </Button>\n      <Menu anchorEl={anchor} open={Boolean(anchor)} onClose={close}>\n        {status === 'loading' || status === 'idle' ? (\n          <MenuItem disabled>{'Loading models…'}</MenuItem>\n        ) : null}\n        {status === 'refused' ? (\n          <MenuItem disabled>{'Your role does not include AI assistance'}</MenuItem>\n        ) : null}\n        {status === 'error' ? (\n          <MenuItem disabled>{'The models could not be loaded — try again'}</MenuItem>\n        ) : null}\n        {status === 'ready' && options?.auto ? (\n          <MenuItem selected={choice.model === null} onClick={() => pick(null)}>\n            <ListItemText\n              primary={options.auto.label}\n              secondary={`${perRequest(options.auto.creditsPerRequest)} · picked for each request`}\n            />\n          </MenuItem>\n        ) : null}\n        {status === 'ready' && options\n          ? options.options.map((option) => (\n              <MenuItem\n                key={option.id}\n                selected={choice.model === option.id}\n                onClick={() => pick({ id: option.id, label: option.label })}\n              >\n                <ListItemText\n                  primary={option.label}\n                  secondary={`${perRequest(option.creditsPerRequest)} · ${option.multiplier}× Auto`}\n                />\n              </MenuItem>\n            ))\n          : null}\n        {status === 'ready' && options && !options.options.length ? (\n          <MenuItem disabled>{'This workspace runs on Auto'}</MenuItem>\n        ) : null}\n      </Menu>\n    </>\n  )\n}\nAiModelSelector.displayName = 'AiModelSelector'\n\nexport default AiModelSelector\n"],"names":["Button","ListItemText","Menu","MenuItem","useState","perRequest","credits","toLocaleString","AiModelSelector","choice","disabled","anchor","setAnchor","open","event","currentTarget","load","close","pick","option","select","options","status","size","color","onClick","aria-haspopup","aria-expanded","Boolean","aria-label","label","sx","textTransform","minWidth","px","anchorEl","onClose","auto","selected","model","primary","secondary","creditsPerRequest","map","id","multiplier","length","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAEA,SAASA,MAAM,EAAEC,YAAY,EAAEC,IAAI,EAAEC,QAAQ,QAAQ,gBAAe;AACpE,SAASC,QAAQ,QAAyB,QAAO;AAQjD,MAAMC,aAAa,CAACC,UAClB,CAAC,EAAE,EAAEA,QAAQC,cAAc,GAAG,OAAO,EAAED,YAAY,IAAI,KAAK,IAAI,UAAU,CAAC;AAE7E;;;;;;;;;;CAUC,GACD,OAAO,SAASE,gBAAgB,EAAEC,MAAM,EAAEC,QAAQ,EAAwB;IACxE,MAAM,CAACC,QAAQC,UAAU,GAAGR,SAA6B;IACzD,MAAMS,OAAO,CAACC;QACZF,UAAUE,MAAMC,aAAa;QAC7BN,OAAOO,IAAI;IACb;IACA,MAAMC,QAAQ,IAAML,UAAU;IAC9B,MAAMM,OAAO,CAACC;QACZV,OAAOW,MAAM,CAACD;QACdF;IACF;IACA,MAAM,EAAEI,OAAO,EAAEC,MAAM,EAAE,GAAGb;IAC5B,qBACE;;0BACE,KAACT;gBACCuB,MAAK;gBACLC,OAAM;gBACNC,SAASZ;gBACTH,UAAUA;gBACVgB,iBAAc;gBACdC,iBAAeC,QAAQjB;gBACvBkB,cAAY,CAAC,UAAU,EAAEpB,OAAOqB,KAAK,EAAE;gBACvCC,IAAI;oBAAEC,eAAe;oBAAQC,UAAU;oBAAGC,IAAI;oBAAGV,OAAO;gBAAiB;0BAExE,CAAC,OAAO,EAAEf,OAAOqB,KAAK,EAAE;;0BAE3B,MAAC5B;gBAAKiC,UAAUxB;gBAAQE,MAAMe,QAAQjB;gBAASyB,SAASnB;;oBACrDK,WAAW,aAAaA,WAAW,uBAClC,KAACnB;wBAASO,QAAQ;kCAAE;yBAClB;oBACHY,WAAW,0BACV,KAACnB;wBAASO,QAAQ;kCAAE;yBAClB;oBACHY,WAAW,wBACV,KAACnB;wBAASO,QAAQ;kCAAE;yBAClB;oBACHY,WAAW,YAAWD,2BAAAA,QAASgB,IAAI,kBAClC,KAAClC;wBAASmC,UAAU7B,OAAO8B,KAAK,KAAK;wBAAMd,SAAS,IAAMP,KAAK;kCAC7D,cAAA,KAACjB;4BACCuC,SAASnB,QAAQgB,IAAI,CAACP,KAAK;4BAC3BW,WAAW,GAAGpC,WAAWgB,QAAQgB,IAAI,CAACK,iBAAiB,EAAE,0BAA0B,CAAC;;yBAGtF;oBACHpB,WAAW,WAAWD,UACnBA,QAAQA,OAAO,CAACsB,GAAG,CAAC,CAACxB,uBACnB,KAAChB;4BAECmC,UAAU7B,OAAO8B,KAAK,KAAKpB,OAAOyB,EAAE;4BACpCnB,SAAS,IAAMP,KAAK;oCAAE0B,IAAIzB,OAAOyB,EAAE;oCAAEd,OAAOX,OAAOW,KAAK;gCAAC;sCAEzD,cAAA,KAAC7B;gCACCuC,SAASrB,OAAOW,KAAK;gCACrBW,WAAW,GAAGpC,WAAWc,OAAOuB,iBAAiB,EAAE,GAAG,EAAEvB,OAAO0B,UAAU,CAAC,MAAM,CAAC;;2BAN9E1B,OAAOyB,EAAE,KAUlB;oBACHtB,WAAW,WAAWD,WAAW,CAACA,QAAQA,OAAO,CAACyB,MAAM,iBACvD,KAAC3C;wBAASO,QAAQ;kCAAE;yBAClB;;;;;AAIZ;AACAF,gBAAgBuC,WAAW,GAAG;AAE9B,eAAevC,gBAAe"}

package/src/lib/components/ai-page-brief-dialog.component.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type AiBriefDialogProps } from './ai-brief-dialog.component';
+/**
+ * "Describe a page" (AGL-2907): the brief dialog both page entry points open,
+ * the Screens page's "Describe it" and the Assist panel's AI jobs.
+ *
+ * It is the shared brief dialog for a `page` job (AGL-3043): one text box and
+ * an optional page type. The job plans first and waits in AI jobs, where the
+ * member confirms the plan and opens the draft once it is built; nothing here
+ * builds or writes anything.
+ */
+export type AiPageBriefDialogProps = Omit<AiBriefDialogProps, 'kind'>;
+export declare function AiPageBriefDialog(props: AiPageBriefDialogProps): import("react").JSX.Element;
+export default AiPageBriefDialog;

package/src/lib/components/ai-page-brief-dialog.component.js

@@ -0,0 +1,27 @@
+'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { AiBriefDialog } from "./ai-brief-dialog.component.js";
+export function AiPageBriefDialog(props) {
+    return /*#__PURE__*/ _jsx(AiBriefDialog, _extends({}, props, {
+        kind: "page"
+    }));
+}
+export default AiPageBriefDialog;
+
+//# sourceMappingURL=ai-page-brief-dialog.component.js.map

package/src/lib/components/ai-page-brief-dialog.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-page-brief-dialog.component.tsx"],"sourcesContent":["'use client'\n\n/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AiBriefDialog, type AiBriefDialogProps } from './ai-brief-dialog.component'\n\n/**\n * \"Describe a page\" (AGL-2907): the brief dialog both page entry points open,\n * the Screens page's \"Describe it\" and the Assist panel's AI jobs.\n *\n * It is the shared brief dialog for a `page` job (AGL-3043): one text box and\n * an optional page type. The job plans first and waits in AI jobs, where the\n * member confirms the plan and opens the draft once it is built; nothing here\n * builds or writes anything.\n */\n\nexport type AiPageBriefDialogProps = Omit<AiBriefDialogProps, 'kind'>\n\nexport function AiPageBriefDialog(props: AiPageBriefDialogProps) {\n  return <AiBriefDialog {...props} kind=\"page\" />\n}\n\nexport default AiPageBriefDialog\n"],"names":["AiBriefDialog","AiPageBriefDialog","props","kind"],"mappings":"AAAA;;;AAEA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,QAAiC,iCAA6B;AAcpF,OAAO,SAASC,kBAAkBC,KAA6B;IAC7D,qBAAO,KAACF,4BAAkBE;QAAOC,MAAK;;AACxC;AAEA,eAAeF,kBAAiB"}

package/src/lib/components/ai-permissions-on-host.component.d.ts

@@ -0,0 +1,55 @@
+import { type ComponentProps } from 'react';
+import { AiAssistProvider } from './ai-assist-provider.component';
+import { AssistPanelComponent } from './assist-panel.component';
+/**
+ * What the console shell hands a provider and the assistant dock (AGL-2984):
+ * the reader's verdict for every catalog key a plugin declared, on the site
+ * in view, with `loaded` false until every read behind it has answered.
+ */
+export interface ShellPermissionsOnHost {
+    loaded: boolean;
+    granted: Readonly<Record<string, boolean>>;
+}
+/** The AI half of that answer, in the shape the AI surfaces hold on. */
+export interface AiPermissionsAnswer {
+    loaded: boolean;
+    use: boolean;
+    generate: boolean;
+}
+/**
+ * The shell's answer read for the two AI keys. `undefined` while the shell
+ * has handed nothing, which the provider reads as pending; one object per
+ * verdict, so the callbacks keyed on it are not rebuilt on every render.
+ */
+export declare function useAiPermissionsOnHost(answer: ShellPermissionsOnHost | undefined): AiPermissionsAnswer | undefined;
+type ProviderProps = Omit<ComponentProps<typeof AiAssistProvider>, 'aiPermissions'> & {
+    permissionsOnHost?: ShellPermissionsOnHost;
+    /**
+     * The plugins that run on the site in view, as the shell resolved them
+     * (AGL-3028). Absent where the shell hands none, which reads as no site
+     * narrowing at all.
+     */
+    enabledPluginIds?: readonly string[];
+};
+/**
+ * The besigner copy assistant's provider, holding on the shell's permission
+ * answer.
+ *
+ * On a site with AI switched off (AGL-3028) it stays MOUNTED — it wraps every
+ * console page, and a provider that came and went per site would remount the
+ * whole tree beneath it — and opens nothing: a settled refusal publishes no
+ * callback, so no control can reach its dialogs.
+ */
+export declare function AiAssistProviderOnHost(props: ProviderProps): import("react").JSX.Element;
+export declare namespace AiAssistProviderOnHost {
+    var displayName: string;
+}
+type PanelProps = Omit<ComponentProps<typeof AssistPanelComponent>, 'aiPermissions'> & {
+    permissionsOnHost?: ShellPermissionsOnHost;
+};
+/** The assistant dock, holding on the shell's permission answer. */
+export declare function AssistPanelOnHost(props: PanelProps): import("react").JSX.Element;
+export declare namespace AssistPanelOnHost {
+    var displayName: string;
+}
+export {};

package/src/lib/components/ai-permissions-on-host.component.js

@@ -0,0 +1,91 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { AI_PLUGIN_ID } from "../constants.js";
+import { aiPermissionsOf } from "../model/ai-permissions.js";
+import { AiAssistProvider } from "./ai-assist-provider.component.js";
+import { AssistPanelComponent } from "./assist-panel.component.js";
+const HELD = {
+    loaded: false,
+    use: false,
+    generate: false
+};
+/**
+ * The shell's answer read for the two AI keys. `undefined` while the shell
+ * has handed nothing, which the provider reads as pending; one object per
+ * verdict, so the callbacks keyed on it are not rebuilt on every render.
+ */ export function useAiPermissionsOnHost(answer) {
+    const present = answer !== undefined;
+    const loaded = (answer == null ? void 0 : answer.loaded) === true;
+    const verdict = aiPermissionsOf(loaded ? answer == null ? void 0 : answer.granted : null);
+    const use = verdict['ai.use'];
+    const generate = verdict['ai.generate'];
+    return useMemo(()=>present ? {
+            loaded,
+            use,
+            generate
+        } : undefined, [
+        present,
+        loaded,
+        use,
+        generate
+    ]);
+}
+/**
+ * Every AI door closed, as a settled answer: what the provider holds on a site
+ * that switched AI off. One object, so the callbacks keyed on it are stable.
+ */ const OFF_FOR_SITE = {
+    loaded: true,
+    use: false,
+    generate: false
+};
+/**
+ * The besigner copy assistant's provider, holding on the shell's permission
+ * answer.
+ *
+ * On a site with AI switched off (AGL-3028) it stays MOUNTED — it wraps every
+ * console page, and a provider that came and went per site would remount the
+ * whole tree beneath it — and opens nothing: a settled refusal publishes no
+ * callback, so no control can reach its dialogs.
+ */ export function AiAssistProviderOnHost(props) {
+    const { permissionsOnHost, enabledPluginIds } = props, rest = _object_without_properties_loose(props, [
+        "permissionsOnHost",
+        "enabledPluginIds"
+    ]);
+    const aiPermissions = useAiPermissionsOnHost(permissionsOnHost);
+    const offForSite = Boolean(enabledPluginIds) && !(enabledPluginIds == null ? void 0 : enabledPluginIds.includes(AI_PLUGIN_ID));
+    return /*#__PURE__*/ _jsx(AiAssistProvider, _extends({}, rest, {
+        aiPermissions: offForSite ? OFF_FOR_SITE : aiPermissions
+    }));
+}
+AiAssistProviderOnHost.displayName = 'AiAssistProviderOnHost';
+/** The assistant dock, holding on the shell's permission answer. */ export function AssistPanelOnHost(props) {
+    var _useAiPermissionsOnHost;
+    const { permissionsOnHost } = props, rest = _object_without_properties_loose(props, [
+        "permissionsOnHost"
+    ]);
+    const aiPermissions = (_useAiPermissionsOnHost = useAiPermissionsOnHost(permissionsOnHost)) != null ? _useAiPermissionsOnHost : HELD;
+    return /*#__PURE__*/ _jsx(AssistPanelComponent, _extends({}, rest, {
+        aiPermissions: aiPermissions
+    }));
+}
+AssistPanelOnHost.displayName = 'AssistPanelOnHost';
+
+//# sourceMappingURL=ai-permissions-on-host.component.js.map

package/src/lib/components/ai-permissions-on-host.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-permissions-on-host.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 { useMemo, type ComponentProps } from 'react'\nimport { AI_PLUGIN_ID } from '../constants'\nimport { aiPermissionsOf } from '../model/ai-permissions'\nimport { AiAssistProvider } from './ai-assist-provider.component'\nimport { AssistPanelComponent } from './assist-panel.component'\n\n/**\n * What the console shell hands a provider and the assistant dock (AGL-2984):\n * the reader's verdict for every catalog key a plugin declared, on the site\n * in view, with `loaded` false until every read behind it has answered.\n */\nexport interface ShellPermissionsOnHost {\n  loaded: boolean\n  granted: Readonly<Record<string, boolean>>\n}\n\n/** The AI half of that answer, in the shape the AI surfaces hold on. */\nexport interface AiPermissionsAnswer {\n  loaded: boolean\n  use: boolean\n  generate: boolean\n}\n\nconst HELD: AiPermissionsAnswer = { loaded: false, use: false, generate: false }\n\n/**\n * The shell's answer read for the two AI keys. `undefined` while the shell\n * has handed nothing, which the provider reads as pending; one object per\n * verdict, so the callbacks keyed on it are not rebuilt on every render.\n */\nexport function useAiPermissionsOnHost(\n  answer: ShellPermissionsOnHost | undefined,\n): AiPermissionsAnswer | undefined {\n  const present = answer !== undefined\n  const loaded = answer?.loaded === true\n  const verdict = aiPermissionsOf(loaded ? answer?.granted : null)\n  const use = verdict['ai.use']\n  const generate = verdict['ai.generate']\n  return useMemo(\n    () => (present ? { loaded, use, generate } : undefined),\n    [present, loaded, use, generate],\n  )\n}\n\ntype ProviderProps = Omit<ComponentProps<typeof AiAssistProvider>, 'aiPermissions'> & {\n  permissionsOnHost?: ShellPermissionsOnHost\n  /**\n   * The plugins that run on the site in view, as the shell resolved them\n   * (AGL-3028). Absent where the shell hands none, which reads as no site\n   * narrowing at all.\n   */\n  enabledPluginIds?: readonly string[]\n}\n\n/**\n * Every AI door closed, as a settled answer: what the provider holds on a site\n * that switched AI off. One object, so the callbacks keyed on it are stable.\n */\nconst OFF_FOR_SITE: AiPermissionsAnswer = { loaded: true, use: false, generate: false }\n\n/**\n * The besigner copy assistant's provider, holding on the shell's permission\n * answer.\n *\n * On a site with AI switched off (AGL-3028) it stays MOUNTED — it wraps every\n * console page, and a provider that came and went per site would remount the\n * whole tree beneath it — and opens nothing: a settled refusal publishes no\n * callback, so no control can reach its dialogs.\n */\nexport function AiAssistProviderOnHost(props: ProviderProps) {\n  const { permissionsOnHost, enabledPluginIds, ...rest } = props\n  const aiPermissions = useAiPermissionsOnHost(permissionsOnHost)\n  const offForSite = Boolean(enabledPluginIds) && !enabledPluginIds?.includes(AI_PLUGIN_ID)\n  return (\n    <AiAssistProvider {...rest} aiPermissions={offForSite ? OFF_FOR_SITE : aiPermissions} />\n  )\n}\nAiAssistProviderOnHost.displayName = 'AiAssistProviderOnHost'\n\ntype PanelProps = Omit<ComponentProps<typeof AssistPanelComponent>, 'aiPermissions'> & {\n  permissionsOnHost?: ShellPermissionsOnHost\n}\n\n/** The assistant dock, holding on the shell's permission answer. */\nexport function AssistPanelOnHost(props: PanelProps) {\n  const { permissionsOnHost, ...rest } = props\n  const aiPermissions = useAiPermissionsOnHost(permissionsOnHost) ?? HELD\n  return <AssistPanelComponent {...rest} aiPermissions={aiPermissions} />\n}\nAssistPanelOnHost.displayName = 'AssistPanelOnHost'\n"],"names":["useMemo","AI_PLUGIN_ID","aiPermissionsOf","AiAssistProvider","AssistPanelComponent","HELD","loaded","use","generate","useAiPermissionsOnHost","answer","present","undefined","verdict","granted","OFF_FOR_SITE","AiAssistProviderOnHost","props","permissionsOnHost","enabledPluginIds","rest","aiPermissions","offForSite","Boolean","includes","displayName","AssistPanelOnHost"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;;;AAEA,SAASA,OAAO,QAA6B,QAAO;AACpD,SAASC,YAAY,QAAQ,kBAAc;AAC3C,SAASC,eAAe,QAAQ,6BAAyB;AACzD,SAASC,gBAAgB,QAAQ,oCAAgC;AACjE,SAASC,oBAAoB,QAAQ,8BAA0B;AAmB/D,MAAMC,OAA4B;IAAEC,QAAQ;IAAOC,KAAK;IAAOC,UAAU;AAAM;AAE/E;;;;CAIC,GACD,OAAO,SAASC,uBACdC,MAA0C;IAE1C,MAAMC,UAAUD,WAAWE;IAC3B,MAAMN,SAASI,CAAAA,0BAAAA,OAAQJ,MAAM,MAAK;IAClC,MAAMO,UAAUX,gBAAgBI,SAASI,0BAAAA,OAAQI,OAAO,GAAG;IAC3D,MAAMP,MAAMM,OAAO,CAAC,SAAS;IAC7B,MAAML,WAAWK,OAAO,CAAC,cAAc;IACvC,OAAOb,QACL,IAAOW,UAAU;YAAEL;YAAQC;YAAKC;QAAS,IAAII,WAC7C;QAACD;QAASL;QAAQC;QAAKC;KAAS;AAEpC;AAYA;;;CAGC,GACD,MAAMO,eAAoC;IAAET,QAAQ;IAAMC,KAAK;IAAOC,UAAU;AAAM;AAEtF;;;;;;;;CAQC,GACD,OAAO,SAASQ,uBAAuBC,KAAoB;IACzD,MAAM,EAAEC,iBAAiB,EAAEC,gBAAgB,EAAW,GAAGF,OAATG,wCAASH;;;;IACzD,MAAMI,gBAAgBZ,uBAAuBS;IAC7C,MAAMI,aAAaC,QAAQJ,qBAAqB,EAACA,oCAAAA,iBAAkBK,QAAQ,CAACvB;IAC5E,qBACE,KAACE,+BAAqBiB;QAAMC,eAAeC,aAAaP,eAAeM;;AAE3E;AACAL,uBAAuBS,WAAW,GAAG;AAMrC,kEAAkE,GAClE,OAAO,SAASC,kBAAkBT,KAAiB;QAE3BR;IADtB,MAAM,EAAES,iBAAiB,EAAW,GAAGD,OAATG,wCAASH;;;IACvC,MAAMI,iBAAgBZ,0BAAAA,uBAAuBS,8BAAvBT,0BAA6CJ;IACnE,qBAAO,KAACD,mCAAyBgB;QAAMC,eAAeA;;AACxD;AACAK,kBAAkBD,WAAW,GAAG"}

package/src/lib/components/ai-product-copy-card.component.d.ts

@@ -0,0 +1,25 @@
+import type { ConsoleProductCopyValues, ConsoleProductEditorZoneProps } from '@aglyn/aglyn/plugin-manager/feature-plugins';
+import { type AiProductCopyProposal } from '../model/ai-products';
+/**
+ * "Write with AI" in the commerce product editor (AGL-2916), through the
+ * `productEditor` zone. A `products` job writes the product's description,
+ * search listing, tags, categories and clearer option names from what the
+ * editor holds: its name, text, tags and options, and its first photo for a
+ * model that reads pictures. The proposal is shown in full, with any fact the
+ * copy could not know marked for the person to fill in, and "Put in the
+ * fields" stages it in the editor as unsaved changes. Save product is the
+ * write; this card never writes a product.
+ */
+/** The brief a product copy job carries, which the jobs list shows. */
+export declare const aiProductCopyBrief: (name: string) => string;
+/** The values a proposal stages, in the editor's terms. */
+export declare function aiProductCopyValues(proposal: AiProductCopyProposal): ConsoleProductCopyValues;
+/** The proposed copy, field by field. */
+export declare function AiProductCopyProposalView(props: {
+    proposal: AiProductCopyProposal;
+}): import("react").JSX.Element;
+export declare function AiProductCopyCard(props: ConsoleProductEditorZoneProps): import("react").JSX.Element;
+export declare namespace AiProductCopyCard {
+    var displayName: string;
+}
+export default AiProductCopyCard;