agentic-api 2.0.31 → 2.0.491

package/dist/src/rag/tools.js

@@ -1,196 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTools = void 0;
-const fs_1 = require("fs");
-const path_1 = __importDefault(require("path"));
-const parser_1 = require("./parser");
-const embeddings_1 = require("./embeddings");
-/**
- * Prompts de suivi pour les outils
- */
-const lookupReferencesContentFollowUpPrompt = "📋 RÉFÉRENCES DISPONIBLES\n\n";
-const lookupKnowledgeFollowUpPrompt = "🔍 RECHERCHE DANS LA BASE DE CONNAISSANCES\n\n";
-/**
- * Définitions des outils pour l'agent
- */
-const toolsReferencesContent = {
-    type: "function",
-    function: {
-        name: "lookupReferencesContent",
-        description: "Récupère le contenu d'un document spécifique ou liste tous les documents disponibles, optionnellement filtrés par service.",
-        parameters: {
-            type: "object",
-            properties: {
-                service: {
-                    type: "string",
-                    description: "Nom du service optionnel (ex: 'Gérance', 'PPE', 'Comptabilité') pour filtrer les documents (insensible à la casse)."
-                },
-                source: {
-                    type: "string",
-                    description: "Identifiant source optionnel (généralement un nom de fichier sans extension) pour récupérer le contenu d'un document spécifique."
-                }
-            },
-            required: [],
-            additionalProperties: false
-        }
-    }
-};
-const toolsKnowledge = {
-    type: "function",
-    function: {
-        name: "lookupKnowledge",
-        description: "Effectue une recherche de connaissances en utilisant la recherche vectorielle basée sur la question de l'utilisateur.",
-        parameters: {
-            type: "object",
-            properties: {
-                question: {
-                    type: "string",
-                    description: "La question de l'utilisateur à rechercher."
-                },
-                justification: {
-                    type: "string",
-                    description: "Justification optionnelle pour la recherche (actuellement loggée mais non utilisée dans la logique principale)."
-                },
-                action_suivante: {
-                    type: "string",
-                    description: "Action suivante optionnelle pour instruire le LLM après traitement des résultats."
-                }
-            },
-            required: ["question"],
-            additionalProperties: false
-        }
-    }
-};
-/**
- * Extrait le header d'un fichier
- */
-function getMatterHeaderFromFile(filePath) {
-    try {
-        const content = (0, fs_1.readFileSync)(filePath, 'utf8');
-        const { sections } = (0, parser_1.getSections)(content, path_1.default.basename(filePath));
-        // Essayer d'extraire le titre de la première section
-        const firstSection = sections[0];
-        if (firstSection?.title) {
-            return { title: firstSection.title };
-        }
-        // Fallback sur le nom du fichier
-        const filename = path_1.default.basename(filePath, path_1.default.extname(filePath));
-        return { title: filename.replace(/-/g, ' ') };
-    }
-    catch (error) {
-        const filename = path_1.default.basename(filePath, path_1.default.extname(filePath));
-        return { title: filename.replace(/-/g, ' ') };
-    }
-}
-// getDocumentFromId supprimée - utilisation directe de semanticSearch
-/**
- * Crée les outils RAG pour un agent
- */
-const createTools = (openai, config) => {
-    // Utiliser l'API Embeddings existante
-    const embeddings = new embeddings_1.Embeddings(config);
-    if (!embeddings.isReady()) {
-        throw new Error(`Index RAG non disponible à ${config.baseDir}. Exécutez buildrag d'abord.`);
-    }
-    // Charger le mapping des IDs
-    const mappingFile = path_1.default.join(config.baseDir, 'rag-mapping.json');
-    let ids = {};
-    try {
-        const mappingData = (0, fs_1.readFileSync)(mappingFile, 'utf8');
-        const mapping = JSON.parse(mappingData);
-        ids = mapping.mapping;
-    }
-    catch (error) {
-        console.error('Erreur lors du chargement du mapping:', error);
-        throw new Error('Mapping RAG non disponible');
-    }
-    /**
-     * Récupère le contenu d'un document spécifique ou liste tous les documents disponibles,
-     * optionnellement filtrés par service.
-     */
-    const lookupReferencesContent = async ({ service, source }) => {
-        const documentPath = config.baseDir;
-        const ftService = service?.toLowerCase();
-        // Liste tous les fichiers markdown dans le répertoire spécifié
-        const mdfiles = (0, fs_1.readdirSync)(documentPath)
-            .filter((file) => file.endsWith('.md') &&
-            (!ftService || file.toLowerCase().includes(ftService)))
-            .map((file) => path_1.default.join(documentPath, file));
-        // Si un source spécifique a été demandé
-        if (source) {
-            source = source.replace(/\.md.*/, '');
-            const file = mdfiles.find((file) => file.includes(source));
-            if (!file) {
-                return { content: `Désolé, je n'ai pas trouvé le document "${source}".` };
-            }
-            const filename = path_1.default.basename(file);
-            const content = (0, fs_1.readFileSync)(file, 'utf8');
-            const { sections } = (0, parser_1.getSections)(content, filename);
-            if (sections.length > 0) {
-                const title = sections[0].title || filename;
-                const allContent = sections.map(s => s.content).join('\n\n');
-                const response = `${title}\n\n${allContent}\n\n[»](${filename})`;
-                return { content: response };
-            }
-            else {
-                return { content: `Le document "${source}" est vide ou mal formaté.` };
-            }
-        }
-        // Si aucun source spécifié, lister les documents (filtrés par service si applicable)
-        const serviceTitle = ftService ? ` pour le service "${service}"` : '';
-        if (!mdfiles.length) {
-            return { content: `Désolé, aucun document trouvé${serviceTitle}.` };
-        }
-        const title = `${lookupReferencesContentFollowUpPrompt}Voici la liste exhaustive des documents disponibles${serviceTitle} :\n`;
-        const content = title + mdfiles.reduce((acc, file) => {
-            const header = getMatterHeaderFromFile(file);
-            const filename = path_1.default.basename(file);
-            return acc + `- ${header.title} [»](/${filename})\n`;
-        }, '');
-        return { content };
-    };
-    /**
-     * Effectue une recherche de connaissances en utilisant la recherche vectorielle
-     */
-    const lookupKnowledge = async (args, debug = false) => {
-        console.log("lookupKnowledge", args.question);
-        try {
-            // Utiliser l'API de recherche sémantique existante
-            const result = await embeddings.semanticSearch(args.question, {
-                neighbors: 5,
-                debug
-            });
-            if (!result.results || !result.results.length) {
-                return {
-                    content: `Aucun document relatif à cette question.(⚠️ Tu dois continuer ton plan sans cette information)`
-                };
-            }
-            console.log(`--- DBG rag search: ${result.results.length} documents trouvés`);
-            if (debug) {
-                return {
-                    documents: result.results,
-                    scores: result.results.map(r => r.score)
-                };
-            }
-            const action_suivante = args.action_suivante || "";
-            const withNextAction = action_suivante ?
-                `(⚠️ A la fin de cette tâche, tu dois exécuter l'action suivante: "${action_suivante}")` : "";
-            const prefix = `${lookupKnowledgeFollowUpPrompt}Voici les sections des documents (avec les références) à analyser de manière exhaustive.${withNextAction}:\n`;
-            const response = prefix + result.results.reduce((doc, curr) => {
-                return doc + `\n---\n[${curr.content}](/${curr.ref})`;
-            }, '');
-            return { content: response };
-        }
-        catch (error) {
-            console.error('Erreur lors de la recherche:', error);
-            return {
-                content: `Erreur lors de la recherche dans la base de connaissances. (⚠️ Tu dois continuer ton plan sans cette information)`
-            };
-        }
-    };
-    return { toolsReferencesContent, toolsKnowledge, lookupReferencesContent, lookupKnowledge };
-};
-exports.createTools = createTools;

