@fraza/module-ai 0.0.0-stage → 0.4.22

package/changelog.json

@@ -0,0 +1,459 @@
+{
+  "name": "@fraza/module-ai",
+  "versions": [
+    {
+      "version": "0.4.22",
+      "date": "2026-11-08",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": []
+    },
+    {
+      "version": "0.4.21",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "feat",
+          "scope": "ui",
+          "subject": "add animated working status to ai studio",
+          "hash": "92e1667",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.20",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "style",
+          "scope": "ui",
+          "subject": "move studio composer focus light inside the box",
+          "hash": "78f9481",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.19",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "style",
+          "scope": "ui",
+          "subject": "soften studio composer focus glow and grain",
+          "hash": "b93cb0d",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.18",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "style",
+          "scope": "ui",
+          "subject": "reshape studio composer glow to match the box",
+          "hash": "d54e21a",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.17",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "style",
+          "scope": "ui",
+          "subject": "soften studio composer focus glow",
+          "hash": "7693879",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.16",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "style",
+          "scope": "ui",
+          "subject": "soften studio composer glow and shadow",
+          "hash": "88946a9",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.15",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "feat",
+          "scope": "admin",
+          "subject": "add start mode panel to studio composer",
+          "hash": "2cbd1f6",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.14",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "refactor",
+          "scope": "ai",
+          "subject": "extract studio composer into its own component",
+          "hash": "4e74444",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.13",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "style",
+          "scope": "ui",
+          "subject": "add bottom border to studio label bar",
+          "hash": "fc4d004",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.12",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "refactor",
+          "scope": "admin",
+          "subject": "move studio bar and window layout into shared component",
+          "hash": "ea95fdf",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.11",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "feat",
+          "scope": "studio",
+          "subject": "group hints into menus and animate the compose layout",
+          "hash": "662ef1c",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.10",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "feat",
+          "scope": "ai",
+          "subject": "add studio compose mode and plan review",
+          "hash": "46ded16",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.9",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "refactor",
+          "scope": "admin",
+          "subject": "rename ai sparkles icon to sparkles icon",
+          "hash": "3ccf3f6",
+          "breaking": false
+        },
+        {
+          "type": "feat",
+          "scope": "admin",
+          "subject": "add icon-only and size options to ai actions trigger",
+          "hash": "eaa0877",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.8",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "refactor",
+          "scope": "ui",
+          "subject": "replace ChatSparkIcon with AiSparklesIcon",
+          "hash": "1dd3dee",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.7",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "refactor",
+          "scope": "ui",
+          "subject": "rename ai apply wording to \"appliquer\" and \"laisser tel quel\"",
+          "hash": "471087a",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.6",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "feat",
+          "scope": "ai",
+          "subject": "add studio mode for comparing and applying prompt versions",
+          "hash": "d2b427d",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.5",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "feat",
+          "scope": "admin",
+          "subject": "enlarge and make resizable long text inputs in ai form",
+          "hash": "858b23c",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.4",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "feat",
+          "scope": "ai",
+          "subject": "add configurable menu label with action descriptions",
+          "hash": "526a6f7",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.3",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "refactor",
+          "scope": "admin",
+          "subject": "use ai trigger component for single action button",
+          "hash": "b79c212",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.2",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "feat",
+          "scope": "ai",
+          "subject": "redesign ai modal with preview, steps and eyebrow",
+          "hash": "ec4ca14",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.1",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "refactor",
+          "scope": "ai",
+          "subject": "use core ai design system in admin actions",
+          "hash": "44cf966",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.4.0",
+      "date": "2026-11-07",
+      "breaking": [],
+      "envAdded": [
+        "FRAZA_MODULE_AI",
+        "FRAZA_MODULE_AI_API_KEY",
+        "FRAZA_MODULE_AI_BASE_URL",
+        "FRAZA_MODULE_AI_MODEL",
+        "FRAZA_MODULE_AI_PROVIDER",
+        "FRAZA_MODULE_AI_RETENTION_DAYS",
+        "FRAZA_MODULE_AI_TIMEOUT_MS"
+      ],
+      "envRemoved": [],
+      "envRenamed": [],
+      "templateChanged": [],
+      "action": [
+        "npx fraza-db migrate",
+        "npx fraza-doctor --fix"
+      ],
+      "entries": [
+        {
+          "type": "feat",
+          "scope": null,
+          "subject": "add ai module with providers, admin pages and prompts",
+          "hash": "6c49c51",
+          "breaking": false
+        },
+        {
+          "type": "other",
+          "scope": null,
+          "subject": "Initial commit",
+          "hash": "6240154",
+          "breaking": false
+        }
+      ]
+    }
+  ]
+}

