agentic-api 2.0.314 → 2.0.585

package/dist/src/prompts.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.usecaseExtractionPrompt = exports.usecaseExtractionPrompt_OLD = exports.htmlToMarkdownPrompt = exports.textToMarkdownPrompt = exports.defaultOutputPrompt = exports.transferAgentPromptHandoff = exports.transferAgentPromptStructured = exports.transferAgentPrompt = exports.transferAgentPrompt__ = exports.transferAgentPrompt_ = void 0;
+exports.usecaseExtractionPrompt = exports.htmlToMarkdownPrompt = exports.textToMarkdownPrompt = exports.defaultOutputPrompt = exports.transferAgentPromptHandoff = exports.transferAgentPromptStructured = exports.transferAgentPrompt = exports.transferAgentPrompt__ = exports.transferAgentPrompt_ = void 0;
 exports.transferAgentPrompt_ = `Triggers a transfer of the user to a more specialized agent. 
   Calls escalate to a more specialized LLM agent or to a human agent, with additional context. 
   Only call this function if one of the available agents is appropriate. Don't transfer to your own agent type.
@@ -242,130 +242,63 @@ owner: {owner}
 
 
 `;
-const usecaseExtractionPrompt_OLD = (file) => `# RÔLE:
-   - Tu es un expert en développement de test unitaires avec nodejs et jtest. 
-   - Tu as développé un RAG avec openai et "hnswlib-node" qui contient toutes les Procédures de l'entreprise Pilet & Renaud SA.
-   - Ta mission est de créer une série de tests exhaustifs pour valider que le RAG couvre à 100% le contenu des procédures de l'entreprise. 
-   - Produire des questions à un coût important, tu dois être efficace, tu dois capturer un maximum de détails ( action, objet, bénéficiaire, contexte) avec un minimum de questions (maximum 4):
-     Une question peut concerner l'utilisation précise d'un logiciel ou un article précis de réglementation.
-     Chaque question doit satisfaire ces critères: clairement identifier le problème à résoudre ou l'action souhaitée dans le domaine précis du document fourni, doit être spécifique et ne peut pas être ambiguë.
-     Tu DOIS supprimer du résultat les questions génériques qui non spécifiques au contexte métier du document.
-     Toutes les questions que tu vas créer concernent précisément le document fourni en INPUT ci-dessous. 
-   - Pour orienter la formulation des questions, je te fournis quelques exemples de questions réelles.
-   - En moyenne, chaque question doit être au maximum de 15 mots, mais tu peux en produire aussi des plus courtes (20%) pour élargir le champ des tests.
-   - La réponse contient la liste de mots très spécifiques pour chaque section de la procédure séparés par des virgules.
-   - Si la réponse concerne un schéma, une procédure ou l'utilisation d'un logiciel, tu dois décrire le besoin spécifique.
-   
-   
-   # EXEMPLES de formulation utilisées par les collaborateurs l'entreprise (attention à ne pas utiliser ces exemples si le sujet du INPUT´est différent).
-   - Écoulement bouché, que faire ?
-   - J’ai une fuite depuis le plafond de ma chambre, j’aimerais un sanitaire
-   - Mon frigo ne fonctionne pas, pouvez-vous mandater quelqu’un ?
-   - Mon store est resté bloqué, pouvez-vous faire quelque chose ?
-   - J’aimerais faire reproduire des clés, comment faire ? combien ça coûte ?
-   - Je suis fournisseur, ma facture n’est toujours pas payée par Pilet & Renaud.
-   - J’ai payé mon loyer, mais j’ai reçu un rappel, pourquoi ?
-   - Je paie toujours bien mon loyer, pouvez-vous supprimer les frais de rappel c’est la première fois que j’ai du retard.
-   - Est-ce que cet appartement est toujours disponible ? Comment déposer un dossier?
-   - Est-ce que mon dossier de candidature est retenu ? j’aimerais des infos.
-   - Inscription de korkmaz?
-   - J’ai reçu un appel manqué de la régie mais je ne sais pas qui a tenté de me joindre.
-   - Un fournisseur me dit que sa facture n’est toujours pas payée par Pilet & Renaud. Comment je vérifie ça?
-   - Comment créer un bon ?
-   - Quelles sont les tâches à faire après avoir conclu un contrat d’entretien ?
-   - Une entreprise souhaite travailler avec nous, que dois-je faire ?
-   
-   # QUESTIONS A EVITER: Les exemples qui ne sont pas pertinents pour le RAG (les documents sont tous concernés par ces questions, c'est donc inutile de les inclure dans les tests).
-   - Ce document contient-il des liens externes ?
-   - Cette absence de liens affecte-t-elle la validité du document ?
-   - Qui doit valider les changements dans la procédure ?
-   - Comment valider une modification de procédure ?
-   
-   # DICTIONNAIRE (jargon de l'entreprise):
-   - Logiciels Spécifiques: Quorum, MFiles, Base de connaissance, Teams, HomePad, Todoist, Mammutt, E-banking, INCH, Ecopartage, Immowise.
-   - SGC: Service de Gestion de la Clientèle
-   - GED: service qui gère le scan des documents, la mise sous plis, l’économat, le réassort des salles de pauses, la saisie des données pour orienter les documents dans M-Files
-   - MED: Mise en demeure.
-   - WC: Toilettes.
-   - M-Files: logiciel de gestion de documents
-   - PR ou PRSA: Pilet & Renaud SA
-   - PPE: Service qui gère les copropriétés.
-   - GP: Garantie Bancaire
-   - BAL: Boite à Lettre
-   - DD: Arrangement de paiement pour facture due mais qui n’est pas du loyer.
-   - copro: copropriétaire (attention à ne pas confondre avec gopros)
-   - un bon (bons): ordre d'intervention pour travaux (ex, bon de travail, création de bons, bons, etc).
-   - La Date à jour Locataire: le dernier mois qui a été payé par le locataire.
-   
-   
-   # OUTPUT INSTRUCTIONS
-   - Tu dois produire un JSON strict avec les champs suivants:
-   \`\`\`JSON
-   {
-     "source": "string",
-     "file": "${file}",
-     "queries": [{ "question": "string" }, ...]
-   }
-   \`\`\`
-   
-   INPUT:
-   `;
-exports.usecaseExtractionPrompt_OLD = usecaseExtractionPrompt_OLD;
-const usecaseExtractionPrompt = (file, options = {}) => `# RÔLE:
-- Tu es un expert en tests unitaires.
+const usecaseExtractionPrompt = (file, options = {}) => `# RÔLE
+- Tu es un collaborateur expérimenté qui aide ses collègues à formuler des questions métier courtes, naturelles et très concrètes.
+- Tu adoptes le point de vue d’un collègue interne qui pose une question précise sur une procédure donnée (INPUT).
 - Le corpus de procédures est indexé (RAG).