package/dist/src/rules/user.mapper.d.ts

@@ -1,61 +0,0 @@
-import { UserMSAL } from '../microsoft/profile';
-import { RuleUser } from './types';
-/**
- * Rôles disponibles pour les règles
- */
-export declare enum RuleRole {
-    READER = "reader",
-    EDITOR = "editor",
-    VALIDATOR = "validator",
-    PUBLISHER = "publisher"
-}
-/**
- * Configuration des permissions par rôle
- */
-export interface RolePermissions {
-    canRead: boolean;
-    canDelete: boolean;
-    canEdit: boolean;
-    canValidate: boolean;
-    canPublish: boolean;
-}
-/**
- * Permissions par rôle
- */
-export declare const ROLE_PERMISSIONS: Record<RuleRole, RolePermissions>;
-/**
- * Mapper pour convertir UserMSAL en RuleUser
- */
-export declare class UserRoleMapper {
-    /**
-     * Convertit un UserMSAL en RuleUser
-     * @param userMSAL L'utilisateur MSAL
-     * @param overrideRole Rôle à forcer (optionnel)
-     */
-    static toRuleUser(userMSAL: UserMSAL, overrideRole?: RuleRole): RuleUser;
-    /**
-     * Détermine le rôle d'un utilisateur basé sur ses propriétés MSAL
-     * @param userMSAL L'utilisateur MSAL
-     */
-    private static determineRoleFromMSAL;
-    /**
-     * Vérifie si un utilisateur a une permission spécifique
-     * @param userMSAL L'utilisateur MSAL
-     * @param permission La permission à vérifier
-     * @param overrideRole Rôle à forcer (optionnel)
-     */
-    static hasPermission(userMSAL: UserMSAL, permission: keyof RolePermissions, overrideRole?: RuleRole): boolean;
-    /**
-     * Obtient toutes les permissions d'un utilisateur
-     * @param userMSAL L'utilisateur MSAL
-     * @param overrideRole Rôle à forcer (optionnel)
-     */
-    static getPermissions(userMSAL: UserMSAL, overrideRole?: RuleRole): RolePermissions;
-    /**
-     * Vérifie si un utilisateur peut effectuer une action sur une branche donnée
-     * @param userMSAL L'utilisateur MSAL
-     * @param action L'action à effectuer
-     * @param branch La branche concernée
-     */
-    static canPerformAction(userMSAL: UserMSAL, action: 'read' | 'edit' | 'validate' | 'publish' | 'delete', branch: string): boolean;
-}

