agentic-api 2.0.31 → 2.0.491

package/dist/src/agents/system-review.js

@@ -1,181 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.systemReview = exports.systemReviewPrompt = void 0;
-const execute_1 = require("../execute");
-const utils_1 = require("../utils");
-const promptMarkdown = `# 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 (sujet, relation, objet) avec un minimum de questions (maximum 4).
-- Toutes les questions que tu vas créer concernent précisément le INPUT fournit ci-dessous. 
-- Pour orienter la formulation des questions, je te fournis quelques exemples de questions réelles.
-- Chaque question doit satisfaire ces critères: clairement identifier le problème à résoudre ou l'action souhaitée dans un domaine précis, doit être spécifique et ne peut pas être ambiguë.
-- 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 à 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 la procédure précisément.
-
-
-# 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:
-`;
-//
-// 1. role & identity
-// 2. scope
-// 3. logic (toute directive doit correspondre à une logique conditionnelle claire)
-// 4. ambiguity (La directive doit déboucher sur une action ou une absence d’action, sans zone grise)
-// 5. Interdiction
-// 6. output (L’agent sait-il comment formuler sa réponse)
-// 😩 Il lit la demande de haïku, voit qu’il doit "appeler un agent spécialisé" et pense que ce n’est pas lui.
-exports.systemReviewPrompt = `
-# PROMPT D’ANALYSE — Audit de directives LLM d'un prompt système
-
-## RÔLE :
-Assume le rôle d’un expert spécialisé dans l’analyse, la formalisation et l’évaluation des directives d’un prompt système d’un Agent LLM.
-On te donnera des problèmes difficiles à résoudre, qui nécessiteront plusieurs techniques principales pour les résoudre, comme l'analyse statistique, la logique, ainsi que certaines techniques métacognitives que tu pourras employer.
-
-## MISSION :
-L'utilisateur a créé un prompt système qui contient une liste de directives (instructions) pour un Agent LLM spécialisé.  
-Tu dois en avoir une connaissance exhaustive et approfondie, les lire ligne par ligne et les garder en mémoire.
-
-Ta mission est de les évaluer individuellement selon les 9 critères mentionnés ci-dessous.  
-Tu dois juger leur pertinence, leur clarté, leur alignement avec le rôle de l’agent, et leur contribution à l’objectif global.
-
-## TÂCHES :
-Tu dois avoir une connaissance exhaustive et approfondie de toutes les directives :
-  - Une directive est décrite avec des phrases sur une ligne.
-  - Tu dois suivre la structure qui organise les directives par sections pour résoudre un objectif précis de l'agent.  
-  - Dans Tu dois évaluer chaque directive individuellement selon les 9 critères ci-dessous.
-  - Tu dois comparer la directive au rôle global de l’agent et de la section pour détecter sa complémentarité et son écart.
-  - Tu dois extraire le chevauchement ou les incohérences par rapport aux autres directives.
-  - Tu dois identifier les cas de redondance et d'indécisions que cela peut créer.
-  - Tu dois produire et conserver en mémoire un schéma du "graph" complet de chaque directive et des critères d'évaluation dont le score est inférieur à 0.9.
-
-## CHAÎNE DE RAISONNEMENT (CoT) :
-
-Tu dois appliquer une démarche par raisonnement étape par étape :
-- Encadre ton raisonnement dans une balise \`<thinking>...</thinking>\`.
-- Utilise des balises \`<step>\` pour chaque étape de réflexion.
-- Reste succinct dans les étapes.
-- Ajuste ton raisonnement si tu détectes une incohérence ou un doute.
-
-
-## CRITÈRES D’ANALYSE
-
-1. **Identité** : La directive reflète-t-elle le rôle de la section actuelle ?
-2. **Périmètre** : Complète-t-elle clairement le domaine de la section actuelle, est-elle utile ?
-3. **Décision** : Y a-t-il une condition explicite du type “SI… ALORS…”, si oui est-elle correctement formulée ?
-4. **Exécution** : L’agent peut-il agir sans hésitation (une autre directive peut-elle contredire la directive en cours) ?
-5. **Interdiction** : Empêche-t-elle les comportements vagues, hors sujet ou parasites ?
-7. **Robustesse** : Faut-il prévoir des cas limites ?
-8. **Redondance (ou contradiction)** : Y a-t-il une redondance ou une contradiction avec une autre directive qui pourrait créer un biais d'interprétation ?
-9. **Simplification** : Pourrait-elle être reformulée sans perte ?
-
-
-## OUTPUT ATTENDU
-- Tu dois produire un **Rapport exhaustif de toutes les directives avec leurs critères**, les scores et les commentaires 
-- ATTENTION seuls les critères avec un scores <= 0.9 intéressent l'utilisateur et doivent être affichées.
-
-`;
-const systemReviewStructurePrompt = `
-## 🔍 ANALYSE STRUCTURELLE (multi-directive)
-
-Après l’analyse individuelle, tu dois effectuer une lecture croisée pour détecter :
-
-1. **Branches Décisionnelles implicites ou explicites**  
-   - Existe-t-il des directives contenant des conditions ?  
-   - Sont-elles formulées de manière claire et non ambiguë ?  
-   - Manque-t-il des transitions, cas d’erreur, ou cas particuliers ?
-
-2. **Unknown Decision Branches**  
-   - Génère des branches hypothétiques en cas de flou (par ex. : "Que se passe-t-il si l’utilisateur demande X alors que ce n’est pas prévu ?").
-
-3. **Pruning des Chemins Invalides**  
-   - Supprime les branches logiques incohérentes ou contradictoires.  
-   - Signale les directives qui se contredisent ou génèrent des conflits de rôle ou de style.
-
-4. **Cartographie des Risques**
-   - Identifie les zones de vulnérabilité : extrapolation, sur-interprétation, sortie non contrôlée.
-   - Classe-les par niveau de risque (Faible / Moyen / Élevé).
-
----
-## OUTPUT ATTENDU
-1. **Rapport de l’analyse globale** avec l'estimation du taux de couverture des directives par rapport à la mission.
-2. **Rapport exhaustif par directive et par critère**, au format expliqué ci-dessous (ATTENTION seuls les scores <= 0.9 intéressent l'utilisateur et sont affichés avec un commentaire).
-3. **Synthèse de l’analyse structurelle**, sous forme de carte des décisions, branches floues, recommandations, la liste chemins avec leur probabilité d'entrer en jeu, et le mermaid flowchart.
-
-
-## EXEMPLE DE RAPPORT
-### Directive N : *“[titre de la directive]”*
-
-- **[critère 1]** : [score] *[commentaire]*  
-- ...
-
-## Analyse structurelle
-...
-
- `;
-exports.systemReview = {
-    name: "systemReview",
-    human: true,
-    model: (0, execute_1.modelConfig)("MEDIUM"),
-    publicDescription: "Agent chargé d'analyser le contenu d'un prompt système et de présenter ses remarques",
-    instructions: exports.systemReviewPrompt,
-    tools: [],
-    downstreamAgents: [],
-};
-//instructions: [systemReviewPrompt, systemReviewStructurePrompt],
-//
-// go back to systemReview once the task is done
-// add the transfer tool to point to downstreamAgents
-const agents = (0, utils_1.injectTransferTools)([exports.systemReview]);
-exports.default = agents;