package/dist/admin/AiActions.client.js

@@ -0,0 +1,166 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import React, { useCallback, useEffect, useId, useMemo, useState } from "react";
+import { AiPreview, AiTrigger, AiWorking, Button, Modal } from "@fraza/core/shared/components";
+import { apiFetch } from "@fraza/core/shared/http";
+import { useToast } from "@fraza/core/toast";
+import { SparklesIcon } from "@fraza/icons/SparklesIcon";
+import AiChoices from "./AiChoices.client.js";
+import AiInputForm from "./AiInputForm.client.js";
+import AiStudio from "./AiStudio.client.js";
+import { applyChoices } from "./choices.js";
+import { formFields, initialValues, readValues } from "./input-form.js";
+import { AI_API } from "./paths.js";
+function useActions(target, scopeKey) {
+  const [actions, setActions] = useState([]);
+  useEffect(() => {
+    let cancelled = false;
+    const query = new URLSearchParams({ target, scope: scopeKey });
+    apiFetch(`${AI_API}/actions?${query}`).then((data) => {
+      if (!cancelled) setActions((data == null ? void 0 : data.configured) ? data.actions ?? [] : []);
+    }).catch(() => {
+      if (!cancelled) setActions([]);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [target, scopeKey]);
+  return actions;
+}
+function stepsOf(output) {
+  return Object.entries((output == null ? void 0 : output.properties) ?? {}).map(([key, node]) => node.title ?? key);
+}
+const KEEP_NOTE = "Rien n'est enregistr\xE9 avant la relecture.";
+function AiActions({ target, scope = {}, context, current, onApply, disabled = false, preview, menuLabel = "Actions d'IA", iconOnly = false, size }) {
+  const toast = useToast();
+  const formId = useId();
+  const scopeKey = useMemo(() => JSON.stringify(scope ?? {}), [scope]);
+  const actions = useActions(target, scopeKey);
+  const [active, setActive] = useState(null);
+  const [phase, setPhase] = useState(null);
+  const [values, setValues] = useState({});
+  const [errors, setErrors] = useState({});
+  const [answer, setAnswer] = useState(null);
+  const fields = useMemo(() => formFields(active == null ? void 0 : active.input), [active]);
+  const working = phase === "working";
+  const close = useCallback(() => {
+    setPhase(null);
+    setActive(null);
+    setAnswer(null);
+    setErrors({});
+  }, []);
+  const run = useCallback(async (action, input) => {
+    setActive(action);
+    setPhase("working");
+    try {
+      const data = await apiFetch(`${AI_API}/run`, {
+        method: "POST",
+        body: {
+          prompt: action.name,
+          input,
+          scope: JSON.parse(scopeKey),
+          context: typeof context === "function" ? context() : context ?? null
+        }
+      });
+      if (action.mode === "choose") {
+        setAnswer(data.data);
+        setPhase("choose");
+        return;
+      }
+      onApply == null ? void 0 : onApply(data.data);
+      close();
+      toast.success("Les champs ont \xE9t\xE9 remplis. Relire avant d'enregistrer.");
+    } catch (error) {
+      toast.error(error.message || "L'IA n'a pas pu r\xE9pondre.");
+      if (formFields(action.input).length > 0) setPhase("form");
+      else close();
+    }
+  }, [close, context, onApply, scopeKey, toast]);
+  const [studio, setStudio] = useState(null);
+  const start = useCallback((action) => {
+    if (action.mode === "studio") {
+      setStudio({ action, current: (typeof current === "function" ? current() : current) ?? {} });
+      return;
+    }
+    const actionFields = formFields(action.input);
+    if (actionFields.length === 0) {
+      run(action, null);
+      return;
+    }
+    setValues(initialValues(actionFields));
+    setErrors({});
+    setAnswer(null);
+    setActive(action);
+    setPhase("form");
+  }, [current, run]);
+  const submitForm = useCallback((event) => {
+    event == null ? void 0 : event.preventDefault();
+    const { input, errors: found } = readValues(fields, values);
+    setErrors(found);
+    if (Object.keys(found).length === 0) run(active, input);
+  }, [active, fields, run, values]);
+  const applyPicked = useCallback((picked) => {
+    onApply == null ? void 0 : onApply(applyChoices(active.output, answer, picked));
+    close();
+    toast.success("La proposition est appliqu\xE9e. Relire avant d'enregistrer.");
+  }, [active, answer, close, onApply, toast]);
+  if (actions.length === 0) return null;
+  const trigger = actions.length === 1 ? /* @__PURE__ */ jsx(AiTrigger, { disabled: disabled || working, iconOnly, size, onClick: () => start(actions[0]), children: actions[0].label }) : /* @__PURE__ */ jsx(
+    AiTrigger,
+    {
+      disabled: disabled || working,
+      iconOnly,
+      size,
+      items: actions.map((action) => ({ label: action.label, description: action.description ?? void 0, onClick: () => start(action) })),
+      children: menuLabel
+    }
+  );
+  const media = (preview == null ? void 0 : preview.src) ? /* @__PURE__ */ jsx(AiPreview, { src: preview.src, alt: preview.alt ?? "", label: preview.label }) : null;
+  const eyebrow = phase === "choose" ? "Propos\xE9 par l'IA" : phase === "working" ? "L'IA r\xE9dige" : active == null ? void 0 : active.label;
+  const title = phase === "working" ? active == null ? void 0 : active.label : (active == null ? void 0 : active.heading) ?? (active == null ? void 0 : active.label);
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    trigger,
+    studio && /* @__PURE__ */ jsx(
+      AiStudio,
+      {
+        isOpen: true,
+        action: studio.action,
+        scope: JSON.parse(scopeKey),
+        context,
+        current: studio.current,
+        onApply: (values2) => onApply == null ? void 0 : onApply(values2),
+        onClose: () => setStudio(null)
+      }
+    ),
+    /* @__PURE__ */ jsxs(
+      Modal,
+      {
+        variant: "ai",
+        isOpen: phase !== null,
+        onClose: close,
+        closable: !working,
+        loading: working,
+        eyebrow,
+        title: title ?? "",
+        media,
+        description: phase === "form" ? (active == null ? void 0 : active.description) ?? void 0 : void 0,
+        size: phase === "choose" ? "lg" : "md",
+        footer: phase === "form" ? /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-3", children: [
+          /* @__PURE__ */ jsx("span", { className: "text-[12px] text-fg-muted", children: KEEP_NOTE }),
+          /* @__PURE__ */ jsxs("div", { className: "flex gap-2", children: [
+            /* @__PURE__ */ jsx(Button, { variant: "secondary", onClick: close, children: "Annuler" }),
+            /* @__PURE__ */ jsx(Button, { variant: "ai", type: "submit", form: formId, icon: SparklesIcon, children: "G\xE9n\xE9rer" })
+          ] })
+        ] }) : null,
+        children: [
+          phase === "form" && /* @__PURE__ */ jsx("form", { id: formId, onSubmit: submitForm, noValidate: true, children: /* @__PURE__ */ jsx(AiInputForm, { fields, values, errors, onChange: setValues }) }),
+          working && /* @__PURE__ */ jsx(AiWorking, { steps: stepsOf(active == null ? void 0 : active.output) }),
+          phase === "choose" && answer && /* @__PURE__ */ jsx(AiChoices, { schema: active.output, data: answer, onApply: applyPicked, onCancel: close, note: KEEP_NOTE })
+        ]
+      }
+    )
+  ] });
+}
+export {
+  AiActions as default
+};

