agentic-api 2.0.31 → 2.0.491

package/dist/src/execute/shared.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DummyWritable = void 0;
+exports.sendFeedback = sendFeedback;
+exports.normalizeOptionsForResponses = normalizeOptionsForResponses;
+exports.normalizedFunctionCallFromResponse = normalizedFunctionCallFromResponse;
+exports.normalizeOutputFromResponses = normalizeOutputFromResponses;
+exports.convertMessagesToResponsesInput = convertMessagesToResponsesInput;
+//
+// Writable vide pour les tests
+exports.DummyWritable = {
+    write: () => { }
+};
+//
+// Envoi de feedback temps réel vers l'UX
+// Informe l'utilisateur de l'état de l'analyse : agent actif, description, usage, state
+function sendFeedback(params) {
+    const { agent, stdout, description, usage, state, verbose } = params;
+    const feedback = {
+        agent,
+        description,
+        usage,
+        state
+    };
+    // if(verbose) {
+    //   console.log('--- DBG sendFeedback:',agent, description || '--', state);
+    // }
+    //
+    // send agent state and description
+    stdout.write(`\n<step>${JSON.stringify(feedback)}</step>\n`);
+}
+/**
+ * Normalise les options pour l'API Responses
+ *
+ * Transforme les paramètres du format Chat Completions vers Responses API:
+ * - Tools: { type: "function", function: {...} } → { type: "function", name, description, parameters, strict }
+ * - Autres transformations futures si nécessaire
+ *
+ * @param options - Options à normaliser
+ * @returns Options normalisées pour Responses API
+ */
+function normalizeOptionsForResponses(options) {
+    const normalized = { ...options };
+    // Transformer les tools au format Responses API
+    if (normalized.tools && normalized.tools.length > 0) {
+        normalized.tools = normalized.tools.map((tool) => {
+            if (tool.type === 'function' && tool.function) {
+                // Format Chat Completions → Responses API
+                return {
+                    type: 'function',
+                    name: tool.function.name,
+                    description: tool.function.description,
+                    parameters: tool.function.parameters,
+                    strict: tool.function.strict ?? true
+                };
+            }
+            // Déjà au bon format ou type différent
+            return tool;
+        });
+    }
+    return normalized;
+}
+/**
+ * Normalise un function call du format Responses vers Chat Completions
+ *
+ * Responses API: { type: "function_call", name, arguments, call_id }
+ * Chat Completions: { id, type: "function", function: { name, arguments } }
+ *
+ * Si déjà au format Chat Completions (avec .function), retourne tel quel
+ *
+ * @param functionCall - Function call au format Responses ou Chat Completions
+ * @returns Function call au format Chat Completions
+ */
+function normalizedFunctionCallFromResponse(functionCall) {
+    // Si déjà au format Chat Completions, retourner tel quel
+    if (functionCall.function) {
+        return functionCall;
+    }
+    // Transformer du format Responses vers Chat Completions
+    return {
+        id: functionCall.call_id,
+        type: "function",
+        function: {
+            name: functionCall.name,
+            arguments: functionCall.arguments
+        }
+    };
+}
+/**
+ * Normalise l'output de l'API Responses vers le format Chat Completions
+ *
+ * Transforme la structure Responses API vers le format attendu par le reste du code
+ *
+ * Format Responses API (result.output array):
+ * - { type: "reasoning", summary: [] }
+ * - { type: "message", content: [{ type: "output_text", text: "..." }] }
+ * - { type: "function_call", name, arguments, call_id }
+ *
+ * Format Chat Completions compatible:
+ * - { choices: [{ message: { content, tool_calls, reasoning_text } }], usage: {...}, id: "..." }
+ *
+ * @param result - Résultat de stream.finalResponse()
+ * @returns Résultat au format Chat Completions avec reasoning_text si présent
+ */
+function normalizeOutputFromResponses(result) {
+    let text = '';
+    let reasoningText = ''; // ✅ Capturer reasoning_text pour modèles reasoning (o-series, gpt-5)
+    const functionCalls = [];
+    // Parcourir les output items pour extraire text, reasoning et function_calls
+    if (result.output && Array.isArray(result.output)) {
+        for (const item of result.output) {
+            // Function calls sont directement dans output
+            if (item.type === 'function_call') {
+                functionCalls.push(item);
+            }
+            // ✅ Capturer reasoning (v5.22.0)
+            else if (item.type === 'reasoning' && item.summary) {
+                reasoningText = Array.isArray(item.summary) ? item.summary.join('\n') : String(item.summary);
+            }
+            // Messages contiennent le texte
+            else if (item.type === 'message' && item.content) {
+                for (const content of item.content) {
+                    if (content.type === 'output_text' && content.text) {
+                        text += content.text;
+                    }
+                }
+            }
+        }
+    }
+    // Transformer tous les function_calls vers le format Chat Completions
+    const toolCalls = functionCalls.map(normalizedFunctionCallFromResponse);
+    // Retourner au format Chat Completions avec reasoning_text optionnel
+    return {
+        choices: [{
+                message: {
+                    tool_calls: toolCalls,
+                    content: text,
+                    reasoning_text: reasoningText || undefined // ✅ Optionnel, seulement si présent
+                }
+            }],
+        usage: {
+            prompt_tokens: result.usage?.input_tokens || 0,
+            completion_tokens: result.usage?.output_tokens || 0,
+            total_tokens: (result.usage?.input_tokens || 0) + (result.usage?.output_tokens || 0)
+        },
+        id: result.id
+    };
+}
+/**
+ * Convertit les messages du stateGraph vers le format Responses API input
+ * Gère les messages normaux, tool_calls (Chat Completions), et function_call_output (Responses)
+ *
+ * Utilisée par:
+ * - readCompletionsStream (responses.ts) pour le follow-up après tool calls
+ * - executeAgentSet (responses.ts) pour préparer l'input initial
+ *
+ * @param messages Messages du stateGraph
+ * @returns Array d'items au format Responses API input
+ */
+function convertMessagesToResponsesInput(messages) {
+    return messages.flatMap((m) => {
+        // ✅ Messages function_call_output ont un format différent (pas de role)
+        if (m.type === 'function_call_output') {
+            return [{ type: m.type, call_id: m.call_id, output: m.output }];
+        }
+        // ✅ Messages avec tool_calls → convertir vers le format Responses API
+        // Documentation: "input_list += response.output" ajoute reasoning + function_calls
+        if (m.tool_calls && m.tool_calls.length > 0) {
+            const result = [];
+            // Ajouter le message assistant si content présent
+            if (m.content) {
+                result.push({ role: m.role, content: m.content });
+            }
+            // Convertir chaque tool_call (Chat Completions) en function_call (Responses)
+            for (const tc of m.tool_calls) {
+                result.push({
+                    type: "function_call",
+                    call_id: tc.id,
+                    name: tc.function.name,
+                    arguments: tc.function.arguments
+                });
+            }
+            return result;
+        }
+        // Messages normaux avec role
+        return [{ role: m.role, content: m.content }];
+    });
+}