-- Tu adoptes le point de vue de l'utilisateur (un collègue interne qui pose une question métier précise à son voisin).
-- Tu génères des **questions discriminantes** testant la **couverture RAG** d’une procédure ou marche à suivre.
-
-# Structure du document en INPUT pour l'extraction des use cases
-- **Titre principal** → unique dans le corpus (très important).
-- **Intervenants** → Acteur(s) et Bénéficiaire(s) (distincts) de la procédure.
-- **Sections** → Titre unique dans la procédure (très important).
-  - **ÉTAPES / ACTIONS** → action/règle/décision importante
-  - **RÉSULTAT** → finalité/effet attendu
-  - **UI/PATH** → chemin/interface (Système > Module > Action)
 
+# Structure du document en INPUT
+- **Titre principal** → unique dans le corpus décrit l'object métier (le “concept central” de la section).
+- **Intervenants** → acteur(s) et bénéficiaire(s).
+- **Sections** → titre unique dans la procédure.
+  - **ÉTAPES / ACTIONS / TABLEAUX**
+  - **RÉSULTAT**
+  - **LOGICIEL** 
 
 # MISSION
-- Créer des **questions ultra-spécifiques** au document **INPUT** pour vérifier la couverture des **objectifs métiers**.
-- Chaque question = **un use-case précis**, **une seule section** (objectif, contexte, bénéficiaire, résultat).
-- Questions **courtes, concrètes, vérifiables** (≈12–18 mots; déroger si nécessaire pour l’exactitude).
-- Efficience : **min. 1** question par section, **max. 6** au total.
-- Une section = **un cas d’usage** spécifique (sans ambiguïté).
-- Une question peut viser un logiciel, un **raccourci** clavier, un acronyme, une étiquette, un montant, ou une règle juridique.
-- Critères : problème/action précis, contexte métier clair, non ambigu.
-- **Ne produis pas** de questions hors objectif du document.
-- Tout porte **strictement** sur le document fourni en INPUT.
-
-# FORMAT DES QUESTIONS (obligatoire)
-- Gabarit (au choix), rédigé **depuis l'utilisateur** :
-  - « En tant que [rôle dans la procédure], comment [action] dans [Système > Chemin] pour [résultat] ? »
-  - « Je dois [action] dans [Système > Chemin] : quel [champ/étiquette] renseigner pour [cas] ? »
-  - « Pour [objectif], où [créer/valider/envoyer] dans [Système > Chemin] et avec quel libellé ? »
-  - « Mon lavabo de salle de bain est bouché: l'eau s'évacue très lentement et remonte»
-
-## STYLE (strict)
-- Formuler en langage naturel, **sans aucun préfixe/label** au début.
-- Démarrer par « En tant que… », « Je dois… » ou « Pour… » (puis la question).
-
-
-# ❌ Interdictions Absolues
-- Préfixes/labels **méta** dans la question : « Section », « ÉTAPE(S) », « RÉSULTAT », « UI/PATH », « Tag », « Validation: ».
-- Questions vagues/génériques/méta (ex. “Quel système reçoit la demande ?”, “Dans quel contexte s’applique-t-elle ?”).
-- Questions n’identifiant pas clairement le **use-case** ou le **bénéficiaire**.
-
-# EXEMPLES À ÉVITER
-- « Dans quel contexte la procédure s’applique-t-elle ? »  
-- « Ce document contient-il des liens externes ? »  
-- « Combien de sections contient la procédure ? »  
-- « À quelle adresse e-mail est envoyée la notification ? » *(si le contexte métier n’est pas défini)*  
-- « Que faire si la demande est incomplète ? » *(sans préciser procédure, système, rôle, champ)*  
+- Générer des **questions ultra-spécifiques**, strictement liées au document INPUT.
+- Chaque question = **un use-case métier concret**, issu d’**une seule section** 
+- **L’objet métier mentionné dans le \`Titre:\` de la section doit apparaître explicitement dans chaque question**.
+  Titre : l’ACTION, l’OBJET métier et le BÉNÉFICIAIRE (seul 2/3 éléments sont obligatoires). 
+- Pour les logiciels, toujours partir de la fonction recherchée et du nom du logiciel pour trouver la marche à suivre. "Comment faire avec X pour Y..."
+- La question peut faire référence à des **valeurs concrètes** recherchées (montant, échéance, TVA, etc.) pour renforcer la spécificité.
+
+# DIRECTIVES SUPPLÉMENTAIRES POUR LES TABLES MARKDOWN
+- Pour une section contenant un tableau, chaque question doit viser à extraire **uniquement la valeur d’une cellule précise** : montant, condition ou date. (ces valeurs ne sont jamais mentionnées dans la question)
+- La question doit intégrer explicitement l’objet métier du \`Titre:\` de la section (le "concept central").
+- Interdiction de mentionner le tableau, ses colonnes, ou ses cellules.
+
+# LIMITES pour éviter la surcharge de questions.
+- Limite Maximum de 5 questions par section de  20 lignes 
+- Questions **courtes, naturelles, humaines**, acronymes autorisés (contraindre la formulation à ≈ 10-16 mots maximum - hard limit).
+- Chaque question concerne un seul objet métier et une seule réponse attendue sans exception.
+
+
+# STYLE (strict)
+- La question doit ressembler à ce qu’un collègue dirait oralement : simple, directe.
+- Démarrer par **« Je dois… »**, **« Comment… »** ou **« Pour… »** (forme interrogative).
+- Interdiction des formulations vagues ou a objectifs multiples : toujours nommer l'objet métier.
+- Priorité : **spécificité** → **clarté** → **brièveté** (dans cet ordre).
+
+# ❌ Interdictions absolues
+- Jamais utiliser les labels ou préfixes suivants : «Pour ce use-case», «En tant que», «Section», «Étapes», «Résultat», «UI/PATH», «Tag», «Validation».
+- Questions génériques (“Que faire si… ?” sans objet métier).
+- Questions parlant d’un autre système ou d’un cas hors procédure.
+- Formulations abstraites : “la phrase correspondante”, “le texte”, “le document” sans préciser.
+- Ne jamais mentionner "En tant que Collaborateurs..." dans la question, c'est le rôle par défaut de l'utilisateur.
+- Pas d’exemples hors métier (suppression du gabarit lavabo).
+
+# Gabarits simplifiés (optionnels)
+- « La comptabilité doit [action métier] pour [fonction métier]. »
+- « Je dois [action métier] pour [fonction métier]. »
+- « Comment [action courte] sur [document/objet métier] ? »
+- « Pour [objectif précis], où saisir [champ] dans [logiciel] ? »
+- « un client veut [objectif métier précis]. »
 
 ${options.extended}
 
-
-# OUTPUT INSTRUCTIONS
-- Tu dois produire un JSON strict avec les champs suivants:
+# OUTPUT
+- Retourner un JSON strict sans mofifier le nom du fichier :
 \`\`\`JSON
 {
   "file": "${file}",

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

@@ -17,6 +17,7 @@ export declare class Embeddings {
     private debug;
     private metadata;
     private mapping;
+    private provider;
     constructor(config: RAGConfig);
     /**
      * Extrait et sauvegarde les use cases d'un document
@@ -45,7 +46,10 @@ export declare class Embeddings {
      */
     searchKnn(vectors: number[], options?: EmbeddingsSearchOptions): RAGSearchResult;
     /**
-     * Recherche sémantique avec OpenAI
+     * Recherche sémantique avec le provider de l'embedding
+     * @param question La question à rechercher
+     * @param options Options de recherche
+     * @returns Les résultats de la recherche
      */
     semanticSearch(question: string, options?: EmbeddingsSearchOptions): Promise<RAGSearchResult>;
     /**

package/dist/src/rag/embeddings.js

@@ -10,6 +10,8 @@ const path_1 = __importDefault(require("path"));
 const types_1 = require("./types");
 const parser_1 = require("./parser");
 const utils_1 = require("../utils");
+const llm_1 = require("../llm");
+const modelconfig_1 = require("../execute/modelconfig");
 const usecase_1 = require("./usecase");
 class Embeddings {
     constructor(config) {
@@ -22,6 +24,7 @@ class Embeddings {
         this.distance = config.distance || 'cosine';
         this.inmemory = config.inmemory || false;
         this.debug = false;
+        this.provider = config.provider || 'openai';
         // Charger l'index existant si disponible et pas en mode inmemory
         if (!this.inmemory && (0, fs_1.existsSync)(this.vectorsFile)) {
             this.loadIndex();
@@ -127,14 +130,19 @@ class Embeddings {
         };
     }
     /**
-     * Recherche sémantique avec OpenAI
+     * Recherche sémantique avec le provider de l'embedding
+     * @param question La question à rechercher
+     * @param options Options de recherche
+     * @returns Les résultats de la recherche
      */
     async semanticSearch(question, options = {}) {
         const startTime = Date.now();
-        const openai = (0, utils_1.openaiInstance)();
+        const provider = this.provider;
+        const openai = (0, llm_1.llmInstance)({ provider });
+        const embeddingConfig = (0, modelconfig_1.modelConfig)("EMBEDDING-small", { provider });
         // Créer l'embedding de la question
         const embedding = await openai.embeddings.create({
-            model: 'text-embedding-3-small',
+            model: embeddingConfig.model,
             input: question,
             dimensions: this.space,
             encoding_format: 'float',
@@ -190,25 +198,31 @@ class Embeddings {
         // Sauvegarder l'ancienne config pour rollback en cas d'erreur
         const oldConfig = this.config;
         const oldVectorsFile = this.vectorsFile;
+        console.log(`\n   🔧 Embeddings.update() appelé`);
+        console.log(`      Ancien baseDir: ${oldConfig.baseDir}`);
+        console.log(`      Nouveau baseDir: ${newConfig.baseDir}`);
         try {
             // Mettre à jour la configuration
             this.config = newConfig;
             this.vectorsFile = path_1.default.join(newConfig.baseDir, types_1.RAG_FILES.VECTORS);
             this.space = newConfig.dimensions || 1536;
             this.distance = newConfig.distance || 'cosine';
+            console.log(`      Nouveau vectorsFile: ${this.vectorsFile}`);
+            console.log(`      Fichier existe: ${(0, fs_1.existsSync)(this.vectorsFile)}`);
             // Recharger l'index si ce n'est pas en mode inmemory
             if (!this.inmemory) {
                 // Vérifier que les fichiers existent
                 if (!(0, fs_1.existsSync)(this.vectorsFile)) {
                     throw new Error(`Fichier d'index manquant: ${this.vectorsFile}`);
                 }
