@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/components/ai-describe-button.component.js

@@ -0,0 +1,87 @@
+'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { Button } from "@mui/material";
+import { useEffect, useRef, useState } from "react";
+import { AiBriefDialog } from "./ai-brief-dialog.component.js";
+/**
+ * Renders nothing until the jobs route has answered for this workspace: the
+ * shell decided the plan, the member's permission and the site's AI switch
+ * before mounting it, and the release flag is the route's to decide, so a 404
+ * or a 403 there is this control staying absent. A lockdown is the start
+ * door's to say, in the dialog, in its own words.
+ */ export function AiDescribeButton({ kind, hostId, orgId }) {
+    var _ref;
+    const { data: user } = useUser();
+    // Held in a ref so the probe keys on WHO is signed in, never on the
+    // identity of the object that says so.
+    const userRef = useRef(user);
+    userRef.current = user;
+    const uid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    const [verdict, setVerdict] = useState('checking');
+    const [open, setOpen] = useState(false);
+    useEffect(()=>{
+        if (!orgId || !uid) return;
+        let active = true;
+        void (async ()=>{
+            try {
+                const response = await authorizedFetch(userRef.current, `/api/ai/jobs?orgId=${encodeURIComponent(orgId)}&limit=1`);
+                if (active) {
+                    setVerdict(response.status === 404 || response.status === 403 ? 'hidden' : 'ready');
+                }
+            } catch (unused) {
+                if (active) setVerdict('hidden');
+            }
+        })();
+        return ()=>{
+            active = false;
+        };
+    }, [
+        orgId,
+        uid
+    ]);
+    if (verdict !== 'ready') return null;
+    return /*#__PURE__*/ _jsxs(_Fragment, {
+        children: [
+            /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                variant: "outlined",
+                onClick: ()=>setOpen(true),
+                children: 'Describe it'
+            }),
+            /*#__PURE__*/ _jsx(AiBriefDialog, {
+                kind: kind,
+                open: open,
+                onClose: ()=>setOpen(false),
+                orgId: orgId,
+                hostId: hostId,
+                user: user
+            })
+        ]
+    });
+}
+/** A page template from a brief, on the Templates page (`hostTemplates`). */ export function AiDescribeTemplateButton(props) {
+    return /*#__PURE__*/ _jsx(AiDescribeButton, _extends({}, props, {
+        kind: "template"
+    }));
+}
+/** A layout from a brief, on the Layouts page (`hostLayouts`). */ export function AiDescribeLayoutButton(props) {
+    return /*#__PURE__*/ _jsx(AiDescribeButton, _extends({}, props, {
+        kind: "layout"
+    }));
+}
+/** A form from a brief, on the Forms page (`hostForms`). */ export function AiDescribeFormButton(props) {
+    return /*#__PURE__*/ _jsx(AiDescribeButton, _extends({}, props, {
+        kind: "form"
+    }));
+}
+/** A reusable component from a brief, on the Components page (`hostComponents`). */ export function AiDescribeComponentButton(props) {
+    return /*#__PURE__*/ _jsx(AiDescribeButton, _extends({}, props, {
+        kind: "component"
+    }));
+}
+export default AiDescribeButton;
+
+//# sourceMappingURL=ai-describe-button.component.js.map

