agentic-api 2.0.31 → 2.0.314

package/dist/src/prompts.js

@@ -1,22 +1,59 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.usecaseExtractionPrompt = exports.htmlToMarkdownPrompt = exports.textToMarkdownPrompt = exports.defaultOutputPrompt = exports.transferAgentPrompt = exports.transferAgentPrompt_ = void 0;
+exports.usecaseExtractionPrompt = exports.usecaseExtractionPrompt_OLD = exports.htmlToMarkdownPrompt = exports.textToMarkdownPrompt = exports.defaultOutputPrompt = exports.transferAgentPromptHandoff = exports.transferAgentPromptStructured = exports.transferAgentPrompt = exports.transferAgentPrompt__ = exports.transferAgentPrompt_ = void 0;
 exports.transferAgentPrompt_ = `Triggers a transfer of the user to a more specialized agent. 
   Calls escalate to a more specialized LLM agent or to a human agent, with additional context. 
   Only call this function if one of the available agents is appropriate. Don't transfer to your own agent type.
   
   Let the user know you're about to transfer them before doing so.
-
-Available Agents:`;
-exports.transferAgentPrompt = `
+  
+  Available Agents:`;
+exports.transferAgentPrompt__ = `
 Triggers a transfer of the user to a specialized agent, for one task.
-Only call this function if one of the available agents is more appropriate (as destination_agent). Don't transfer to your own agent name "__AGENT_NAME__".
+Only call this function if one of the available agents is more appropriate (as destination_agent).
 
 ⚠️ Rules:
-- NEVER call this function for requests that match your own specialization.
+- NEVER call this function for requests that match your own specialization ("__AGENT_NAME__").
+
+
+Available Agents:`;
+exports.transferAgentPrompt = `Transfer control to the agent "__AGENT_NAME__".
+This agent is described as: "__AGENT_DESCRIPTION__".
+Use this tool (handoff) when that agent is better suited to handle the user's request.
 
 
 Available Agents:`;
+exports.transferAgentPromptStructured = `
+Cet outil permet de transférer le contrôle vers un agent spécialisé lorsque la demande de l'utilisateur dépasse le périmètre de "__AGENT_NAME__".
+
+**QUAND UTILISER :**
+- Si l'Agent détermine que le transfert est nécessaire (confidence >= 0.7) il doit appeler cet outil.
+- L'utilisateur demande explicitement un service hors de votre spécialisation
+- La requête nécessite des outils ou connaissances spécifiques à un autre agent
+- Vous identifiez qu'un agent spécialisé (disponible ci-dessous) est mieux adapté pour répondre
+
+**QUAND NE PAS UTILISER :**
+- Votre niveau de confiance (confidence) est inférieur à 0.7
+
+Il prend les arguments suivants :
+- rationale_for_transfer (string) : La justification précise expliquant en moins de 10 mots pourquoi ce transfert est nécessaire
+- conversation_context (string) : Le contexte pertinent de la conversation qui aidera l'agent destinataire à effectuer l'action correcte
+- destination_agent (string) : Le nom de l'agent spécialisé qui doit traiter la demande (valeurs possibles listées ci-dessous)
+- confidence (number) : Votre niveau de confiance (0.0 à 1.0) que le transfert vers un agent plus approprié est nécessaire. Minimum requis : 0.7
+
+Available Agents:`;
+exports.transferAgentPromptHandoff = `# Contexte général
+Tu fais partie d'un système multi-agents conçu pour faciliter la coordination et l'exécution entre plusieurs agents. Tu utilises deux abstractions principales : **Agents** et **Transferts**. 
+Un agent possède des instructions et des outils, et peut, quand c'est approprié, transmettre une conversation à un autre agent avec une autre spécialisation. Les transferts se font en appelant un outil nommée \`transferAgents\`.
+Les transferts entre agents sont gérés automatiquement en arrière-plan ; tu ne dois jamais mentionner ou attirer l'attention sur ces transferts dans ta conversation avec l'utilisateur.
+
+## PROTOCOLE CONTEXT TRAIL \`<context-trail>\`
+TU DOIS consulter le trail avant de prendre une décision pour éviter les répétitions et te coordonner avec les autres agents. Le trail est visible pour toi dans tes instructions système pour:
+- Détecter les boucles et ne pas les reproduire (action déjà faite → surtout ne pas répéter)
+- Comprendre les étapes et ce qui reste
+- Prévention du drift (maintenir l'alignement à l'objectif)
+
+`;
 exports.defaultOutputPrompt = `
 # OUTPUT INSTRUCTIONS
 - Only output CoT and Markdown.
@@ -116,7 +153,6 @@ exports.htmlToMarkdownPrompt = `
 Vous êtes *MarkdownPDF-Pro*, un assistant expert chargé de transformer un texte brut issu d’un PDF en un fichier Markdown clair et minimaliste, sans mise en page complexe.
 Tu travailles dans le contexte de l'entreprise Pilet & Renaud SA. Tu sais que les procédures proviennent des services suivants: SGC (Gestion de la Clientèle), RH, PPE (copropriété), gérance locataire, direction, comptabilité, contentieux, IT.
 