package/dist/src/index.d.ts

@@ -6,7 +6,7 @@ export * from './utils';
 export * from './types';
 export * from './stategraph';
 export * from './execute';
-export * from './princing.openai';
+export * from './pricing.llm';
 export * from './scrapper';
 export * from './agents/reducer';
 export * from './agents/semantic';

package/dist/src/index.js

@@ -24,9 +24,9 @@ __exportStar(require("./utils"), exports);
 __exportStar(require("./types"), exports);
 // StateGraph - nouvelle architecture de gestion des discussions
 __exportStar(require("./stategraph"), exports);
-// Execute
+// Execute (avec feature toggle legacy/responses)
 __exportStar(require("./execute"), exports);
-__exportStar(require("./princing.openai"), exports);
+__exportStar(require("./pricing.llm"), exports);
 // Scrapper
 __exportStar(require("./scrapper"), exports);
 // Agents

package/dist/src/{princing.openai.d.ts → pricing.llm.d.ts}

@@ -8,4 +8,10 @@ type ModelPricing = {
 export declare const modelPricing: Record<string, ModelPricing>;
 export declare function calculateCost(model: string, usage?: CompletionUsage): number;
 export declare function accumulateCost(currentUsage: Usage, model: string, usage?: CompletionUsage): number;
+export declare function LLM(openai: any, forceThinking?: boolean): any;
+export declare const LLMxai: any;
+/**
+ * Get model mapping for OpenAI
+ */
+export declare const LLMopenai: any;
 export {};

package/dist/src/pricing.llm.js

@@ -0,0 +1,255 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMopenai = exports.LLMxai = exports.modelPricing = void 0;
+exports.calculateCost = calculateCost;
+exports.accumulateCost = accumulateCost;
+exports.LLM = LLM;
+//
+// get/update pricing from openai
+// - https://platform.openai.com/docs/pricing#latest-models
+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 },
+    "gpt-4.1-nano": { input: 0.0000001, cachedInput: 0.000000025, output: 0.0000004 },
+    "gpt-4o": { input: 0.0000025, cachedInput: 0.00000125, output: 0.00001 },
+    "gpt-4o-audio-preview": { input: 0.0000025, output: 0.00001 },
+    "gpt-4o-realtime-preview": { input: 0.000005, cachedInput: 0.0000025, output: 0.00002 },
+    "gpt-4o-search-preview": { input: 0.000005, cachedInput: 0.0000025, output: 0.00002 },
+    "gpt-4o-mini": { input: 0.00000015, cachedInput: 0.000000075, output: 0.0000006 },
+    "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.1": { input: 0.00000125, output: 0.00001 },
+    "gpt-5-mini": { input: 0.00000025, output: 0.000002 },
+    "gpt-5-nano": { input: 0.00000005, output: 0.0000004 },
+    "o1": { input: 0.000015, cachedInput: 0.0000075, output: 0.00006 },
+    "o4-mini": { input: 0.0000011, cachedInput: 0.00000055, output: 0.0000044 },
+    "o3-mini": { input: 0.0000011, cachedInput: 0.00000055, output: 0.0000044 },
+    "o1-mini": { input: 0.0000011, cachedInput: 0.00000055, output: 0.0000044 },
+    // Grok 4 family - Official pricing from xAI docs (per million tokens)
+    "grok-4-fast-reasoning": { input: 0.0002, cachedInput: 0.0001, output: 0.0005 },
+    "grok-4-fast-non-reasoning": { input: 0.0002, cachedInput: 0.0001, output: 0.0005 },
+    "grok-4-0709": { input: 0.003, cachedInput: 0.0015, output: 0.015 },
+    "grok-code-fast-1": { input: 0.0002, cachedInput: 0.0001, output: 0.0015 },
+};
+function calculateCost(model, usage) {
+    if (!usage) {
+        return 0;
+    }
+    if (!exports.modelPricing[model]) {
+        throw new Error("Unknown 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(currentUsage, model, usage) {
+    if (!usage) {
+        return 0;
+    }
+    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;
+}
+//
+// depending on the API source, return the correct mapping between ALIAS and destination models and options.
+// - LOW-fast: openai => gpt-5-nano, xAI => grok-4-nano
+// - etc.
+function LLM(openai, forceThinking) {
+    //
+    // Detect provider based on baseURL  
+    const mapping = openai?.baseURL ? LLMmapping[openai?.baseURL] : LLMmapping["default"];
+    // FIXME: this is a temporary solution to force reasoning effort to high if thinking is enabled
+    if (mapping.reasoning_effort && forceThinking) {
+        mapping.reasoning_effort = "high";
+    }
+    return mapping;
+}
+exports.LLMxai = {
+    "LOW-fast": {
+        temperature: 0.2,
+        model: "grok-code-fast-1", // Fast code model, good for low-complexity tasks
+        stream: true
+    },
+    "LOW": {
+        temperature: 0.2,
+        model: "grok-4-fast-non-reasoning", // Fast non-reasoning model
+        stream: true
+    },
+    "LOW-medium": {
+        temperature: 0.2,
+        model: "grok-4-fast-non-reasoning", // Fast non-reasoning model
+        stream: true
+    },
+    "MEDIUM-fast": {
+        temperature: 0.2,
+        model: "grok-4-fast-reasoning", // Fast reasoning model
+        stream: true
+    },
+    "MEDIUM": {
+        temperature: 0.2,
+        model: "grok-4-fast-reasoning", // Fast reasoning model
+        stream: true
+    },
+    "HIGH-fast": {
+        model: "grok-4-fast-reasoning",
+        temperature: 0.2,
+        stream: true
+    },
+    "HIGH-low": {
+        model: "grok-4-0709", // Most capable Grok-4 model
+        temperature: 0.2,
+        stream: true
+    },
+    "HIGH-medium": {
+        model: "grok-4-0709", // Most capable Grok-4 model
+        temperature: 0.2,
+        stream: true
+    },
+    "SEARCH-fast": {
+        temperature: 0.2,
+        model: "grok-code-fast-1",
+        web_search_options: {
+            user_location: {
+                type: "approximate",
+                approximate: {
+                    country: "CH",
+                    city: "Geneva",
+                    region: "Geneva",
+                },
+            },
+        },
+    },
+    "SEARCH": {
+        temperature: 0.2,
+        model: "grok-4-fast-non-reasoning",
+        web_search_options: {
+            user_location: {
+                type: "approximate",
+                approximate: {
+                    country: "CH",
+                    city: "Geneva",
+                    region: "Geneva",
+                },
+            },
+        },
+    },
+};
+/**
+ * Get model mapping for OpenAI
+ */
+exports.LLMopenai = {
+    "LOW-fast": {
+        temperature: 1,
+        frequency_penalty: 0.0,
+        presence_penalty: 0.0,
+        model: "gpt-5-nano",
+        reasoning_effort: "minimal",
+        verbosity: "low",
+        stream: true
+    },
+    "LOW": {
+        temperature: 1,
+        frequency_penalty: 0.0,
+        presence_penalty: 0.0,
+        model: "gpt-5-nano",
+        reasoning_effort: "low",
+        verbosity: "low",
+        stream: true
+    },
+    "LOW-medium": {
+        temperature: 1,
+        frequency_penalty: 0.0,
+        presence_penalty: 0.0,
+        model: "gpt-5-nano",
+        reasoning_effort: "medium",
+        verbosity: "low",
+        stream: true
+    },
+    "LOW-4fast": {
+        temperature: .2,
+        frequency_penalty: 0.0,
+        presence_penalty: 0.0,
+        model: "gpt-4.1-nano",
+        stream: true
+    },
+    "MEDIUM-4.1-mini": {
+        temperature: .2,
+        frequency_penalty: 0.0,
+        presence_penalty: 0.0,
+        model: "gpt-4.1-mini",
+        stream: true
+    },
+    "MEDIUM-4.1": {
+        temperature: .2,
+        frequency_penalty: 0.0,
+        presence_penalty: 0.0,
+        model: "gpt-4.1",
+        stream: true
+    },
+    "MEDIUM-fast": {
+        temperature: 1,
+        frequency_penalty: 0.0,
+        presence_penalty: 0.0,
+        model: "gpt-5-mini",
+        reasoning_effort: "minimal",
+        verbosity: "low",
+        stream: true
+    },
+    "MEDIUM": {
+        temperature: 1,
+        frequency_penalty: 0.0,
+        presence_penalty: 0.0,
+        model: "gpt-5-mini",
+        reasoning_effort: "low",
+        verbosity: "low",
+        stream: true
+    },
+    "HIGH-fast": {
+        model: "gpt-5.1",
+        reasoning_effort: "none",
+        verbosity: "low",
+        temperature: 1,
+        stream: true
+    },
+    "HIGH": {
+        model: "gpt-5.1",
+        reasoning_effort: "low",
+        verbosity: "low",
+        stream: true
+    },
+    "HIGH-medium": {
+        model: "gpt-5",
+        reasoning_effort: "medium",
+        verbosity: "low",
+        stream: true
+    },
+    "SEARCH": {
+        model: "gpt-5-mini",
+        reasoning: { effort: "low" },
+        tools: [
+            {
+                type: "web_search_preview",
+                user_location: {
+                    type: "approximate",
+                    country: "CH",
+                    city: "Geneva",
+                    region: "Geneva",
+                },
+            }
+        ],
+    },
+};
+const LLMmapping = {
+    "https://api.x.ai/v1": exports.LLMxai,
+    "https://api.openai.com/v1": exports.LLMopenai,
+    "default": exports.LLMopenai
+};

package/dist/src/prompts.d.ts

@@ -1,6 +1,15 @@
-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 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  \n  Available 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).\n\n\u26A0\uFE0F Rules:\n- NEVER call this function for requests that match your own specialization (\"__AGENT_NAME__\").\n\n\nAvailable Agents:";
+export declare const transferAgentPrompt = "Transfer control to the agent \"__AGENT_NAME__\".\nThis agent is described as: \"__AGENT_DESCRIPTION__\".\nUse this tool (handoff) when that agent is better suited to handle the user's request.\n\n\nAvailable Agents:";
+export declare const transferAgentPromptStructured = "\nCet outil permet de transf\u00E9rer le contr\u00F4le vers un agent sp\u00E9cialis\u00E9 lorsque la demande de l'utilisateur d\u00E9passe le p\u00E9rim\u00E8tre de \"__AGENT_NAME__\".\n\n**QUAND UTILISER :**\n- Si l'Agent d\u00E9termine que le transfert est n\u00E9cessaire (confidence >= 0.7) il doit appeler cet outil.\n- L'utilisateur demande explicitement un service hors de votre sp\u00E9cialisation\n- La requ\u00EAte n\u00E9cessite des outils ou connaissances sp\u00E9cifiques \u00E0 un autre agent\n- Vous identifiez qu'un agent sp\u00E9cialis\u00E9 (disponible ci-dessous) est mieux adapt\u00E9 pour r\u00E9pondre\n\n**QUAND NE PAS UTILISER :**\n- Votre niveau de confiance (confidence) est inf\u00E9rieur \u00E0 0.7\n\nIl prend les arguments suivants :\n- rationale_for_transfer (string) : La justification pr\u00E9cise expliquant en moins de 10 mots pourquoi ce transfert est n\u00E9cessaire\n- conversation_context (string) : Le contexte pertinent de la conversation qui aidera l'agent destinataire \u00E0 effectuer l'action correcte\n- destination_agent (string) : Le nom de l'agent sp\u00E9cialis\u00E9 qui doit traiter la demande (valeurs possibles list\u00E9es ci-dessous)\n- confidence (number) : Votre niveau de confiance (0.0 \u00E0 1.0) que le transfert vers un agent plus appropri\u00E9 est n\u00E9cessaire. Minimum requis : 0.7\n\nAvailable Agents:";
+export declare const transferAgentPromptHandoff = "# Contexte g\u00E9n\u00E9ral\nTu fais partie d'un syst\u00E8me multi-agents con\u00E7u pour faciliter la coordination et l'ex\u00E9cution entre plusieurs agents. Tu utilises deux abstractions principales : **Agents** et **Transferts**. \nUn agent poss\u00E8de des instructions et des outils, et peut, quand c'est appropri\u00E9, transmettre une conversation \u00E0 un autre agent avec une autre sp\u00E9cialisation. Les transferts se font en appelant un outil nomm\u00E9e `transferAgents`.\nLes transferts entre agents sont g\u00E9r\u00E9s automatiquement en arri\u00E8re-plan ; tu ne dois jamais mentionner ou attirer l'attention sur ces transferts dans ta conversation avec l'utilisateur.\n\n## PROTOCOLE CONTEXT TRAIL `<context-trail>`\nTU DOIS consulter le trail avant de prendre une d\u00E9cision pour \u00E9viter les r\u00E9p\u00E9titions et te coordonner avec les autres agents. Le trail est visible pour toi dans tes instructions syst\u00E8me pour:\n- D\u00E9tecter les boucles et ne pas les reproduire (action d\u00E9j\u00E0 faite \u2192 surtout ne pas r\u00E9p\u00E9ter)\n- Comprendre les \u00E9tapes et ce qui reste\n- Pr\u00E9vention du drift (maintenir l'alignement \u00E0 l'objectif)\n\n";
 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:\" 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;
+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**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-matter 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 doivent \u00EAtre d\u00E9tect\u00E9s et normalis\u00E9s selon les \u201CR\u00E8gles de TABLE Markdown\u201D ci-dessous (pas de copie brute ligne par ligne).**\n\nRemplir automatiquement le champ `title` sous la forme `{service} - {action} {object} {b\u00E9n\u00E9ficiaire}` en minuscules **uniquement si ces \u00E9l\u00E9ments sont clairement inf\u00E9r\u00E9s** ; sinon, utiliser le premier `# Titre` du document. Ne jamais \u00E9crire \u201Cunknown\u201D dans `title`.\n\n---\n\n### Heuristique de structuration\n1. **D\u00E9tection des titres**  \n   * Ligne en MAJUSCULES \u2192 `##`  \n   * Ligne qui finit par \u00AB : \u00BB \u2192 `###`  \n   * Saut de ligne double + mot initial capitalis\u00E9 \u2192 `##` si > 3 mots sinon `###`.\n2. **Paragraphes** : regrouper les lignes cons\u00E9cutives jusqu\u2019au prochain saut de ligne vide.\n3. **Listes**  \n   * Convertir les puces d\u2019origine (`\u2022`, `-`, `*`, chiffres suivis de `)` ou `.`).  \n   * Conserver l\u2019imbrication (quatre espaces par niveau).\n\n---\n\n### R\u00E8gles de TABLE Markdown (g\u00E9n\u00E9riques, robustes)\n1. **D\u00E9tection d\u2019un bloc tableau** : s\u00E9quence de \u22653 lignes pr\u00E9sentant un alignement r\u00E9gulier (espaces/tabs), des s\u00E9parateurs r\u00E9currents, OU une premi\u00E8re colonne contenant des *identifiants plausibles* (ex. codes, IDs, sigles).  \n2. **Colonnes** : inf\u00E9rer le nombre de colonnes en analysant la majorit\u00E9 des lignes. Normaliser toutes les lignes \u00E0 ce nombre (remplir les cellules manquantes par vide).  \n3. **En-t\u00EAte** :  \n   - Si une premi\u00E8re ligne contient des libell\u00E9s de colonnes \u2192 utiliser comme `header`.  \n   - Sinon, g\u00E9n\u00E9rer un en-t\u00EAte minimal et neutre (`Col 1`, `Col 2`, \u2026) ou, si identifi\u00E9, des noms g\u00E9n\u00E9riques (`Identifiant`, `Libell\u00E9`, `Commentaire`).  \n4. **Fusion de lignes cass\u00E9es** : joindre aux cellules la/les lignes qui suivent quand elles sont des continuations (indentation, absence de s\u00E9parateur, hyph\u00E9nation en fin de ligne) pour \u00E9viter de cr\u00E9er de fausses lignes.  \n5. **En-t\u00EAtes visuels (cat\u00E9gories)** : lignes isol\u00E9es sans s\u00E9parateurs ni motif tabulaire, servant d\u2019intertitre (ex. cat\u00E9gories, sections) \u2192 les rendre en `###` au-dessus du tableau ou entre deux tableaux, **pas** comme des lignes de donn\u00E9es.  \n6. **Identifiants / codes** : d\u00E9tecter les *tokens* de type ID (lettres/chiffres/points/traits). Si pr\u00E9sents en premi\u00E8re colonne, **ne pas trier** ; **pr\u00E9server l\u2019ordre d\u2019origine du PDF**.  \n7. **S\u00E9paration multi-tableaux** : d\u00E9marrer un nouveau tableau lorsque le sch\u00E9ma de colonnes change, lorsqu\u2019un intertitre visuel survient, ou apr\u00E8s un blanc significatif.  \n8. **Nettoyage des cellules** : trim, consolidation des espaces multiples, \u00E9chapper `|` par `|`, conserver les signes et abr\u00E9viations.  \n9. **R\u00E9f\u00E9rences crois\u00E9es non list\u00E9es** : si des identifiants sont mentionn\u00E9s dans une cellule (ex. \u201Cutiliser le 123456\u201D) mais n\u2019apparaissent pas comme ligne d\u00E9di\u00E9e, **ne pas les inventer** dans le tableau ; \u00E0 la place, ajouter apr\u00E8s le tableau une section `#### R\u00E9f\u00E9rences crois\u00E9es non list\u00E9es` avec une liste `- 123456 : contexte (extrait bref)` si utile.  \n10. **Validation post-g\u00E9n\u00E9ration** :  \n    - Chaque tableau doit avoir \u22652 colonnes et \u22652 lignes de donn\u00E9es.  \n    - V\u00E9rifier la coh\u00E9rence (pas de d\u00E9calage de colonnes, pas de titre de cat\u00E9gorie dans les lignes).  \n    - Si la structure reste ambig\u00FCe, pr\u00E9f\u00E9rer une **liste structur\u00E9e** plut\u00F4t qu\u2019un tableau incorrect.\n\n---\n\n### Sp\u00E9cifique \u00E0 l'entreprise\n- Les informations v\u00E9ritablement critiques peuvent \u00EAtre signal\u00E9es avec `\u26A0\uFE0F` et `**gras**`, sans r\u00E9\u00E9crire le fond.  \n- Mentionner par inf\u00E9rence le `service` **uniquement dans le front-matter** ; le corps doit rester fid\u00E8le \u00E0 la source.  \n- Ne pas promouvoir des intertitres visuels en alertes `\u26A0\uFE0F`.\n\n---\n\n### \u00C9l\u00E9ments hors-texte\n- **Images** : `![Img page-X-Y](IMAGE_PLACEHOLDER_X_Y)` (une ligne par image, \u00E0 l\u2019emplacement d\u2019origine).  \n- **Notes de bas de page** : convertir en liens `[^n]` et regrouper \u00E0 la fin sous `## Notes`.\n\n---\n\n### Nettoyage final\n- Supprimer en-t\u00EAtes/pieds de page r\u00E9p\u00E9t\u00E9s (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 les sections de revue automatique (ex. \u201Crapport de r\u00E9vision\u2026\u201D) quand d\u00E9tectables.\n\n---\n\n### Format d\u2019entr\u00E9e attendu\n**Proc\u00E9dure :**\n1. Lire attentivement le bloc `<<PDF_TEXT>>`.  \n2. Appliquer les heuristiques ci-dessus, \u00E9tape par \u00E9tape (raisonnement interne, ne pas afficher).  \n3. Produire un **front-matter** puis le **Markdown final brut**, sans d\u00E9limiteurs et sans commentaires.\n\n**Front-matter (YAML) \u00E0 produire :**\n---\ntitle: {service} - {action} {object} {b\u00E9n\u00E9ficiaire}   # en minuscules si inf\u00E9r\u00E9s, sinon premier H1\nservice: {service}                                     # \"unknown\" si non d\u00E9duit\nrole: rule\nowner: {owner}\n---\n\n\n";
+export interface UsecaseExtractionOptions {
+    model?: string;
+    examples?: string;
+    extended?: string;
+}
+export declare const usecaseExtractionPrompt_OLD: (file: string) => string;
+export declare const usecaseExtractionPrompt: (file: string, options?: UsecaseExtractionOptions) => string;