package/src/lib/components/ai-describe-button.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-describe-button.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 type {\n  ConsoleHostComponentsZoneProps,\n  ConsoleHostFormsZoneProps,\n  ConsoleHostLayoutsZoneProps,\n  ConsoleHostScreensZoneProps,\n  ConsoleHostTemplatesZoneProps,\n} from '@aglyn/aglyn/plugin-manager/feature-plugins'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { Button } from '@mui/material'\nimport { useEffect, useRef, useState } from 'react'\nimport { AiBriefDialog, type AiBriefKind } from './ai-brief-dialog.component'\n\n/**\n * \"Describe it\" (AGL-2907, AGL-3043, AGL-3051): a job from a brief, beside the\n * create actions of the page that lists what the job makes — a page on\n * Screens, a page template on Templates, a layout on Layouts, a form on Forms\n * and a reusable component on Components — each mounted through that page's\n * zone. The Assist panel's AI jobs opens the same dialog for a page.\n */\n\ntype Verdict = 'checking' | 'ready' | 'hidden'\n\nexport interface AiDescribeButtonProps extends ConsoleHostScreensZoneProps {\n  /** The job the brief starts: what the page the button sits on lists. */\n  kind: AiBriefKind\n}\n\n/**\n * Renders nothing until the jobs route has answered for this workspace: the\n * shell decided the plan, the member's permission and the site's AI switch\n * before mounting it, and the release flag is the route's to decide, so a 404\n * or a 403 there is this control staying absent. A lockdown is the start\n * door's to say, in the dialog, in its own words.\n */\nexport function AiDescribeButton({ kind, hostId, orgId }: AiDescribeButtonProps) {\n  const { data: user } = useUser()\n  // Held in a ref so the probe keys on WHO is signed in, never on the\n  // identity of the object that says so.\n  const userRef = useRef(user)\n  userRef.current = user\n  const uid = user?.uid ?? null\n  const [verdict, setVerdict] = useState<Verdict>('checking')\n  const [open, setOpen] = useState(false)\n\n  useEffect(() => {\n    if (!orgId || !uid) return\n    let active = true\n    void (async () => {\n      try {\n        const response = await authorizedFetch(\n          userRef.current,\n          `/api/ai/jobs?orgId=${encodeURIComponent(orgId)}&limit=1`,\n        )\n        if (active) {\n          setVerdict(response.status === 404 || response.status === 403 ? 'hidden' : 'ready')\n        }\n      } catch {\n        if (active) setVerdict('hidden')\n      }\n    })()\n    return () => {\n      active = false\n    }\n  }, [orgId, uid])\n\n  if (verdict !== 'ready') return null\n  return (\n    <>\n      <Button size=\"small\" variant=\"outlined\" onClick={() => setOpen(true)}>\n        {'Describe it'}\n      </Button>\n      <AiBriefDialog\n        kind={kind}\n        open={open}\n        onClose={() => setOpen(false)}\n        orgId={orgId}\n        hostId={hostId}\n        user={user}\n      />\n    </>\n  )\n}\n\n/** A page template from a brief, on the Templates page (`hostTemplates`). */\nexport function AiDescribeTemplateButton(props: ConsoleHostTemplatesZoneProps) {\n  return <AiDescribeButton {...props} kind=\"template\" />\n}\n\n/** A layout from a brief, on the Layouts page (`hostLayouts`). */\nexport function AiDescribeLayoutButton(props: ConsoleHostLayoutsZoneProps) {\n  return <AiDescribeButton {...props} kind=\"layout\" />\n}\n\n/** A form from a brief, on the Forms page (`hostForms`). */\nexport function AiDescribeFormButton(props: ConsoleHostFormsZoneProps) {\n  return <AiDescribeButton {...props} kind=\"form\" />\n}\n\n/** A reusable component from a brief, on the Components page (`hostComponents`). */\nexport function AiDescribeComponentButton(props: ConsoleHostComponentsZoneProps) {\n  return <AiDescribeButton {...props} kind=\"component\" />\n}\n\nexport default AiDescribeButton\n"],"names":["authorizedFetch","useUser","Button","useEffect","useRef","useState","AiBriefDialog","AiDescribeButton","kind","hostId","orgId","data","user","userRef","current","uid","verdict","setVerdict","open","setOpen","active","response","encodeURIComponent","status","size","variant","onClick","onClose","AiDescribeTemplateButton","props","AiDescribeLayoutButton","AiDescribeFormButton","AiDescribeComponentButton"],"mappings":"AAAA;;;AA0BA,SAASA,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,OAAO,QAAQ,iCAAgC;AACxD,SAASC,MAAM,QAAQ,gBAAe;AACtC,SAASC,SAAS,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,QAAO;AACnD,SAASC,aAAa,QAA0B,iCAA6B;AAiB7E;;;;;;CAMC,GACD,OAAO,SAASC,iBAAiB,EAAEC,IAAI,EAAEC,MAAM,EAAEC,KAAK,EAAyB;;IAC7E,MAAM,EAAEC,MAAMC,IAAI,EAAE,GAAGX;IACvB,oEAAoE;IACpE,uCAAuC;IACvC,MAAMY,UAAUT,OAAOQ;IACvBC,QAAQC,OAAO,GAAGF;IAClB,MAAMG,cAAMH,wBAAAA,KAAMG,GAAG,mBAAI;IACzB,MAAM,CAACC,SAASC,WAAW,GAAGZ,SAAkB;IAChD,MAAM,CAACa,MAAMC,QAAQ,GAAGd,SAAS;IAEjCF,UAAU;QACR,IAAI,CAACO,SAAS,CAACK,KAAK;QACpB,IAAIK,SAAS;QACb,KAAK,AAAC,CAAA;YACJ,IAAI;gBACF,MAAMC,WAAW,MAAMrB,gBACrBa,QAAQC,OAAO,EACf,CAAC,mBAAmB,EAAEQ,mBAAmBZ,OAAO,QAAQ,CAAC;gBAE3D,IAAIU,QAAQ;oBACVH,WAAWI,SAASE,MAAM,KAAK,OAAOF,SAASE,MAAM,KAAK,MAAM,WAAW;gBAC7E;YACF,EAAE,eAAM;gBACN,IAAIH,QAAQH,WAAW;YACzB;QACF,CAAA;QACA,OAAO;YACLG,SAAS;QACX;IACF,GAAG;QAACV;QAAOK;KAAI;IAEf,IAAIC,YAAY,SAAS,OAAO;IAChC,qBACE;;0BACE,KAACd;gBAAOsB,MAAK;gBAAQC,SAAQ;gBAAWC,SAAS,IAAMP,QAAQ;0BAC5D;;0BAEH,KAACb;gBACCE,MAAMA;gBACNU,MAAMA;gBACNS,SAAS,IAAMR,QAAQ;gBACvBT,OAAOA;gBACPD,QAAQA;gBACRG,MAAMA;;;;AAId;AAEA,2EAA2E,GAC3E,OAAO,SAASgB,yBAAyBC,KAAoC;IAC3E,qBAAO,KAACtB,+BAAqBsB;QAAOrB,MAAK;;AAC3C;AAEA,gEAAgE,GAChE,OAAO,SAASsB,uBAAuBD,KAAkC;IACvE,qBAAO,KAACtB,+BAAqBsB;QAAOrB,MAAK;;AAC3C;AAEA,0DAA0D,GAC1D,OAAO,SAASuB,qBAAqBF,KAAgC;IACnE,qBAAO,KAACtB,+BAAqBsB;QAAOrB,MAAK;;AAC3C;AAEA,kFAAkF,GAClF,OAAO,SAASwB,0BAA0BH,KAAqC;IAC7E,qBAAO,KAACtB,+BAAqBsB;QAAOrB,MAAK;;AAC3C;AAEA,eAAeD,iBAAgB"}

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

@@ -0,0 +1,26 @@
+/**
+ * @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 { ConsoleHostScreensZoneProps } from '@aglyn/aglyn/plugin-manager/feature-plugins';
+/**
+ * "Describe it" (AGL-2907): a page from a brief, beside Templates and Create
+ * New Screen on a site's Screens page, mounted through the `hostScreens`
+ * zone. The Assist panel's AI jobs opens the same dialog. The button, its
+ * probe and its dialog are the ones every describe entry shares
+ * (`ai-describe-button.component.tsx`, AGL-3043).
+ */
+export declare function AiDescribePageButton(props: ConsoleHostScreensZoneProps): import("react").JSX.Element;
+export default AiDescribePageButton;

package/src/lib/components/ai-describe-page.component.js

@@ -0,0 +1,18 @@
+'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { AiDescribeButton } from "./ai-describe-button.component.js";
+/**
+ * "Describe it" (AGL-2907): a page from a brief, beside Templates and Create
+ * New Screen on a site's Screens page, mounted through the `hostScreens`
+ * zone. The Assist panel's AI jobs opens the same dialog. The button, its
+ * probe and its dialog are the ones every describe entry shares
+ * (`ai-describe-button.component.tsx`, AGL-3043).
+ */ export function AiDescribePageButton(props) {
+    return /*#__PURE__*/ _jsx(AiDescribeButton, _extends({}, props, {
+        kind: "page"
+    }));
+}
+export default AiDescribePageButton;
+
+//# sourceMappingURL=ai-describe-page.component.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-describe-page.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 type { ConsoleHostScreensZoneProps } from '@aglyn/aglyn/plugin-manager/feature-plugins'\nimport { AiDescribeButton } from './ai-describe-button.component'\n\n/**\n * \"Describe it\" (AGL-2907): a page from a brief, beside Templates and Create\n * New Screen on a site's Screens page, mounted through the `hostScreens`\n * zone. The Assist panel's AI jobs opens the same dialog. The button, its\n * probe and its dialog are the ones every describe entry shares\n * (`ai-describe-button.component.tsx`, AGL-3043).\n */\nexport function AiDescribePageButton(props: ConsoleHostScreensZoneProps) {\n  return <AiDescribeButton {...props} kind=\"page\" />\n}\n\nexport default AiDescribePageButton\n"],"names":["AiDescribeButton","AiDescribePageButton","props","kind"],"mappings":"AAAA;;;AAoBA,SAASA,gBAAgB,QAAQ,oCAAgC;AAEjE;;;;;;CAMC,GACD,OAAO,SAASC,qBAAqBC,KAAkC;IACrE,qBAAO,KAACF,+BAAqBE;QAAOC,MAAK;;AAC3C;AAEA,eAAeF,qBAAoB"}

package/src/lib/components/ai-experiment-cards.component.d.ts

@@ -0,0 +1,75 @@
+import { type AiExperimentTarget } from '../model/ai-experiment';
+import { type AiExperimentExplanationProposal, type AiExperimentVariantsProposalView } from '../model/ai-experiment-proposal';
+/** One of the experiment editor's variants, as the zone hands it over. */
+export interface AiExperimentZoneVariant {
+    id: string;
+    name: string;
+    subject: string;
+    body: string;
+}
+/** What the variants zone hands this widget. */
+export interface AiExperimentVariantsCardProps {
+    hostId: string;
+    experimentId: string;
+    name: string;
+    target: AiExperimentTarget;
+    goal: string;
+    variants: AiExperimentZoneVariant[];
+    proposeVariants: (variants: readonly AiExperimentZoneVariant[], key: string) => void;
+}
+/** What the result zone hands this widget. */
+export interface AiExperimentResultCardProps {
+    hostId: string;
+    experimentId: string;
+    test: string;
+}
+/**
+ * The copy an email test varies, as the editor holds it: the FIRST variant's
+ * subject and body, which is the control. A screen or a section varies a
+ * screen version, which the editor does not hold, so there is nothing to
+ * prefill and the person pastes what is under test.
+ */
+export declare function aiExperimentSubjectFrom(target: AiExperimentTarget, variants: readonly AiExperimentZoneVariant[]): string;
+/**
+ * A proposal mapped onto the editor's variants, in order. Only the fields
+ * that target has a place for are filled: an email varies its subject and
+ * body, and a screen or a section varies a screen version, so there only the
+ * name is filled and the copy is read on the card.
+ */
+export declare function aiExperimentVariantDrafts(target: AiExperimentTarget, variants: readonly AiExperimentZoneVariant[], proposal: AiExperimentVariantsProposalView): AiExperimentZoneVariant[];
+/** Where a proposed variant's copy lands, said before the person presses the button. */
+export declare function aiExperimentApplyCopy(target: AiExperimentTarget): string;
+/**
+ * "Write variants with AI", in the experiment editor beneath the variants it
+ * writes for. It proposes COPY: no weight, no traffic split, no goal and no
+ * schedule, and the first variant it writes is the copy as it stands so the
+ * test has something to measure against.
+ */
+export declare function AiExperimentVariantsCard(props: AiExperimentVariantsCardProps): import("react").JSX.Element;
+export declare namespace AiExperimentVariantsCard {
+    var displayName: string;
+}
+/**
+ * The explanation, drawn to the verdict rather than to the numbers.
+ *
+ * The chip and the caveat come FIRST, above the prose: a reader who stops
+ * after one line must stop on what the result settled, not on a sentence
+ * about one variant. No row is marked unless the verdict names an arm, and
+ * `aiExperimentArmIsNamed` is asked per row rather than `winnerId` compared
+ * directly, so a stored winner beside an undecided verdict marks nothing.
+ */
+export declare function AiExperimentExplanation({ explanation, }: {
+    explanation: AiExperimentExplanationProposal;
+}): import("react").JSX.Element;
+export declare namespace AiExperimentExplanation {
+    var displayName: string;
+}
+/**
+ * "Explain this result", below one test's figures. It starts an `experiment`
+ * job, which reads the same figures the dialog above it shows, decides what
+ * they support in code, and asks a model only for the words.
+ */
+export declare function AiExperimentResultCard(props: AiExperimentResultCardProps): import("react").JSX.Element;
+export declare namespace AiExperimentResultCard {
+    var displayName: string;
+}