-
 **But :**
 Structurer le contenu pour qu’il soit immédiatement lisible dans n’importe quel éditeur Markdown, tout en préservant la hiérarchie logique (titres, listes, tableaux simples).
 
@@ -129,140 +165,211 @@ Structurer le contenu pour qu’il soit immédiatement lisible dans n’importe
    * blocs de citation \`>\` si nécessaire  
    * tableaux au format pipe \`| Col 1 | Col 2 |\`  
    * emphase \`*italique*\` et \`**gras**\`  
-   * Front‑matter YAML \`---\n ...\n---\n\` pour les métadonnées.
+   * Front-matter YAML \`---\n ...\n---\n\` pour les métadonnées.
 4. Ne pas ajouter d’analyse ou de commentaires personnels.
-5. Si le service n’est pas déduit du texte, laisser service: unknown.
-6. les tableaux sont copiés telles-quelles à l'identique ligne par ligne.
+5. Si le service n’est pas déduit du texte, laisser \`service: unknown\`.
+6. **Les tableaux doivent être détectés et normalisés selon les “Règles de TABLE Markdown” ci-dessous (pas de copie brute ligne par ligne).**
 
+Remplir automatiquement le champ \`title\` sous la forme \`{service} - {action} {object} {bénéficiaire}\` en minuscules **uniquement si ces éléments sont clairement inférés** ; sinon, utiliser le premier \`# Titre\` du document. Ne jamais écrire “unknown” dans \`title\`.
 
-Remplir automatiquement le champ title sous la forme "{service} - {action} {object} {bénéficiaire}" en minuscules.
+---
 
-**Heuristique de structuration :**
+### Heuristique de structuration
 1. **Détection des titres**  
-   * Ligne en MAJUSCULES → \`## Titre 2\`  
-   * Ligne qui finit par « : » → \`### Titre 3\`  
+   * Ligne en MAJUSCULES → \`##\`  
+   * Ligne qui finit par « : » → \`###\`  
    * Saut de ligne double + mot initial capitalisé → \`##\` si > 3 mots sinon \`###\`.
-
 2. **Paragraphes** : regrouper les lignes consécutives jusqu’au prochain saut de ligne vide.
-
 3. **Listes**  
-   * Trouver les puces d’origine (\`•\`, \`-\`, \`*\`, chiffres suivis de \`)\` ou \`.\`) et convertir.  
+   * Convertir les puces d’origine (\`•\`, \`-\`, \`*\`, chiffres suivis de \`)\` ou \`.\`).  
    * Conserver l’imbrication (quatre espaces par niveau).
 
-4. **Détection de Table**  
-   * Si plusieurs lignes consécutives contiennent des colonnes alignées par espaces ou tabulations ou un même séparateur, c'est un tableau à convertir en Markdown.
-
-5. **Spécifique à l'entreprise**: 
-   * Les informations importantes doivent être converties avec l'icone ⚠️ et le texte en gras.
-   * Un document fait toujours référence à un service de l'entreprise.
-     **Mentionner par inférence le service uniquement dans le front-matter; le corps du document doit rester fidèle à la source**
-   * Un document fait référence à un Bénéficiaire (ex: locataire, copropriétaire, fournisseur, collaborateur, directeur, etc) dans un contexte de "use-case". Si tu ne le trouves pas, laisser bénéficiaire: unknown.
-   * Un document fait référence à un Destinataire, qui est un collaborateur de l'entreprise. Si tu ne le trouves pas, laisser destinataire: unknown.
-   * Le jargon de l'entreprise:
-    - BAL: Boite à Lettre
-    - DD: Arrangement de paiement pour facture due mais qui n'est pas du loyer.
-    - FVGLS: fondation de la ville de Genève pour le logement social (terme discriminant).
-    - GB/GP: Garantie bancaire
-    - GED: service qui gère le scan des documents, l'économat, le réassort des salles de pauses, la saisie des données pour M-Files
-    - MED: Mise en demeure.
-    - Logiciels Spécialisés: Quorum, Teams, HomePad, Todoist, Mammutt, E-banking, INCH, Ecopartage, Immowise.
-    - M-Files: logiciel de gestion de documents (ou MFiles)
-    - MyAbacus: logiciel pour les ressources humaines.
-
-6. **Éléments hors-texte**  
-   * Images : placer \`![Img page-X-Y](IMAGE_PLACEHOLDER_X_Y)\` à l’endroit d’origine (une ligne par image).  
-   * Notes de bas de page : convertir en liens \`[^{n}]\` et regrouper à la fin sous \`## Notes\`.
-
-6. **Nettoyage final**  
-   * Supprimer les en-têtes/pieds de page répétitifs (même séquence sur ≥ 3 pages).  
-   * Réduire les blancs multiples à un seul.  
-   * Conserver un seul saut de ligne vide entre blocs.
-   * Supprimer la section complète du "rapport de révision de la procédure"
+---
+
+### Règles de TABLE Markdown (génériques, robustes)
+1. **Détection d’un bloc tableau** : séquence de ≥3 lignes présentant un alignement régulier (espaces/tabs), des séparateurs récurrents, OU une première colonne contenant des *identifiants plausibles* (ex. codes, IDs, sigles).  
+2. **Colonnes** : inférer le nombre de colonnes en analysant la majorité des lignes. Normaliser toutes les lignes à ce nombre (remplir les cellules manquantes par vide).  
+3. **En-tête** :  
+   - Si une première ligne contient des libellés de colonnes → utiliser comme \`header\`.  
+   - Sinon, générer un en-tête minimal et neutre (\`Col 1\`, \`Col 2\`, …) ou, si identifié, des noms génériques (\`Identifiant\`, \`Libellé\`, \`Commentaire\`).  
+4. **Fusion de lignes cassées** : joindre aux cellules la/les lignes qui suivent quand elles sont des continuations (indentation, absence de séparateur, hyphénation en fin de ligne) pour éviter de créer de fausses lignes.  
+5. **En-têtes visuels (catégories)** : lignes isolées sans séparateurs ni motif tabulaire, servant d’intertitre (ex. catégories, sections) → les rendre en \`###\` au-dessus du tableau ou entre deux tableaux, **pas** comme des lignes de données.  
+6. **Identifiants / codes** : détecter les *tokens* de type ID (lettres/chiffres/points/traits). Si présents en première colonne, **ne pas trier** ; **préserver l’ordre d’origine du PDF**.  
+7. **Séparation multi-tableaux** : démarrer un nouveau tableau lorsque le schéma de colonnes change, lorsqu’un intertitre visuel survient, ou après un blanc significatif.  
+8. **Nettoyage des cellules** : trim, consolidation des espaces multiples, échapper \`|\` par \`\|\`, conserver les signes et abréviations.  
+9. **Références croisées non listées** : si des identifiants sont mentionnés dans une cellule (ex. “utiliser le 123456”) mais n’apparaissent pas comme ligne dédiée, **ne pas les inventer** dans le tableau ; à la place, ajouter après le tableau une section \`#### Références croisées non listées\` avec une liste \`- 123456 : contexte (extrait bref)\` si utile.  
+10. **Validation post-génération** :  
+    - Chaque tableau doit avoir ≥2 colonnes et ≥2 lignes de données.  
+    - Vérifier la cohérence (pas de décalage de colonnes, pas de titre de catégorie dans les lignes).  
+    - Si la structure reste ambigüe, préférer une **liste structurée** plutôt qu’un tableau incorrect.
 
 ---
 
-### Format d’entrée attendu
+### Spécifique à l'entreprise
+- Les informations véritablement critiques peuvent être signalées avec \`⚠️\` et \`**gras**\`, sans réécrire le fond.  
+- Mentionner par inférence le \`service\` **uniquement dans le front-matter** ; le corps doit rester fidèle à la source.  
+- Ne pas promouvoir des intertitres visuels en alertes \`⚠️\`.
 
-**Procédure :**
-1. Lis attentivement le bloc \`<<PDF_TEXT>>\`.  
-2. Applique les heuristiques ci-dessus, étape par étape (« chain-of-thought » interne, ne pas afficher).  
-3. Ajoutes un MATTER en entête puis le Markdown final brut sans délimiteurs et sans commentaires.
+---
 
-*(Prends le temps nécessaire et vérifie ta sortie avant de répondre.)*
+### Éléments hors-texte
+- **Images** : \`![Img page-X-Y](IMAGE_PLACEHOLDER_X_Y)\` (une ligne par image, à l’emplacement d’origine).  
+- **Notes de bas de page** : convertir en liens \`[^n]\` et regrouper à la fin sous \`## Notes\`.
 
-MATTER : format du matter à ajouter dans l'entête du markdown.
-\`
 ---
-title: {service} - {action} {object} {bénéficiaire}
-service: {service}
-role: rule,
+
+### Nettoyage final
+- Supprimer en-têtes/pieds de page répétés (même séquence sur ≥ 3 pages).  
+- Réduire les blancs multiples à un seul.  
+- Conserver un seul saut de ligne vide entre blocs.  
+- Supprimer les sections de revue automatique (ex. “rapport de révision…”) quand détectables.
+
+---
+
+### Format d’entrée attendu
+**Procédure :**
+1. Lire attentivement le bloc \`<<PDF_TEXT>>\`.  
+2. Appliquer les heuristiques ci-dessus, étape par étape (raisonnement interne, ne pas afficher).  
+3. Produire un **front-matter** puis le **Markdown final brut**, sans délimiteurs et sans commentaires.
+
+**Front-matter (YAML) à produire :**
+---
+title: {service} - {action} {object} {bénéficiaire}   # en minuscules si inférés, sinon premier H1
+service: {service}                                     # "unknown" si non déduit
+role: rule
 owner: {owner}
----\`
+---
+
 
 `;
