avantgate 1.0.0

package/dist/index.js

@@ -0,0 +1,361 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AvantGateControlLayer: () => AvantGateControlLayer,
+  DEFAULT_MODEL_PRICES: () => DEFAULT_MODEL_PRICES,
+  ZenLLMControlLayer: () => AvantGateControlLayer,
+  calculateCostUSD: () => calculateCostUSD,
+  createAvantGate: () => createAvantGate,
+  createLLMControlLayer: () => createLLMControlLayer,
+  extractAndCleanJSON: () => extractAndCleanJSON,
+  sanitizePII: () => sanitizePII,
+  validateUserInput: () => validateUserInput,
+  validateWithZod: () => validateWithZod
+});
+module.exports = __toCommonJS(index_exports);
+
+// 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
+  },
+  // OpenAI
+  "gpt-4o-mini": {
+    promptUSDPerMillion: 0.15,
+    completionUSDPerMillion: 0.6
+  },
+  "gpt-4o": {
+    promptUSDPerMillion: 2.5,
+    completionUSDPerMillion: 10
+  },
+  // Ollama (local)
+  "ollama": {
+    promptUSDPerMillion: 0,
+    completionUSDPerMillion: 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,
+  /disregard\s+(?:all\s+)?(?:previous|prior)\s+(?:instructions|prompts)/i,
+  /you\s+are\s+now\s+(?:dan|unrestricted|in\s+developer\s+mode)/i,
+  /bypass\s+(?:all\s+)?(?:content\s+filters|safety\s+guidelines)/i,
+  /output\s+(?:your\s+)?(?:system\s+prompt|initial\s+instructions)/i,
+  /repeat\s+(?:the\s+words\s+above|everything\s+above)/i
+];
+function validateUserInput(input, options) {
+  const maxLength = options?.maxLength ?? 5e4;
+  if (input.length > maxLength) {
+    return {
+      valid: false,
+      blockedReason: `Input length (${input.length}) exceeds max allowed (${maxLength})`
+    };
+  }
+  if (options?.detectInjection !== false) {
+    for (const pattern of INJECTION_PATTERNS) {
+      if (pattern.test(input)) {
+        return {
+          valid: false,
+          blockedReason: `Prompt injection or jailbreak detected: matches security rule [${pattern.source}]`
+        };
+      }
+    }
+  }
+  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/control-layer.ts
+var AvantGateControlLayer = class {
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  applySecurityGuards(userQuery) {
+    const guard = validateUserInput(userQuery, {
+      detectInjection: this.config.security?.detectPromptInjection,
+      maxLength: this.config.security?.maxInputLength
+    });
+    if (!guard.valid) {
+      throw new Error(`[AvantGate Security Guard] Request blocked: ${guard.blockedReason}`);
+    }
+    if (this.config.security?.maskPII) {
+      return sanitizePII(userQuery).text;
+    }
+    return userQuery;
+  }
+  buildMessages(systemPrompt, query) {
+    const messages = [];
+    if (systemPrompt) {
+      messages.push({ role: "system", content: systemPrompt });
+    }
+    messages.push({ role: "user", content: query });
+    return messages;
+  }
+  resolveTokens(rawUsage, query, text) {
+    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 };
+  }
+  getProviderChain() {
+    return [
+      this.config.primary,
+      this.config.fallback,
+      this.config.emergencyFallback
+    ].filter((provider) => Boolean(provider?.client));
+  }
+  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);
+    return {
+      text: `[AvantGate In-Process Engine] Response simulation for model: ${this.config.primary.model}`,
+      tokens: {
+        prompt: promptTokens,
+        completion: completionTokens,
+        total: promptTokens + completionTokens
+      },
+      costUSD: cost,
+      modelUsed: this.config.primary.model,
+      failoverOccurred: false,
+      attempts: 1
+    };
+  }
+  async executeOverrideProvider(provider, messages, query, temperature) {
+    const response = await provider.complete({
+      model: this.config.primary.model,
+      messages,
+      temperature: temperature ?? 0.2
+    });
+    const usage = this.resolveTokens(response.usage, query, response.text);
+    return {
+      responseText: response.text,
+      usage,
+      modelUsed: this.config.primary.model,
+      failoverOccurred: false,
+      attempts: 1
+    };
+  }
+  async executeProviderPipeline(messages, query, temperature) {
+    const chain = this.getProviderChain();
+    let lastError;
+    for (let index = 0; index < chain.length; index++) {
+      const providerConfig = chain[index];
+      try {
+        const response = await providerConfig.client.complete({
+          model: providerConfig.model,
+          messages,
+          temperature: temperature ?? 0.2
+        });
+        const usage = this.resolveTokens(response.usage, query, response.text);
+        return {
+          responseText: response.text,
+          usage,
+          modelUsed: providerConfig.model,
+          failoverOccurred: index > 0,
+          attempts: index + 1
+        };
+      } catch (err) {
+        lastError = err;
+      }
+    }
+    throw lastError;
+  }
+  assembleResult(output) {
+    const costUSD = calculateCostUSD(
+      output.modelUsed,
+      output.usage.promptTokens,
+      output.usage.completionTokens
+    );
+    return {
+      text: output.responseText,
+      tokens: {
+        prompt: output.usage.promptTokens,
+        completion: output.usage.completionTokens,
+        total: output.usage.totalTokens
+      },
+      costUSD,
+      modelUsed: output.modelUsed,
+      failoverOccurred: output.failoverOccurred,
+      attempts: output.attempts
+    };
+  }
+  async notifyAuditSink(result) {
+    if (!this.config.auditSink) {
+      return;
+    }
+    await this.config.auditSink.log({
+      timestamp: /* @__PURE__ */ new Date(),
+      model: result.modelUsed,
+      tokens: result.tokens,
+      costUSD: result.costUSD,
+      failoverOccurred: result.failoverOccurred,
+      attempts: result.attempts
+    });
+  }
+  /**
+   * Exécute une requête avec garde d'entrée, masquage PII, et calcul des coûts.
+   */
+  async execute(options) {
+    const sanitizedQuery = this.applySecurityGuards(options.userQuery);
+    const messages = this.buildMessages(options.systemPrompt, sanitizedQuery);
+    if (!options.providerOverride && this.getProviderChain().length === 0) {
+      const simResult = this.executeSimulation(sanitizedQuery, options.systemPrompt);
+      await this.notifyAuditSink(simResult);
+      return simResult;
+    }
+    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);
+    await this.notifyAuditSink(result);
+    return result;
+  }
+  /**
+   * Exécute une requête et valide/répare le résultat selon un schéma Zod.
+   */
+  async executeStructured(options) {
+    const rawResult = await this.execute({
+      userQuery: options.userQuery,
+      systemPrompt: options.systemPrompt,
+      temperature: options.temperature ?? 0.1,
+      providerOverride: options.providerOverride
+    });
+    const parsedData = validateWithZod(rawResult.text, options.schema);
+    return {
+      data: parsedData,
+      rawText: rawResult.text,
+      tokens: rawResult.tokens,
+      costUSD: rawResult.costUSD,
+      modelUsed: rawResult.modelUsed,
+      failoverOccurred: rawResult.failoverOccurred
+    };
+  }
+};
+function createLLMControlLayer(config) {
+  return new AvantGateControlLayer(config);
+}
+var createAvantGate = createLLMControlLayer;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AvantGateControlLayer,
+  DEFAULT_MODEL_PRICES,
+  ZenLLMControlLayer,
+  calculateCostUSD,
+  createAvantGate,
+  createLLMControlLayer,
+  extractAndCleanJSON,
+  sanitizePII,
+  validateUserInput,
+  validateWithZod
+});

