avantgate 1.0.0 → 1.1.0

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";
@@ -67,6 +68,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 +88,7 @@ interface ControlLayerConfig {
     security?: SecurityConfig;
     hourlyTokenLimit?: number;
     dailyTokenLimit?: number;
+    features?: FeaturesConfig;
 }
 interface ExecutionResult {
     text: string;
@@ -103,6 +114,16 @@ 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;
@@ -114,7 +135,7 @@ declare function calculateCostUSD(model: string, promptTokens: number, completio
 
 /**
  * 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 +157,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,8 +169,9 @@ 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;
@@ -177,8 +204,105 @@ 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;
+}
+
+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 };

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";
@@ -67,6 +68,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 +88,7 @@ interface ControlLayerConfig {
     security?: SecurityConfig;
     hourlyTokenLimit?: number;
     dailyTokenLimit?: number;
+    features?: FeaturesConfig;
 }
 interface ExecutionResult {
     text: string;
@@ -103,6 +114,16 @@ 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;
@@ -114,7 +135,7 @@ declare function calculateCostUSD(model: string, promptTokens: number, completio
 
 /**
  * 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 +157,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,8 +169,9 @@ 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;
@@ -177,8 +204,105 @@ 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;
+}
+
+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 };