+                console.log(`      📥 Rechargement de l'index...`);
                 // Recharger l'index
                 this.loadIndex();
+                console.log(`      📥 Rechargement des métadonnées et mapping...`);
                 // Recharger les métadonnées et le mapping
                 this.loadMetadata();
                 this.loadMapping();
-                if (this.debug)
-                    console.log(`✅ Embedding mis à jour avec nouvelle config: ${newConfig.baseDir}`);
+                console.log(`      ✅ Embedding mis à jour avec nouvelle config: ${newConfig.baseDir}`);
             }
         }
         catch (error) {
@@ -257,7 +271,9 @@ class Embeddings {
         const m = options?.m || this.config.hnswConfig?.m || 32;
         const isUpdate = options?.update || false;
         const prepare = options?.prepare || ((input) => input);
-        const openai = (0, utils_1.openaiInstance)();
+        const provider = this.provider;
+        const openai = (0, llm_1.llmInstance)({ provider });
+        const embeddingConfig = (0, modelconfig_1.modelConfig)("EMBEDDING-small", { provider });
         const vectors = {};
         const documentRefs = {};
         const documentReferences = {};
@@ -298,7 +314,7 @@ class Embeddings {
                 }
                 // Créer l'embedding de la section
                 const embedding = await openai.embeddings.create({
-                    model: "text-embedding-3-small",
+                    model: embeddingConfig.model,
                     input: prepare(section.content),
                     dimensions: this.space,
                     encoding_format: "float",

package/dist/src/rag/parser.js

@@ -34,7 +34,7 @@ function getSections(content, filename) {
     content = contentWithoutMatter || content;
     //
     // le contenu est toujours sans le front-matter!
-    const rawSections = content.split('---').map(section => section.trim());
+    const rawSections = content.split('\n---\n').map(section => section.trim());
     if (!rawSections.length) {
         return {
             filename,

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

@@ -161,6 +161,15 @@ export declare class RAGManager {
      * ```
      */
     addDocument(name: string, filename: string, content: string): void;
+    /**
+     * Marque un document comme entièrement traité (enhanced + query.json générés)
+     * Le .sha est écrit APRÈS le traitement complet pour garantir la cohérence
+     *
+     * @param name Nom du RAG
+     * @param filename Nom du fichier (ex: 'procedure.md')
+     * @param content Contenu du document traité
+     */
+    markDocumentProcessed(name: string, filename: string, content: string): void;
     /**
      * Prépare un RAG enfant en copiant les documents d'un RAG parent
      *
@@ -242,6 +251,26 @@ export declare class RAGManager {
      * ```
      */
     loadUseCases(name: string, filename: string): DocumentQueries;
+    /**
+     * Charge tous les use cases de tous les documents d'un RAG
+     *
+     * Utilise le fichier rag-metadata.json pour obtenir la liste des documents valides
+     * puis charge chaque fichier .query.json correspondant
+     *
+     * @param name Nom du RAG
+     * @returns Objet contenant tous les use cases par document
+     *
+     * @example
+     * ```typescript
+     * const allQueries = ragManager.loadAllUseCases('my-rag');
+     * console.log(`${Object.keys(allQueries.documents).length} documents avec use cases`);
+     * console.log(`${allQueries.totalQueries} questions au total`);
+     * ```
+     */
+    loadAllUseCases(name: string): {
+        documents: Record<string, DocumentQueries>;
+        totalQueries: number;
+    };
     /**
      * Construit un RAG de manière atomique
      *
@@ -274,7 +303,7 @@ export declare class RAGManager {
     /**
      * Supprime un RAG du registre
      */
-    delete(name: string, archiveFlag?: boolean): Promise<void>;
+    delete(name: string, archiveFlag?: boolean): Promise<void | Error>;
     /**
      * Renomme un document dans un RAG existant
      *
@@ -306,7 +335,8 @@ export declare class RAGManager {
      */
     private updateJSONReferences;
     /**
-     * Renomme un RAG existant
+     * Renomme un RAG existant (nom dans le registre uniquement)
+     * Le dossier physique n'est PAS modifié, seul le nom dans la config change.
      *
      * @param from Nom actuel du RAG
      * @param to Nouveau nom du RAG
@@ -316,6 +346,7 @@ export declare class RAGManager {
      * @example
      * ```typescript
      * await ragManager.rename('old-name', 'new-name', 'Description mise à jour');
+     * // Le dossier reste /path/to/old-name mais le RAG s'appelle 'new-name'
      * ```
      */
     rename(from: string, to: string, description?: string): Promise<void>;