-const usecaseExtractionPrompt = (file) => `# RÔLE:
-- Tu es un expert en développement de test unitaires avec nodejs et jtest. 
-- Tu as développé un RAG avec openai et "hnswlib-node" qui contient toutes les Procédures de l'entreprise Pilet et Renaud SA.
-- Ta mission est de créer une série de tests exhaustifs pour valider que le RAG couvre à 100% le contenu des procédures de l'entreprise. 
-- Produire des questions à un coût important, tu dois être efficace, tu dois capturer un maximum de détails ( action, objet, bénéficiaire, contexte) avec un minimum de questions (maximum 4):
-  Une question peut concerner l'utilisation précise d'un logiciel ou un article précis de réglementation.
-  Chaque question doit satisfaire ces critères: clairement identifier le problème à résoudre ou l'action souhaitée dans le domaine précis du document fourni, doit être spécifique et ne peut pas être ambiguë.
-  Tu DOIS supprimer du résultat les questions génériques qui non spécifiques au contexte métier du document.
-  Toutes les questions que tu vas créer concernent précisément le document fourni en INPUT ci-dessous. 
-- Pour orienter la formulation des questions, je te fournis quelques exemples de questions réelles.
-- En moyenne, chaque question doit être au maximum de 15 mots, mais tu peux en produire aussi des plus courtes (20%) pour élargir le champ des tests.
-- La réponse contient la liste de mots très spécifiques pour chaque section de la procédure séparés par des virgules.
-- Si la réponse concerne un schéma, une procédure ou l'utilisation d'un logiciel, tu dois décrire le besoin spécifique.
-
-
-# EXEMPLES de formulation utilisées par les collaborateurs l'entreprise (attention à ne pas utiliser ces exemples si le sujet du INPUT´est différent).
-- Écoulement bouché, que faire ?
-- J’ai une fuite depuis le plafond de ma chambre, j’aimerais un sanitaire
-- Mon frigo ne fonctionne pas, pouvez-vous mandater quelqu’un ?
-- Mon store est resté bloqué, pouvez-vous faire quelque chose ?
-- J’aimerais faire reproduire des clés, comment faire ? combien ça coûte ?
-- Je suis fournisseur, ma facture n’est toujours pas payée par Pilet et Renaud.
-- J’ai payé mon loyer, mais j’ai reçu un rappel, pourquoi ?
-- Je paie toujours bien mon loyer, pouvez-vous supprimer les frais de rappel c’est la première fois que j’ai du retard.
-- Est-ce que cet appartement est toujours disponible ? Comment déposer un dossier?
-- Est-ce que mon dossier de candidature est retenu ? j’aimerais des infos.
-- Inscription de korkmaz?
-- J’ai reçu un appel manqué de la régie mais je ne sais pas qui a tenté de me joindre.
-- Un fournisseur me dit que sa facture n’est toujours pas payée par Pilet et Renaud. Comment je vérifie ça?
-- Comment créer un bon ?
-- Quelles sont les tâches à faire après avoir conclu un contrat d’entretien ?
-- Une entreprise souhaite travailler avec nous, que dois-je faire ?
-
-# QUESTIONS A EVITER: Les exemples qui ne sont pas pertinents pour le RAG (les documents sont tous concernés par ces questions, c'est donc inutile de les inclure dans les tests).
-- Ce document contient-il des liens externes ?
-- Cette absence de liens affecte-t-elle la validité du document ?
-- Qui doit valider les changements dans la procédure ?
-- Comment valider une modification de procédure ?
-
-# DICTIONNAIRE (jargon de l'entreprise):
-- Logiciels Spécifiques: Quorum, MFiles, Base de connaissance, Teams, HomePad, Todoist, Mammutt, E-banking, INCH, Ecopartage, Immowise.
-- SGC: Service de Gestion de la Clientèle
-- GED: service qui gère le scan des documents, la mise sous plis, l’économat, le réassort des salles de pauses, la saisie des données pour orienter les documents dans M-Files
-- MED: Mise en demeure.
-- WC: Toilettes.
-- M-Files: logiciel de gestion de documents
-- PR ou PRSA: Pilet & Renaud SA
-- PPE: Service qui gère les copropriétés.
-- GP: Garantie Bancaire
-- BAL: Boite à Lettre
-- DD: Arrangement de paiement pour facture due mais qui n’est pas du loyer.
-- copro: copropriétaire (attention à ne pas confondre avec gopros)
-- un bon (bons): ordre d'intervention pour travaux (ex, bon de travail, création de bons, bons, etc).
-- La Date à jour Locataire: le dernier mois qui a été payé par le locataire.
+const usecaseExtractionPrompt_OLD = (file) => `# RÔLE:
+   - Tu es un expert en développement de test unitaires avec nodejs et jtest. 
+   - Tu as développé un RAG avec openai et "hnswlib-node" qui contient toutes les Procédures de l'entreprise Pilet & Renaud SA.
+   - Ta mission est de créer une série de tests exhaustifs pour valider que le RAG couvre à 100% le contenu des procédures de l'entreprise. 
+   - Produire des questions à un coût important, tu dois être efficace, tu dois capturer un maximum de détails ( action, objet, bénéficiaire, contexte) avec un minimum de questions (maximum 4):
+     Une question peut concerner l'utilisation précise d'un logiciel ou un article précis de réglementation.
+     Chaque question doit satisfaire ces critères: clairement identifier le problème à résoudre ou l'action souhaitée dans le domaine précis du document fourni, doit être spécifique et ne peut pas être ambiguë.
+     Tu DOIS supprimer du résultat les questions génériques qui non spécifiques au contexte métier du document.
+     Toutes les questions que tu vas créer concernent précisément le document fourni en INPUT ci-dessous. 
+   - Pour orienter la formulation des questions, je te fournis quelques exemples de questions réelles.
+   - En moyenne, chaque question doit être au maximum de 15 mots, mais tu peux en produire aussi des plus courtes (20%) pour élargir le champ des tests.
+   - La réponse contient la liste de mots très spécifiques pour chaque section de la procédure séparés par des virgules.
+   - Si la réponse concerne un schéma, une procédure ou l'utilisation d'un logiciel, tu dois décrire le besoin spécifique.
+   
+   
+   # EXEMPLES de formulation utilisées par les collaborateurs l'entreprise (attention à ne pas utiliser ces exemples si le sujet du INPUT´est différent).
+   - Écoulement bouché, que faire ?
+   - J’ai une fuite depuis le plafond de ma chambre, j’aimerais un sanitaire
+   - Mon frigo ne fonctionne pas, pouvez-vous mandater quelqu’un ?
+   - Mon store est resté bloqué, pouvez-vous faire quelque chose ?
+   - J’aimerais faire reproduire des clés, comment faire ? combien ça coûte ?
+   - Je suis fournisseur, ma facture n’est toujours pas payée par Pilet & Renaud.
+   - J’ai payé mon loyer, mais j’ai reçu un rappel, pourquoi ?
+   - Je paie toujours bien mon loyer, pouvez-vous supprimer les frais de rappel c’est la première fois que j’ai du retard.
+   - Est-ce que cet appartement est toujours disponible ? Comment déposer un dossier?
+   - Est-ce que mon dossier de candidature est retenu ? j’aimerais des infos.
+   - Inscription de korkmaz?
+   - J’ai reçu un appel manqué de la régie mais je ne sais pas qui a tenté de me joindre.
+   - Un fournisseur me dit que sa facture n’est toujours pas payée par Pilet & Renaud. Comment je vérifie ça?
+   - Comment créer un bon ?
+   - Quelles sont les tâches à faire après avoir conclu un contrat d’entretien ?
+   - Une entreprise souhaite travailler avec nous, que dois-je faire ?
+   
+   # QUESTIONS A EVITER: Les exemples qui ne sont pas pertinents pour le RAG (les documents sont tous concernés par ces questions, c'est donc inutile de les inclure dans les tests).
+   - Ce document contient-il des liens externes ?
+   - Cette absence de liens affecte-t-elle la validité du document ?
+   - Qui doit valider les changements dans la procédure ?
+   - Comment valider une modification de procédure ?
+   
+   # DICTIONNAIRE (jargon de l'entreprise):
+   - Logiciels Spécifiques: Quorum, MFiles, Base de connaissance, Teams, HomePad, Todoist, Mammutt, E-banking, INCH, Ecopartage, Immowise.
+   - SGC: Service de Gestion de la Clientèle
+   - GED: service qui gère le scan des documents, la mise sous plis, l’économat, le réassort des salles de pauses, la saisie des données pour orienter les documents dans M-Files
+   - MED: Mise en demeure.
+   - WC: Toilettes.
+   - M-Files: logiciel de gestion de documents
+   - PR ou PRSA: Pilet & Renaud SA
+   - PPE: Service qui gère les copropriétés.
+   - GP: Garantie Bancaire
+   - BAL: Boite à Lettre
+   - DD: Arrangement de paiement pour facture due mais qui n’est pas du loyer.
+   - copro: copropriétaire (attention à ne pas confondre avec gopros)
+   - un bon (bons): ordre d'intervention pour travaux (ex, bon de travail, création de bons, bons, etc).
+   - La Date à jour Locataire: le dernier mois qui a été payé par le locataire.
+   
+   
+   # OUTPUT INSTRUCTIONS
+   - Tu dois produire un JSON strict avec les champs suivants:
+   \`\`\`JSON
+   {
+     "source": "string",
+     "file": "${file}",
+     "queries": [{ "question": "string" }, ...]
+   }
+   \`\`\`
+   
+   INPUT:
+   `;
+exports.usecaseExtractionPrompt_OLD = usecaseExtractionPrompt_OLD;
+const usecaseExtractionPrompt = (file, options = {}) => `# RÔLE:
+- Tu es un expert en tests unitaires.
+- Le corpus de procédures est indexé (RAG).
+- Tu adoptes le point de vue de l'utilisateur (un collègue interne qui pose une question métier précise à son voisin).
+- Tu génères des **questions discriminantes** testant la **couverture RAG** d’une procédure ou marche à suivre.
+
+# Structure du document en INPUT pour l'extraction des use cases
+- **Titre principal** → unique dans le corpus (très important).
+- **Intervenants** → Acteur(s) et Bénéficiaire(s) (distincts) de la procédure.
+- **Sections** → Titre unique dans la procédure (très important).
+  - **ÉTAPES / ACTIONS** → action/règle/décision importante
+  - **RÉSULTAT** → finalité/effet attendu
+  - **UI/PATH** → chemin/interface (Système > Module > Action)
+
+
+# MISSION
+- Créer des **questions ultra-spécifiques** au document **INPUT** pour vérifier la couverture des **objectifs métiers**.
+- Chaque question = **un use-case précis**, **une seule section** (objectif, contexte, bénéficiaire, résultat).
+- Questions **courtes, concrètes, vérifiables** (≈12–18 mots; déroger si nécessaire pour l’exactitude).
+- Efficience : **min. 1** question par section, **max. 6** au total.
+- Une section = **un cas d’usage** spécifique (sans ambiguïté).
+- Une question peut viser un logiciel, un **raccourci** clavier, un acronyme, une étiquette, un montant, ou une règle juridique.
+- Critères : problème/action précis, contexte métier clair, non ambigu.
+- **Ne produis pas** de questions hors objectif du document.
+- Tout porte **strictement** sur le document fourni en INPUT.
+
+# FORMAT DES QUESTIONS (obligatoire)
+- Gabarit (au choix), rédigé **depuis l'utilisateur** :
+  - « En tant que [rôle dans la procédure], comment [action] dans [Système > Chemin] pour [résultat] ? »
+  - « Je dois [action] dans [Système > Chemin] : quel [champ/étiquette] renseigner pour [cas] ? »
+  - « Pour [objectif], où [créer/valider/envoyer] dans [Système > Chemin] et avec quel libellé ? »
+  - « Mon lavabo de salle de bain est bouché: l'eau s'évacue très lentement et remonte»
+
+## STYLE (strict)
+- Formuler en langage naturel, **sans aucun préfixe/label** au début.
+- Démarrer par « En tant que… », « Je dois… » ou « Pour… » (puis la question).
+
+
+# ❌ Interdictions Absolues
+- Préfixes/labels **méta** dans la question : « Section », « ÉTAPE(S) », « RÉSULTAT », « UI/PATH », « Tag », « Validation: ».
+- Questions vagues/génériques/méta (ex. “Quel système reçoit la demande ?”, “Dans quel contexte s’applique-t-elle ?”).
+- Questions n’identifiant pas clairement le **use-case** ou le **bénéficiaire**.
+
+# EXEMPLES À ÉVITER
+- « Dans quel contexte la procédure s’applique-t-elle ? »  
+- « Ce document contient-il des liens externes ? »  
+- « Combien de sections contient la procédure ? »  
+- « À quelle adresse e-mail est envoyée la notification ? » *(si le contexte métier n’est pas défini)*  
+- « Que faire si la demande est incomplète ? » *(sans préciser procédure, système, rôle, champ)*  
+
+${options.extended}
 
 
 # OUTPUT INSTRUCTIONS
 - Tu dois produire un JSON strict avec les champs suivants:
 \`\`\`JSON
 {
-  "source": "string",
   "file": "${file}",
-  "queries": [{ "question": "string", "answer": "string" }, ...]
+  "queries": [{ "question": "string" }, ...]
 }
 \`\`\`
 

package/dist/src/rag/embeddings.d.ts

@@ -1,4 +1,4 @@
-import { RAGConfig, RAGMetadata, RAGSearchResult, RAGMapping, ParsedDocument, DocumentQueries } from './types';
+import { RAGConfig, RAGMetadata, RAGSearchResult, RAGMapping, ParsedDocument, DocumentQueries, IndexBuildResult } from './types';
 export interface EmbeddingsSearchOptions {
     /** Nombre de voisins à retourner */
     neighbors?: number;
@@ -19,15 +19,13 @@ export declare class Embeddings {
     private mapping;
     constructor(config: RAGConfig);
     /**
-     * Retourne le prochain ID documentaire stable et met à jour metadata.docLastID.
-     * Pré-conditions: this.mapping et this.metadata sont chargés.
+     * Extrait et sauvegarde les use cases d'un document
+     * Utilise la fonction standalone pour la compatibilité
+     *
+     * @param document Document parsé
+     * @returns Les queries extraites avec leur coût
+     * @deprecated Utiliser extractAndSaveDocumentUseCases de usecase.ts directement
      */
-    getNextID(): number;
-    /**
-     * Retourne l'ID documentaire pour un fichier. Si non trouvé, attribue un nouvel ID.
-     * Stratégie: utiliser le mapping id -> "filename#section-0".
-     */
-    getOrAssignDocumentID(file: string): number;
     extractAndSaveDocumentUseCases(document: ParsedDocument): Promise<DocumentQueries>;
     /**
      * Charge les documents du RAG
@@ -60,6 +58,28 @@ export declare class Embeddings {
      * Vérifie si l'index est prêt
      */
     isReady(): boolean;
+    /**
+     * Met à jour l'embedding avec une nouvelle configuration
+     * Recharge l'index, les métadonnées et le mapping depuis les nouveaux fichiers
+     *
+     * Cette méthode est appelée par RAGManager.notifyUpdate() quand un RAG est modifié
+     *
+     * FIXME: Gérer le cas où l'embedding est en cours d'exécution (recherche/indexation)
+     * Actuellement, l'update est appliqué immédiatement sans vérifier si l'embedding est busy.
+     * Solutions possibles:
+     * - Ajouter un flag `isBusy` pour bloquer les updates pendant une recherche
+     * - Implémenter une queue d'updates avec retry
+     * - Utiliser un système de locks/mutex
+     *
+     * @param newConfig Nouvelle configuration RAG
+     *
+     * @example
+     * ```typescript
+     * // Appelé automatiquement par RAGManager après un build ou rename
+     * embedding.update(newConfig);
+     * ```
+     */
+    update(newConfig: RAGConfig): void;
     /**
      * Réinitialise l'index
      */
@@ -67,6 +87,12 @@ export declare class Embeddings {
     /**
      * Crée un nouvel index HierarchicalNSW avec documents parsés
      * ou met à jour l'index existant avec de nouveaux documents
+     *
+     * @returns IndexBuildResult contenant les données nécessaires pour créer les métadonnées RAG
+     *
+     * Note: Cette méthode ne sauvegarde plus les métadonnées directement.
+     * RAGManager est responsable de créer et sauvegarder les métadonnées
+     * à partir du résultat retourné.
      */
     indexFromDocuments(documents: ParsedDocument[], options?: {
         ef?: number;
@@ -75,7 +101,7 @@ export declare class Embeddings {
         branch?: string;
         update?: boolean;
         prepare?: (input: string) => string;
-    }): Promise<void>;
+    }): Promise<IndexBuildResult>;
     /**
      * Charge l'index HierarchicalNSW existant
      */
@@ -88,14 +114,6 @@ export declare class Embeddings {
      * Charge le mapping des IDs
      */
     private loadMapping;
-    /**
-     * Sauvegarde les métadonnées dans rag-metadata.json
-     */
-    private saveMetadata;
-    /**
-     * Sauvegarde le mapping des IDs
-     */
-    private saveMapping;
     /**
      * Récupère un vecteur depuis l'index existant (pour les mises à jour)
      */