avantgate 1.1.0 → 1.1.2

package/dist/index.mjs

@@ -1,109 +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*(?:0[1-9]|1[0-2]|[2-9]\d)\s*(?:0[1-9]|[1-8]\d|9[0-8]|2[ABab])\s*(?!000)\d{3}\s*(?!000)\d{3}(?:\s*\d{2})?\b/g;
-var SPI_LABELLED_REGEX = /(?:(?:num[ée]ro\s+fiscal|spi|n[°o]\s*fiscal|d[ée]clarant(?: fiscal)?)\s*[:=]?\s*)\b(\d{2}(?:[\s.-]?\d{2}){5}[\s.-]?\d|\d{13})\b/gi;
-var SPI_FORMATTED_REGEX = /\b[0-3]\d(?:\s+\d{2}){5}\s+\d\b/g;
-var IBAN_REGEX = /\b[A-Z]{2}\s*[0-9]{2}(?:[\s\r\n.-]*[A-Z0-9]){11,30}\b/g;
-var BIC_LABELLED_REGEX = /(?:(?:bic|swift)\s*[:=]?\s*)\b([A-Z]{4}[A-Z]{2}[A-Z0-9]{2}(?:[A-Z0-9]{3})?)\b/gi;
-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(IBAN_REGEX, (match) => {
-    const cleanChars = match.replace(/[\s\r\n.-]/g, "");
-    if (cleanChars.length >= 15 && cleanChars.length <= 34) {
-      count++;
-      return "[REDACTED_IBAN]";
-    }
-    return match;
-  });
-  result = result.replace(BIC_LABELLED_REGEX, (_, bicCode) => {
-    count++;
-    return `[REDACTED_BIC: ${bicCode.slice(0, 4)}****]`;
-  });
-  result = result.replace(SPI_LABELLED_REGEX, (fullMatch, digits) => {
-    count++;
-    return fullMatch.replace(digits, "[REDACTED_SPI]");
-  });
-  result = result.replace(NIR_SSN_REGEX, (match) => {
-    const rawDigits = match.replace(/\s+/g, "");
-    if (rawDigits.length === 13 || rawDigits.length === 15) {
-      count++;
-      return "[REDACTED_NIR]";
-    }
-    return match;
-  });
-  result = result.replace(SPI_FORMATTED_REGEX, (match) => {
-    if (!match.includes("[REDACTED")) {
-      count++;
-      return "[REDACTED_SPI]";
-    }
-    return match;
-  });
-  return { text: result, maskedCount: count };
-}
-
 // src/input-guard.ts
 var INJECTION_PATTERNS = [
   /ignore\s+(?:all\s+)?(?:previous|prior)\s+(?:instructions|prompts|rules)/i,
@@ -134,11 +245,144 @@ function validateUserInput(input, options) {
   return { valid: true };
 }
 
+// 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, {
@@ -153,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) {
@@ -165,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 [
@@ -177,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: {
@@ -233,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,
@@ -265,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;
   }
@@ -319,6 +618,9 @@ var AvantGateControlLayer = class {
       }
       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;
@@ -341,10 +643,16 @@ var AvantGateControlLayer = class {
           attemptCompletionTokens = usage.completionTokens;
           modelUsed = modelToUse;
         } else if (this.getProviderChain().length === 0) {
-          const sim = this.executeSimulation(JSON.stringify(processedMessages));
-          responseText = sim.text;
-          attemptPromptTokens = sim.tokens.prompt;
-          attemptCompletionTokens = sim.tokens.completion;
+          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,
@@ -368,7 +676,8 @@ var AvantGateControlLayer = class {
           jurisdiction: this.config.features?.finance?.jurisdiction
         });
         const totalTokens = accumulatedPromptTokens + accumulatedCompletionTokens;
-        const costUSD = calculateCostUSD(modelUsed, accumulatedPromptTokens, accumulatedCompletionTokens);
+        const costUSD = this.calculateCost(modelUsed, accumulatedPromptTokens, accumulatedCompletionTokens);
+        this.checkPostExecutionBudget(totalTokens, costUSD);
         const result = {
           data: parsedData,
           rawText: responseText,
@@ -721,16 +1030,27 @@ var PromptRegistry = class {
   }
 };
 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

package/package.json

@@ -1,13 +1,22 @@
 {
   "name": "avantgate",
-  "version": "1.1.0",
-  "description": "Zero-infrastructure, in-process LLM control plane: real-time cost control, token budgets, PII redaction, prompt guardrails, and multi-model failover without hosting servers.",
+  "version": "1.1.2",
+  "description": "Zero-infrastructure, in-process LLM control plane & SaaS observability bridge: real-time cost control, token budgets, PII redaction, prompt guardrails, multi-model failover, durable agent workflow harness, and HTTP telemetry without hosting heavy servers.",
   "author": "Antigravity & LexTalk Team",
   "license": "MIT",
   "keywords": [
     "avantgate",
     "llm",
     "ai",
+    "agent",
+    "observability",
+    "telemetry",
+    "session-replay",
+    "helicone-alternative",
+    "agentops-alternative",
+    "durable-execution",
+    "human-in-the-loop",
+    "dual-channel",
     "cost-control",
     "token-budget",
     "guardrails",
@@ -37,6 +46,11 @@
       "import": "./dist/finance/index.mjs",
       "require": "./dist/finance/index.js"
     },
+    "./agent": {
+      "types": "./dist/agent/index.d.ts",
+      "import": "./dist/agent/index.mjs",
+      "require": "./dist/agent/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -45,11 +59,12 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsup src/index.ts src/finance/index.ts --format cjs --format esm --dts --clean",
-    "test": "tsx tests/avantgate.test.ts && tsx tests/financial-normalizer.test.ts && tsx tests/prompt-builder.test.ts && tsx tests/pii-extended.test.ts",
+    "build": "tsup src/index.ts src/finance/index.ts src/agent/index.ts --format cjs --format esm --dts --clean",
+    "test": "tsx tests/avantgate.test.ts && tsx tests/preflight-budget.test.ts && tsx tests/financial-normalizer.test.ts && tsx tests/prompt-builder.test.ts && tsx tests/pii-extended.test.ts && npm run test:agent",
     "test:finance": "tsx tests/financial-normalizer.test.ts",
     "test:prompts": "tsx tests/prompt-builder.test.ts",
     "test:pii": "tsx tests/pii-extended.test.ts",
+    "test:agent": "tsx tests/agent/step-runner.test.ts && tsx tests/agent/isolated-tool.test.ts && tsx tests/agent/dto-pattern.test.ts && tsx tests/agent/tool-patterns.test.ts && tsx tests/agent/storage-adapters.test.ts && tsx tests/agent/tool-aliasing.test.ts && tsx tests/agent/tool-chaining.test.ts && tsx tests/agent/tool-storage.test.ts && tsx tests/agent/telemetry-exporter.test.ts && tsx tests/agent/platform-adapter.test.ts",
     "lint": "tsc --noEmit",
     "prepublishOnly": "npm run build && npm test"
   },