agentic-api 1.0.6 → 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,6 +19,10 @@ 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 },
@@ -27,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 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:\" doit suivre ce format : \"{Objectif proc\u00E9dure} via {action de la section} incluant {\u00E9l\u00E9ments cl\u00E9s} et {responsables/outils}\".\n    - Il sert de r\u00E9sum\u00E9 dense et contextualis\u00E9 pour l'embedding.\n\n2.  **Section (Obligatoire)**\n    - Le champ \"Section:\" contient le contenu d\u00E9taill\u00E9 de l'unit\u00E9, incluant le contexte, les \u00E9tapes, les actions et les responsables.\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 {\u00E9l\u00E9ments cl\u00E9s} et {responsables}\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 = "\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,6 +28,7 @@ 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 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).
@@ -42,11 +43,11 @@ exports.textToMarkdownPrompt = `# RÔLE:
 # RÈGLES DE STRUCTURATION D'UNE UNITÉ
 
 1.  **Titre (Obligatoire)**
-    - Le champ "Titre:" doit suivre ce format : "{Objectif procédure} via {action de la section} incluant {éléments clés} et {responsables/outils}".
-    - Il sert de résumé dense et contextualisé pour l'embedding.
+    - 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é de l'unité, incluant le contexte, les étapes, les actions et les responsables.
+    - 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é.
@@ -60,7 +61,7 @@ exports.textToMarkdownPrompt = `# RÔLE:
 - Le séparateur "---" est utilisé exclusivement entre chaque unité.
 
 ## EXEMPLE DE SORTIE ATTENDUE
-Titre: {Objectif procédure} via {action} incluant {éléments clés} et {responsables}
+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)
@@ -92,7 +93,7 @@ Template: Un modèle de lettre est décrit ici.
 - 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.
@@ -112,20 +113,159 @@ Template: Un modèle de lettre est décrit ici.
 ${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;
+}