package/dist/admin/AiChoices.client.js

@@ -0,0 +1,67 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import React, { useState } from "react";
+import { AI_CLASSES, Button } from "@fraza/core/shared/components";
+import { CheckIcon } from "@fraza/icons/CheckIcon";
+import { choiceGroups } from "./choices.js";
+const SLUG = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+function Proposal({ text, picked, mono, delay, onPick }) {
+  return /* @__PURE__ */ jsxs(
+    "button",
+    {
+      type: "button",
+      "aria-pressed": picked,
+      onClick: onPick,
+      style: { animationDelay: `${delay}s` },
+      className: `${AI_CLASSES.arrive} flex min-h-10 w-full items-start gap-2.5 rounded-control border px-3 py-2.5 text-left text-fg transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-surface ${picked ? AI_CLASSES.optionPicked : AI_CLASSES.option}`,
+      children: [
+        /* @__PURE__ */ jsx("span", { "aria-hidden": "true", className: `mt-0.5 flex h-4 w-4 shrink-0 items-center justify-center rounded-full border ${picked ? "border-accent bg-accent text-accent-fg" : "border-line-strong"}`, children: picked && /* @__PURE__ */ jsx(CheckIcon, { className: "h-2.5 w-2.5" }) }),
+        /* @__PURE__ */ jsx("span", { className: mono ? "break-all font-code text-[13px] leading-5" : `text-[15px] leading-[21px] ${AI_CLASSES.voice}`, children: text })
+      ]
+    }
+  );
+}
+function AiChoices({ schema, data, onApply, onCancel, note }) {
+  const groups = choiceGroups(schema, data);
+  const [picked, setPicked] = useState(() => Object.fromEntries(groups.map((group) => [group.key, 0])));
+  let order = 0;
+  return /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-5", children: [
+    groups.map((group) => {
+      const mono = group.options.every((option) => SLUG.test(option));
+      return /* @__PURE__ */ jsxs("fieldset", { className: "m-0 flex flex-col gap-1.5 border-0 p-0", children: [
+        /* @__PURE__ */ jsx("legend", { className: "mb-2 p-0 text-[12.5px] font-medium text-fg", children: group.title }),
+        group.options.map((option, index) => /* @__PURE__ */ jsx(
+          Proposal,
+          {
+            text: option,
+            mono,
+            picked: picked[group.key] === index,
+            delay: order++ * 0.12,
+            onPick: () => setPicked({ ...picked, [group.key]: index })
+          },
+          index
+        )),
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            "aria-pressed": picked[group.key] === null,
+            onClick: () => setPicked({ ...picked, [group.key]: null }),
+            className: `self-start px-0.5 py-1 text-[12.5px] transition-colors hover:text-fg ${picked[group.key] === null ? "text-fg" : "text-fg-muted"}`,
+            children: "Laisser tel quel"
+          }
+        )
+      ] }, group.key);
+    }),
+    /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-3 pb-4", children: [
+      /* @__PURE__ */ jsx("span", { className: "text-[12px] text-fg-muted", children: note }),
+      /* @__PURE__ */ jsxs("div", { className: "flex gap-2", children: [
+        /* @__PURE__ */ jsx(Button, { variant: "secondary", onClick: onCancel, children: "Annuler" }),
+        /* @__PURE__ */ jsx(Button, { variant: "ai", onClick: () => onApply(picked), children: "Appliquer" })
+      ] })
+    ] })
+  ] });
+}
+export {
+  AiChoices as default
+};