avantgate 1.1.0 → 1.1.2

package/dist/chunk-DVCF4CSV.mjs

@@ -0,0 +1,56 @@
+// 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 };
+}
+
+export {
+  sanitizePII
+};

package/dist/index.d.mts

@@ -34,12 +34,28 @@ interface LLMProviderPort {
     stream?(options: LLMCompletionOptions): AsyncGenerator<string, LLMUsage | undefined>;
     generateStructuredOutput?<T>(options: LLMStructuredOutputOptions<T>): Promise<T>;
 }
+interface ModelPrice {
+    promptUSDPerMillion: number;
+    completionUSDPerMillion: number;
+    cacheHitUSDPerMillion?: number;
+}
+interface PricingAdapter {
+    fetchPrice(model: string, provider?: string): Promise<ModelPrice | undefined> | ModelPrice | undefined;
+}
+declare class ConfigurationError extends Error {
+    constructor(message: string);
+}
+declare class BudgetExceededError extends Error {
+    constructor(message: string);
+}
+
 interface ProviderConfig {
     provider: "deepseek" | "mistral" | "openai" | "ollama" | "openrouter" | "custom";
     model: string;
     apiKey?: string;
     baseUrl?: string;
     client?: LLMProviderPort;
+    pricing?: ModelPrice;
 }
 interface SecurityConfig {
     detectPromptInjection?: boolean;
@@ -89,6 +105,10 @@ interface ControlLayerConfig {
     hourlyTokenLimit?: number;
     dailyTokenLimit?: number;
     features?: FeaturesConfig;
+    pricingAdapter?: PricingAdapter;
+    pricingCacheTtlMs?: number;
+    customPricing?: Record<string, ModelPrice>;
+    mockSimulation?: boolean;
 }
 interface ExecutionResult {
     text: string;
@@ -125,13 +145,52 @@ interface GenerateStructuredOutputOptions<T> {
     financialNormalizer?: boolean;
 }
 
-interface ModelPrice {
-    promptUSDPerMillion: number;
-    completionUSDPerMillion: number;
-    cacheHitUSDPerMillion?: number;
+interface CalculateCostOptions {
+    provider?: string;
+    providerPricing?: ModelPrice;
+    customPricing?: Record<string, ModelPrice>;
+    adapter?: PricingAdapter;
+}
+/**
+ * Catalogue indicatif non injecté par défaut dans le moteur.
+ * Les utilisateurs peuvent s'en servir comme jeu de données initial (ex: seed Prisma)
+ * ou pour peupler le PricingRegistry s'ils souhaitent des valeurs de départ.
+ */
+declare const SEED_MODEL_PRICES: Record<string, ModelPrice>;
+declare class CachedPricingAdapter implements PricingAdapter {
+    private cache;
+    private ttlMs;
+    private delegate;
+    constructor(delegate: PricingAdapter, ttlMs?: number);
+    fetchPrice(model: string, provider?: string): Promise<ModelPrice | undefined>;
+    peek(model: string, provider?: string): ModelPrice | undefined;
+    clearCache(): void;
+    invalidate(model?: string, provider?: string): void;
+}
+/**
+ * Registre de tarification dynamique.
+ * Démarre 100% vide : aucune valeur codée en dur n'est imposée par défaut (Option A : Strict & Truthful).
+ */
+declare class PricingRegistry {
+    private static prices;
+    private static adapter?;
+    static registerPrice(identifier: string, price: ModelPrice): void;
+    static registerDistributorPrices(distributor: string, priceMap: Record<string, ModelPrice>): void;
+    static registerPrices(prices: Record<string, ModelPrice>): void;
+    static getPrice(model: string, provider?: string): ModelPrice | undefined;
+    static setAdapter(adapter: PricingAdapter): void;
+    static getAdapter(): PricingAdapter | undefined;
+    static clear(): void;
+    /**
+     * Réinitialise le registre en chargeant le catalogue d'exemple SEED_MODEL_PRICES.
+     */
+    static loadSeedPrices(): void;
+    static getAllPrices(): Record<string, ModelPrice>;
 }
 declare const DEFAULT_MODEL_PRICES: Record<string, ModelPrice>;
-declare function calculateCostUSD(model: string, promptTokens: number, completionTokens: number, cacheHitTokens?: number): number;
+declare function resolveModelPrice(model: string, options?: CalculateCostOptions | string): ModelPrice | undefined;
+declare function resolveModelPriceAsync(model: string, options?: CalculateCostOptions | string): Promise<ModelPrice | undefined>;
+declare function calculateCostUSD(model: string, promptTokens: number, completionTokens: number, cacheHitTokens?: number, options?: CalculateCostOptions | string): number;
 
 /**
  * In-Flight PII Sanitizer for AvantGate.
@@ -175,8 +234,14 @@ declare function validateWithZod<T>(rawText: string, schema: z.ZodType<T>, optio
 
 declare class AvantGateControlLayer {
     private config;
+    private cachedPricingAdapter?;
     constructor(config: ControlLayerConfig);
+    private resolveProviderConfig;
+    private findProviderConfig;
+    private calculateCost;
     private applySecurityGuards;
+    private checkPreflightBudget;
+    private checkPostExecutionBudget;
     private buildMessages;
     private resolveTokens;
     private getProviderChain;
@@ -186,7 +251,7 @@ declare class AvantGateControlLayer {
     private assembleResult;
     private notifyAuditSink;
     /**
-     * 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.
      */
     execute(options: {
         userQuery: string;
@@ -305,4 +370,21 @@ declare class PromptRegistry {
     static clear(): void;
 }
 
-export { type AuditRecord, type AuditSinkPort, AvantGateControlLayer, type BuildResult, type ChatMessage, type ControlLayerConfig, DEFAULT_MODEL_PRICES, type ExecutionResult, type FeaturesConfig, type FinanceFeaturesConfig, type GenerateStructuredOutputOptions, type ITokenBudget, type InputGuardResult, type LLMCompletionOptions, type LLMProviderPort, type LLMStructuredOutputOptions, type LLMUsage, type ModelPrice, PromptBuilder, type PromptLabel, type PromptMessage, PromptRegistry, PromptTemplate, type PromptTemplateOptions, type PromptValidationResult, type ProviderConfig, type RetryConfig, type SanitizeResult, type SecurityConfig, type StructuredExecutionResult, type ValidateOptions, AvantGateControlLayer as ZenLLMControlLayer, calculateCostUSD, createAvantGate, createLLMControlLayer, extractAndCleanJSON, sanitizePII, validateUserInput, validateWithZod };
+declare class HttpProviderClient implements LLMProviderPort {
+    readonly name: string;
+    private readonly baseUrl;
+    private readonly apiKey?;
+    private readonly providerType;
+    constructor(config: ProviderConfig);
+    private resolveEndpoint;
+    private buildHeaders;
+    private buildPayload;
+    private extractUsage;
+    complete(options: LLMCompletionOptions): Promise<{
+        text: string;
+        usage?: LLMUsage;
+    }>;
+}
+declare function createHttpProviderClient(config: ProviderConfig): HttpProviderClient;
+
+export { type AuditRecord, type AuditSinkPort, BudgetExceededError as AvantGateBudgetExceededError, ConfigurationError as AvantGateConfigurationError, AvantGateControlLayer, BudgetExceededError, type BuildResult, CachedPricingAdapter, type CalculateCostOptions, type ChatMessage, ConfigurationError, type ControlLayerConfig, DEFAULT_MODEL_PRICES, type ExecutionResult, type FeaturesConfig, type FinanceFeaturesConfig, type GenerateStructuredOutputOptions, HttpProviderClient, type ITokenBudget, type InputGuardResult, type LLMCompletionOptions, type LLMProviderPort, type LLMStructuredOutputOptions, type LLMUsage, type ModelPrice, type PricingAdapter, PricingRegistry, PromptBuilder, type PromptLabel, type PromptMessage, PromptRegistry, PromptTemplate, type PromptTemplateOptions, type PromptValidationResult, type ProviderConfig, type RetryConfig, SEED_MODEL_PRICES, type SanitizeResult, type SecurityConfig, type StructuredExecutionResult, type ValidateOptions, AvantGateControlLayer as ZenLLMControlLayer, calculateCostUSD, createAvantGate, createHttpProviderClient, createLLMControlLayer, extractAndCleanJSON, resolveModelPrice, resolveModelPriceAsync, sanitizePII, validateUserInput, validateWithZod };

package/dist/index.d.ts

@@ -34,12 +34,28 @@ interface LLMProviderPort {
     stream?(options: LLMCompletionOptions): AsyncGenerator<string, LLMUsage | undefined>;
     generateStructuredOutput?<T>(options: LLMStructuredOutputOptions<T>): Promise<T>;
 }
+interface ModelPrice {
+    promptUSDPerMillion: number;
+    completionUSDPerMillion: number;
+    cacheHitUSDPerMillion?: number;
+}
+interface PricingAdapter {
+    fetchPrice(model: string, provider?: string): Promise<ModelPrice | undefined> | ModelPrice | undefined;
+}
+declare class ConfigurationError extends Error {
+    constructor(message: string);
+}
+declare class BudgetExceededError extends Error {
+    constructor(message: string);
+}
+
 interface ProviderConfig {
     provider: "deepseek" | "mistral" | "openai" | "ollama" | "openrouter" | "custom";
     model: string;
     apiKey?: string;
     baseUrl?: string;
     client?: LLMProviderPort;
+    pricing?: ModelPrice;
 }
 interface SecurityConfig {
     detectPromptInjection?: boolean;
@@ -89,6 +105,10 @@ interface ControlLayerConfig {
     hourlyTokenLimit?: number;
     dailyTokenLimit?: number;
     features?: FeaturesConfig;
+    pricingAdapter?: PricingAdapter;
+    pricingCacheTtlMs?: number;
+    customPricing?: Record<string, ModelPrice>;
+    mockSimulation?: boolean;
 }
 interface ExecutionResult {
     text: string;
@@ -125,13 +145,52 @@ interface GenerateStructuredOutputOptions<T> {
     financialNormalizer?: boolean;
 }
 
-interface ModelPrice {
-    promptUSDPerMillion: number;
-    completionUSDPerMillion: number;
-    cacheHitUSDPerMillion?: number;
+interface CalculateCostOptions {
+    provider?: string;
+    providerPricing?: ModelPrice;
+    customPricing?: Record<string, ModelPrice>;
+    adapter?: PricingAdapter;
+}
+/**
+ * Catalogue indicatif non injecté par défaut dans le moteur.
+ * Les utilisateurs peuvent s'en servir comme jeu de données initial (ex: seed Prisma)
+ * ou pour peupler le PricingRegistry s'ils souhaitent des valeurs de départ.
+ */
+declare const SEED_MODEL_PRICES: Record<string, ModelPrice>;
+declare class CachedPricingAdapter implements PricingAdapter {
+    private cache;
+    private ttlMs;
+    private delegate;
+    constructor(delegate: PricingAdapter, ttlMs?: number);
+    fetchPrice(model: string, provider?: string): Promise<ModelPrice | undefined>;
+    peek(model: string, provider?: string): ModelPrice | undefined;
+    clearCache(): void;
+    invalidate(model?: string, provider?: string): void;
+}
+/**
+ * Registre de tarification dynamique.
+ * Démarre 100% vide : aucune valeur codée en dur n'est imposée par défaut (Option A : Strict & Truthful).
+ */
+declare class PricingRegistry {
+    private static prices;
+    private static adapter?;
+    static registerPrice(identifier: string, price: ModelPrice): void;
+    static registerDistributorPrices(distributor: string, priceMap: Record<string, ModelPrice>): void;
+    static registerPrices(prices: Record<string, ModelPrice>): void;
+    static getPrice(model: string, provider?: string): ModelPrice | undefined;
+    static setAdapter(adapter: PricingAdapter): void;
+    static getAdapter(): PricingAdapter | undefined;
+    static clear(): void;
+    /**
+     * Réinitialise le registre en chargeant le catalogue d'exemple SEED_MODEL_PRICES.
+     */
+    static loadSeedPrices(): void;
+    static getAllPrices(): Record<string, ModelPrice>;
 }
 declare const DEFAULT_MODEL_PRICES: Record<string, ModelPrice>;
-declare function calculateCostUSD(model: string, promptTokens: number, completionTokens: number, cacheHitTokens?: number): number;
+declare function resolveModelPrice(model: string, options?: CalculateCostOptions | string): ModelPrice | undefined;
+declare function resolveModelPriceAsync(model: string, options?: CalculateCostOptions | string): Promise<ModelPrice | undefined>;
+declare function calculateCostUSD(model: string, promptTokens: number, completionTokens: number, cacheHitTokens?: number, options?: CalculateCostOptions | string): number;
 
 /**
  * In-Flight PII Sanitizer for AvantGate.
@@ -175,8 +234,14 @@ declare function validateWithZod<T>(rawText: string, schema: z.ZodType<T>, optio
 
 declare class AvantGateControlLayer {
     private config;
+    private cachedPricingAdapter?;
     constructor(config: ControlLayerConfig);
+    private resolveProviderConfig;
+    private findProviderConfig;
+    private calculateCost;
     private applySecurityGuards;
+    private checkPreflightBudget;
+    private checkPostExecutionBudget;
     private buildMessages;
     private resolveTokens;
     private getProviderChain;
@@ -186,7 +251,7 @@ declare class AvantGateControlLayer {
     private assembleResult;
     private notifyAuditSink;
     /**
-     * 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.
      */
     execute(options: {
         userQuery: string;
@@ -305,4 +370,21 @@ declare class PromptRegistry {
     static clear(): void;
 }
 
-export { type AuditRecord, type AuditSinkPort, AvantGateControlLayer, type BuildResult, type ChatMessage, type ControlLayerConfig, DEFAULT_MODEL_PRICES, type ExecutionResult, type FeaturesConfig, type FinanceFeaturesConfig, type GenerateStructuredOutputOptions, type ITokenBudget, type InputGuardResult, type LLMCompletionOptions, type LLMProviderPort, type LLMStructuredOutputOptions, type LLMUsage, type ModelPrice, PromptBuilder, type PromptLabel, type PromptMessage, PromptRegistry, PromptTemplate, type PromptTemplateOptions, type PromptValidationResult, type ProviderConfig, type RetryConfig, type SanitizeResult, type SecurityConfig, type StructuredExecutionResult, type ValidateOptions, AvantGateControlLayer as ZenLLMControlLayer, calculateCostUSD, createAvantGate, createLLMControlLayer, extractAndCleanJSON, sanitizePII, validateUserInput, validateWithZod };
+declare class HttpProviderClient implements LLMProviderPort {
+    readonly name: string;
+    private readonly baseUrl;
+    private readonly apiKey?;
+    private readonly providerType;
+    constructor(config: ProviderConfig);
+    private resolveEndpoint;
+    private buildHeaders;
+    private buildPayload;
+    private extractUsage;
+    complete(options: LLMCompletionOptions): Promise<{
+        text: string;
+        usage?: LLMUsage;
+    }>;
+}
+declare function createHttpProviderClient(config: ProviderConfig): HttpProviderClient;
+
+export { type AuditRecord, type AuditSinkPort, BudgetExceededError as AvantGateBudgetExceededError, ConfigurationError as AvantGateConfigurationError, AvantGateControlLayer, BudgetExceededError, type BuildResult, CachedPricingAdapter, type CalculateCostOptions, type ChatMessage, ConfigurationError, type ControlLayerConfig, DEFAULT_MODEL_PRICES, type ExecutionResult, type FeaturesConfig, type FinanceFeaturesConfig, type GenerateStructuredOutputOptions, HttpProviderClient, type ITokenBudget, type InputGuardResult, type LLMCompletionOptions, type LLMProviderPort, type LLMStructuredOutputOptions, type LLMUsage, type ModelPrice, type PricingAdapter, PricingRegistry, PromptBuilder, type PromptLabel, type PromptMessage, PromptRegistry, PromptTemplate, type PromptTemplateOptions, type PromptValidationResult, type ProviderConfig, type RetryConfig, SEED_MODEL_PRICES, type SanitizeResult, type SecurityConfig, type StructuredExecutionResult, type ValidateOptions, AvantGateControlLayer as ZenLLMControlLayer, calculateCostUSD, createAvantGate, createHttpProviderClient, createLLMControlLayer, extractAndCleanJSON, resolveModelPrice, resolveModelPriceAsync, sanitizePII, validateUserInput, validateWithZod };