package/dist/src/agents/systemReview.d.ts

@@ -1,4 +0,0 @@
-import { AgentConfig } from "../types";
-export declare const systemReview: AgentConfig;
-declare const agents: AgentConfig[];
-export default agents;

package/dist/src/agents/systemReview.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.systemReview = void 0;
-const execute_1 = require("../execute");
-const utils_1 = require("../utils");
-const prompts_1 = require("./prompts");
-exports.systemReview = {
-    name: "systemReview",
-    human: true,
-    model: (0, execute_1.modelConfig)("MEDIUM"),
-    publicDescription: "Agent chargé d'analyser le contenu d'un prompt système et de présenter ses remarques",
-    instructions: prompts_1.systemReviewPrompt,
-    maxSteps: 3,
-    tools: [],
-    downstreamAgents: [],
-};
-//instructions: [systemReviewPrompt, systemReviewStructurePrompt],
-//
-// go back to systemReview once the task is done
-// add the transfer tool to point to downstreamAgents
-const agents = (0, utils_1.injectTransferTools)([exports.systemReview]);
-exports.default = agents;

package/dist/src/execute.d.ts

@@ -1,49 +0,0 @@
-import { AgentConfig, AgenticContext, AgentModel, ExecuteAgentResult, Feedback, ExecutionResult } from "./types";
-import { Writable } from "stream";
-import { AgentStateGraph } from "./stategraph";
-export declare function modelConfig(model: string, custom?: any): AgentModel;
-export declare function sendFeedback(params: Feedback): void;
-export interface ReadCompletionsStreamOptions {
-    stateGraph: AgentStateGraph;
-    discussion: any;
-    agentConfig: AgentConfig;
-    agents: AgentConfig[];
-    agentName: string;
-    stdout: Writable;
-    session: AgenticContext;
-    final: any;
-    verbose?: boolean;
-    enrichWithMemory?: (role: string, agent: AgentConfig, context: AgenticContext) => Promise<string>;
-}
-export declare function readCompletionsStream(params: ReadCompletionsStreamOptions): Promise<ExecutionResult>;
-/**
- * Parameters for executing an agent set
- * @interface ExecuteAgentSetParams
- * @property {OpenAI} openai - OpenAI client instance
- * @property {string} query - User query to process
- * @property {string} home - Name of the agent to start with
- * @property {Writable} stdout - Stream to write output to
- * @property {boolean} [verbose] - Whether to log verbose debug information
- * @property {number} [maxSteps] - Maximum number of steps to execute
- */
-export interface ExecuteAgentSetParams {
-    enrichWithMemory?: (role: string, agent: AgentConfig, context: AgenticContext) => Promise<string>;
-    query: string;
-    home?: string;
-    stdout: Writable;
-    verbose?: boolean;
-    debug?: boolean;
-}
-/**
- * Executes a set of agents to process a user query
- *
- * This function initializes the agent memory, processes the user query through the appropriate
- * agent, and handles any agent transfers or tool calls that occur during execution.
- *
- * @param {AgentConfig[]} agentSet - Array of agent configurations
- * @param {AgenticContext} session - {memory, user, ...}  - Session object to store/read conversation state
- * @param {ExecuteAgentSetParams} params - Execution parameters
- * @returns {Promise<void>}
- */
-export declare function executeAgentSet(agentSet: AgentConfig[], context: AgenticContext, params: ExecuteAgentSetParams): Promise<ExecutionResult>;
-export declare function executeAgent(agentSet: AgentConfig[], params: ExecuteAgentSetParams): Promise<ExecuteAgentResult>;