avantgate 1.0.0 → 1.1.1

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { F as FinancialJurisdictionCode } from './strategy.interface-CB4_ZAuk.mjs';
 
 interface ChatMessage {
     role: "system" | "user" | "assistant" | "tool";
@@ -33,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;
@@ -67,6 +84,15 @@ interface AuditSinkPort {
     readonly name: string;
     log(record: AuditRecord): Promise<void> | void;
 }
+interface FinanceFeaturesConfig {
+    enableFrenchAccounting?: boolean;
+    stripCurrencySymbols?: boolean;
+    jurisdiction?: "FR" | "US" | "UK" | "CH" | "INTERNATIONAL";
+    autoDetect?: boolean;
+}
+interface FeaturesConfig {
+    finance?: FinanceFeaturesConfig;
+}
 interface ControlLayerConfig {
     primary: ProviderConfig;
     fallback?: ProviderConfig;
@@ -78,6 +104,11 @@ interface ControlLayerConfig {
     security?: SecurityConfig;
     hourlyTokenLimit?: number;
     dailyTokenLimit?: number;
+    features?: FeaturesConfig;
+    pricingAdapter?: PricingAdapter;
+    pricingCacheTtlMs?: number;
+    customPricing?: Record<string, ModelPrice>;
+    mockSimulation?: boolean;
 }
 interface ExecutionResult {
     text: string;
@@ -103,18 +134,67 @@ interface StructuredExecutionResult<T> {
     modelUsed: string;
     failoverOccurred: boolean;
 }
+interface GenerateStructuredOutputOptions<T> {
+    model?: string;
+    messages: ChatMessage[];
+    schema: z.ZodType<T>;
+    schemaName?: string;
+    maxRetries?: number;
+    temperature?: number;
+    providerOverride?: LLMProviderPort;
+    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.
- * Masque les données sensibles (email, numéros de téléphone, NIR/sécurité sociale, IBAN)
+ * Masque les données sensibles (email, téléphone, NIR/sécurité sociale, IBAN/BIC, numéro fiscal SPI)
  * avant l'envoi vers des API cloud.
  */
 interface SanitizeResult {
@@ -136,6 +216,11 @@ declare function validateUserInput(input: string, options?: {
     maxLength?: number;
 }): InputGuardResult;
 
+interface ValidateOptions {
+    normalizer?: (rawText: string) => string;
+    financialNormalizer?: boolean;
+    jurisdiction?: FinancialJurisdictionCode;
+}
 /**
  * Nettoie et extrait un bloc JSON valide depuis une réponse de LLM
  * (gère les blocs markdown ```json ... ```, les balises de réflexion, etc.)
@@ -143,13 +228,20 @@ declare function validateUserInput(input: string, options?: {
 declare function extractAndCleanJSON(rawText: string): string;
 /**
  * Valide et auto-répare une sortie JSON contre un schéma Zod.
+ * Supporte l'option de normalisation financière (parenthèses négatives, formats comptables).
  */
-declare function validateWithZod<T>(rawText: string, schema: z.ZodType<T>): T;
+declare function validateWithZod<T>(rawText: string, schema: z.ZodType<T>, options?: ValidateOptions): T;
 
 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;
@@ -159,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;
@@ -177,8 +269,122 @@ declare class AvantGateControlLayer {
         temperature?: number;
         providerOverride?: LLMProviderPort;
     }): Promise<StructuredExecutionResult<T>>;
+    /**
+     * 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.
+     */
+    generateStructuredOutput<T>(options: GenerateStructuredOutputOptions<T>): Promise<StructuredExecutionResult<T>>;
 }
 declare function createLLMControlLayer(config: ControlLayerConfig): AvantGateControlLayer;
 declare const createAvantGate: typeof createLLMControlLayer;
 
-export { type AuditRecord, type AuditSinkPort, AvantGateControlLayer, type ChatMessage, type ControlLayerConfig, DEFAULT_MODEL_PRICES, type ExecutionResult, type InputGuardResult, type LLMCompletionOptions, type LLMProviderPort, type LLMStructuredOutputOptions, type LLMUsage, type ModelPrice, type ProviderConfig, type RetryConfig, type SanitizeResult, type SecurityConfig, type StructuredExecutionResult, AvantGateControlLayer as ZenLLMControlLayer, calculateCostUSD, createAvantGate, createLLMControlLayer, extractAndCleanJSON, sanitizePII, validateUserInput, validateWithZod };
+interface PromptMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+type PromptLabel = "production" | "staging" | "experimental";
+interface PromptTemplateOptions<TVariables extends Record<string, unknown> = Record<string, unknown>> {
+    id: string;
+    version: number;
+    label?: PromptLabel;
+    description?: string;
+    template: string;
+    inputSchema?: z.ZodType<TVariables>;
+    antiInjection?: {
+        enabled?: boolean;
+        blockPatterns?: RegExp[];
+        sanitizer?: (value: string) => string;
+    };
+}
+interface PromptValidationResult {
+    isValid: boolean;
+    threats: string[];
+}
+interface ITokenBudget {
+    count(text: string): number;
+    remaining(): number;
+    reserve(slot: string, text: string): void;
+    forceReserve(slot: string, text: string): void;
+    getAllocated(): number;
+    reset(): void;
+}
+interface BuildResult {
+    messages: PromptMessage[];
+    promptText: string;
+    allocatedTokens?: number;
+    isTruncated: boolean;
+    truncatedSlot?: "context" | "pinnedFacts" | "user";
+}
+
+declare class PromptTemplate<TVariables extends Record<string, unknown> = Record<string, unknown>> {
+    readonly id: string;
+    readonly version: number;
+    readonly label: PromptLabel;
+    readonly description?: string;
+    readonly template: string;
+    readonly inputSchema?: z.ZodType<TVariables>;
+    private blockPatterns;
+    private antiInjectionEnabled;
+    private customSanitizer?;
+    constructor(options: PromptTemplateOptions<TVariables>);
+    validateUserInput(variables: TVariables): PromptValidationResult;
+    format(variables: TVariables): string;
+}
+
+declare class PromptBuilder {
+    private personaSlot;
+    private rulesSlot;
+    private retryHintSlot;
+    private fewShotSlot;
+    private pinnedFactsSlot;
+    private contextSlot;
+    private userPayloadSlot;
+    private schemaContractText;
+    constructor(templateOrId?: string | PromptTemplate);
+    withPersona(persona: string): this;
+    withRules(rules: string | string[]): this;
+    withRetryHint(hint: string): this;
+    withFewShot(examples: Array<{
+        question: string;
+        answer: string;
+    }>): this;
+    withPinnedFacts(facts: string | Record<string, unknown>): this;
+    withContext(context: string): this;
+    withUserPayload(payload: string): this;
+    schemaContract<T>(schema: z.ZodType<T>, options?: {
+        schemaName?: string;
+    }): this;
+    private assembleMessages;
+    toMessages(): PromptMessage[];
+    build(budget?: ITokenBudget): BuildResult;
+}
+
+declare class PromptRegistry {
+    private static registry;
+    static register<T extends Record<string, unknown>>(templateOrOptions: PromptTemplate<T> | PromptTemplateOptions<T>): void;
+    static get<T extends Record<string, unknown> = Record<string, unknown>>(id: string, options?: {
+        version?: number;
+        label?: PromptLabel;
+    }): PromptTemplate<T>;
+    static has(id: string): boolean;
+    static clear(): void;
+}
+
+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

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { F as FinancialJurisdictionCode } from './strategy.interface-CB4_ZAuk.js';
 
 interface ChatMessage {
     role: "system" | "user" | "assistant" | "tool";
@@ -33,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;
@@ -67,6 +84,15 @@ interface AuditSinkPort {
     readonly name: string;
     log(record: AuditRecord): Promise<void> | void;
 }
+interface FinanceFeaturesConfig {
+    enableFrenchAccounting?: boolean;
+    stripCurrencySymbols?: boolean;
+    jurisdiction?: "FR" | "US" | "UK" | "CH" | "INTERNATIONAL";
+    autoDetect?: boolean;
+}
+interface FeaturesConfig {
+    finance?: FinanceFeaturesConfig;
+}
 interface ControlLayerConfig {
     primary: ProviderConfig;
     fallback?: ProviderConfig;
@@ -78,6 +104,11 @@ interface ControlLayerConfig {
     security?: SecurityConfig;
     hourlyTokenLimit?: number;
     dailyTokenLimit?: number;
+    features?: FeaturesConfig;
+    pricingAdapter?: PricingAdapter;
+    pricingCacheTtlMs?: number;
+    customPricing?: Record<string, ModelPrice>;
+    mockSimulation?: boolean;
 }
 interface ExecutionResult {
     text: string;
@@ -103,18 +134,67 @@ interface StructuredExecutionResult<T> {
     modelUsed: string;
     failoverOccurred: boolean;
 }
+interface GenerateStructuredOutputOptions<T> {
+    model?: string;
+    messages: ChatMessage[];
+    schema: z.ZodType<T>;
+    schemaName?: string;
+    maxRetries?: number;
+    temperature?: number;
+    providerOverride?: LLMProviderPort;
+    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.
- * Masque les données sensibles (email, numéros de téléphone, NIR/sécurité sociale, IBAN)
+ * Masque les données sensibles (email, téléphone, NIR/sécurité sociale, IBAN/BIC, numéro fiscal SPI)
  * avant l'envoi vers des API cloud.
  */
 interface SanitizeResult {
@@ -136,6 +216,11 @@ declare function validateUserInput(input: string, options?: {
     maxLength?: number;
 }): InputGuardResult;
 
+interface ValidateOptions {
+    normalizer?: (rawText: string) => string;
+    financialNormalizer?: boolean;
+    jurisdiction?: FinancialJurisdictionCode;
+}
 /**
  * Nettoie et extrait un bloc JSON valide depuis une réponse de LLM
  * (gère les blocs markdown ```json ... ```, les balises de réflexion, etc.)
@@ -143,13 +228,20 @@ declare function validateUserInput(input: string, options?: {
 declare function extractAndCleanJSON(rawText: string): string;
 /**
  * Valide et auto-répare une sortie JSON contre un schéma Zod.
+ * Supporte l'option de normalisation financière (parenthèses négatives, formats comptables).
  */
-declare function validateWithZod<T>(rawText: string, schema: z.ZodType<T>): T;
+declare function validateWithZod<T>(rawText: string, schema: z.ZodType<T>, options?: ValidateOptions): T;
 
 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;
@@ -159,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;
@@ -177,8 +269,122 @@ declare class AvantGateControlLayer {
         temperature?: number;
         providerOverride?: LLMProviderPort;
     }): Promise<StructuredExecutionResult<T>>;
+    /**
+     * 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.
+     */
+    generateStructuredOutput<T>(options: GenerateStructuredOutputOptions<T>): Promise<StructuredExecutionResult<T>>;
 }
 declare function createLLMControlLayer(config: ControlLayerConfig): AvantGateControlLayer;
 declare const createAvantGate: typeof createLLMControlLayer;
 
-export { type AuditRecord, type AuditSinkPort, AvantGateControlLayer, type ChatMessage, type ControlLayerConfig, DEFAULT_MODEL_PRICES, type ExecutionResult, type InputGuardResult, type LLMCompletionOptions, type LLMProviderPort, type LLMStructuredOutputOptions, type LLMUsage, type ModelPrice, type ProviderConfig, type RetryConfig, type SanitizeResult, type SecurityConfig, type StructuredExecutionResult, AvantGateControlLayer as ZenLLMControlLayer, calculateCostUSD, createAvantGate, createLLMControlLayer, extractAndCleanJSON, sanitizePII, validateUserInput, validateWithZod };
+interface PromptMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+type PromptLabel = "production" | "staging" | "experimental";
+interface PromptTemplateOptions<TVariables extends Record<string, unknown> = Record<string, unknown>> {
+    id: string;
+    version: number;
+    label?: PromptLabel;
+    description?: string;
+    template: string;
+    inputSchema?: z.ZodType<TVariables>;
+    antiInjection?: {
+        enabled?: boolean;
+        blockPatterns?: RegExp[];
+        sanitizer?: (value: string) => string;
+    };
+}
+interface PromptValidationResult {
+    isValid: boolean;
+    threats: string[];
+}
+interface ITokenBudget {
+    count(text: string): number;
+    remaining(): number;
+    reserve(slot: string, text: string): void;
+    forceReserve(slot: string, text: string): void;
+    getAllocated(): number;
+    reset(): void;
+}
+interface BuildResult {
+    messages: PromptMessage[];
+    promptText: string;
+    allocatedTokens?: number;
+    isTruncated: boolean;
+    truncatedSlot?: "context" | "pinnedFacts" | "user";
+}
+
+declare class PromptTemplate<TVariables extends Record<string, unknown> = Record<string, unknown>> {
+    readonly id: string;
+    readonly version: number;
+    readonly label: PromptLabel;
+    readonly description?: string;
+    readonly template: string;
+    readonly inputSchema?: z.ZodType<TVariables>;
+    private blockPatterns;
+    private antiInjectionEnabled;
+    private customSanitizer?;
+    constructor(options: PromptTemplateOptions<TVariables>);
+    validateUserInput(variables: TVariables): PromptValidationResult;
+    format(variables: TVariables): string;
+}
+
+declare class PromptBuilder {
+    private personaSlot;
+    private rulesSlot;
+    private retryHintSlot;
+    private fewShotSlot;
+    private pinnedFactsSlot;
+    private contextSlot;
+    private userPayloadSlot;
+    private schemaContractText;
+    constructor(templateOrId?: string | PromptTemplate);
+    withPersona(persona: string): this;
+    withRules(rules: string | string[]): this;
+    withRetryHint(hint: string): this;
+    withFewShot(examples: Array<{
+        question: string;
+        answer: string;
+    }>): this;
+    withPinnedFacts(facts: string | Record<string, unknown>): this;
+    withContext(context: string): this;
+    withUserPayload(payload: string): this;
+    schemaContract<T>(schema: z.ZodType<T>, options?: {
+        schemaName?: string;
+    }): this;
+    private assembleMessages;
+    toMessages(): PromptMessage[];
+    build(budget?: ITokenBudget): BuildResult;
+}
+
+declare class PromptRegistry {
+    private static registry;
+    static register<T extends Record<string, unknown>>(templateOrOptions: PromptTemplate<T> | PromptTemplateOptions<T>): void;
+    static get<T extends Record<string, unknown> = Record<string, unknown>>(id: string, options?: {
+        version?: number;
+        label?: PromptLabel;
+    }): PromptTemplate<T>;
+    static has(id: string): boolean;
+    static clear(): void;
+}
+
+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 };