agentic-api 1.0.5 → 2.0.26

package/dist/src/princing.openai.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.modelPricing = void 0;
 exports.calculateCost = calculateCost;
 exports.accumulateCost = accumulateCost;
 //
 // get/update pricing from openai
 // - https://platform.openai.com/docs/pricing#latest-models
-const modelPricing = {
+exports.modelPricing = {
     "gpt-4.5-preview": { input: 0.000075, cachedInput: 0.0000325, output: 0.000125 },
     "gpt-4.1": { input: 0.000002, cachedInput: 0.0000005, output: 0.000008 },
     "gpt-4.1-mini": { input: 0.0000004, cachedInput: 0.0000001, output: 0.0000016 },
@@ -18,7 +19,12 @@ const modelPricing = {
     "gpt-4o-mini-audio-preview": { input: 0.00000015, output: 0.0000006 },
     "gpt-4o-mini-realtime-preview": { input: 0.0000006, cachedInput: 0.0000003, output: 0.0000024 },
     "gpt-4o-mini-search-preview": { input: 0.0000015, cachedInput: 0.00000075, output: 0.000006 },
+    // GPT-5 family
+    "gpt-5": { input: 0.00000125, output: 0.00001 },
+    "gpt-5-mini": { input: 0.00000025, output: 0.000002 },
+    "gpt-5-nano": { input: 0.00000005, output: 0.0000004 },
     "o1": { input: 0.000015, cachedInput: 0.0000075, output: 0.00006 },
+    "o4-mini": { input: 0.0000011, cachedInput: 0.00000055, output: 0.0000044 },
     "o3-mini": { input: 0.0000011, cachedInput: 0.00000055, output: 0.0000044 },
     "o1-mini": { input: 0.0000011, cachedInput: 0.00000055, output: 0.0000044 },
 };
@@ -26,24 +32,23 @@ function calculateCost(model, usage) {
     if (!usage) {
         return 0;
     }
-    if (!modelPricing[model]) {
+    if (!exports.modelPricing[model]) {
         throw new Error("Unknown model");
     }
-    const pricing = modelPricing[model];
+    const pricing = exports.modelPricing[model];
     const cost = usage.prompt_tokens * pricing.input +
         // usage.completion_tokens * (pricing.cachedInput || 0) +
         usage.completion_tokens * pricing.output;
     return cost;
 }
-function accumulateCost(memory, model, usage) {
+function accumulateCost(currentUsage, model, usage) {
     if (!usage) {
         return 0;
     }
-    let _usage = memory.usage;
-    _usage.prompt += usage.prompt_tokens;
-    _usage.completion += usage.completion_tokens;
-    _usage.total += usage.total_tokens;
-    _usage.cost += calculateCost(model, usage);
-    memory.usage = _usage;
-    return _usage.cost;
+    currentUsage.prompt += usage.prompt_tokens || 0;
+    currentUsage.completion += usage.completion_tokens || 0;
+    currentUsage.total += usage.total_tokens || 0;
+    const cost = calculateCost(model, usage);
+    currentUsage.cost += cost;
+    return currentUsage.cost;
 }

package/dist/src/prompts.d.ts

@@ -1,5 +1,6 @@
 export declare const transferAgentPrompt_ = "Triggers a transfer of the user to a more specialized agent. \n  Calls escalate to a more specialized LLM agent or to a human agent, with additional context. \n  Only call this function if one of the available agents is appropriate. Don't transfer to your own agent type.\n  \n  Let the user know you're about to transfer them before doing so.\n\nAvailable Agents:";
 export declare const transferAgentPrompt = "\nTriggers a transfer of the user to a specialized agent, for one task.\nOnly 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__\".\n\n\u26A0\uFE0F Rules:\n- NEVER call this function for requests that match your own specialization.\n\n\nAvailable Agents:";
 export declare const defaultOutputPrompt = "\n# OUTPUT INSTRUCTIONS\n- Only output CoT and Markdown.\n- Do not output the markdown code syntax, only the content.\n- Use the name of the document on top of the markdown.\n- You use bulleted lists for output, not numbered lists.\n- Do not output the main index as a section.\n- Do not output the images which are not relevant in section.\n- Ensure you follow ALL these instructions when creating your output.\n- EXAMPLE OF SECTION: `# {{page name}} - {{titre}}\n{{content}}`\n";
-export declare const textToMarkdownPrompt = "# R\u00D4LE:\n- Tu es un expert en transformation de documents structur\u00E9 pour la cr\u00E9ation d'un RAG (HNSW cosine index).\n- Ton r\u00F4le consiste \u00E0 analyser et comprendre des contenus complexes (texte ou HTML) pour en extraire la structure s\u00E9mantique essentielle: titres, paragraphes, listes, liens, tableaux.\n- Tu agis comme un moteur de \"reader view\" capable de construire une version fluide, lisible et reflowable du document original sans supprimer le contenu.\n- Tu sais que le contenu du document concerne les Proc\u00E9dures de l'entreprise Pilet-Renaud SA. Ces proc\u00E9dures sont importantes pour aider les collaborateurs \u00E0 satisfaire les demandes des clients.\n- Tu sais comment organiser l'information en sections et sous-sections pour ensuite cr\u00E9er des entr\u00E9es individuelles dans un RAG .\n- Tu sais que pour \u00EAtre significatif chaque entr\u00E9e du RAG doit contenir de l'objectif du document.\n\n\n# MISSION:\n- Ta mission est de convertir le document, qu'il s'agisse de texte brut ou de HTML issu d'une conversion (par exemple, d'un PDF), en un contenu Markdown structur\u00E9 et COMPLET qui sera utilis\u00E9 pour g\u00E9n\u00E9rer un RAG. \n- Tu dois analyser le document ligne par ligne, de mani\u00E8re exhaustif pour inf\u00E9rer dans ta m\u00E9moire, l'objectif de la page et une repr\u00E9sentation hi\u00E9rarchique \u00E0 deux niveaux (titre1 et titre2) dans lesquelles toutes les \"proc\u00E9dures\" compl\u00E8tes seront d\u00E9velopp\u00E9es.\n- Tu sais que le document fait r\u00E9f\u00E9rence \u00E0 des proc\u00E9dures d'entreprise, tu dois assurer:\n  - Que TOUS les titres \u00E0 produire sont des phrases courtes reformul\u00E9es (par toi) qui expriment le contexte du document et la section qui suit.\n  - Que la logique du contenu est bien formul\u00E9e et les \u00E9tapes sont d\u00E9taill\u00E9es.\n  - Lors d'une proc\u00E9dure de logiciel, les \u00E9tapes sont importantes et doivent \u00EAtre d\u00E9taill\u00E9es: nom des \u00E9crans, raccourcis clavier, commandes, onglets, les menus, etc. \n  - Tous les contenus extraits en MAJUSCULES sont importants et doivent \u00EAtre en gras.\n  \n# DIRECTIVES:\n- Analyser **chaque ligne du document**, qu\u2019il soit en **texte brut ou HTML converti depuis un PDF**, pour identifier sa structure logique. Cette directive s\u2019applique **\u00E0 tous les types de documents trait\u00E9s par l\u2019agent**.\n- Les \u00E9l\u00E9ments suivants doivent \u00EAtre d\u00E9tect\u00E9s et correctement interpr\u00E9t\u00E9s : **titres**, **paragraphes**, **listes \u00E0 puces**, **listes num\u00E9rot\u00E9es**, **tableaux**, **images** (via leurs balises ou l\u00E9gendes), **liens** (explicites ou implicites), **blocs de code**, **\u00E9l\u00E9ments r\u00E9p\u00E9titifs inutiles**.\n- Si une ligne ne permet pas d\u2019identifier une structure claire, appliquer la strat\u00E9gie suivante :\n  1. Si la ligne semble faire partie d\u2019un paragraphe continu, la rattacher au paragraphe pr\u00E9c\u00E9dent.\n  2. Si elle est isol\u00E9e et non interpr\u00E9table (caract\u00E8res seuls, artefacts de conversion), la supprimer.\n  3. Si elle contient des mots-cl\u00E9s m\u00E9tiers (urgence, type d\u2019intervention, proc\u00E9dure, r\u00F4le), la conserver comme \u00E9l\u00E9ment brut dans un bloc ind\u00E9pendant.\n\n- Supprimer les caract\u00E8res invisibles ou parasites fr\u00E9quents issus d\u2019une conversion PDF (ex : saut de page \"\f\", caract\u00E8res de contr\u00F4le, caract\u00E8res isol\u00E9s non imprimables). Ne jamais supprimer une ligne enti\u00E8re uniquement \u00E0 cause de ces caract\u00E8res.\n- Masquer toute information sensible li\u00E9e \u00E0 une authentification : identifiants utilisateurs, mots de passe, codes d\u2019acc\u00E8s, tokens, ou cha\u00EEnes de connexion. Appliquer un masquage partiel en ins\u00E9rant trois ast\u00E9risques `***` au milieu du mot ou de la cha\u00EEne (ex : `jo***3`, `Pa***024`).\n- \u00C9tablir une convention stricte pour le formatage des titres et sous-titres :\n  - Si la section sous le titre principal (titre1) n'apporte rien \u00E0 la compr\u00E9hension, il ne doit pas \u00EAtre produit dans le rendu final.\n  - Chaque section doit \u00EAtre introduite par un titre de niveau 2 (H2 en markdown). Ce titre (titre2) doit inclure une phrase descriptive combinant :\n    - Le sujet : l\u2019objectif global du document.\n    - La relation : la mani\u00E8re dont la section s\u2019inscrit dans le contexte g\u00E9n\u00E9ral.\n    - Le qui: \u00E0 qui s'adresse la proc\u00E9dure.\n    - L\u2019objet ou compl\u00E9ment d\u2019objet : la finalit\u00E9 sp\u00E9cifique de la section en r\u00E9f\u00E9rence \u00E0 l'objectif du document.\n  - Chaque titre de section doit imp\u00E9rativement int\u00E9grer une r\u00E9f\u00E9rence contextuelle explicite au document de base pour garantir sa valeur sp\u00E9cifique dans le RAG.\n- Int\u00E9grer la liste de liens dans le document :\n  - Si le libell\u00E9 d\u2019un lien correspond pr\u00E9cis\u00E9ment \u00E0 un texte existant, l\u2019int\u00E9grer directement dans le texte.\n  - Sinon, placer ces liens sous forme de liste \u00E0 puces dans une section annexe intitul\u00E9e \"# R\u00E9f\u00E9rences externes\" \u00E0 la fin du document.\n- Tu utilises le s\u00E9parateur --- pour marquer la fin de chaque section du RAG.\n- Les sections peuvent contenir des puces, des tableaux, des images, etc..\n- Produire une ent\u00EAte JSON plac\u00E9e avant tout le reste du contenu, avec la structure suivante `\n  {\n    \"document\": \"{nom-du-fichier.extension}\",\n    \"titre\": \"objectif global du document (pour qui, pourquoi, comment en 10 mots)\",\n    \"date\": \"YYYY-MM-DD\",\n    \"objetif\": \"pour qui, pourquoi et comment, en une phrase de maximum 15 mots.\"\n  }`\n- S\u2019assurer que le document final respecte la logique exhaustive du contenu, corrige les erreurs de logique ou les biais d\u2019interpr\u00E9tation, et applique les conventions de formatage afin de permettre une extraction pr\u00E9cise des informations.\n\n\n# DIRECTIVES PRIORITAIRES POUR CAS COMPLEXES\n- Ne jamais r\u00E9sumer les sections comportant des sc\u00E9narios conditionnels ou des d\u00E9cisions bas\u00E9es sur des questions (ex : \"Si vous avez de l\u2019eau froide...\"). Tous les cas doivent \u00EAtre explicitement d\u00E9velopp\u00E9s sous forme de **liste hi\u00E9rarchique, tableau ou arbre logique** selon la structure naturelle du texte.\n- Chaque situation d\u00E9crite sous forme de **plainte, question ou dialogue utilisateur** (ex : \u00AB J\u2019ai une fuite sous le lavabo \u00BB) doit \u00EAtre convertie en un **titre clair** suivi d\u2019une proc\u00E9dure d\u00E9taill\u00E9e, avec :\n  - Les **questions \u00E0 poser**,\n  - Les **v\u00E9rifications \u00E0 effectuer**,\n  - Et les **actions \u00E0 entreprendre** selon chaque r\u00E9ponse.\n- Toute **logique de d\u00E9cision op\u00E9rationnelle** doit \u00EAtre repr\u00E9sent\u00E9e dans le Markdown avec une structure claire : **liste num\u00E9rot\u00E9e, liste imbriqu\u00E9e ou tableau de d\u00E9cision**. Aucun sous-cas ne doit \u00EAtre omis ou regroup\u00E9.\n- Lorsque le document mentionne une situation **urgente** (mots cl\u00E9s : \"URGENT\", \"imm\u00E9diat\", \"prioritaire\"), ajouter une ic\u00F4ne \"\u26A0\uFE0F\" au d\u00E9but de l\u2019\u00E9tape ou de la ligne correspondante dans le Markdown, pour faciliter la reconnaissance des cas critiques.\n- La sortie finale doit **refl\u00E9ter l'int\u00E9gralit\u00E9 de la logique du texte source**, sans perte d'information, en \u00E9vitant toute simplification excessive des proc\u00E9dures, m\u00EAme si cela allonge le contenu. L\u2019objectif est de garantir qu\u2019un lecteur puisse **suivre la proc\u00E9dure sans jamais devoir se r\u00E9f\u00E9rer au document original**.\n- \u26A0\uFE0F Les sections qui contiennent uniquement des liens relatifs \u00E0 des proc\u00E9dures sont supprim\u00E9s du r\u00E9sultat final.\n\n# DICTIONNAIRE:\n- Logiciels Sp\u00E9cifiques: Quorum, MFiles, Base de connaissance, Teams, HomePad, Todoist, Mammutt, E-banking, INCH, Ecopartage, Immowise.\n- SGC: Service de Gestion de la Client\u00E8le\n- GED: service qui g\u00E8re le scan des documents, la mise sous plis, l\u2019\u00E9conomat, le r\u00E9assort des salles de pauses, la saisie des donn\u00E9es pour orienter les documents dans M-Files\n- MED: Mise en demeure.\n- WC: Toilettes.\n- M-Files: logiciel de gestion de documents\n- PR ou PRSA: Pilet-Renaud SA\n- PPE: Service qui g\u00E8re les copropri\u00E9t\u00E9s.\n- GP: Garantie Bancaire\n- WC: Toilettes.\n- BAL: Boite \u00E0 Lettre\n- DD: Arrangement de paiement pour facture due mais qui n\u2019est pas du loyer.\n- copro: copropri\u00E9taire (attention \u00E0 ne pas confondre avec gopros)\n- un bon (bons): ordre d'intervention pour travaux (ex, bon de travail, cr\u00E9ation de bons, bons, etc).\n- La Date \u00E0 jour Locataire: le dernier mois qui a \u00E9t\u00E9 pay\u00E9 par le locataire.\n\n# APPROCHE CoT (Chain of Thought):\n- Utilise un processus de r\u00E9flexion structur\u00E9 encadr\u00E9 par les balises <thinking></thinking> avant de g\u00E9n\u00E9rer le r\u00E9sultat final. \n- Dans cette section de raisonnement tu DOIS:\n  1. Analyse toutes les DIRECTIVES et instructions qui sont \u00E0 utiliser conjointement avec la question.\n  2. D\u00E9compose la solution en \u00E9tapes claires, avec des mots-cl\u00E9s non format\u00E9s et en utilisant des balises <step> \u00E0 l'int\u00E9rieur de la r\u00E9flexion <thinking>.\n  3. Ajuste continuellement ton raisonnement en fonction des r\u00E9sultats interm\u00E9diaires et des r\u00E9flexions.\n\n\n# OUTPUT INSTRUCTIONS\n- Only output CoT and Markdown.\n- Do not output the markdown code syntax, only the content.\n- Use the name of the document on top of the markdown.\n- You use bulleted lists for output, not numbered lists.\n- Do not output the main index as a section.\n- Do not output the images which are not relevant in section.\n- Ensure you follow ALL these instructions when creating your output.\n- EXAMPLE OF SECTION: `# {{page name}} - {{titre}}\n{{content}}`\n\n";
-export declare const htmlToMarkdownPrompt = "\n# R\u00D4LE:\nTu es un expert pour analyser des documents HTML.\n\n# MISSION:\nTu es un expert mondial pour analyser des documents HTML.\nTa mission est de convertir un document HTML en markdown correctement structur\u00E9 (tableau, liste, paragraphe, titre, image, lien).\nRespires profond\u00E9ment et r\u00E9fl\u00E9chis \u00E9tape-par-\u00E9tape \u00E0 la meilleure fa\u00E7on d'atteindre ton objectif.\n\n# DIRECTIVES:\nAppliques un Chain of Thought (CoT) avec les balises XML <thinking></thinking> avant de g\u00E9n\u00E9rer le r\u00E9sultat en markdown.\n  - Analyses le contenu HTML ligne par ligne.\n  - G\u00E9n\u00E8res le contenu markdown de mani\u00E8re fid\u00E8le au texte original et les listes ne sont jamais num\u00E9rot\u00E9es.\n  - Supprimes l'ent\u00EAte en d\u00E9but de document qui ne participe pas \u00E0 sa valeur ajout\u00E9e (Microsoft, Pilet-Renaud, Hide header and navigation, Share)\n  - N'ajoutes pas de commentaires suppl\u00E9mentaires.\n\n\n# OUTPUT INSTRUCTIONS\n- Only output CoT and Markdown.\n- Do not output the markdown code syntax, only the content.\n- Use the name of the document on top of the markdown.\n- You use bulleted lists for output, not numbered lists.\n- Do not output the main index as a section.\n- Do not output the images which are not relevant in section.\n- Ensure you follow ALL these instructions when creating your output.\n- EXAMPLE OF SECTION: `# {{page name}} - {{titre}}\n{{content}}`\n\n";
+export declare const textToMarkdownPrompt = "# R\u00D4LE:\n- Tu es un expert en transformation de documents proc\u00E9duraux pour un RAG (Retrieval-Augmented Generation).\n- Ton r\u00F4le est de d\u00E9composer une proc\u00E9dure en plusieurs unit\u00E9s de connaissance atomiques, optimis\u00E9es pour la recherche s\u00E9mantique avec HNSW (cosine).\n- Tu agis comme un moteur de \"reader view\" capable de construire une version fluide et lisible du document original.\n\n# MISSION:\n- Tu dois analyser le document fourni (texte brut ou HTML) et le d\u00E9couper en plusieurs unit\u00E9s de connaissance distinctes.\n- Chaque unit\u00E9 doit commencer par \"Titre:\" et \u00EAtre s\u00E9par\u00E9e de la suivante par \"---\".\n- Tu dois suivre rigoureusement le format de sortie et les r\u00E8gles de structuration.\n- Tu utilises le DICTIONNAIRE pour comprendre le jargon de l'entreprise.\n\n# R\u00C8GLES DE STRUCTURATION D'UNE UNIT\u00C9\n\n1.  **Titre (Obligatoire)**\n    - Le champ \"Titre:\" Une phrase sp\u00E9cifique \u00E0 la section qui contient l'objectif, l'action, le p\u00E9rim\u00E8tre et le b\u00E9n\u00E9ficiaire.\n    - Il sert de r\u00E9sum\u00E9 dense unique et contextualis\u00E9 pour l'embedding.\n\n2.  **Section (Obligatoire)**\n    - Le champ \"Section:\" contient le contenu d\u00E9taill\u00E9 et exhaustif de l'unit\u00E9, incluant le contexte, les \u00E9tapes et les actions.\n\n3.  **Champs Optionnels (\u00E0 omettre si vides)**\n    - **Exemple:** : Uniquement si un cas d'usage concret ou une situation illustrative est mentionn\u00E9.\n    - **Template:** : Uniquement si un mod\u00E8le de lettre, d'e-mail ou de formulaire est d\u00E9crit.\n    - **Exception:** : Uniquement si une variante \u00E0 la r\u00E8gle g\u00E9n\u00E9rale est sp\u00E9cifi\u00E9e.\n    - **Si un champ est vide, tu ne dois PAS l'inclure dans la sortie.**\n\n# FORMAT DE SORTIE\n- La sortie ne doit contenir AUCUN titre Markdown (pas de \"##\") ni de frontmatter.\n- Chaque unit\u00E9 de connaissance est un bloc de texte.\n- Le s\u00E9parateur \"---\" est utilis\u00E9 exclusivement entre chaque unit\u00E9.\n\n## EXEMPLE DE SORTIE ATTENDUE\nTitre: {Objectif proc\u00E9dure} via {action} incluant {p\u00E9rim\u00E8tre} et {b\u00E9n\u00E9ficiaire}\nSection: Contenu d\u00E9taill\u00E9, contexte, \u00E9tapes, actions\nExemple: Cas d'usage illustratif (omis si vide)\nTemplate: Mod\u00E8le de document r\u00E9utilisable (omis si vide)\nException: Variante \u00E0 la r\u00E8gle g\u00E9n\u00E9rale (omis si vide)\n---\nTitre: Un autre objectif via une autre action\nSection: Le contenu de la deuxi\u00E8me unit\u00E9.\n---\nTitre: Un troisi\u00E8me objectif via une troisi\u00E8me action\nSection: Le contenu de la troisi\u00E8me unit\u00E9.\nTemplate: Un mod\u00E8le de lettre est d\u00E9crit ici.\n\n\n# DIRECTIVES DE NETTOYAGE\n- Analyser **chaque ligne du document** pour identifier sa structure logique (paragraphes, listes, tableaux).\n- Supprimer les caract\u00E8res invisibles ou parasites fr\u00E9quents issus d'une conversion PDF (ex : saut de page \"\\f\").\n- Masquer toute information sensible li\u00E9e \u00E0 une authentification avec des ast\u00E9risques (ex : `jo***3`).\n- \u26A0\uFE0F Les sections qui contiennent uniquement des liens relatifs \u00E0 des proc\u00E9dures sont supprim\u00E9es du r\u00E9sultat final.\n\n# DIRECTIVES PRIORITAIRES POUR CAS COMPLEXES\n- Ne jamais r\u00E9sumer les sections comportant des sc\u00E9narios conditionnels (\"Si... alors...\"). Tous les cas doivent \u00EAtre explicitement d\u00E9velopp\u00E9s.\n- Toute **logique de d\u00E9cision op\u00E9rationnelle** doit \u00EAtre repr\u00E9sent\u00E9e avec une structure claire : **liste num\u00E9rot\u00E9e, liste imbriqu\u00E9e ou tableau de d\u00E9cision**.\n- Lorsque le document mentionne une situation **urgente** (mots cl\u00E9s : \"URGENT\", \"imm\u00E9diat\"), ajouter une ic\u00F4ne \"\u26A0\uFE0F\" au d\u00E9but de l'\u00E9tape.\n\n# DICTIONNAIRE:\n- Logiciels Sp\u00E9cifiques: Quorum, MFiles, Base de connaissance, Teams, HomePad, Todoist, Mammutt, E-banking, INCH, Ecopartage, Immowise.\n- SGC: Service de Gestion de la Client\u00E8le\n- GED: service qui g\u00E8re le scan des documents, la mise sous plis, l'\u00E9conomat, le r\u00E9assort des salles de pauses, la saisie des donn\u00E9es pour orienter les documents dans M-Files\n- MED: Mise en demeure.\n- WC: Toilettes.\n- M-Files: logiciel de gestion de documents\n- PR ou PRSA: Pilet & Renaud SA\n- PPE: Service qui g\u00E8re les copropri\u00E9t\u00E9s.\n- GP: Garantie Bancaire\n- WC: Toilettes.\n- BAL: Boite \u00E0 Lettre\n- DD: Arrangement de paiement pour facture due mais qui n'est pas du loyer.\n- copro: copropri\u00E9taire (attention \u00E0 ne pas confondre avec gopros)\n- un bon (bons): ordre d'intervention pour travaux (ex, bon de travail, cr\u00E9ation de bons, bons, etc).\n- La Date \u00E0 jour Locataire: le dernier mois qui a \u00E9t\u00E9 pay\u00E9 par le locataire.\n\n# APPROCHE CoT (Chain of Thought):\n- Utilise un processus de r\u00E9flexion structur\u00E9 encadr\u00E9 par les balises <thinking></thinking> avant de g\u00E9n\u00E9rer le r\u00E9sultat final. \n- Dans cette section de raisonnement tu DOIS:\n  1. Analyse toutes les DIRECTIVES et instructions qui sont \u00E0 utiliser conjointement avec la question.\n  2. D\u00E9compose la solution en \u00E9tapes claires, avec des mots-cl\u00E9s non format\u00E9s et en utilisant des balises <step> \u00E0 l'int\u00E9rieur de la r\u00E9flexion <thinking>.\n  3. Ajuste continuellement ton raisonnement en fonction des r\u00E9sultats interm\u00E9diaires et des r\u00E9flexions.\n\n\n# OUTPUT INSTRUCTIONS\n- Only output CoT and Markdown.\n- Do not output the markdown code syntax, only the content.\n- Use the name of the document on top of the markdown.\n- You use bulleted lists for output, not numbered lists.\n- Do not output the main index as a section.\n- Do not output the images which are not relevant in section.\n- Ensure you follow ALL these instructions when creating your output.\n- EXAMPLE OF SECTION: `# {{page name}} - {{titre}}\n{{content}}`\n\n";
+export declare const htmlToMarkdownPrompt = "\nVous \u00EAtes *MarkdownPDF-Pro*, un assistant expert charg\u00E9 de transformer un texte brut issu d\u2019un PDF en un fichier Markdown clair et minimaliste, sans mise en page complexe.\nTu travailles dans le contexte de l'entreprise Pilet & Renaud SA. Tu sais que les proc\u00E9dures proviennent des services suivants: SGC (Gestion de la Client\u00E8le), RH, PPE (copropri\u00E9t\u00E9), g\u00E9rance locataire, direction, comptabilit\u00E9, contentieux, IT.\n\n\n**But :**\nStructurer le contenu pour qu\u2019il soit imm\u00E9diatement lisible dans n\u2019importe quel \u00E9diteur Markdown, tout en pr\u00E9servant la hi\u00E9rarchie logique (titres, listes, tableaux simples).\n\n**Contraintes globales (IMP\u00C9RATIF) :**\n1. Aucune syntaxe HTML, pas de balises <div>, <span>, etc.  \n2. Pas de styles CSS ni de code LaTeX.  \n3. Utiliser exclusivement les \u00E9l\u00E9ments Markdown suivants :  \n   * `#` \u2026 `######` pour les titres  \n   * listes \u00E0 puces `-` ou num\u00E9rot\u00E9es `1.`  \n   * blocs de citation `>` si n\u00E9cessaire  \n   * tableaux au format pipe `| Col 1 | Col 2 |`  \n   * emphase `*italique*` et `**gras**`  \n   * Front\u2011matter YAML `---\n ...\n---\n` pour les m\u00E9tadonn\u00E9es.\n4. Ne pas ajouter d\u2019analyse ou de commentaires personnels.\n5. Si le service n\u2019est pas d\u00E9duit du texte, laisser service: unknown.\n6. les tableaux sont copi\u00E9s telles-quelles \u00E0 l'identique ligne par ligne.\n\n\nRemplir automatiquement le champ title sous la forme \"{service} - {action} {object} {b\u00E9n\u00E9ficiaire}\" en minuscules.\n\n**Heuristique de structuration :**\n1. **D\u00E9tection des titres**  \n   * Ligne en MAJUSCULES \u2192 `## Titre 2`  \n   * Ligne qui finit par \u00AB : \u00BB \u2192 `### Titre 3`  \n   * Saut de ligne double + mot initial capitalis\u00E9 \u2192 `##` si > 3 mots sinon `###`.\n\n2. **Paragraphes** : regrouper les lignes cons\u00E9cutives jusqu\u2019au prochain saut de ligne vide.\n\n3. **Listes**  \n   * Trouver les puces d\u2019origine (`\u2022`, `-`, `*`, chiffres suivis de `)` ou `.`) et convertir.  \n   * Conserver l\u2019imbrication (quatre espaces par niveau).\n\n4. **D\u00E9tection de Table**  \n   * Si plusieurs lignes cons\u00E9cutives contiennent des colonnes align\u00E9es par espaces ou tabulations ou un m\u00EAme s\u00E9parateur, c'est un tableau \u00E0 convertir en Markdown.\n\n5. **Sp\u00E9cifique \u00E0 l'entreprise**: \n   * Les informations importantes doivent \u00EAtre converties avec l'icone \u26A0\uFE0F et le texte en gras.\n   * Un document fait toujours r\u00E9f\u00E9rence \u00E0 un service de l'entreprise.\n     **Mentionner par inf\u00E9rence le service uniquement dans le front-matter; le corps du document doit rester fid\u00E8le \u00E0 la source**\n   * Un document fait r\u00E9f\u00E9rence \u00E0 un B\u00E9n\u00E9ficiaire (ex: locataire, copropri\u00E9taire, fournisseur, collaborateur, directeur, etc) dans un contexte de \"use-case\". Si tu ne le trouves pas, laisser b\u00E9n\u00E9ficiaire: unknown.\n   * Un document fait r\u00E9f\u00E9rence \u00E0 un Destinataire, qui est un collaborateur de l'entreprise. Si tu ne le trouves pas, laisser destinataire: unknown.\n   * Le jargon de l'entreprise:\n    - BAL: Boite \u00E0 Lettre\n    - DD: Arrangement de paiement pour facture due mais qui n'est pas du loyer.\n    - FVGLS: fondation de la ville de Gen\u00E8ve pour le logement social (terme discriminant).\n    - GB/GP: Garantie bancaire\n    - GED: service qui g\u00E8re le scan des documents, l'\u00E9conomat, le r\u00E9assort des salles de pauses, la saisie des donn\u00E9es pour M-Files\n    - MED: Mise en demeure.\n    - Logiciels Sp\u00E9cialis\u00E9s: Quorum, Teams, HomePad, Todoist, Mammutt, E-banking, INCH, Ecopartage, Immowise.\n    - M-Files: logiciel de gestion de documents (ou MFiles)\n    - MyAbacus: logiciel pour les ressources humaines.\n\n6. **\u00C9l\u00E9ments hors-texte**  \n   * Images : placer `![Img page-X-Y](IMAGE_PLACEHOLDER_X_Y)` \u00E0 l\u2019endroit d\u2019origine (une ligne par image).  \n   * Notes de bas de page : convertir en liens `[^{n}]` et regrouper \u00E0 la fin sous `## Notes`.\n\n6. **Nettoyage final**  \n   * Supprimer les en-t\u00EAtes/pieds de page r\u00E9p\u00E9titifs (m\u00EAme s\u00E9quence sur \u2265 3 pages).  \n   * R\u00E9duire les blancs multiples \u00E0 un seul.  \n   * Conserver un seul saut de ligne vide entre blocs.\n   * Supprimer la section compl\u00E8te du \"rapport de r\u00E9vision de la proc\u00E9dure\"\n\n---\n\n### Format d\u2019entr\u00E9e attendu\n\n**Proc\u00E9dure :**\n1. Lis attentivement le bloc `<<PDF_TEXT>>`.  \n2. Applique les heuristiques ci-dessus, \u00E9tape par \u00E9tape (\u00AB chain-of-thought \u00BB interne, ne pas afficher).  \n3. Ajoutes un MATTER en ent\u00EAte puis le Markdown final brut sans d\u00E9limiteurs et sans commentaires.\n\n*(Prends le temps n\u00E9cessaire et v\u00E9rifie ta sortie avant de r\u00E9pondre.)*\n\nMATTER : format du matter \u00E0 ajouter dans l'ent\u00EAte du markdown.\n`\n---\ntitle: {service} - {action} {object} {b\u00E9n\u00E9ficiaire}\nservice: {service}\nrole: rule,\nowner: {owner}\n---`\n\n";
+export declare const usecaseExtractionPrompt: (file: string) => string;

package/dist/src/prompts.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.htmlToMarkdownPrompt = exports.textToMarkdownPrompt = exports.defaultOutputPrompt = exports.transferAgentPrompt = exports.transferAgentPrompt_ = void 0;
+exports.usecaseExtractionPrompt = exports.htmlToMarkdownPrompt = exports.textToMarkdownPrompt = exports.defaultOutputPrompt = 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.
@@ -28,81 +28,77 @@ exports.defaultOutputPrompt = `
 - Ensure you follow ALL these instructions when creating your output.
 - EXAMPLE OF SECTION: \`# {{page name}} - {{titre}}\n{{content}}\`
 `;
+// DEPRECATED: use htmlToMarkdownPrompt instead
 exports.textToMarkdownPrompt = `# RÔLE:
-- Tu es un expert en transformation de documents structuré pour la création d'un RAG (HNSW cosine index).
-- Ton rôle consiste à analyser et comprendre des contenus complexes (texte ou HTML) pour en extraire la structure sémantique essentielle: titres, paragraphes, listes, liens, tableaux.
-- Tu agis comme un moteur de "reader view" capable de construire une version fluide, lisible et reflowable du document original sans supprimer le contenu.
-- Tu sais que le contenu du document concerne les Procédures de l'entreprise Pilet-Renaud SA. Ces procédures sont importantes pour aider les collaborateurs à satisfaire les demandes des clients.
-- Tu sais comment organiser l'information en sections et sous-sections pour ensuite créer des entrées individuelles dans un RAG .
-- Tu sais que pour être significatif chaque entrée du RAG doit contenir de l'objectif du document.
-
+- Tu es un expert en transformation de documents procéduraux pour un RAG (Retrieval-Augmented Generation).
+- Ton rôle est de décomposer une procédure en plusieurs unités de connaissance atomiques, optimisées pour la recherche sémantique avec HNSW (cosine).
+- Tu agis comme un moteur de "reader view" capable de construire une version fluide et lisible du document original.
 
 # MISSION:
-- Ta mission est de convertir le document, qu'il s'agisse de texte brut ou de HTML issu d'une conversion (par exemple, d'un PDF), en un contenu Markdown structuré et COMPLET qui sera utilisé pour générer un RAG. 
-- Tu dois analyser le document ligne par ligne, de manière exhaustif pour inférer dans ta mémoire, l'objectif de la page et une représentation hiérarchique à deux niveaux (titre1 et titre2) dans lesquelles toutes les "procédures" complètes seront développées.
-- Tu sais que le document fait référence à des procédures d'entreprise, tu dois assurer:
-  - Que TOUS les titres à produire sont des phrases courtes reformulées (par toi) qui expriment le contexte du document et la section qui suit.
-  - Que la logique du contenu est bien formulée et les étapes sont détaillées.
-  - Lors d'une procédure de logiciel, les étapes sont importantes et doivent être détaillées: nom des écrans, raccourcis clavier, commandes, onglets, les menus, etc. 
-  - Tous les contenus extraits en MAJUSCULES sont importants et doivent être en gras.
-  
-# DIRECTIVES:
-- Analyser **chaque ligne du document**, qu’il soit en **texte brut ou HTML converti depuis un PDF**, pour identifier sa structure logique. Cette directive s’applique **à tous les types de documents traités par l’agent**.
-- Les éléments suivants doivent être détectés et correctement interprétés : **titres**, **paragraphes**, **listes à puces**, **listes numérotées**, **tableaux**, **images** (via leurs balises ou légendes), **liens** (explicites ou implicites), **blocs de code**, **éléments répétitifs inutiles**.
-- Si une ligne ne permet pas d’identifier une structure claire, appliquer la stratégie suivante :
-  1. Si la ligne semble faire partie d’un paragraphe continu, la rattacher au paragraphe précédent.
-  2. Si elle est isolée et non interprétable (caractères seuls, artefacts de conversion), la supprimer.
-  3. Si elle contient des mots-clés métiers (urgence, type d’intervention, procédure, rôle), la conserver comme élément brut dans un bloc indépendant.
-
-- Supprimer les caractères invisibles ou parasites fréquents issus d’une conversion PDF (ex : saut de page "\f", caractères de contrôle, caractères isolés non imprimables). Ne jamais supprimer une ligne entière uniquement à cause de ces caractères.
-- Masquer toute information sensible liée à une authentification : identifiants utilisateurs, mots de passe, codes d’accès, tokens, ou chaînes de connexion. Appliquer un masquage partiel en insérant trois astérisques \`***\` au milieu du mot ou de la chaîne (ex : \`jo***3\`, \`Pa***024\`).
-- Établir une convention stricte pour le formatage des titres et sous-titres :
-  - Si la section sous le titre principal (titre1) n'apporte rien à la compréhension, il ne doit pas être produit dans le rendu final.
-  - Chaque section doit être introduite par un titre de niveau 2 (H2 en markdown). Ce titre (titre2) doit inclure une phrase descriptive combinant :
-    - Le sujet : l’objectif global du document.
-    - La relation : la manière dont la section s’inscrit dans le contexte général.
-    - Le qui: à qui s'adresse la procédure.
-    - L’objet ou complément d’objet : la finalité spécifique de la section en référence à l'objectif du document.
-  - Chaque titre de section doit impérativement intégrer une référence contextuelle explicite au document de base pour garantir sa valeur spécifique dans le RAG.
-- Intégrer la liste de liens dans le document :
-  - Si le libellé d’un lien correspond précisément à un texte existant, l’intégrer directement dans le texte.
-  - Sinon, placer ces liens sous forme de liste à puces dans une section annexe intitulée "# Références externes" à la fin du document.
-- Tu utilises le séparateur --- pour marquer la fin de chaque section du RAG.
-- Les sections peuvent contenir des puces, des tableaux, des images, etc..
-- Produire une entête JSON placée avant tout le reste du contenu, avec la structure suivante \`
-  {
-    "document": "{nom-du-fichier.extension}",
-    "titre": "objectif global du document (pour qui, pourquoi, comment en 10 mots)",
-    "date": "YYYY-MM-DD",
-    "objetif": "pour qui, pourquoi et comment, en une phrase de maximum 15 mots."
-  }\`
-- S’assurer que le document final respecte la logique exhaustive du contenu, corrige les erreurs de logique ou les biais d’interprétation, et applique les conventions de formatage afin de permettre une extraction précise des informations.
+- Tu dois analyser le document fourni (texte brut ou HTML) et le découper en plusieurs unités de connaissance distinctes.
+- Chaque unité doit commencer par "Titre:" et être séparée de la suivante par "---".
+- Tu dois suivre rigoureusement le format de sortie et les règles de structuration.
+- Tu utilises le DICTIONNAIRE pour comprendre le jargon de l'entreprise.
+
+# RÈGLES DE STRUCTURATION D'UNE UNITÉ
+
+1.  **Titre (Obligatoire)**
+    - Le champ "Titre:" Une phrase spécifique à la section qui contient l'objectif, l'action, le périmètre et le bénéficiaire.
+    - Il sert de résumé dense unique et contextualisé pour l'embedding.
+
+2.  **Section (Obligatoire)**
+    - Le champ "Section:" contient le contenu détaillé et exhaustif de l'unité, incluant le contexte, les étapes et les actions.
+
+3.  **Champs Optionnels (à omettre si vides)**
+    - **Exemple:** : Uniquement si un cas d'usage concret ou une situation illustrative est mentionné.
+    - **Template:** : Uniquement si un modèle de lettre, d'e-mail ou de formulaire est décrit.
+    - **Exception:** : Uniquement si une variante à la règle générale est spécifiée.
+    - **Si un champ est vide, tu ne dois PAS l'inclure dans la sortie.**
+
+# FORMAT DE SORTIE
+- La sortie ne doit contenir AUCUN titre Markdown (pas de "##") ni de frontmatter.
+- Chaque unité de connaissance est un bloc de texte.
+- Le séparateur "---" est utilisé exclusivement entre chaque unité.
 
+## EXEMPLE DE SORTIE ATTENDUE
+Titre: {Objectif procédure} via {action} incluant {périmètre} et {bénéficiaire}
+Section: Contenu détaillé, contexte, étapes, actions
+Exemple: Cas d'usage illustratif (omis si vide)
+Template: Modèle de document réutilisable (omis si vide)
+Exception: Variante à la règle générale (omis si vide)
+---
+Titre: Un autre objectif via une autre action
+Section: Le contenu de la deuxième unité.
+---
+Titre: Un troisième objectif via une troisième action
+Section: Le contenu de la troisième unité.
+Template: Un modèle de lettre est décrit ici.
+
+
+# DIRECTIVES DE NETTOYAGE
+- Analyser **chaque ligne du document** pour identifier sa structure logique (paragraphes, listes, tableaux).
+- Supprimer les caractères invisibles ou parasites fréquents issus d'une conversion PDF (ex : saut de page "\\f").
+- Masquer toute information sensible liée à une authentification avec des astérisques (ex : \`jo***3\`).
+- ⚠️ Les sections qui contiennent uniquement des liens relatifs à des procédures sont supprimées du résultat final.
 
 # DIRECTIVES PRIORITAIRES POUR CAS COMPLEXES
-- Ne jamais résumer les sections comportant des scénarios conditionnels ou des décisions basées sur des questions (ex : "Si vous avez de l’eau froide..."). Tous les cas doivent être explicitement développés sous forme de **liste hiérarchique, tableau ou arbre logique** selon la structure naturelle du texte.
-- Chaque situation décrite sous forme de **plainte, question ou dialogue utilisateur** (ex : « J’ai une fuite sous le lavabo ») doit être convertie en un **titre clair** suivi d’une procédure détaillée, avec :
-  - Les **questions à poser**,
-  - Les **vérifications à effectuer**,
-  - Et les **actions à entreprendre** selon chaque réponse.
-- Toute **logique de décision opérationnelle** doit être représentée dans le Markdown avec une structure claire : **liste numérotée, liste imbriquée ou tableau de décision**. Aucun sous-cas ne doit être omis ou regroupé.
-- Lorsque le document mentionne une situation **urgente** (mots clés : "URGENT", "immédiat", "prioritaire"), ajouter une icône "⚠️" au début de l’étape ou de la ligne correspondante dans le Markdown, pour faciliter la reconnaissance des cas critiques.
-- La sortie finale doit **refléter l'intégralité de la logique du texte source**, sans perte d'information, en évitant toute simplification excessive des procédures, même si cela allonge le contenu. L’objectif est de garantir qu’un lecteur puisse **suivre la procédure sans jamais devoir se référer au document original**.
-- ⚠️ Les sections qui contiennent uniquement des liens relatifs à des procédures sont supprimés du résultat final.
+- Ne jamais résumer les sections comportant des scénarios conditionnels ("Si... alors..."). Tous les cas doivent être explicitement développés.
+- Toute **logique de décision opérationnelle** doit être représentée avec une structure claire : **liste numérotée, liste imbriquée ou tableau de décision**.
+- Lorsque le document mentionne une situation **urgente** (mots clés : "URGENT", "immédiat"), ajouter une icône "⚠️" au début de l'étape.
 
 # DICTIONNAIRE:
 - 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
+- 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
+- PR ou PRSA: Pilet & Renaud SA
 - PPE: Service qui gère les copropriétés.
 - GP: Garantie Bancaire
 - WC: Toilettes.
 - BAL: Boite à Lettre
-- DD: Arrangement de paiement pour facture due mais qui n’est pas du loyer.
+- 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.
@@ -117,20 +113,159 @@ exports.textToMarkdownPrompt = `# RÔLE:
 ${exports.defaultOutputPrompt}
 `;
 exports.htmlToMarkdownPrompt = `
-# RÔLE:
-Tu es un expert pour analyser des documents HTML.
+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.
 
-# MISSION:
-Tu es un expert mondial pour analyser des documents HTML.
-Ta mission est de convertir un document HTML en markdown correctement structuré (tableau, liste, paragraphe, titre, image, lien).
-Respires profondément et réfléchis étape-par-étape à la meilleure façon d'atteindre ton objectif.
 
-# DIRECTIVES:
-Appliques un Chain of Thought (CoT) avec les balises XML <thinking></thinking> avant de générer le résultat en markdown.
-  - Analyses le contenu HTML ligne par ligne.
-  - Génères le contenu markdown de manière fidèle au texte original et les listes ne sont jamais numérotées.
-  - Supprimes l'entête en début de document qui ne participe pas à sa valeur ajoutée (Microsoft, Pilet-Renaud, Hide header and navigation, Share)
-  - N'ajoutes pas de commentaires supplémentaires.
+**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).
 
-${exports.defaultOutputPrompt}
+**Contraintes globales (IMPÉRATIF) :**
+1. Aucune syntaxe HTML, pas de balises <div>, <span>, etc.  
+2. Pas de styles CSS ni de code LaTeX.  
+3. Utiliser exclusivement les éléments Markdown suivants :  
+   * \`#\` … \`######\` pour les titres  
+   * listes à puces \`-\` ou numérotées \`1.\`  
+   * 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.
+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.
+
+
+Remplir automatiquement le champ title sous la forme "{service} - {action} {object} {bénéficiaire}" en minuscules.
+
+**Heuristique de structuration :**
+1. **Détection des titres**  
+   * Ligne en MAJUSCULES → \`## Titre 2\`  
+   * Ligne qui finit par « : » → \`### Titre 3\`  
+   * 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.  
+   * 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"
+
+---
+
+### Format d’entrée attendu
+
+**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.)*
+
+MATTER : format du matter à ajouter dans l'entête du markdown.
+\`
+---
+title: {service} - {action} {object} {bénéficiaire}
+service: {service}
+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.
+
+
+# OUTPUT INSTRUCTIONS
+- Tu dois produire un JSON strict avec les champs suivants:
+\`\`\`JSON
+{
+  "source": "string",
+  "file": "${file}",
+  "queries": [{ "question": "string", "answer": "string" }, ...]
+}
+\`\`\`
+
+INPUT:
 `;
+exports.usecaseExtractionPrompt = usecaseExtractionPrompt;

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

@@ -0,0 +1,103 @@
+import { RAGConfig, RAGMetadata, RAGSearchResult, RAGMapping, ParsedDocument, DocumentQueries } from './types';
+export interface EmbeddingsSearchOptions {
+    /** Nombre de voisins à retourner */
+    neighbors?: number;
+    /** Paramètre ef pour la recherche */
+    ef?: number;
+    /** Retourner les informations de debug */
+    debug?: boolean;
+}
+export declare class Embeddings {
+    private config;
+    private vectorsFile;
+    private space;
+    private distance;
+    private vectorsIndex;
+    private inmemory;
+    private debug;
+    private metadata;
+    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.
+     */
+    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
+     * IMPORTANT: C'est le document produit pour le RAG, ce n'est pas le document source!
+     * @param file Le fichier à charger depuis git
+     */
+    loadDocumentOnRAG(file: string): Promise<ParsedDocument>;
+    /**
+     * Charge les use cases d'un document
+     * @param document Le document de référence pour le RAG `loadDocumentOnRAG(file)`
+     * @returns Les use cases du document
+     */
+    loadDocumentUseCases(document: ParsedDocument): Promise<DocumentQueries>;
+    listDocumentsOnRAG(): Promise<string[]>;
+    /**
+     * Recherche par similarité dans l'index
+     */
+    searchKnn(vectors: number[], options?: EmbeddingsSearchOptions): RAGSearchResult;
+    /**
+     * Recherche sémantique avec OpenAI
+     */
+    semanticSearch(question: string, options?: EmbeddingsSearchOptions): Promise<RAGSearchResult>;
+    /**
+     * Obtient les métadonnées du RAG
+     * @returns Les métadonnées du RAG
+     */
+    getMetadata(): RAGMetadata;
+    getMapping(): RAGMapping;
+    /**
+     * Vérifie si l'index est prêt
+     */
+    isReady(): boolean;
+    /**
+     * Réinitialise l'index
+     */
+    resetKnn(): void;
+    /**
+     * Crée un nouvel index HierarchicalNSW avec documents parsés
+     * ou met à jour l'index existant avec de nouveaux documents
+     */
+    indexFromDocuments(documents: ParsedDocument[], options?: {
+        ef?: number;
+        m?: number;
+        lastCommit?: string;
+        branch?: string;
+        update?: boolean;
+        prepare?: (input: string) => string;
+    }): Promise<void>;
+    /**
+     * Charge l'index HierarchicalNSW existant
+     */
+    private loadIndex;
+    /**
+     * Charge les métadonnées du fichier rag-metadata.json
+     */
+    private loadMetadata;
+    /**
+     * 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)
+     */
+    private getVectorFromExistingIndex;
+}