package/dist/src/rules/user.mapper.js

@@ -1,160 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UserRoleMapper = exports.ROLE_PERMISSIONS = exports.RuleRole = void 0;
-/**
- * Rôles disponibles pour les règles
- */
-var RuleRole;
-(function (RuleRole) {
-    RuleRole["READER"] = "reader";
-    RuleRole["EDITOR"] = "editor";
-    RuleRole["VALIDATOR"] = "validator";
-    RuleRole["PUBLISHER"] = "publisher";
-})(RuleRole || (exports.RuleRole = RuleRole = {}));
-/**
- * Permissions par rôle
- */
-exports.ROLE_PERMISSIONS = {
-    [RuleRole.READER]: {
-        canRead: true,
-        canDelete: false,
-        canEdit: false,
-        canValidate: false,
-        canPublish: false
-    },
-    [RuleRole.EDITOR]: {
-        canRead: true,
-        canDelete: true,
-        canEdit: true,
-        canValidate: false,
-        canPublish: false
-    },
-    [RuleRole.VALIDATOR]: {
-        canRead: true,
-        canDelete: true,
-        canEdit: true,
-        canValidate: true,
-        canPublish: false
-    },
-    [RuleRole.PUBLISHER]: {
-        canRead: true,
-        canDelete: true,
-        canEdit: true,
-        canValidate: true,
-        canPublish: true
-    }
-};
-/**
- * Mapper pour convertir UserMSAL en RuleUser
- */
-class UserRoleMapper {
-    /**
-     * Convertit un UserMSAL en RuleUser
-     * @param userMSAL L'utilisateur MSAL
-     * @param overrideRole Rôle à forcer (optionnel)
-     */
-    static toRuleUser(userMSAL, overrideRole) {
-        // Déterminer le rôle
-        let role = overrideRole;
-        if (!role) {
-            // Déterminer le rôle basé sur les propriétés de l'utilisateur MSAL
-            role = this.determineRoleFromMSAL(userMSAL);
-        }
-        return {
-            name: userMSAL.displayName || userMSAL.id,
-            email: userMSAL.mail || `${userMSAL.id}@placeholder.local`,
-            role: role
-        };
-    }
-    /**
-     * Détermine le rôle d'un utilisateur basé sur ses propriétés MSAL
-     * @param userMSAL L'utilisateur MSAL
-     */
-    static determineRoleFromMSAL(userMSAL) {
-        // Logique de détermination du rôle basée sur les propriétés MSAL
-        // Cette logique peut être personnalisée selon les besoins de l'organisation
-        // Par défaut, utiliser hasRole() si disponible
-        const userRole = userMSAL.role;
-        // Mapper les rôles MSAL vers les rôles de règles
-        switch (userRole?.toLowerCase()) {
-            case 'admin':
-            case 'administrator':
-            case 'director':
-            case 'publisher':
-                return RuleRole.PUBLISHER;
-            case 'manager':
-            case 'chef':
-            case 'validator':
-            case 'reviewer':
-                return RuleRole.VALIDATOR;
-            case 'editor':
-            case 'contributor':
-            case 'writer':
-                return RuleRole.EDITOR;
-            case 'reader':
-            case 'viewer':
-            case 'anonymous':
-            default:
-                return RuleRole.READER;
-        }
-    }
-    /**
-     * Vérifie si un utilisateur a une permission spécifique
-     * @param userMSAL L'utilisateur MSAL
-     * @param permission La permission à vérifier
-     * @param overrideRole Rôle à forcer (optionnel)
-     */
-    static hasPermission(userMSAL, permission, overrideRole) {
-        const ruleUser = this.toRuleUser(userMSAL, overrideRole);
-        const role = ruleUser.role || RuleRole.READER;
-        return exports.ROLE_PERMISSIONS[role][permission];
-    }
-    /**
-     * Obtient toutes les permissions d'un utilisateur
-     * @param userMSAL L'utilisateur MSAL
-     * @param overrideRole Rôle à forcer (optionnel)
-     */
-    static getPermissions(userMSAL, overrideRole) {
-        const ruleUser = this.toRuleUser(userMSAL, overrideRole);
-        const role = ruleUser.role || RuleRole.READER;
-        return exports.ROLE_PERMISSIONS[role];
-    }
-    /**
-     * Vérifie si un utilisateur peut effectuer une action sur une branche donnée
-     * @param userMSAL L'utilisateur MSAL
-     * @param action L'action à effectuer
-     * @param branch La branche concernée
-     */
-    static canPerformAction(userMSAL, action, branch) {
-        // Déterminer le rôle requis selon l'action et la branche
-        const isValidationBranch = branch.startsWith('rule-validation-');
-        const isMainBranch = branch === 'main';
-        switch (action) {
-            case 'delete':
-                return this.hasPermission(userMSAL, 'canDelete');
-            case 'read':
-                return this.hasPermission(userMSAL, 'canRead');
-            case 'edit':
-                // L'édition n'est autorisée que sur la branche d'édition
-                if (branch !== 'rule-editor' && !isValidationBranch) {
-                    return false;
-                }
-                return this.hasPermission(userMSAL, 'canEdit');
-            case 'validate':
-                // La validation n'est autorisée que sur les branches de validation
-                if (!isValidationBranch) {
-                    return false;
-                }
-                return this.hasPermission(userMSAL, 'canValidate');
-            case 'publish':
-                // La publication n'est autorisée que depuis les branches de validation vers main
-                if (!isValidationBranch) {
-                    return false;
-                }
-                return this.hasPermission(userMSAL, 'canPublish');
-            default:
-                return false;
-        }
-    }
-}
-exports.UserRoleMapper = UserRoleMapper;

