data-primals-engine 1.7.2 → 1.7.3

package/client/src/RTETrans.jsx

@@ -15,7 +15,7 @@ const RTETrans = ({ value, onChange, field }) => {
         params.append('model', 'lang');
         params.append("_user", getUserId(me));
         params.append("depth", '1');
-        return fetch(`/api/data/search?${params.toString()}`, { signal, method: 'POST', body: JSON.stringify({}), headers: { "Content-Type": "application/json"}})
+        return fetch(`/api/data/search?${params.toString()}`, { credentials:"include", signal, method: 'POST',  body: JSON.stringify({}), headers: { "Content-Type": "application/json"}})
             .then((res) => res.json())
             .then((data) => {
                 setAvailableLangs(data.data || []);

package/client/src/RelationField.jsx

@@ -49,6 +49,7 @@ const RelationField = ({ field, help, onFocus, onBlur, onChange, value = null })
 
             const response = await fetch(`/api/data/search?${params.toString()}`, {
                 method: 'POST',
+                credentials:"include",
                 headers: { 'Content-Type': 'application/json' },
                 body: JSON.stringify({ filter: {} }) // Le filtre peut être vide quand on cherche par IDs
             });
@@ -126,6 +127,7 @@ const RelationField = ({ field, help, onFocus, onBlur, onChange, value = null })
                 body: JSON.stringify({ filter: finalFilter }),
                 method: 'POST',
                 signal: signal,
+                credentials:"include",
                 headers: { 'Content-Type': 'application/json' },
             })
                 .then(e => e.json())

package/client/src/RelationSelectorWidget.jsx

@@ -13,6 +13,7 @@ import { useAuthContext } from './contexts/AuthContext.jsx';
 const insertDataAPI = async (modelName, data) => {
     const response = await fetch(`/api/data`, {
         method: 'POST',
+        credentials:"include",
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({model: modelName,data})
     });
@@ -27,6 +28,7 @@ const searchDataAPI = async (modelName, filter) => {
     const params = new URLSearchParams({ model: modelName, depth: '1' });
     const response = await fetch(`/api/data/search?${params.toString()}`, {
         method: 'POST',
+        credentials:"include",
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({ filter })
     });

package/client/src/RelationValue.jsx

@@ -44,6 +44,7 @@ const RelationValue = ({ field, data, align }) => {
 
             return fetch(`/api/data/search?${params.toString()}`, {
                 method: 'POST',
+                credentials:"include",
                 headers: { 'Content-Type': 'application/json' },
             })
                 .then(res => res.json())

package/client/src/RestoreDialog.jsx

@@ -42,6 +42,7 @@ function RestoreDialog() {
             try {
                 const response = await fetch(apiUrl, {
                     method: 'GET', // Ou 'POST' si l'API l'exige, mais GET semble plus probable ici
+                    credentials:"include",
                     headers: {
                         'Accept': 'application/json',
                         // Ajoute d'autres headers si nécessaire (ex: Authorization si requis)

package/client/src/WorkflowEditor.jsx

@@ -84,6 +84,7 @@ const WorkflowEditor = ({ workflowId }) => {
         ['mainWorkflow', workflowId],
         () => fetch('/api/data/search?_user='+me.username, {
             method: 'POST',
+            credentials:"include",
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({
                 model: 'workflow',
@@ -102,6 +103,7 @@ const WorkflowEditor = ({ workflowId }) => {
         ['workflowSteps', workflowId],
         () => fetch('/api/data/search?_user=' + me.username, {
             method: 'POST',
+            credentials:"include",
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({
                 model: 'workflowStep',
@@ -122,6 +124,7 @@ const WorkflowEditor = ({ workflowId }) => {
         ['workflowActions', workflowId],
         () => fetch('/api/data/search?_user=' + me.username, {
             method: 'POST',
+            credentials:"include",
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({
                 model: 'workflowAction',

package/client/src/contexts/CommandContext.jsx

@@ -116,7 +116,7 @@ export class InsertCommand {
     async undo() {
         // On garde une copie de l'item avant de le supprimer pour le redo.
         if (!this.insertedItem?._id) throw new Error("Cannot undo insert: item ID is missing.");
-        const response = await fetch(`/api/data/${this.insertedItem._id}`, { method: 'DELETE' });
+        const response = await fetch(`/api/data/${this.insertedItem._id}`, { credentials:"include",method: 'DELETE' });
         const result = await response.json();
         if (!response.ok || !result.success) {
             throw new Error(result.error || 'Undo (delete) failed');
@@ -184,6 +184,7 @@ export class DeleteCommand {
  
             return fetch('/api/data?_user=system', { // On ajoute _user=system pour tracer l'origine de l'action
                 method: 'POST',
+                credentials:"include",
                 headers: { 'Content-Type': 'application/json' },
                 body: JSON.stringify({ model: this.modelName, data: reinsertData }),
             }).then(res => res.json().then(data => {

package/client/src/contexts/ModelContext.jsx

@@ -45,7 +45,7 @@ export const ModelProvider = ({ children }) => {
     const { data: dataModels = [], isFetched } = useQuery(['api/models', me], () => {
         if(!me)
             return Promise.reject();
-        return fetch(`/api/models?lang=${lang}&_user=${encodeURIComponent(getUserId(me))}`).then((res) => {
+        return fetch(`/api/models?lang=${lang}&_user=${encodeURIComponent(getUserId(me))}`, {credentials:"include"}).then((res) => {
             if( !res.ok ){
                 return [];
             }
@@ -118,7 +118,7 @@ export const ModelProvider = ({ children }) => {
                     if( rel){
                         return Promise.resolve(rel);
                     }
-                    return fetch(`/api/data/search?${params.toString()}`, { signal, method: 'POST', headers: { "Content-Type": "application/json"}})
+                    return fetch(`/api/data/search?${params.toString()}`, { credentials:"include",signal, method: 'POST', headers: { "Content-Type": "application/json"}})
                         .then((res) => res.json())
                         .then((e) => ({
                             count: e.count,
@@ -204,7 +204,7 @@ export const ModelProvider = ({ children }) => {
                 const c = pagedFilterToMongoConds(pagedFilters, model)
                 const filter= JSON.stringify({filter:{$and:c}});
 
-                return fetch(`/api/data/search?${params.toString()}`, { signal, method: 'POST', body: filter, headers: { "Content-Type": "application/json"}})
+                return fetch(`/api/data/search?${params.toString()}`, { signal, credentials: "include", method: 'POST', body: filter, headers: { "Content-Type": "application/json"}})
                     .then((res) => res.json())
                     .then((e) => {
                         return {

package/client/src/hooks/data.js

@@ -12,6 +12,7 @@ export const useData = (model, filter, options) => {
     return useQuery([options.queryKey || model, filter, me], () => {
         return fetch('/api/data/search?limit='+(options.limit||1)+'&lang='+(options.lang||lang)+'&_user=' + encodeURIComponent(getUserId(me)) + '&model='+model, {
             method: 'POST',
+            credentials:"include",
             body: JSON.stringify({filter}),
             headers: { "Content-Type": "application/json"}}
         )

package/client/src/hooks/useValidation.js

@@ -13,6 +13,7 @@ import { useState, useCallback, useMemo } from 'react';
  */
 const validateFieldOnServer = async (api, payload) => {
     return fetch('/api/data/validate', { method: 'POST',
+        credentials:"include",
         headers: {
             'Content-Type': 'application/json'
         }

package/client/src/translations.js

@@ -457,8 +457,8 @@ export const websiteTranslations = {
             "btns.backup": "Restaurer",
             "backup.restore.title": "Envoi de votre lien de restauration",
             "backup.restore.confirm": "Un lien pour restaurer votre sauvegarde vous sera envoyé à votre adresse e-mail. Ce lien expirera dans 30 minutes. Voulez-vous vraiment continuer?",
-            "email.backup.restoreRequest.subject": "Votre demande de restauration de sauvegarde",
-            "email.backup.restoreRequest.content": `<p>Vous avez demandé une restauration de sauvegarde. Veuillez choisir une option :</p>
+            "email_backup_restoreRequest_subject": "Votre demande de restauration de sauvegarde",
+            "email_backup_restoreRequest_content": `<p>Vous avez demandé une restauration de sauvegarde. Veuillez choisir une option :</p>
 <p><strong>ATTENTION : Toute restauration écrasera vos données actuelles (modèles et/ou données).</strong></p>
 <ul>
     <li><a href="https://{{host}}/backup/restore?token={{modelsToken}}&username={{user}}&type=full">Restauration Complète (Modèles ET Données)</a></li>
@@ -1570,8 +1570,8 @@ export const websiteTranslations = {
             "backup.restore.title": "Sending your restore link",
             "btns.backup": "Restore",
             "backup.restore.confirm": "A link to restore your backup will be sent to your email address. This link will expire in 30 minutes. Are you sure you want to proceed?",
-            "email.backup.restoreRequest.subject": "Your Backup restoration request",
-            "email.backup.restoreRequest.content": `<p>You have requested a backup restoration. Please choose an option:</p>
+            "email_backup_restoreRequest_subject": "Your Backup restoration request",
+            "email_backup_restoreRequest_content": `<p>You have requested a backup restoration. Please choose an option:</p>
 <p><strong>WARNING: Any restoration will overwrite your current data (models and/or data).</strong></p>
 <ul>
     <li><a href="https://{{host}}/backup/restore?token={{fullToken}}&username={{user}}&type=full">Full Restoration (Models AND Data)</a></li>
@@ -3046,8 +3046,8 @@ export const websiteTranslations = {
             "btns.cancel": "Cancelar",
             "btns.backup": "Restaurar",
             "backup.restore.confirm": "Se enviará un enlace para restaurar su copia de seguridad a su correo electrónico. Este enlace caducará en 30 minutos. ¿Está seguro de que desea continuar?",
-            "email.backup.restoreRequest.subject": "Su solicitud de restauración de copia de seguridad",
-            "email.backup.restoreRequest.content": `<p>Has solicitado una restauración de copia de seguridad. Por favor, elige una opción:</p>
+            "email_backup_restoreRequest_subject": "Su solicitud de restauración de copia de seguridad",
+            "email_backup_restoreRequest_content": `<p>Has solicitado una restauración de copia de seguridad. Por favor, elige una opción:</p>
 <p><strong>ADVERTENCIA: Cualquier restauración sobrescribirá tus datos actuales (modelos y/o datos).</strong></p>
 <ul>
     <li><a href="https://{{host}}/backup/restore?token={{fullToken}}&username={{user}}&type=full">Restauración completa (Modelos Y Datos)</a></li>
@@ -4528,8 +4528,8 @@ export const websiteTranslations = {
             "btns.cancel": "Cancelar",
             "btns.backup": "Restaurar",
             "backup.restore.confirm": "Será enviado um link para restaurar o seu backup para o seu endereço de e-mail. Este link expirará em 30 minutos. Tem a certeza de que pretende prosseguir?",
-            "email.backup.restoreRequest.subject": "O seu pedido de restauro de cópia de segurança",
-            "email.backup.restoreRequest.content": `<p>Solicitou a restauração de uma cópia de segurança. Por favor, escolha uma opção:</p>
+            "email_backup_restoreRequest_subject": "O seu pedido de restauro de cópia de segurança",
+            "email_backup_restoreRequest_content": `<p>Solicitou a restauração de uma cópia de segurança. Por favor, escolha uma opção:</p>
 <p><strong>ATENÇÃO: Qualquer restauração irá substituir os seus dados atuais (modelos e/ou dados).</strong></p>
 <ul>
     <li><a href="https://{{host}}/backup/restore?token={{fullToken}}&username={{user}}&type=full">Restauração Completa (Modelos E Dados)</a></li>
@@ -5984,8 +5984,8 @@ export const websiteTranslations = {
             "btns.cancel": "Abbrechen",
             "btns.backup": "Wiederherstellen",
             "backup.restore.confirm": "Ein Link zur Wiederherstellung Ihres Backups wird an Ihre E-Mail-Adresse gesendet. Dieser Link läuft in 30 Minuten ab. Möchten Sie wirklich fortfahren?",
-            "email.backup.restoreRequest.subject": "Ihre Anfrage zur Wiederherstellung des Backups",
-            "email.backup.restoreRequest.content": `<p>Sie haben die Wiederherstellung eines Backups angefordert. Bitte wählen Sie eine Option:</p>
+            "email_backup_restoreRequest_subject": "Ihre Anfrage zur Wiederherstellung des Backups",
+            "email_backup_restoreRequest_content": `<p>Sie haben die Wiederherstellung eines Backups angefordert. Bitte wählen Sie eine Option:</p>
 <p><strong>ACHTUNG: Jede Wiederherstellung überschreibt Ihre aktuellen Daten (Modelle und/oder Daten).</strong></p>
 <ul>
     <li><a href="https://{{host}}/backup/restore?token={{fullToken}}&username={{user}}&type=full">Vollständige Wiederherstellung (Modelle UND Daten)</a></li>
@@ -7463,8 +7463,8 @@ export const websiteTranslations = {
             "btns.cancel": "Annulla",
             "btns.backup": "Ripristina",
             "backup.restore.confirm": "Un link per ripristinare il backup verrà inviato al tuo indirizzo email. Questo link scadrà tra 30 minuti. Vuoi procedere?",
-            "email.backup.restoreRequest.subject": "La tua richiesta di ripristino del backup",
-            "email.backup.restoreRequest.content": `<p>Hai richiesto il ripristino di un backup. Scegli un'opzione:</p>
+            "email_backup_restoreRequest_subject": "La tua richiesta di ripristino del backup",
+            "email_backup_restoreRequest_content": `<p>Hai richiesto il ripristino di un backup. Scegli un'opzione:</p>
 <p><strong>ATTENZIONE: Qualsiasi ripristino sovrascriverà i tuoi dati attuali (modelli e/o dati).</strong></p>
 <ul>
     <li><a href="https://{{host}}/backup/restore?token={{fullToken}}&username={{user}}&type=full">Ripristino Completo (Modelli E Dati)</a></li>
@@ -8937,8 +8937,8 @@ export const websiteTranslations = {
             "btns.cancel": "Zrušit",
             "btns.backup": "Obnovit",
             "backup.restore.confirm": "Na vaši e-mailovou adresu bude odeslán odkaz pro obnovení zálohy. Platnost tohoto odkazu vyprší za 30 minut. Opravdu chcete pokračovat?",
-            "email.backup.restoreRequest.subject": "Váš požadavek na obnovení zálohy",
-            "email.backup.restoreRequest.content": `<p>Požádali jste o obnovení ze zálohy. Vyberte prosím možnost:</p>
+            "email_backup_restoreRequest_subject": "Váš požadavek na obnovení zálohy",
+            "email_backup_restoreRequest_content": `<p>Požádali jste o obnovení ze zálohy. Vyberte prosím možnost:</p>
 <p><strong>VAROVÁNÍ: Jakákoli obnova přepíše vaše aktuální data (modely a/nebo data).</strong></p>
 <ul>
     <li><a href="https://{{host}}/backup/restore?token={{fullToken}}&username={{user}}&type=full">Kompletní obnova (Modely I Data)</a></li>
@@ -10409,8 +10409,8 @@ export const websiteTranslations = {
             "btns.cancel": "Отмена",
             "btns.backup": "Восстановить",
             "backup.restore.confirm": "Ссылка для восстановления резервной копии будет отправлена ​​на ваш адрес электронной почты. Срок действия этой ссылки истекает через 30 минут. Вы уверены, что хотите продолжить?",
-            "email.backup.restoreRequest.subject": "Ваш запрос на восстановление резервной копии",
-            "email.backup.restoreRequest.content": `<p>Вы запросили восстановление из резервной копии. Пожалуйста, выберите вариант:</p>
+            "email_backup_restoreRequest_subject": "Ваш запрос на восстановление резервной копии",
+            "email_backup_restoreRequest_content": `<p>Вы запросили восстановление из резервной копии. Пожалуйста, выберите вариант:</p>
 <p><strong>ВНИМАНИЕ: Любое восстановление перезапишет ваши текущие данные (модели и/или данные).</strong></p>
 <ul>
     <li><a href="https://{{host}}/backup/restore?token={{fullToken}}&username={{user}}&type=full">Полное восстановление (Модели И Данные)</a></li>
@@ -11900,8 +11900,8 @@ export const websiteTranslations = {
             "btns.cancel": "إلغاء",
             "btns.backup": "استعادة",
             "backup.restore.confirm": "سيتم إرسال رابط لاستعادة النسخة الاحتياطية إلى بريدك الإلكتروني. سينتهي هذا الرابط خلال 30 دقيقة. هل أنت متأكد من رغبتك في المتابعة؟",
-            "email.backup.restoreRequest.subject": "طلب استعادة النسخة الاحتياطية الخاص بك",
-            "email.backup.restoreRequest.content": `<p>لقد طلبت استعادة نسخة احتياطية. يرجى اختيار خيار:</p>
+            "email_backup_restoreRequest_subject": "طلب استعادة النسخة الاحتياطية الخاص بك",
+            "email_backup_restoreRequest_content": `<p>لقد طلبت استعادة نسخة احتياطية. يرجى اختيار خيار:</p>
 <p><strong>تحذير: أي عملية استعادة ستستبدل بياناتك الحالية (النماذج و/أو البيانات).</strong></p>
 <ul>
     <li><a href="https://{{host}}/backup/restore?token={{fullToken}}&username={{user}}&type=full">استعادة كاملة (النماذج والبيانات)</a></li>
@@ -13380,8 +13380,8 @@ export const websiteTranslations = {
             "btns.cancel": "Avbryt",
             "btns.backup": "Återställ",
             "backup.restore.confirm": "En länk för att återställa din säkerhetskopia kommer att skickas till din e-postadress. Den här länken upphör att gälla om 30 minuter. Är du säker på att du vill fortsätta?",
-            "email.backup.restoreRequest.subject": "Din begäran om återställning av säkerhetskopia",
-            "email.backup.restoreRequest.content": `<p>Du har begärt en återställning från backup. Vänligen välj ett alternativ:</p>
+            "email_backup_restoreRequest_subject": "Din begäran om återställning av säkerhetskopia",
+            "email_backup_restoreRequest_content": `<p>Du har begärt en återställning från backup. Vänligen välj ett alternativ:</p>
 <p><strong>OBS: All återställning kommer att skriva över din nuvarande data (modeller och/eller data).</strong></p>
 <ul>
     <li><a href="https://{{host}}/backup/restore?token={{fullToken}}&username={{user}}&type=full">Fullständig återställning (Modeller OCH Data)</a></li>
@@ -14854,8 +14854,8 @@ export const websiteTranslations = {
             "btns.cancel": "Ακύρωση",
             "btns.backup": "Επαναφορά",
             "backup.restore.confirm": "Ένας σύνδεσμος για την επαναφορά του αντιγράφου ασφαλείας θα σταλεί στη διεύθυνση email σας. Αυτός ο σύνδεσμος θα λήξει σε 30 λεπτά. Είστε βέβαιοι ότι θέλετε να συνεχίσετε;",
-            "email.backup.restoreRequest.subject": "Το αίτημα επαναφοράς αντιγράφων ασφαλείας",
-            "email.backup.restoreRequest.content": `<p>Έχετε αιτηθεί επαναφορά από αντίγραφο ασφαλείας. Παρακαλώ επιλέξτε μια επιλογή:</p>
+            "email_backup_restoreRequest_subject": "Το αίτημα επαναφοράς αντιγράφων ασφαλείας",
+            "email_backup_restoreRequest_content": `<p>Έχετε αιτηθεί επαναφορά από αντίγραφο ασφαλείας. Παρακαλώ επιλέξτε μια επιλογή:</p>
 <p><strong>ΠΡΟΣΟΧΗ: Οποιαδήποτε επαναφορά θα αντικαταστήσει τα τρέχοντα δεδομένα σας (μοντέλα και/ή δεδομένα).</strong></p>
 <ul>
     <li><a href="https://{{host}}/backup/restore?token={{fullToken}}&username={{user}}&type=full">Πλήρης Επαναφορά (Μοντέλα ΚΑΙ Δεδομένα)</a></li>
@@ -16283,8 +16283,8 @@ export const websiteTranslations = {
             "btns.backup": "بازیابی",
             "backup.restore.title": "ارسال لینک بازیابی شما",
             "backup.restore.confirm": "لینکی برای بازیابی پشتیبان‌گیری شما به آدرس ایمیل شما ارسال خواهد شد. این لینک پس از 30 دقیقه منقضی می‌شود. آیا واقعاً می‌خواهید ادامه دهید؟",
-            "email.backup.restoreRequest.subject": "درخواست بازیابی پشتیبان‌گیری شما",
-            "email.backup.restoreRequest.content": `<p>درخواست بازیابی نسخه پشتیبان را داده‌اید. لطفاً یک گزینه انتخاب کنید:</p>
+            "email_backup_restoreRequest_subject": "درخواست بازیابی پشتیبان‌گیری شما",
+            "email_backup_restoreRequest_content": `<p>درخواست بازیابی نسخه پشتیبان را داده‌اید. لطفاً یک گزینه انتخاب کنید:</p>
 <p><strong>هشدار: هرگونه بازیابی، داده‌های فعلی شما (مدل‌ها و/یا داده‌ها) را بازنویسی خواهد کرد.</strong></p>
 <ul>
     <li><a href="https://{{host}}/backup/restore?token={{fullToken}}&username={{user}}&type=full">بازیابی کامل (هم مدل‌ها و هم داده‌ها)</a></li>

package/doc/AI-assistance.md

@@ -1,93 +1,117 @@
 # AI Assistance: Leverage Artificial Intelligence
 
-`data-primals-engine` includes a powerful, built-in AI assistant named **Prior**. This assistant is designed to understand natural language queries, allowing you to interact with your data, generate insights, and perform actions without writing complex code or API requests.
+The `data-primals-engine` integrates powerful generative AI capabilities directly into its core, allowing you to automate content creation, analyze data, and enrich your business processes.
 
 ## Enabling the AI Assistant
 
-To use the AI assistant, you must first provide API keys for one or more supported AI providers. The engine natively supports providers like **OpenAI, Google (Gemini), DeepSeek, and Anthropic**.
+To use the AI features, you must first provide API keys for one or more supported AI providers. The engine natively supports providers like **OpenAI, Google (Gemini), DeepSeek, and Anthropic**.
 
 You can configure your keys in two ways:
 
 1.  **Environment Variables**: Set the appropriate variable in your `.env` file. This is the recommended approach for production.
-    ```env
-    # Choose one or more providers
-    OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx
-    GOOGLE_API_KEY=AIzaSyxxxxxxxxxxxxxxxxxxxx
-    DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx
-    ```
 
-2.  **`env` Model**: For user-specific keys, you can store them in the `env` model within the application. The assistant will automatically look for a key belonging to the current user.
-
-Once a key is configured, the AI assistant chat interface becomes available in the UI.
-
-## Core Capabilities
-
-The assistant, "Prior," can perform a wide range of actions based on your natural language commands.
-
-### 1. Data Querying and Visualization
-
-You can ask the assistant to find, filter, and display your data. It can present the results in various formats.
-
--   **Simple Search**:
-    > "Show me the latest 5 orders from French customers."
-
--   **Chart Generation**: Create charts on the fly.
-    > "Create a bar chart of user sign-ups per month for the last year."
-
--   **Custom HTML Views**: Generate sophisticated, styled views of your data using Handlebars templates.
-    > "Build a dashboard of my active projects with their status and due dates, using a modern dark theme."
-
-### 2. Data Modification (with Confirmation)
+```env
+# Choose one or more providers
+OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx
+GOOGLE_API_KEY=AIzaSyxxxxxxxxxxxxxxxxxxxx
+DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx
+ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx
+```
 
-The assistant can create, update, or delete data, but it will **always ask for your confirmation** before executing a modifying action. This provides a critical safety layer.
+2.  **`env` Model**: For user-specific keys, you can store them in the `env` model within the application. The assistant will automatically look for a key belonging to the current user.
 
--   **Create Data**:
-    > "Create a new task to 'Follow up with Client X' due tomorrow."
+Once a key is configured, AI capabilities become available, most notably within the automation engine.
 
--   **Update Data**:
-    > "Update the status of all tickets in the 'Support' category to 'resolved'."
+## AI in Workflows: The `GenerateAIContent` Action
 
--   **Delete Data**:
-    > "Delete all draft products created before last month."
+The most powerful way to use AI in `data-primals-engine` is by integrating it into your **Workflows**. The `GenerateAIContent` action type allows you to call an AI model as a step in any automated process.
 
-When you issue such a command, the assistant will respond with a summary of the action it intends to perform and a "Confirm" button. The action is only executed after you click it.
+This is perfect for tasks like:
+-   Summarizing a new support ticket.
+-   Generating a product description when a new product is added.
+-   Classifying incoming data based on its content.
+-   Translating text.
 
-### 3. Answering Questions
+### Example: Automatically Generating a Product Description
 
-The assistant can answer questions about the data it has access to.
+Let's create a complete workflow that automatically generates an SEO description whenever a new product is added without one.
 
-> "What was our total revenue in the last quarter?"
+This workflow can be created programmatically by making the following API calls from your JavaScript code.
 
-## How It Works: The Reasoning Loop
 
-When you send a message, the assistant follows a strict reasoning process:
+#### 1. The `workflow`
 
-1.  **Analyze Intent**: It first analyzes your request to understand what you want to do.
-2.  **Search Models (Internal Step)**: Its first action is always to call the `search_models` tool internally. This gives it the exact structure, field names, and types for the relevant data models. This step is crucial for preventing errors and "hallucinations."
-3.  **Formulate Action**: Based on your intent and the model structures it found, it formulates a final action, such as `search`, `generateChart`, or a `post` request.
-4.  **Execute or Confirm**:
-    -   If it's a read-only action (like `search` or `generateChart`), it executes it and displays the result.
-    -   If it's a write action (like `post` or `delete`), it presents the action to you for confirmation.
+First, we define the main workflow. This document acts as a container for the steps and logic.
 
-## AI in Workflows: The `GenerateAIContent` Action
+```javascript
+await insertData("workflow", {
+    "name": "Generate Product SEO Description",
+    "description": "When a new product is created without an SEO description, this workflow uses AI to generate one based on the product's name.",
+    "startStep": { "$find": { "name": "Generate and Update Description" } }
+});
+```
 
-Beyond the chat interface, you can leverage AI directly within your automation **Workflows**. The `GenerateAIContent` action allows you to call an AI model as a step in a workflow.
+#### 2. The `workflowAction` documents
 
-This is perfect for tasks like:
--   Summarizing a new support ticket.
--   Generating a product description when a new product is added.
--   Classifying incoming data based on its content.
--   Translating text.
+Next, we define the individual actions that will be performed. We need two actions: one to generate the content with AI, and another to update the product with that content. We use `insertData` to create both in a single call.
 
-**Example `workflowAction`:**
-```json
-{
-    "name": "Summarize Ticket",
+```javascript
+await insertData("workflowAction", [
+  {
+    "name": "Generate SEO Content",
     "type": "GenerateAIContent",
     "aiProvider": "OpenAI",
-    "aiModel": "gpt-4-turbo",
-    "prompt": "Summarize the following support ticket in one sentence: {triggerData.description}"
-}
+    "aiModel": "gpt-4o-mini",
+    "prompt": "Write a short, engaging, and SEO-optimized product description (30-40 words) for the following product: '{triggerData.name}'. Return only the description text, without any introductory or concluding phrases."
+  },
+  {
+    "name": "Update Product with AI Content",
+    "type": "UpdateData",
+    "targetModel": "product",
+    "targetSelector": { "_id": "{triggerData._id}" },
+    "fieldsToUpdate": { "seoDescription": "{context.aiContent}" }
+  }
+]);
+```
+> **Note**: The `targetSelector` and `fieldsToUpdate` use placeholders. `{triggerData._id}` refers to the ID of the product that started the workflow, and `{context.aiContent}` refers to the text generated by the previous AI action.
+
+#### 3. The `workflowStep`
+
+Now, we create a step that groups our actions together. A workflow can have multiple steps that execute in sequence. For this simple case, we only need one, which we create with `insertData`.
+
+```javascript
+await insertData("workflowStep", {
+  "name": "Generate and Update Description",
+  "workflow": { "$find": { "name": "Generate Product SEO Description" } },
+  "actions": [
+    { "$find": { "name": "Generate SEO Content" } },
+    { "$find": { "name": "Update Product with AI Content" } }
+  ],
+  "isTerminal": true
+});
 ```
 
+#### 4. The `workflowTrigger`
+
+Finally, we define the trigger that will start the workflow. This trigger will listen for new documents being added (`DataAdded`) to the `product` model. It also includes a `dataFilter` to ensure it only runs if the `seoDescription` field is empty. We create it with `insertData`.
+
+```javascript
+await insertData("workflowTrigger", {
+  "name": "On New Product Added without SEO Description",
+  "workflow": { "$find": { "name": "Generate Product SEO Description" } },
+  "type": "manual",
+  "onEvent": "DataAdded",
+  "targetModel": "product",
+  "dataFilter": {
+    "$or": [
+      { "seoDescription": { "$exists": false } },
+      { "seoDescription": "" }
+    ]
+  },
+  "isActive": true
+});
+```
+
+With these four API calls, your automated AI content generation workflow is now active. Any new product created without an SEO description will automatically have one generated and saved.
+
 This integration of AI both as an interactive assistant and as an automation component makes `data-primals-engine` a powerful platform for building intelligent applications.