avantgate 1.0.0 → 1.1.1

package/dist/index.mjs

@@ -1,78 +1,220 @@
+import {
+  sanitizePII
+} from "./chunk-DVCF4CSV.mjs";
+import {
+  extractAndCleanJSON,
+  validateWithZod
+} from "./chunk-CO26LNFD.mjs";
+
+// src/types.ts
+var ConfigurationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ConfigurationError";
+  }
+};
+var BudgetExceededError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "BudgetExceededError";
+  }
+};
+
 // src/pricing.ts
-var DEFAULT_MODEL_PRICES = {
-  // DeepSeek
-  "deepseek-chat": {
-    promptUSDPerMillion: 0.14,
-    completionUSDPerMillion: 0.28,
-    cacheHitUSDPerMillion: 0.014
-  },
-  "deepseek-reasoner": {
-    promptUSDPerMillion: 0.55,
-    completionUSDPerMillion: 2.19,
-    cacheHitUSDPerMillion: 0.14
-  },
-  // Mistral
-  "mistral-small-latest": {
-    promptUSDPerMillion: 0.2,
-    completionUSDPerMillion: 0.6
-  },
-  "mistral-large-latest": {
-    promptUSDPerMillion: 2,
-    completionUSDPerMillion: 6
+var SEED_MODEL_PRICES = {
+  // DeepSeek Direct
+  "deepseek-chat": { promptUSDPerMillion: 0.14, completionUSDPerMillion: 0.28, cacheHitUSDPerMillion: 0.014 },
+  "deepseek-reasoner": { promptUSDPerMillion: 0.55, completionUSDPerMillion: 2.19, cacheHitUSDPerMillion: 0.14 },
+  "deepseek/deepseek-chat": { promptUSDPerMillion: 0.14, completionUSDPerMillion: 0.28, cacheHitUSDPerMillion: 0.014 },
+  "deepseek/deepseek-reasoner": { promptUSDPerMillion: 0.55, completionUSDPerMillion: 2.19, cacheHitUSDPerMillion: 0.14 },
+  // Mistral AI Direct
+  "mistral-small-latest": { promptUSDPerMillion: 0.2, completionUSDPerMillion: 0.6 },
+  "mistral-large-latest": { promptUSDPerMillion: 2, completionUSDPerMillion: 6 },
+  "mistral/mistral-small-latest": { promptUSDPerMillion: 0.2, completionUSDPerMillion: 0.6 },
+  "mistral/mistral-large-latest": { promptUSDPerMillion: 2, completionUSDPerMillion: 6 },
+  // OpenAI Direct
+  "gpt-4o-mini": { promptUSDPerMillion: 0.15, completionUSDPerMillion: 0.6 },
+  "gpt-4o": { promptUSDPerMillion: 2.5, completionUSDPerMillion: 10 },
+  "openai/gpt-4o-mini": { promptUSDPerMillion: 0.15, completionUSDPerMillion: 0.6 },
+  "openai/gpt-4o": { promptUSDPerMillion: 2.5, completionUSDPerMillion: 10 },
+  // OpenRouter Direct
+  "openrouter/deepseek/deepseek-chat": { promptUSDPerMillion: 0.14, completionUSDPerMillion: 0.28 },
+  "openrouter/deepseek/deepseek-r1": { promptUSDPerMillion: 0.55, completionUSDPerMillion: 2.19 },
+  "openrouter/anthropic/claude-3.5-sonnet": { promptUSDPerMillion: 3, completionUSDPerMillion: 15 },
+  // Local Ollama (Toujours $0)
+  "ollama": { promptUSDPerMillion: 0, completionUSDPerMillion: 0 }
+};
+function normalizeKey(identifier) {
+  return identifier.trim().toLowerCase().replace(":", "/");
+}
+var CachedPricingAdapter = class {
+  cache = /* @__PURE__ */ new Map();
+  ttlMs;
+  delegate;
+  constructor(delegate, ttlMs = 5 * 60 * 1e3) {
+    this.delegate = delegate;
+    this.ttlMs = ttlMs;
+  }
+  async fetchPrice(model, provider) {
+    const key = provider ? normalizeKey(`${provider}/${model}`) : normalizeKey(model);
+    const cached = this.cache.get(key);
+    if (cached && Date.now() < cached.expiresAt) {
+      return cached.price;
+    }
+    try {
+      const freshPrice = await this.delegate.fetchPrice(model, provider);
+      if (freshPrice) {
+        this.cache.set(key, { price: freshPrice, expiresAt: Date.now() + this.ttlMs });
+        return freshPrice;
+      }
+    } catch {
+      if (cached) {
+        return cached.price;
+      }
+    }
+    return void 0;
+  }
+  peek(model, provider) {
+    const key = provider ? normalizeKey(`${provider}/${model}`) : normalizeKey(model);
+    return this.cache.get(key)?.price;
+  }
+  clearCache() {
+    this.cache.clear();
+  }
+  invalidate(model, provider) {
+    if (!model) {
+      this.clearCache();
+      return;
+    }
+    const key = provider ? normalizeKey(`${provider}/${model}`) : normalizeKey(model);
+    this.cache.delete(key);
+  }
+};
+var PricingRegistry = class {
+  static prices = /* @__PURE__ */ new Map();
+  static adapter;
+  static registerPrice(identifier, price) {
+    this.prices.set(normalizeKey(identifier), price);
+  }
+  static registerDistributorPrices(distributor, priceMap) {
+    for (const [model, price] of Object.entries(priceMap)) {
+      this.prices.set(normalizeKey(`${distributor}/${model}`), price);
+    }
+  }
+  static registerPrices(prices) {
+    for (const [key, price] of Object.entries(prices)) {
+      this.prices.set(normalizeKey(key), price);
+    }
+  }
+  static getPrice(model, provider) {
+    if (provider) {
+      const distributorKey = normalizeKey(`${provider}/${model}`);
+      const directDistributorPrice = this.prices.get(distributorKey);
+      if (directDistributorPrice) {
+        return directDistributorPrice;
+      }
+    }
+    return this.prices.get(normalizeKey(model));
+  }
+  static setAdapter(adapter) {
+    this.adapter = adapter;
+  }
+  static getAdapter() {
+    return this.adapter;
+  }
+  static clear() {
+    this.prices.clear();
+    this.adapter = void 0;
+  }
+  /**
+   * Réinitialise le registre en chargeant le catalogue d'exemple SEED_MODEL_PRICES.
+   */
+  static loadSeedPrices() {
+    this.registerPrices(SEED_MODEL_PRICES);
+  }
+  static getAllPrices() {
+    const out = {};
+    for (const [k, v] of this.prices.entries()) {
+      out[k] = v;
+    }
+    return out;
+  }
+};
+var DEFAULT_MODEL_PRICES = new Proxy({}, {
+  get(_target, prop) {
+    return PricingRegistry.getPrice(prop);
   },
-  // OpenAI
-  "gpt-4o-mini": {
-    promptUSDPerMillion: 0.15,
-    completionUSDPerMillion: 0.6
+  has(_target, prop) {
+    return Boolean(PricingRegistry.getPrice(prop));
   },
-  "gpt-4o": {
-    promptUSDPerMillion: 2.5,
-    completionUSDPerMillion: 10
+  ownKeys() {
+    return Object.keys(PricingRegistry.getAllPrices());
   },
-  // Ollama (local)
-  "ollama": {
-    promptUSDPerMillion: 0,
-    completionUSDPerMillion: 0
+  getOwnPropertyDescriptor(_target, prop) {
+    const price = PricingRegistry.getPrice(prop);
+    if (price) {
+      return { value: price, enumerable: true, configurable: true, writable: false };
+    }
+    return void 0;
+  }
+});
+function resolveModelPrice(model, options) {
+  const opts = typeof options === "string" ? { provider: options } : options ?? {};
+  if (opts.providerPricing) {
+    return opts.providerPricing;
+  }
+  if (opts.customPricing) {
+    if (opts.provider) {
+      const customDistributorKey = normalizeKey(`${opts.provider}/${model}`);
+      if (opts.customPricing[customDistributorKey]) {
+        return opts.customPricing[customDistributorKey];
+      }
+    }
+    if (opts.customPricing[normalizeKey(model)] ?? opts.customPricing[model]) {
+      return opts.customPricing[normalizeKey(model)] ?? opts.customPricing[model];
+    }
+  }
+  const activeAdapter = opts.adapter ?? PricingRegistry.getAdapter();
+  if (activeAdapter instanceof CachedPricingAdapter) {
+    const cached = activeAdapter.peek(model, opts.provider);
+    if (cached) {
+      return cached;
+    }
+  }
+  const registeredPrice = PricingRegistry.getPrice(model, opts.provider);
+  if (registeredPrice) {
+    return registeredPrice;
+  }
+  if (opts.provider === "ollama" || model.toLowerCase().includes("ollama")) {
+    return { promptUSDPerMillion: 0, completionUSDPerMillion: 0 };
+  }
+  return void 0;
+}
+async function resolveModelPriceAsync(model, options) {
+  const opts = typeof options === "string" ? { provider: options } : options ?? {};
+  const activeAdapter = opts.adapter ?? PricingRegistry.getAdapter();
+  if (activeAdapter) {
+    try {
+      const adapterPrice = await activeAdapter.fetchPrice(model, opts.provider);
+      if (adapterPrice) {
+        return adapterPrice;
+      }
+    } catch {
+    }
+  }
+  return resolveModelPrice(model, options);
+}
+function calculateCostUSD(model, promptTokens, completionTokens, cacheHitTokens = 0, options) {
+  const pricing = resolveModelPrice(model, options);
+  if (!pricing) {
+    return 0;
   }
-};
-function calculateCostUSD(model, promptTokens, completionTokens, cacheHitTokens = 0) {
-  const pricing = DEFAULT_MODEL_PRICES[model] ?? {
-    promptUSDPerMillion: 0.5,
-    completionUSDPerMillion: 1.5
-  };
   const promptCost = promptTokens / 1e6 * pricing.promptUSDPerMillion;
   const completionCost = completionTokens / 1e6 * pricing.completionUSDPerMillion;
   const cacheDiscount = cacheHitTokens && pricing.cacheHitUSDPerMillion ? cacheHitTokens / 1e6 * (pricing.promptUSDPerMillion - pricing.cacheHitUSDPerMillion) : 0;
   return Math.max(0, promptCost + completionCost - cacheDiscount);
 }
 
-// src/sanitizer.ts
-var EMAIL_REGEX = /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,7}\b/g;
-var PHONE_FR_REGEX = /\b(?:(?:\+|00)33|0)\s*[1-9](?:[\s.-]*\d{2}){4}\b/g;
-var NIR_SSN_REGEX = /\b[12]\s*\d{2}\s*\d{2}\s*\d{2}\s*\d{3}\s*\d{3}(?:\s*\d{2})?\b/g;
-var IBAN_REGEX = /\b[A-Z]{2}\d{2}[A-Z0-9]{4}\d{7}([A-Z0-9]?){0,16}\b/g;
-function sanitizePII(input) {
-  let count = 0;
-  let result = input;
-  result = result.replace(EMAIL_REGEX, () => {
-    count++;
-    return "[REDACTED_EMAIL]";
-  });
-  result = result.replace(PHONE_FR_REGEX, () => {
-    count++;
-    return "[REDACTED_PHONE]";
-  });
-  result = result.replace(NIR_SSN_REGEX, () => {
-    count++;
-    return "[REDACTED_NIR]";
-  });
-  result = result.replace(IBAN_REGEX, () => {
-    count++;
-    return "[REDACTED_IBAN]";
-  });
-  return { text: result, maskedCount: count };
-}
-
 // src/input-guard.ts
 var INJECTION_PATTERNS = [
   /ignore\s+(?:all\s+)?(?:previous|prior)\s+(?:instructions|prompts|rules)/i,
@@ -103,49 +245,144 @@ function validateUserInput(input, options) {
   return { valid: true };
 }
 
-// src/response-validator.ts
-function extractAndCleanJSON(rawText) {
-  let cleaned = rawText.trim();
-  cleaned = cleaned.replace(/<think>[\s\S]*?<\/think>/gi, "").trim();
-  const codeBlockMatch = cleaned.match(/```(?:json)?\s*([\s\S]*?)\s*```/i);
-  if (codeBlockMatch && codeBlockMatch[1]) {
-    cleaned = codeBlockMatch[1].trim();
-  }
-  const firstBrace = cleaned.indexOf("{");
-  const firstBracket = cleaned.indexOf("[");
-  let startIndex = -1;
-  if (firstBrace !== -1 && firstBracket !== -1) {
-    startIndex = Math.min(firstBrace, firstBracket);
-  } else if (firstBrace !== -1) {
-    startIndex = firstBrace;
-  } else if (firstBracket !== -1) {
-    startIndex = firstBracket;
-  }
-  const lastBrace = cleaned.lastIndexOf("}");
-  const lastBracket = cleaned.lastIndexOf("]");
-  const endIndex = Math.max(lastBrace, lastBracket);
-  if (startIndex !== -1 && endIndex !== -1 && endIndex > startIndex) {
-    cleaned = cleaned.slice(startIndex, endIndex + 1);
-  }
-  return cleaned;
-}
-function validateWithZod(rawText, schema) {
-  const jsonString = extractAndCleanJSON(rawText);
-  let parsed;
-  try {
-    parsed = JSON.parse(jsonString);
-  } catch (error) {
-    const sanitized = jsonString.replace(/,\s*([}\]])/g, "$1").replace(/'/g, '"');
-    parsed = JSON.parse(sanitized);
-  }
-  return schema.parse(parsed);
+// src/providers/http-client.ts
+var DEFAULT_BASE_URLS = {
+  deepseek: "https://api.deepseek.com/v1",
+  mistral: "https://api.mistral.ai/v1",
+  openai: "https://api.openai.com/v1",
+  ollama: "http://localhost:11434/v1",
+  openrouter: "https://openrouter.ai/api/v1"
+};
+var HttpProviderClient = class {
+  name;
+  baseUrl;
+  apiKey;
+  providerType;
+  constructor(config) {
+    this.providerType = config.provider;
+    this.name = `${config.provider}-http`;
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || DEFAULT_BASE_URLS[config.provider] || "https://api.openai.com/v1";
+  }
+  resolveEndpoint() {
+    const trimmed = this.baseUrl.replace(/\/+$/, "");
+    if (trimmed.endsWith("/chat/completions")) {
+      return trimmed;
+    }
+    return `${trimmed}/chat/completions`;
+  }
+  buildHeaders() {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (this.apiKey) {
+      headers["Authorization"] = `Bearer ${this.apiKey}`;
+    }
+    if (this.providerType === "openrouter") {
+      headers["HTTP-Referer"] = "https://avantgate.dev";
+      headers["X-Title"] = "AvantGate";
+    }
+    return headers;
+  }
+  buildPayload(options, model) {
+    return {
+      model,
+      messages: options.messages.map((m) => ({
+        role: m.role,
+        content: m.content
+      })),
+      temperature: options.temperature ?? 0.2,
+      ...options.responseFormat ? { response_format: options.responseFormat } : {}
+    };
+  }
+  extractUsage(usageData) {
+    if (!usageData) {
+      return void 0;
+    }
+    return {
+      promptTokens: usageData.prompt_tokens,
+      completionTokens: usageData.completion_tokens,
+      totalTokens: usageData.total_tokens,
+      promptCacheHitTokens: usageData.prompt_tokens_details?.cached_tokens
+    };
+  }
+  async complete(options) {
+    const endpoint = this.resolveEndpoint();
+    const model = options.model ?? "default";
+    const headers = this.buildHeaders();
+    const body = JSON.stringify(this.buildPayload(options, model));
+    const response = await fetch(endpoint, {
+      method: "POST",
+      headers,
+      body
+    });
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(
+        `[AvantGate HTTP Provider ${this.providerType}] HTTP ${response.status} ${response.statusText}: ${errorText}`
+      );
+    }
+    const data = await response.json();
+    const text = data.choices?.[0]?.message?.content ?? "";
+    const usage = this.extractUsage(data.usage);
+    return { text, usage };
+  }
+};
+function createHttpProviderClient(config) {
+  return new HttpProviderClient(config);
 }
 
 // src/control-layer.ts
 var AvantGateControlLayer = class {
   config;
+  cachedPricingAdapter;
   constructor(config) {
-    this.config = config;
+    this.config = {
+      ...config,
+      primary: this.resolveProviderConfig(config.primary),
+      fallback: this.resolveProviderConfig(config.fallback),
+      emergencyFallback: this.resolveProviderConfig(config.emergencyFallback)
+    };
+    if (config.pricingAdapter) {
+      this.cachedPricingAdapter = new CachedPricingAdapter(
+        config.pricingAdapter,
+        config.pricingCacheTtlMs ?? 5 * 60 * 1e3
+      );
+    }
+  }
+  resolveProviderConfig(provider) {
+    if (!provider) return void 0;
+    if (provider.client) return provider;
+    if (provider.apiKey || provider.baseUrl || provider.provider === "ollama") {
+      return {
+        ...provider,
+        client: createHttpProviderClient(provider)
+      };
+    }
+    return provider;
+  }
+  findProviderConfig(provider, model) {
+    const list = [this.config.primary, this.config.fallback, this.config.emergencyFallback].filter(
+      (p) => Boolean(p)
+    );
+    if (provider) {
+      const matchProvider = list.find((p) => p.provider === provider);
+      if (matchProvider) return matchProvider;
+    }
+    if (model) {
+      const matchModel = list.find((p) => p.model === model);
+      if (matchModel) return matchModel;
+    }
+    return this.config.primary;
+  }
+  calculateCost(model, promptTokens, completionTokens, cacheHitTokens = 0, provider) {
+    const providerCfg = this.findProviderConfig(provider, model);
+    return calculateCostUSD(model, promptTokens, completionTokens, cacheHitTokens, {
+      provider: provider ?? providerCfg?.provider,
+      providerPricing: providerCfg?.pricing,
+      customPricing: this.config.customPricing,
+      adapter: this.cachedPricingAdapter
+    });
   }
   applySecurityGuards(userQuery) {
     const guard = validateUserInput(userQuery, {
@@ -160,6 +397,46 @@ var AvantGateControlLayer = class {
     }
     return userQuery;
   }
+  checkPreflightBudget(estimatedPromptTokens, targetModel, provider) {
+    if (this.config.maxTokenBudget !== void 0 && estimatedPromptTokens > this.config.maxTokenBudget) {
+      throw new BudgetExceededError(
+        `[AvantGate Budget Guard] Pre-flight token budget exceeded: estimated prompt (${estimatedPromptTokens} tokens) exceeds maxTokenBudget (${this.config.maxTokenBudget}).`
+      );
+    }
+    if (this.config.maxCostUSD !== void 0) {
+      const isLocalFree = provider === "ollama" || targetModel.toLowerCase().includes("ollama");
+      const providerCfg = this.findProviderConfig(provider, targetModel);
+      const price = resolveModelPrice(targetModel, {
+        provider: provider ?? providerCfg?.provider,
+        providerPricing: providerCfg?.pricing,
+        customPricing: this.config.customPricing,
+        adapter: this.cachedPricingAdapter
+      });
+      if (!isLocalFree && !price) {
+        throw new ConfigurationError(
+          `[AvantGate Configuration Error] 'maxCostUSD' was set to $${this.config.maxCostUSD}, but no pricing was configured for model '${targetModel}'. Please define pricing in ProviderConfig, customPricing, or via PricingAdapter.`
+        );
+      }
+      const estimatedPromptCost = this.calculateCost(targetModel, estimatedPromptTokens, 0, 0, provider);
+      if (estimatedPromptCost > this.config.maxCostUSD) {
+        throw new BudgetExceededError(
+          `[AvantGate Budget Guard] Pre-flight cost budget exceeded: estimated prompt cost ($${estimatedPromptCost.toFixed(6)}) exceeds maxCostUSD ($${this.config.maxCostUSD}).`
+        );
+      }
+    }
+  }
+  checkPostExecutionBudget(tokensTotal, costUSD) {
+    if (this.config.maxTokenBudget !== void 0 && tokensTotal > this.config.maxTokenBudget) {
+      throw new BudgetExceededError(
+        `[AvantGate Budget Guard] Execution total tokens (${tokensTotal}) exceeded maxTokenBudget (${this.config.maxTokenBudget}).`
+      );
+    }
+    if (this.config.maxCostUSD !== void 0 && costUSD > this.config.maxCostUSD) {
+      throw new BudgetExceededError(
+        `[AvantGate Budget Guard] Execution cost ($${costUSD.toFixed(6)}) exceeded maxCostUSD ($${this.config.maxCostUSD}).`
+      );
+    }
+  }
   buildMessages(systemPrompt, query) {
     const messages = [];
     if (systemPrompt) {
@@ -172,7 +449,12 @@ var AvantGateControlLayer = class {
     const promptTokens = rawUsage?.promptTokens ?? Math.ceil(query.length / 4);
     const completionTokens = rawUsage?.completionTokens ?? Math.ceil(text.length / 4);
     const totalTokens = rawUsage?.totalTokens ?? promptTokens + completionTokens;
-    return { promptTokens, completionTokens, totalTokens };
+    return {
+      promptTokens,
+      completionTokens,
+      totalTokens,
+      promptCacheHitTokens: rawUsage?.promptCacheHitTokens
+    };
   }
   getProviderChain() {
     return [
@@ -184,7 +466,7 @@ var AvantGateControlLayer = class {
   executeSimulation(query, systemPrompt) {
     const promptTokens = Math.ceil(((systemPrompt?.length ?? 0) + query.length) / 4);
     const completionTokens = 50;
-    const cost = calculateCostUSD(this.config.primary.model, promptTokens, completionTokens);
+    const cost = this.calculateCost(this.config.primary.model, promptTokens, completionTokens);
     return {
       text: `[AvantGate In-Process Engine] Response simulation for model: ${this.config.primary.model}`,
       tokens: {
@@ -213,14 +495,15 @@ var AvantGateControlLayer = class {
       attempts: 1
     };
   }
-  async executeProviderPipeline(messages, query, temperature) {
+  async executeProviderPipeline(messages, query, temperature, modelOverride) {
     const chain = this.getProviderChain();
     let lastError;
     for (let index = 0; index < chain.length; index++) {
       const providerConfig = chain[index];
+      const targetModel = index === 0 && modelOverride ? modelOverride : providerConfig.model;
       try {
         const response = await providerConfig.client.complete({
-          model: providerConfig.model,
+          model: targetModel,
           messages,
           temperature: temperature ?? 0.2
         });
@@ -228,7 +511,7 @@ var AvantGateControlLayer = class {
         return {
           responseText: response.text,
           usage,
-          modelUsed: providerConfig.model,
+          modelUsed: targetModel,
           failoverOccurred: index > 0,
           attempts: index + 1
         };
@@ -239,10 +522,11 @@ var AvantGateControlLayer = class {
     throw lastError;
   }
   assembleResult(output) {
-    const costUSD = calculateCostUSD(
+    const costUSD = this.calculateCost(
       output.modelUsed,
       output.usage.promptTokens,
-      output.usage.completionTokens
+      output.usage.completionTokens,
+      output.usage.promptCacheHitTokens ?? 0
     );
     return {
       text: output.responseText,
@@ -271,18 +555,27 @@ var AvantGateControlLayer = class {
     });
   }
   /**
-   * Exécute une requête avec garde d'entrée, masquage PII, et calcul des coûts.
+   * Exécute une requête avec garde d'entrée, masquage PII, garde pré-vol et calcul des coûts.
    */
   async execute(options) {
     const sanitizedQuery = this.applySecurityGuards(options.userQuery);
     const messages = this.buildMessages(options.systemPrompt, sanitizedQuery);
+    const promptLength = (options.systemPrompt?.length ?? 0) + sanitizedQuery.length;
+    const estimatedPromptTokens = Math.ceil(promptLength / 4);
+    this.checkPreflightBudget(estimatedPromptTokens, this.config.primary.model, this.config.primary.provider);
     if (!options.providerOverride && this.getProviderChain().length === 0) {
-      const simResult = this.executeSimulation(sanitizedQuery, options.systemPrompt);
-      await this.notifyAuditSink(simResult);
-      return simResult;
+      if (this.config.mockSimulation) {
+        const simResult = this.executeSimulation(sanitizedQuery, options.systemPrompt);
+        await this.notifyAuditSink(simResult);
+        return simResult;
+      }
+      throw new ConfigurationError(
+        "[AvantGate Configuration Error] No active LLM provider configured. Provide a client implementing LLMProviderPort or configure credentials (apiKey / baseUrl)."
+      );
     }
     const output = options.providerOverride ? await this.executeOverrideProvider(options.providerOverride, messages, sanitizedQuery, options.temperature) : await this.executeProviderPipeline(messages, sanitizedQuery, options.temperature);
     const result = this.assembleResult(output);
+    this.checkPostExecutionBudget(result.tokens.total, result.costUSD);
     await this.notifyAuditSink(result);
     return result;
   }
@@ -296,7 +589,13 @@ var AvantGateControlLayer = class {
       temperature: options.temperature ?? 0.1,
       providerOverride: options.providerOverride
     });
-    const parsedData = validateWithZod(rawResult.text, options.schema);
+    const isFinancial = Boolean(
+      this.config.features?.finance?.enableFrenchAccounting || this.config.features?.finance
+    );
+    const parsedData = validateWithZod(rawResult.text, options.schema, {
+      financialNormalizer: isFinancial,
+      jurisdiction: this.config.features?.finance?.jurisdiction
+    });
     return {
       data: parsedData,
       rawText: rawResult.text,
@@ -306,19 +605,452 @@ var AvantGateControlLayer = class {
       failoverOccurred: rawResult.failoverOccurred
     };
   }
+  /**
+   * Méthode unifiée de premier niveau pour l'extraction structurée sans code boilerplate.
+   * Gère le failover multi-fournisseurs, les retries, la validation Zod et la normalisation financière.
+   */
+  async generateStructuredOutput(options) {
+    const maxRetries = options.maxRetries ?? this.config.retryOptions?.maxRetries ?? 2;
+    const modelToUse = options.model ?? this.config.primary.model;
+    const processedMessages = options.messages.map((msg) => {
+      if (msg.role === "user") {
+        return { ...msg, content: this.applySecurityGuards(msg.content) };
+      }
+      return msg;
+    });
+    const promptLength = processedMessages.reduce((sum, msg) => sum + msg.content.length, 0);
+    const estimatedPromptTokens = Math.ceil(promptLength / 4);
+    this.checkPreflightBudget(estimatedPromptTokens, modelToUse);
+    let lastError;
+    let accumulatedPromptTokens = 0;
+    let accumulatedCompletionTokens = 0;
+    let failoverOccurred = false;
+    let modelUsed = modelToUse;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      try {
+        let responseText = "";
+        let attemptPromptTokens = 0;
+        let attemptCompletionTokens = 0;
+        if (options.providerOverride) {
+          const res = await options.providerOverride.complete({
+            model: modelToUse,
+            messages: processedMessages,
+            temperature: options.temperature ?? 0.1
+          });
+          responseText = res.text;
+          const usage = this.resolveTokens(res.usage, JSON.stringify(processedMessages), responseText);
+          attemptPromptTokens = usage.promptTokens;
+          attemptCompletionTokens = usage.completionTokens;
+          modelUsed = modelToUse;
+        } else if (this.getProviderChain().length === 0) {
+          if (this.config.mockSimulation) {
+            const sim = this.executeSimulation(JSON.stringify(processedMessages));
+            responseText = sim.text;
+            attemptPromptTokens = sim.tokens.prompt;
+            attemptCompletionTokens = sim.tokens.completion;
+          } else {
+            throw new ConfigurationError(
+              "[AvantGate Configuration Error] No active LLM provider configured. Provide a client implementing LLMProviderPort or configure credentials (apiKey / baseUrl)."
+            );
+          }
+        } else {
+          const output = await this.executeProviderPipeline(
+            processedMessages,
+            JSON.stringify(processedMessages),
+            options.temperature ?? 0.1,
+            options.model
+          );
+          responseText = output.responseText;
+          attemptPromptTokens = output.usage.promptTokens;
+          attemptCompletionTokens = output.usage.completionTokens;
+          modelUsed = output.modelUsed;
+          failoverOccurred = output.failoverOccurred;
+        }
+        accumulatedPromptTokens += attemptPromptTokens;
+        accumulatedCompletionTokens += attemptCompletionTokens;
+        const isFinancial = options.financialNormalizer ?? Boolean(
+          this.config.features?.finance?.enableFrenchAccounting || this.config.features?.finance
+        );
+        const parsedData = validateWithZod(responseText, options.schema, {
+          financialNormalizer: isFinancial,
+          jurisdiction: this.config.features?.finance?.jurisdiction
+        });
+        const totalTokens = accumulatedPromptTokens + accumulatedCompletionTokens;
+        const costUSD = this.calculateCost(modelUsed, accumulatedPromptTokens, accumulatedCompletionTokens);
+        this.checkPostExecutionBudget(totalTokens, costUSD);
+        const result = {
+          data: parsedData,
+          rawText: responseText,
+          tokens: {
+            prompt: accumulatedPromptTokens,
+            completion: accumulatedCompletionTokens,
+            total: totalTokens
+          },
+          costUSD,
+          modelUsed,
+          failoverOccurred
+        };
+        await this.notifyAuditSink({
+          text: responseText,
+          tokens: result.tokens,
+          costUSD: result.costUSD,
+          modelUsed: result.modelUsed,
+          failoverOccurred: result.failoverOccurred,
+          attempts: attempt + 1
+        });
+        return result;
+      } catch (err) {
+        lastError = err;
+        if (attempt < maxRetries) {
+          const delay = (this.config.retryOptions?.initialDelayMs ?? 200) * Math.pow(this.config.retryOptions?.backoffFactor ?? 1.5, attempt);
+          await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+      }
+    }
+    throw lastError;
+  }
 };
 function createLLMControlLayer(config) {
   return new AvantGateControlLayer(config);
 }
 var createAvantGate = createLLMControlLayer;
+
+// src/prompts/prompt-template.ts
+var DEFAULT_JAILBREAK_PATTERNS = [
+  /ignore\s+(all\s+)?(previous|prior)\s+(instructions|rules)/i,
+  /disregard\s+(all\s+)?(previous|prior)\s+(instructions|rules)/i,
+  /system\s+override/i,
+  /you\s+are\s+now\s+(unrestricted|DAN|jailbroken)/i,
+  /<\s*\|\s*im_start\s*\|>/i,
+  /\[SYSTEM_PROMPT\]/i
+];
+var PromptTemplate = class {
+  id;
+  version;
+  label;
+  description;
+  template;
+  inputSchema;
+  blockPatterns;
+  antiInjectionEnabled;
+  customSanitizer;
+  constructor(options) {
+    this.id = options.id;
+    this.version = options.version;
+    this.label = options.label || "production";
+    this.description = options.description;
+    this.template = options.template;
+    this.inputSchema = options.inputSchema;
+    this.antiInjectionEnabled = options.antiInjection?.enabled !== false;
+    this.blockPatterns = options.antiInjection?.blockPatterns || DEFAULT_JAILBREAK_PATTERNS;
+    this.customSanitizer = options.antiInjection?.sanitizer;
+  }
+  validateUserInput(variables) {
+    const threats = [];
+    if (this.inputSchema) {
+      const parsed = this.inputSchema.safeParse(variables);
+      if (!parsed.success) {
+        return {
+          isValid: false,
+          threats: parsed.error.issues.map(
+            (issue) => `${issue.path.join(".")}: ${issue.message}`
+          )
+        };
+      }
+    }
+    if (this.antiInjectionEnabled) {
+      for (const [key, val] of Object.entries(variables)) {
+        if (typeof val === "string") {
+          for (const pattern of this.blockPatterns) {
+            if (pattern.test(val)) {
+              threats.push(
+                `Potential prompt injection in variable "${key}" matching pattern ${pattern}`
+              );
+            }
+          }
+        }
+      }
+    }
+    return { isValid: threats.length === 0, threats };
+  }
+  format(variables) {
+    const check = this.validateUserInput(variables);
+    if (!check.isValid) {
+      throw new Error(
+        `[PromptTemplate:${this.id}] Validation failed: ${check.threats.join(", ")}`
+      );
+    }
+    const interpolated = this.template.replace(/\{\{\s*([\w.-]+)\s*\}\}/g, (_, key) => {
+      let value = variables[key];
+      if (value === void 0 || value === null) {
+        return "";
+      }
+      let stringValue = typeof value === "object" ? JSON.stringify(value) : String(value);
+      if (this.customSanitizer) {
+        stringValue = this.customSanitizer(stringValue);
+      }
+      return stringValue;
+    });
+    return interpolated.split("\n").filter((line, index, arr) => line.trim() !== "" || index > 0 && arr[index - 1].trim() !== "").join("\n");
+  }
+};
+
+// src/prompts/prompt-builder.ts
+import { z } from "zod";
+var PromptBuilder = class {
+  personaSlot = "";
+  rulesSlot = [];
+  retryHintSlot = "";
+  fewShotSlot = [];
+  pinnedFactsSlot = "";
+  contextSlot = "";
+  userPayloadSlot = "";
+  schemaContractText = "";
+  constructor(templateOrId) {
+    if (templateOrId instanceof PromptTemplate) {
+      this.personaSlot = templateOrId.template;
+    } else if (typeof templateOrId === "string") {
+      this.personaSlot = templateOrId.trim();
+    }
+  }
+  withPersona(persona) {
+    this.personaSlot = persona.trim();
+    return this;
+  }
+  withRules(rules) {
+    if (Array.isArray(rules)) {
+      this.rulesSlot.push(...rules.map((rule) => rule.trim()).filter(Boolean));
+    } else if (rules) {
+      this.rulesSlot.push(rules.trim());
+    }
+    return this;
+  }
+  withRetryHint(hint) {
+    this.retryHintSlot = hint.trim();
+    return this;
+  }
+  withFewShot(examples) {
+    this.fewShotSlot = examples;
+    return this;
+  }
+  withPinnedFacts(facts) {
+    if (!facts) return this;
+    if (typeof facts === "string") {
+      this.pinnedFactsSlot = facts.trim();
+      return this;
+    }
+    this.pinnedFactsSlot = Object.entries(facts).filter(([, val]) => val !== void 0 && val !== null && val !== "").map(([key, val]) => `\u2022 ${key} : ${Array.isArray(val) ? val.join(", ") : String(val)}`).join("\n");
+    return this;
+  }
+  withContext(context) {
+    this.contextSlot = context.trim();
+    return this;
+  }
+  withUserPayload(payload) {
+    this.userPayloadSlot = payload.trim();
+    return this;
+  }
+  schemaContract(schema, options) {
+    let shapeDescription = "JSON Object";
+    if (schema instanceof z.ZodObject) {
+      shapeDescription = JSON.stringify(Object.keys(schema.shape));
+    }
+    this.schemaContractText = [
+      `[DIRECTIVE DE CONTRAT DE SORTIE JSON STRICT]`,
+      `Tu DOIS renvoyer UNIQUEMENT un objet JSON valide, sans balises markdown (\`\`\`json), sans texte avant ou apr\xE8s.`,
+      `Champs obligatoires et types attendus :`,
+      options?.schemaName ? `Sch\xE9ma : ${options.schemaName}` : "",
+      shapeDescription
+    ].filter(Boolean).join("\n");
+    return this;
+  }
+  assembleMessages(pinnedFacts, context, userPayload) {
+    const messages = [];
+    let system0 = this.personaSlot || "Tu es un assistant expert.";
+    if (this.schemaContractText) {
+      system0 += `
+
+${this.schemaContractText}`;
+    }
+    messages.push({ role: "system", content: system0 });
+    const dynamicParts = [];
+    if (this.rulesSlot.length > 0) {
+      dynamicParts.push(
+        `[R\xC8GLES ET CONSIGNES M\xC9TIER]
+${this.rulesSlot.map((rule, idx) => `${idx + 1}. ${rule}`).join("\n")}`
+      );
+    }
+    if (this.retryHintSlot) {
+      dynamicParts.push(`[INSTRUCTION DE CORRECTION / RETRY]
+${this.retryHintSlot}`);
+    }
+    if (dynamicParts.length > 0) {
+      messages.push({ role: "system", content: dynamicParts.join("\n\n") });
+    }
+    if (this.fewShotSlot.length > 0) {
+      const examplesContent = this.fewShotSlot.map(
+        (ex, idx) => `[Exemple ${idx + 1}]
+Question: ${ex.question}
+R\xE9ponse attendue: ${ex.answer}`
+      ).join("\n\n");
+      messages.push({ role: "system", content: `[EXEMPLES DE R\xC9F\xC9RENCE]
+${examplesContent}` });
+    }
+    const userParts = [];
+    if (pinnedFacts) {
+      userParts.push(`[FAITS STRUCTUR\xC9S]
+${pinnedFacts}`);
+    }
+    if (context) {
+      userParts.push(`[CONTEXTE DOCUMENTAIRE]
+${context}`);
+    }
+    if (userPayload) {
+      const labelNeeded = Boolean(pinnedFacts || context);
+      userParts.push(labelNeeded ? `[DONN\xC9ES \xC0 ANALYSER]
+${userPayload}` : userPayload);
+    }
+    messages.push({ role: "user", content: userParts.join("\n\n") });
+    return messages;
+  }
+  toMessages() {
+    return this.assembleMessages(this.pinnedFactsSlot, this.contextSlot, this.userPayloadSlot);
+  }
+  build(budget) {
+    if (!budget) {
+      const messages2 = this.toMessages();
+      const promptText2 = messages2.map((msg) => `${msg.role.toUpperCase()}:
+${msg.content}`).join("\n\n");
+      return {
+        messages: messages2,
+        promptText: promptText2,
+        allocatedTokens: Math.ceil(promptText2.length / 4),
+        isTruncated: false
+      };
+    }
+    budget.reset();
+    let isTruncated = false;
+    let truncatedSlot;
+    let system0 = this.personaSlot || "Tu es un assistant expert.";
+    if (this.schemaContractText) {
+      system0 += `
+
+${this.schemaContractText}`;
+    }
+    budget.forceReserve("persona", system0);
+    if (this.rulesSlot.length > 0 || this.retryHintSlot) {
+      const rulesText = this.rulesSlot.map((rule, idx) => `${idx + 1}. ${rule}`).join("\n");
+      budget.forceReserve("rules", `${rulesText}
+${this.retryHintSlot}`);
+    }
+    let payloadToUse = this.userPayloadSlot;
+    let factsToUse = this.pinnedFactsSlot;
+    let contextToUse = this.contextSlot;
+    if (payloadToUse) {
+      const payloadCost = budget.count(payloadToUse);
+      if (payloadCost > budget.remaining()) {
+        const charLimit = Math.max(100, budget.remaining() * 4);
+        payloadToUse = payloadToUse.slice(0, charLimit);
+        isTruncated = true;
+        truncatedSlot = "user";
+      }
+      budget.reserve("user", payloadToUse);
+    }
+    if (factsToUse) {
+      const factsCost = budget.count(factsToUse);
+      if (factsCost > budget.remaining()) {
+        const charLimit = Math.max(50, budget.remaining() * 4);
+        factsToUse = factsToUse.slice(0, charLimit);
+        isTruncated = true;
+        truncatedSlot = "pinnedFacts";
+      }
+      budget.reserve("pinnedFacts", factsToUse);
+    }
+    if (contextToUse) {
+      const contextCost = budget.count(contextToUse);
+      if (contextCost > budget.remaining()) {
+        const charLimit = Math.max(0, budget.remaining() * 4);
+        contextToUse = contextToUse.slice(0, charLimit);
+        isTruncated = true;
+        truncatedSlot = "context";
+      }
+      budget.reserve("context", contextToUse);
+    }
+    const messages = this.assembleMessages(factsToUse, contextToUse, payloadToUse);
+    const promptText = messages.map((msg) => `${msg.role.toUpperCase()}:
+${msg.content}`).join("\n\n");
+    return {
+      messages,
+      promptText,
+      allocatedTokens: budget.getAllocated(),
+      isTruncated,
+      truncatedSlot
+    };
+  }
+};
+
+// src/prompts/prompt-registry.ts
+var PromptRegistry = class {
+  static registry = /* @__PURE__ */ new Map();
+  static register(templateOrOptions) {
+    const template = templateOrOptions instanceof PromptTemplate ? templateOrOptions : new PromptTemplate(templateOrOptions);
+    const existing = this.registry.get(template.id) || [];
+    const filtered = existing.filter((item) => item.version !== template.version);
+    filtered.push(template);
+    filtered.sort((a, b) => b.version - a.version);
+    this.registry.set(template.id, filtered);
+  }
+  static get(id, options) {
+    const templates = this.registry.get(id);
+    if (!templates || templates.length === 0) {
+      throw new Error(`[PromptRegistry] No prompt template registered with id: "${id}"`);
+    }
+    if (options?.version !== void 0) {
+      const match = templates.find((item) => item.version === options.version);
+      if (!match) {
+        throw new Error(
+          `[PromptRegistry] Template "${id}" with version ${options.version} not found`
+        );
+      }
+      return match;
+    }
+    if (options?.label) {
+      const match = templates.find((item) => item.label === options.label);
+      if (match) {
+        return match;
+      }
+    }
+    return templates[0];
+  }
+  static has(id) {
+    return this.registry.has(id);
+  }
+  static clear() {
+    this.registry.clear();
+  }
+};
 export {
+  BudgetExceededError as AvantGateBudgetExceededError,
+  ConfigurationError as AvantGateConfigurationError,
   AvantGateControlLayer,
+  BudgetExceededError,
+  CachedPricingAdapter,
+  ConfigurationError,
   DEFAULT_MODEL_PRICES,
+  HttpProviderClient,
+  PricingRegistry,
+  PromptBuilder,
+  PromptRegistry,
+  PromptTemplate,
+  SEED_MODEL_PRICES,
   AvantGateControlLayer as ZenLLMControlLayer,
   calculateCostUSD,
   createAvantGate,
+  createHttpProviderClient,
   createLLMControlLayer,
   extractAndCleanJSON,
+  resolveModelPrice,
+  resolveModelPriceAsync,
   sanitizePII,
   validateUserInput,
   validateWithZod