package/dist/index.mjs

@@ -0,0 +1,325 @@
+// 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
+  },
+  // OpenAI
+  "gpt-4o-mini": {
+    promptUSDPerMillion: 0.15,
+    completionUSDPerMillion: 0.6
+  },
+  "gpt-4o": {
+    promptUSDPerMillion: 2.5,
+    completionUSDPerMillion: 10
+  },
+  // Ollama (local)
+  "ollama": {
+    promptUSDPerMillion: 0,
+    completionUSDPerMillion: 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,
+  /disregard\s+(?:all\s+)?(?:previous|prior)\s+(?:instructions|prompts)/i,
+  /you\s+are\s+now\s+(?:dan|unrestricted|in\s+developer\s+mode)/i,
+  /bypass\s+(?:all\s+)?(?:content\s+filters|safety\s+guidelines)/i,
+  /output\s+(?:your\s+)?(?:system\s+prompt|initial\s+instructions)/i,
+  /repeat\s+(?:the\s+words\s+above|everything\s+above)/i
+];
+function validateUserInput(input, options) {
+  const maxLength = options?.maxLength ?? 5e4;
+  if (input.length > maxLength) {
+    return {
+      valid: false,
+      blockedReason: `Input length (${input.length}) exceeds max allowed (${maxLength})`
+    };
+  }
+  if (options?.detectInjection !== false) {
+    for (const pattern of INJECTION_PATTERNS) {
+      if (pattern.test(input)) {
+        return {
+          valid: false,
+          blockedReason: `Prompt injection or jailbreak detected: matches security rule [${pattern.source}]`
+        };
+      }
+    }
+  }
+  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/control-layer.ts
+var AvantGateControlLayer = class {
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  applySecurityGuards(userQuery) {
+    const guard = validateUserInput(userQuery, {
+      detectInjection: this.config.security?.detectPromptInjection,
+      maxLength: this.config.security?.maxInputLength
+    });
+    if (!guard.valid) {
+      throw new Error(`[AvantGate Security Guard] Request blocked: ${guard.blockedReason}`);
+    }
+    if (this.config.security?.maskPII) {
+      return sanitizePII(userQuery).text;
+    }
+    return userQuery;
+  }
+  buildMessages(systemPrompt, query) {
+    const messages = [];
+    if (systemPrompt) {
+      messages.push({ role: "system", content: systemPrompt });
+    }
+    messages.push({ role: "user", content: query });
+    return messages;
+  }
+  resolveTokens(rawUsage, query, text) {
+    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 };
+  }
+  getProviderChain() {
+    return [
+      this.config.primary,
+      this.config.fallback,
+      this.config.emergencyFallback
+    ].filter((provider) => Boolean(provider?.client));
+  }
+  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);
+    return {
+      text: `[AvantGate In-Process Engine] Response simulation for model: ${this.config.primary.model}`,
+      tokens: {
+        prompt: promptTokens,
+        completion: completionTokens,
+        total: promptTokens + completionTokens
+      },
+      costUSD: cost,
+      modelUsed: this.config.primary.model,
+      failoverOccurred: false,
+      attempts: 1
+    };
+  }
+  async executeOverrideProvider(provider, messages, query, temperature) {
+    const response = await provider.complete({
+      model: this.config.primary.model,
+      messages,
+      temperature: temperature ?? 0.2
+    });
+    const usage = this.resolveTokens(response.usage, query, response.text);
+    return {
+      responseText: response.text,
+      usage,
+      modelUsed: this.config.primary.model,
+      failoverOccurred: false,
+      attempts: 1
+    };
+  }
+  async executeProviderPipeline(messages, query, temperature) {
+    const chain = this.getProviderChain();
+    let lastError;
+    for (let index = 0; index < chain.length; index++) {
+      const providerConfig = chain[index];
+      try {
+        const response = await providerConfig.client.complete({
+          model: providerConfig.model,
+          messages,
+          temperature: temperature ?? 0.2
+        });
+        const usage = this.resolveTokens(response.usage, query, response.text);
+        return {
+          responseText: response.text,
+          usage,
+          modelUsed: providerConfig.model,
+          failoverOccurred: index > 0,
+          attempts: index + 1
+        };
+      } catch (err) {
+        lastError = err;
+      }
+    }
+    throw lastError;
+  }
+  assembleResult(output) {
+    const costUSD = calculateCostUSD(
+      output.modelUsed,
+      output.usage.promptTokens,
+      output.usage.completionTokens
+    );
+    return {
+      text: output.responseText,
+      tokens: {
+        prompt: output.usage.promptTokens,
+        completion: output.usage.completionTokens,
+        total: output.usage.totalTokens
+      },
+      costUSD,
+      modelUsed: output.modelUsed,
+      failoverOccurred: output.failoverOccurred,
+      attempts: output.attempts
+    };
+  }
+  async notifyAuditSink(result) {
+    if (!this.config.auditSink) {
+      return;
+    }
+    await this.config.auditSink.log({
+      timestamp: /* @__PURE__ */ new Date(),
+      model: result.modelUsed,
+      tokens: result.tokens,
+      costUSD: result.costUSD,
+      failoverOccurred: result.failoverOccurred,
+      attempts: result.attempts
+    });
+  }
+  /**
+   * Exécute une requête avec garde d'entrée, masquage PII, et calcul des coûts.
+   */
+  async execute(options) {
+    const sanitizedQuery = this.applySecurityGuards(options.userQuery);
+    const messages = this.buildMessages(options.systemPrompt, sanitizedQuery);
+    if (!options.providerOverride && this.getProviderChain().length === 0) {
+      const simResult = this.executeSimulation(sanitizedQuery, options.systemPrompt);
+      await this.notifyAuditSink(simResult);
+      return simResult;
+    }
+    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);
+    await this.notifyAuditSink(result);
+    return result;
+  }
+  /**
+   * Exécute une requête et valide/répare le résultat selon un schéma Zod.
+   */
+  async executeStructured(options) {
+    const rawResult = await this.execute({
+      userQuery: options.userQuery,
+      systemPrompt: options.systemPrompt,
+      temperature: options.temperature ?? 0.1,
+      providerOverride: options.providerOverride
+    });
+    const parsedData = validateWithZod(rawResult.text, options.schema);
+    return {
+      data: parsedData,
+      rawText: rawResult.text,
+      tokens: rawResult.tokens,
+      costUSD: rawResult.costUSD,
+      modelUsed: rawResult.modelUsed,
+      failoverOccurred: rawResult.failoverOccurred
+    };
+  }
+};
+function createLLMControlLayer(config) {
+  return new AvantGateControlLayer(config);
+}
+var createAvantGate = createLLMControlLayer;
+export {
+  AvantGateControlLayer,
+  DEFAULT_MODEL_PRICES,
+  AvantGateControlLayer as ZenLLMControlLayer,
+  calculateCostUSD,
+  createAvantGate,
+  createLLMControlLayer,
+  extractAndCleanJSON,
+  sanitizePII,
+  validateUserInput,
+  validateWithZod
+};