package/dist/src/rules/utils/slug.d.ts

@@ -1,22 +0,0 @@
-/**
- * Utility functions for handling slugs in the rules system
- */
-/**
- * Extracts a slug from a file path
- * @param filePath The file path to extract the slug from
- * @returns The slug extracted from the file path
- */
-export declare const slugFromFile: (filePath: string, ext?: string) => string;
-/**
- * Converts a slug back to a file path
- * @param slug The slug to convert to a file path
- * @param ext The file extension to append (default: '.md')
- * @returns The file path created from the slug
- */
-export declare const fileFromSlug: (slug: string, ext?: string) => string;
-/**
- * Validates if a string is a valid slug
- * @param slug The slug to validate
- * @returns True if the slug is valid, false otherwise
- */
-export declare const isValidSlug: (slug: string) => boolean;

package/dist/src/rules/utils/slug.js

@@ -1,35 +0,0 @@
-"use strict";
-/**
- * Utility functions for handling slugs in the rules system
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidSlug = exports.fileFromSlug = exports.slugFromFile = void 0;
-const utils_1 = require("../../utils");
-/**
- * Extracts a slug from a file path
- * @param filePath The file path to extract the slug from
- * @returns The slug extracted from the file path
- */
-const slugFromFile = (filePath, ext = '.md') => {
-    return (0, utils_1.toSlug)(filePath.replace(ext, ''));
-};
-exports.slugFromFile = slugFromFile;
-/**
- * Converts a slug back to a file path
- * @param slug The slug to convert to a file path
- * @param ext The file extension to append (default: '.md')
- * @returns The file path created from the slug
- */
-const fileFromSlug = (slug, ext = '.md') => {
-    return `${slug}${ext}`;
-};
-exports.fileFromSlug = fileFromSlug;
-/**
- * Validates if a string is a valid slug
- * @param slug The slug to validate
- * @returns True if the slug is valid, false otherwise
- */
-const isValidSlug = (slug) => {
-    return /^[a-z0-9-]+$/.test(slug);
-};
-exports.isValidSlug = isValidSlug;