@praxisui/ai 4.0.0-beta.0 → 6.0.0-beta.0

package/index.d.ts

@@ -1,19 +1,148 @@
 import * as i0 from '@angular/core';
-import { OnInit, ChangeDetectorRef, OnDestroy, ElementRef } from '@angular/core';
-import * as _praxisui_core from '@praxisui/core';
-import { AiValueKind, AiCapability, GlobalConfigService, GlobalAiConfig, RulePropertySchema } from '@praxisui/core';
-import { Observable } from 'rxjs';
+import { OnDestroy, ElementRef, OnInit, ChangeDetectorRef } from '@angular/core';
 import { Schema } from '@google/generative-ai';
+import { Observable } from 'rxjs';
+import { CdkOverlayOrigin } from '@angular/cdk/overlay';
+import * as _praxisui_ai from '@praxisui/ai';
 import { MatDialogRef } from '@angular/material/dialog';
 import { MatSnackBar } from '@angular/material/snack-bar';
-import { FunctionRegistry, ContextProvider, ValidationIssue } from '@praxisui/specification';
-import { CdkOverlayOrigin } from '@angular/cdk/overlay';
 
 declare class PraxisAi {
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisAi, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisAi, "lib-praxis-ai", never, {}, {}, never, never, true, never>;
 }
 
+declare const AI_STREAM_EVENT_TYPES: readonly ["status", "thought.step", "heartbeat", "result", "error", "cancelled"];
+type AiJsonPrimitive = string | number | boolean | null;
+type AiJsonArray = AiJsonValue[];
+interface AiJsonObject {
+    [key: string]: AiJsonValue;
+}
+type AiJsonValue = AiJsonPrimitive | AiJsonObject | AiJsonArray;
+interface AiSchemaContextContract {
+    path?: string | null;
+    operation?: string | null;
+    schemaType?: string | null;
+}
+interface AiChatMessageContract {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+interface AiUiContextRefContract {
+    componentType?: string | null;
+    componentId?: string | null;
+    routeKey?: string | null;
+    schemaHash?: string | null;
+    variantId?: string | null;
+}
+interface AiCurrentStateDigestContract {
+    columns?: string[] | null;
+    sort?: string | null;
+    rowCount?: number | null;
+}
+interface AiOrchestratorRequestContract {
+    componentId: string;
+    componentType: string;
+    userPrompt?: string;
+    sessionId?: string;
+    mode?: 'new' | 'continue';
+    clientTurnId?: string;
+    messages?: AiChatMessageContract[];
+    summary?: string;
+    uiContextRef?: AiUiContextRefContract;
+    currentStateDigest?: AiCurrentStateDigestContract;
+    currentState: AiJsonObject;
+    dataProfile?: AiJsonObject | null;
+    schemaFields?: AiJsonObject[] | null;
+    runtimeState?: AiJsonObject | null;
+    suggestedPatch?: AiJsonObject | null;
+    contextHints?: AiJsonObject | null;
+    aiMode?: string;
+    requireSchema?: boolean;
+    resourcePath?: string;
+    contractVersion?: string;
+    schemaHash?: string;
+    schemaContext?: AiSchemaContextContract | null;
+    variantId?: string;
+    apiMethod?: string;
+    apiTags?: string;
+    apiSearchLimit?: number;
+}
+type AiOrchestratorResponseType = 'patch' | 'clarification' | 'error' | 'info';
+interface AiPatchDiffContract {
+    path: string;
+    before?: AiJsonValue;
+    after?: AiJsonValue;
+}
+interface AiOptionContract {
+    value?: string | null;
+    label?: string | null;
+    example?: string | null;
+    contextHints?: AiJsonObject | null;
+}
+interface AiClarificationUiContract {
+    responseType?: 'text' | 'choice' | 'confirm' | 'mixed' | 'context';
+    selectionMode?: 'single' | 'multiple';
+    presentation?: 'buttons' | 'list' | 'chips';
+    allowCustom?: boolean | null;
+}
+interface AiMemoryInfoContract {
+    summaryUpdated?: boolean | null;
+    windowSize?: number | null;
+    cached?: boolean | null;
+}
+interface AiOrchestratorResponseContract {
+    sessionId?: string | null;
+    code?: string | null;
+    type?: AiOrchestratorResponseType;
+    contractVersion?: string | null;
+    schemaHash?: string | null;
+    patch?: AiJsonObject | null;
+    diff?: AiPatchDiffContract[] | null;
+    explanation?: string | null;
+    warnings?: string[] | null;
+    message?: string | null;
+    options?: string[] | null;
+    optionPayloads?: AiOptionContract[] | null;
+    contextRequest?: number[] | null;
+    clarification?: AiClarificationUiContract;
+    componentId?: string | null;
+    componentType?: string | null;
+    path?: string | null;
+    providedValue?: AiJsonValue;
+    allowedValues?: string[] | null;
+    memory?: AiMemoryInfoContract;
+}
+interface AiPatchStreamStartResponseContract {
+    streamId: string;
+    threadId: string;
+    turnId: string;
+    eventSchemaVersion: string;
+    streamAuthMode?: 'cookie' | 'signed_url_token' | null;
+    streamAccessToken?: string | null;
+    expiresAt: string;
+    fallbackPatchUrl: string;
+}
+interface AiPatchStreamCancelResponseContract {
+    streamId?: string | null;
+    threadId?: string | null;
+    turnId?: string | null;
+    terminalState: 'cancelled' | 'completed' | 'not_found';
+    message?: string | null;
+}
+interface AiPatchStreamEnvelopeContract<TPayload extends AiJsonObject = AiJsonObject> {
+    eventId?: string | null;
+    streamId: string;
+    threadId: string;
+    turnId: string;
+    seq: number;
+    eventSchemaVersion: string;
+    timestamp: string;
+    type: AiPatchStreamEventType$1;
+    payload: TPayload;
+}
+type AiPatchStreamEventType$1 = (typeof AI_STREAM_EVENT_TYPES)[number];
+
 /**
  * Models for Praxis AI (Centralized)
  */
@@ -28,8 +157,8 @@ interface AiRuleResponse {
     targetType: 'field' | 'section' | 'action' | 'row' | 'column';
     /** IDs of the target elements */
     targetIds: string[];
-    /** Condition in DSL format (e.g., "age >= 18") or null for always applied */
-    conditionDsl: string | null;
+    /** Canonical JSON Logic condition payload or null for always applied */
+    condition: AiJsonObject | null;
     /** Effects to apply */
     effects: {
         /** Properties to apply when condition is true */
@@ -59,7 +188,7 @@ interface PromptContext {
     fieldsText: string;
     /** List of available properties for the selected target type */
     propertiesText: string;
-    /** List of supported DSL operators */
+    /** List of supported JSON Logic operators */
     operatorsText: string;
     /** Selected target type */
     targetType: string;
@@ -126,40 +255,32 @@ interface AiModel {
     topP?: number;
     topK?: number;
 }
-type ValueKind = AiValueKind;
-type Capability = AiCapability;
-
-declare class PraxisAiService {
-    private globalConfigService;
-    private genAI;
-    private config;
-    constructor(globalConfigService: GlobalConfigService);
-    private syncConfig;
-    classifyIntent(userInput: string, columns: string[]): Observable<any>;
-    answerQuestion(userInput: string, targetConfig: any): Observable<string>;
-    executeEnrichedPrompt(userInput: string, contextDescription: string, targetConfig: any, capabilities: any): Observable<any>;
-    private formatCapabilities;
-    private normalizeIntentClassification;
-    generateContent(prompt: string, modelName?: string): Observable<string>;
-    generateContentStream(prompt: string, modelName?: string): Observable<string>;
-    generateJson<T>(prompt: string, modelName?: string, schema?: any): Observable<T | null>;
-    isMockMode(): boolean;
-    private extractUserIntent;
-    private getMockPatch;
-    listModels(apiKey?: string): Observable<AiModel[]>;
-    testConnection(apiKey?: string, model?: string): Observable<boolean>;
-    private resolveProvider;
-    private isGeminiProvider;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisAiService, [{ optional: true; }]>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PraxisAiService>;
+type ValueKind = 'boolean' | 'string' | 'number' | 'enum' | 'expression' | 'object' | 'array';
+interface Capability {
+    path: string;
+    category: string;
+    valueKind: ValueKind | string;
+    allowedValues?: Array<string | number>;
+    description?: string;
+    critical?: boolean;
+    intentExamples?: string[];
+    dependsOn?: string;
+    example?: string;
+    safetyNotes?: string;
 }
-
-declare class AiConfigService {
-    private globalConfig;
-    getConfig(): AiIntegrationConfig;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AiConfigService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AiConfigService>;
+type RulePropertyType = 'string' | 'boolean' | 'object' | 'enum' | 'number';
+interface RulePropertyDefinition {
+    name: string;
+    type: RulePropertyType;
+    label: string;
+    description?: string;
+    enumValues?: Array<{
+        value: string;
+        label: string;
+    }>;
+    category?: 'content' | 'appearance' | 'behavior' | 'layout' | 'validation';
 }
+type RulePropertySchema = Record<'field' | 'section' | 'action' | 'row' | 'column', RulePropertyDefinition[]>;
 
 interface PatchResult {
     success: boolean;
@@ -256,136 +377,63 @@ interface AiConfigAdapter<TConfig = any> {
     applyPatch(patch: Partial<TConfig>, intent?: string): Promise<PatchResult>;
 }
 
-declare const AI_STREAM_EVENT_TYPES: readonly ["status", "thought.step", "heartbeat", "result", "error", "cancelled"];
-type AiJsonPrimitive = string | number | boolean | null;
-type AiJsonArray = AiJsonValue[];
-interface AiJsonObject {
-    [key: string]: AiJsonValue;
-}
-type AiJsonValue = AiJsonPrimitive | AiJsonObject | AiJsonArray;
-interface AiSchemaContextContract {
-    path?: string | null;
-    operation?: string | null;
-    schemaType?: string | null;
-}
-interface AiChatMessageContract {
-    role: 'user' | 'assistant' | 'system';
-    content: string;
-}
-interface AiUiContextRefContract {
-    componentType?: string | null;
-    componentId?: string | null;
-    routeKey?: string | null;
-    schemaHash?: string | null;
-    variantId?: string | null;
-}
-interface AiCurrentStateDigestContract {
-    columns?: string[] | null;
-    sort?: string | null;
-    rowCount?: number | null;
-}
-interface AiOrchestratorRequestContract {
-    componentId: string;
-    componentType: string;
-    userPrompt?: string;
-    sessionId?: string;
-    mode?: 'new' | 'continue';
-    clientTurnId?: string;
-    messages?: AiChatMessageContract[];
-    summary?: string;
-    uiContextRef?: AiUiContextRefContract;
-    currentStateDigest?: AiCurrentStateDigestContract;
-    currentState: AiJsonObject;
-    dataProfile?: AiJsonObject | null;
-    schemaFields?: AiJsonObject[] | null;
-    runtimeState?: AiJsonObject | null;
-    suggestedPatch?: AiJsonObject | null;
-    contextHints?: AiJsonObject | null;
-    aiMode?: string;
-    requireSchema?: boolean;
-    resourcePath?: string;
-    contractVersion?: string;
-    schemaHash?: string;
-    schemaContext?: AiSchemaContextContract | null;
-    variantId?: string;
-    apiMethod?: string;
-    apiTags?: string;
-    apiSearchLimit?: number;
-}
-type AiOrchestratorResponseType = 'patch' | 'clarification' | 'error' | 'info';
-interface AiPatchDiffContract {
-    path: string;
-    before?: AiJsonValue;
-    after?: AiJsonValue;
-}
-interface AiOptionContract {
-    value?: string | null;
-    label?: string | null;
-    example?: string | null;
-    contextHints?: AiJsonObject | null;
-}
-interface AiClarificationUiContract {
-    responseType?: 'text' | 'choice' | 'confirm' | 'mixed' | 'context';
-    selectionMode?: 'single' | 'multiple';
-    presentation?: 'buttons' | 'list' | 'chips';
-    allowCustom?: boolean | null;
-}
-interface AiMemoryInfoContract {
-    summaryUpdated?: boolean | null;
-    windowSize?: number | null;
-    cached?: boolean | null;
-}
-interface AiOrchestratorResponseContract {
-    sessionId?: string | null;
-    code?: string | null;
-    type?: AiOrchestratorResponseType;
-    contractVersion?: string | null;
-    schemaHash?: string | null;
-    patch?: AiJsonObject | null;
-    diff?: AiPatchDiffContract[] | null;
-    explanation?: string | null;
-    warnings?: string[] | null;
-    message?: string | null;
-    options?: string[] | null;
-    optionPayloads?: AiOptionContract[] | null;
-    contextRequest?: number[] | null;
-    clarification?: AiClarificationUiContract;
-    componentId?: string | null;
-    componentType?: string | null;
-    path?: string | null;
-    providedValue?: AiJsonValue;
-    allowedValues?: string[] | null;
-    memory?: AiMemoryInfoContract;
-}
-interface AiPatchStreamStartResponseContract {
-    streamId: string;
-    threadId: string;
-    turnId: string;
-    eventSchemaVersion: string;
-    streamAuthMode?: 'cookie' | 'signed_url_token' | null;
-    streamAccessToken?: string | null;
-    expiresAt: string;
-    fallbackPatchUrl: string;
+/**
+ * Base implementation for AI Adapters.
+ * Provides common validation logic against the Capabilities Catalog.
+ */
+declare abstract class BaseAiAdapter<TConfig = any> implements AiConfigAdapter<TConfig> {
+    abstract componentName: string;
+    abstract getCurrentConfig(): TConfig;
+    abstract getCapabilities(): Capability[];
+    abstract applyPatch(patch: Partial<TConfig>, intent?: string): Promise<PatchResult>;
+    abstract createSnapshot(): any;
+    abstract restoreSnapshot(snapshot: any): Promise<void>;
+    getTaskPresets?(): Record<string, string[]>;
+    getSuggestions(_forceReload?: boolean): Promise<AiSuggestion[]>;
+    getSuggestionContext?(): Record<string, any>;
+    getRuntimeState?(): Record<string, any>;
+    /**
+     * Helper to validate a patch against the capabilities catalog.
+     * Removes keys that are not in the allowed paths.
+     */
+    protected validatePatchAgainstCapabilities(patch: any): any;
+    /**
+     * Helper to check if a patch contains critical changes.
+     */
+    protected getCriticalWarnings(patch: any): string[];
 }
-interface AiPatchStreamCancelResponseContract {
-    streamId?: string | null;
-    threadId?: string | null;
-    turnId?: string | null;
-    terminalState: 'cancelled' | 'completed' | 'not_found';
-    message?: string | null;
+
+interface FieldSchemaLike {
+    label: string;
+    type: string;
+    description?: string;
+    required?: boolean;
+    uiConfig?: {
+        category?: string;
+    };
+    allowedValues?: Array<{
+        value: any;
+        label: string;
+    }>;
 }
-interface AiPatchStreamEnvelopeContract<TPayload extends AiJsonObject = AiJsonObject> {
-    eventId?: string | null;
-    streamId: string;
-    threadId: string;
-    turnId: string;
-    seq: number;
-    eventSchemaVersion: string;
-    timestamp: string;
-    type: AiPatchStreamEventType$1;
-    payload: TPayload;
+declare class SchemaMinifierService {
+    /**
+     * Converts complete FieldSchemas into a minified version for AI context (Token optimized)
+     */
+    minify(schemas: Record<string, FieldSchemaLike>): MinifiedField[];
+    /**
+     * Formats minified fields into a string for the AI prompt (Legacy/Text mode)
+     */
+    toPromptFormat(fields: MinifiedField[]): string;
+    /**
+     * Transforms Praxis FieldSchemas into Google Gemini JSON Schema format.
+     * This enables "Response Schema" enforcement in the API.
+     */
+    toGeminiSchema(fields: Record<string, FieldSchemaLike>): Schema;
+    private mapTypeToGemini;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SchemaMinifierService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SchemaMinifierService>;
 }
-type AiPatchStreamEventType$1 = (typeof AI_STREAM_EVENT_TYPES)[number];
 
 declare const AI_INTENT_CONTRACT_VERSION: "v1.1";
 declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "51b7901f1df633d89fc019a2e41f675cc5b87b135dfc8335aa96e53205034b26";
@@ -475,184 +523,67 @@ interface AiProviderStatusResponse {
     success?: boolean;
     message?: string;
 }
-interface AiContextTemplateMeta {
-    variants?: Array<{
-        id?: string;
-        registryKey?: string;
-    } | string>;
-    defaultVariantId?: string;
-}
-interface AiContextTemplate {
-    templateMeta?: AiContextTemplateMeta;
-}
-interface AiContextDTO {
-    componentId?: string;
-    componentType?: string;
-    template?: AiContextTemplate | null;
-}
-interface AiHeaderContext {
-    tenantId: string;
-    env: string;
-    userId: string;
-    missing: string[];
-}
-declare class AiBackendApiService {
-    private readonly http;
-    private readonly globalConfig;
-    private readonly storageOpts;
-    private readonly baseUrl;
-    private readonly contextUrl;
-    getSuggestions(request: AiSuggestionsRequest): Observable<AiSuggestionsResponse>;
-    getPatch(request: AiOrchestratorRequest): Observable<AiOrchestratorResponse>;
-    startPatchStream(request: AiOrchestratorRequest): Observable<AiPatchStreamStartResponse>;
-    connectPatchStream(streamId: string, lastEventId?: string, accessToken?: string): AiPatchStreamConnection;
-    cancelPatchStream(streamId: string, accessToken?: string): Observable<AiPatchStreamCancelResponse>;
-    listModels(request: AiProviderModelsRequest): Observable<AiProviderModelsResponse>;
-    listProviderCatalog(): Observable<AiProviderCatalogResponse>;
-    testProvider(request: AiProviderTestRequest): Observable<AiProviderTestResponse>;
-    getAiStatus(): Observable<AiProviderStatusResponse>;
-    getAiContext(componentId: string, componentType: string): Observable<AiContextDTO>;
-    loadGlobalAiConfig(): Observable<GlobalAiConfig | null>;
-    saveGlobalAiConfig(aiConfig: GlobalAiConfig): Observable<void>;
-    getHeaderContext(): AiHeaderContext;
-    private buildHeaders;
-    private normalizeContractVersion;
-    private normalizeContractSchemaHash;
-    private resolveHeaderMap;
-    private parsePatchStreamEnvelope;
-    private isPatchStreamEnvelope;
-    private isJsonObject;
-    private probePatchStreamEndpoint;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AiBackendApiService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AiBackendApiService>;
-}
-
-interface FieldSchemaLike {
-    label: string;
-    type: string;
-    description?: string;
-    required?: boolean;
-    uiConfig?: {
-        category?: string;
-    };
-    allowedValues?: Array<{
-        value: any;
-        label: string;
-    }>;
-}
-declare class SchemaMinifierService {
-    /**
-     * Converts complete FieldSchemas into a minified version for AI context (Token optimized)
-     */
-    minify(schemas: Record<string, FieldSchemaLike>): MinifiedField[];
-    /**
-     * Formats minified fields into a string for the AI prompt (Legacy/Text mode)
-     */
-    toPromptFormat(fields: MinifiedField[]): string;
-    /**
-     * Transforms Praxis FieldSchemas into Google Gemini JSON Schema format.
-     * This enables "Response Schema" enforcement in the API.
-     */
-    toGeminiSchema(fields: Record<string, FieldSchemaLike>): Schema;
-    private mapTypeToGemini;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SchemaMinifierService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SchemaMinifierService>;
-}
-
-declare class AiContextBuilderService {
-    private schemaMinifier;
-    constructor(schemaMinifier: SchemaMinifierService);
-    /**
-     * Builds the complete context for the AI prompt
-     */
-    buildPromptContext(fieldSchemas: Record<string, FieldSchemaLike>, targetType: 'field' | 'section' | 'action' | 'row' | 'column', propertySchema: RulePropertySchema): PromptContext;
-    buildRulePrompt(userPrompt: string, context: PromptContext): string;
-    buildSuggestionPrompt(context: PromptContext): string;
-    /**
-     * Formats available properties by targetType
-     */
-    private formatProperties;
-    /**
-     * Lists DSL operators with examples
-     */
-    private formatOperators;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AiContextBuilderService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AiContextBuilderService>;
-}
-
-/**
- * Normalize DSL expression by replacing aliases with standard operators
- */
-declare function normalizeDsl(dsl: string): string;
-/**
- * Configuration for parsing DSL expressions
- */
-interface DslParsingConfig {
-    /** Available function registry */
-    functionRegistry?: FunctionRegistry<any>;
-    /** Context provider for variable resolution */
-    contextProvider?: ContextProvider;
-    /** Known field names for validation */
-    knownFields?: string[];
-    /** Enable performance warnings */
-    enablePerformanceWarnings?: boolean;
-    /** Maximum expression complexity */
-    maxComplexity?: number;
+interface AiContextTemplateMeta {
+    variants?: Array<{
+        id?: string;
+        registryKey?: string;
+    } | string>;
+    defaultVariantId?: string;
 }
-/**
- * Result of parsing a DSL expression
- */
-interface DslParsingResult<T extends object = any> {
-    /** Whether parsing was successful */
-    success: boolean;
-    /** Parsed specification (if successful) */
-    specification?: any;
-    /** Validation issues found */
-    issues: ValidationIssue[];
-    /** Performance metrics */
-    metrics?: {
-        parseTime: number;
-        complexity: number;
-    };
+interface AiContextTemplate {
+    templateMeta?: AiContextTemplateMeta;
 }
-/**
- * Dedicated service for DSL parsing and validation
- * Extracted from SpecificationBridgeService to follow SRP
- */
-declare class DslParsingService {
-    constructor();
-    /**
-     * Parse a DSL expression into a specification
-     */
-    parseDsl<T extends object = any>(dslExpression: string, config?: DslParsingConfig): DslParsingResult<T>;
-    /**
-     * Normalize DSL expression (delegates to utility)
-     */
-    normalizeDsl(dsl: string): string;
-    /**
-     * Static wrapper for backward compatibility if needed
-     */
-    static normalizeDsl(dsl: string): string;
-    /**
-     * Validate DSL syntax without parsing
-     */
-    validateDsl(dslExpression: string, config?: DslParsingConfig): ValidationIssue[];
-    /**
-     * Get suggestions for DSL completion
-     */
-    getDslSuggestions(partialExpression: string, cursorPosition: number, config?: DslParsingConfig): string[];
-    /**
-     * Format DSL expression for readability
-     */
-    formatDsl(dslExpression: string): string;
-    /**
-     * Check if DSL expression is syntactically valid
-     */
-    isValidDsl(dslExpression: string, config?: DslParsingConfig): boolean;
-    private calculateComplexity;
-    private getCurrentToken;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DslParsingService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<DslParsingService>;
+interface AiContextDTO {
+    componentId?: string;
+    componentType?: string;
+    template?: AiContextTemplate | null;
+}
+interface AiHeaderContext {
+    tenantId: string;
+    env: string;
+    userId: string;
+    missing: string[];
+}
+interface AiGlobalConfigSnapshot {
+    provider?: string;
+    apiKey?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    timeout?: number;
+    retryAttempts?: number;
+    gatewayUrl?: string;
+    riskPolicy?: string;
+}
+declare class AiBackendApiService {
+    private readonly http;
+    private readonly globalConfigStore;
+    private readonly storageOpts;
+    private readonly baseUrl;
+    private readonly contextUrl;
+    getSuggestions(request: AiSuggestionsRequest): Observable<AiSuggestionsResponse>;
+    getPatch(request: AiOrchestratorRequest): Observable<AiOrchestratorResponse>;
+    startPatchStream(request: AiOrchestratorRequest): Observable<AiPatchStreamStartResponse>;
+    connectPatchStream(streamId: string, lastEventId?: string, accessToken?: string): AiPatchStreamConnection;
+    cancelPatchStream(streamId: string, accessToken?: string): Observable<AiPatchStreamCancelResponse>;
+    listModels(request: AiProviderModelsRequest): Observable<AiProviderModelsResponse>;
+    listProviderCatalog(): Observable<AiProviderCatalogResponse>;
+    testProvider(request: AiProviderTestRequest): Observable<AiProviderTestResponse>;
+    getAiStatus(): Observable<AiProviderStatusResponse>;
+    getAiContext(componentId: string, componentType: string): Observable<AiContextDTO>;
+    loadGlobalAiConfig(): Observable<AiGlobalConfigSnapshot | null>;
+    saveGlobalAiConfig(aiConfig: AiGlobalConfigSnapshot): Observable<void>;
+    getHeaderContext(): AiHeaderContext;
+    private buildHeaders;
+    private normalizeContractVersion;
+    private normalizeContractSchemaHash;
+    private resolveHeaderMap;
+    private parsePatchStreamEnvelope;
+    private isPatchStreamEnvelope;
+    private isJsonObject;
+    private probePatchStreamEndpoint;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AiBackendApiService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AiBackendApiService>;
 }
 
 interface ValidationContext {
@@ -661,14 +592,17 @@ interface ValidationContext {
     propertySchema: RulePropertySchema;
 }
 declare class AiResponseValidatorService {
-    private dslParsingService;
-    constructor(dslParsingService: DslParsingService);
     /**
      * Validates the complete AI response
      */
     validate(response: AiRuleResponse, context: ValidationContext): AiValidationResult;
     private validateStructure;
     private validateTargetIds;
+    private validateCondition;
+    private validateJsonLogicExpression;
+    private walkJsonLogicNode;
+    private isSupportedJsonLogicOperator;
+    private collectVarPaths;
     private isValidTargetId;
     private findSimilarTargetId;
     private calculateSimilarity;
@@ -678,114 +612,6 @@ declare class AiResponseValidatorService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AiResponseValidatorService>;
 }
 
-interface AiWizardData {
-    fieldSchemas: Record<string, FieldSchemaLike>;
-    targetSchemas?: any;
-    propertySchema: RulePropertySchema;
-}
-type WizardStep = 'prompt' | 'review';
-declare class AiRuleWizardDialogComponent implements OnInit {
-    dialogRef: MatDialogRef<AiRuleWizardDialogComponent>;
-    data: AiWizardData;
-    private aiService;
-    private validator;
-    private snackBar;
-    private contextBuilder;
-    private cdr;
-    selectedTargetType: 'field' | 'section' | 'action' | 'row' | 'column';
-    userPrompt: string;
-    isGenerating: boolean;
-    validationError: string | null;
-    loadingSuggestions: boolean;
-    suggestions: string[];
-    private suggestionsCache;
-    private suggestionsRequestId;
-    currentStep: WizardStep;
-    generatedResponse: AiRuleResponse | null;
-    warnings: AiValidationWarning[];
-    loadingMessages: string[];
-    currentLoadingMessage: string;
-    streamingText: string;
-    private loadingInterval;
-    constructor(dialogRef: MatDialogRef<AiRuleWizardDialogComponent>, data: AiWizardData, aiService: PraxisAiService, validator: AiResponseValidatorService, snackBar: MatSnackBar, contextBuilder: AiContextBuilderService, cdr: ChangeDetectorRef);
-    ngOnInit(): void;
-    onTargetTypeChange(): void;
-    getAvailableProperties(): _praxisui_core.RulePropertyDefinition[];
-    loadSuggestions(forceRefresh?: boolean): Promise<void>;
-    reloadSuggestions(): void;
-    applySuggestion(text: string): void;
-    generate(): Promise<void>;
-    private startLoadingUX;
-    private stopLoadingUX;
-    backToPrompt(): void;
-    confirm(): void;
-    getProps(obj: any): {
-        key: string;
-        value: any;
-    }[];
-    hasProps(obj: any): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AiRuleWizardDialogComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AiRuleWizardDialogComponent, "praxis-ai-rule-wizard-dialog", never, {}, {}, never, never, true, never>;
-}
-
-declare class StreamingFeedbackComponent {
-    title: string;
-    displayText: string;
-    isThinking: boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<StreamingFeedbackComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<StreamingFeedbackComponent, "praxis-ai-streaming-feedback", never, { "title": { "alias": "title"; "required": false; }; "displayText": { "alias": "displayText"; "required": false; }; "isThinking": { "alias": "isThinking"; "required": false; }; }, {}, never, never, true, never>;
-}
-
-interface ConfigAgentRequest {
-    adapter: AiConfigAdapter;
-    userIntent: string;
-}
-interface ConfigAgentResponse {
-    patch: any;
-    explanation: string;
-    applied: boolean;
-    mockMode: boolean;
-}
-declare class AiConfigAgentService {
-    private ai;
-    constructor(ai: PraxisAiService);
-    isMockMode(): boolean;
-    /**
-     * Legacy single-shot flow: builds a prompt with full config + capabilities.
-     * Two-step flow is preferred (see TableAiAdapter.processUserIntent), but this remains as fallback.
-     */
-    generateConfigPatch(request: ConfigAgentRequest): Promise<ConfigAgentResponse>;
-    private buildPrompt;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AiConfigAgentService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AiConfigAgentService>;
-}
-
-/**
- * Base implementation for AI Adapters.
- * Provides common validation logic against the Capabilities Catalog.
- */
-declare abstract class BaseAiAdapter<TConfig = any> implements AiConfigAdapter<TConfig> {
-    abstract componentName: string;
-    abstract getCurrentConfig(): TConfig;
-    abstract getCapabilities(): Capability[];
-    abstract applyPatch(patch: Partial<TConfig>, intent?: string): Promise<PatchResult>;
-    abstract createSnapshot(): any;
-    abstract restoreSnapshot(snapshot: any): Promise<void>;
-    getTaskPresets?(): Record<string, string[]>;
-    getSuggestions(_forceReload?: boolean): Promise<AiSuggestion[]>;
-    getSuggestionContext?(): Record<string, any>;
-    getRuntimeState?(): Record<string, any>;
-    /**
-     * Helper to validate a patch against the capabilities catalog.
-     * Removes keys that are not in the allowed paths.
-     */
-    protected validatePatchAgainstCapabilities(patch: any): any;
-    /**
-     * Helper to check if a patch contains critical changes.
-     */
-    protected getCriticalWarnings(patch: any): string[];
-}
-
 type AssistantMessageRole = 'user' | 'assistant' | 'system';
 interface AssistantHistoryMessage {
     id: string;
@@ -1212,5 +1038,105 @@ declare class PraxisAiAssistantComponent implements OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisAiAssistantComponent, "praxis-ai-assistant", never, { "adapter": { "alias": "adapter"; "required": true; }; "riskPolicy": { "alias": "riskPolicy"; "required": false; }; "allowManualPatchEdit": { "alias": "allowManualPatchEdit"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-export { AI_INTENT_CONTRACT_SCHEMA_HASH, AI_INTENT_CONTRACT_VERSION, AiBackendApiService, AiConfigAgentService, AiConfigService, AiContextBuilderService, AiPatchStreamConnectionError, AiResponseValidatorService, AiRuleWizardDialogComponent, BaseAiAdapter, DslParsingService, PraxisAi, PraxisAiAssistantComponent, PraxisAiService, SchemaMinifierService, StreamingFeedbackComponent, normalizeDsl };
-export type { AiChatMessage, AiConfigAdapter, AiContextDTO, AiContextTemplate, AiContextTemplateMeta, AiCurrentStateDigest, AiExamplePair, AiHeaderContext, AiIntegrationConfig, AiModel, AiOrchestratorRequest, AiOrchestratorResponse, AiPatchDiff, AiPatchStreamCancelResponse, AiPatchStreamConnection, AiPatchStreamConnectionErrorKind, AiPatchStreamEnvelope, AiPatchStreamEventType, AiPatchStreamStartResponse, AiProviderCatalogItem, AiProviderCatalogResponse, AiProviderModelsRequest, AiProviderModelsResponse, AiProviderStatusResponse, AiProviderTestRequest, AiProviderTestResponse, AiRuleResponse, AiSchemaContext, AiSuggestion, AiSuggestionsRequest, AiSuggestionsResponse, AiUiContextRef, AiValidationError, AiValidationResult, AiValidationWarning, AiWizardData, Capability, ConfigAgentRequest, ConfigAgentResponse, DslParsingConfig, DslParsingResult, FieldSchemaLike, MinifiedField, PatchResult, PromptContext, ValidationContext, ValueKind };
+interface PraxisAiConfigSource {
+    getAiConfigSnapshot?: () => Partial<AiIntegrationConfig> | null | undefined;
+    aiConfigChanges$?: Observable<Partial<AiIntegrationConfig> | null>;
+}
+declare class PraxisAiService {
+    private readonly configSource;
+    private genAI;
+    private config;
+    constructor(configSource: PraxisAiConfigSource | null);
+    private syncConfig;
+    classifyIntent(userInput: string, columns: string[]): Observable<any>;
+    answerQuestion(userInput: string, targetConfig: any): Observable<string>;
+    executeEnrichedPrompt(userInput: string, contextDescription: string, targetConfig: any, capabilities: any): Observable<any>;
+    private formatCapabilities;
+    private normalizeIntentClassification;
+    generateContent(prompt: string, modelName?: string): Observable<string>;
+    generateContentStream(prompt: string, modelName?: string): Observable<string>;
+    generateJson<T>(prompt: string, modelName?: string, schema?: any): Observable<T | null>;
+    isMockMode(): boolean;
+    private extractUserIntent;
+    private getMockPatch;
+    listModels(apiKey?: string): Observable<AiModel[]>;
+    testConnection(apiKey?: string, model?: string): Observable<boolean>;
+    private resolveProvider;
+    private isGeminiProvider;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisAiService, [{ optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PraxisAiService>;
+}
+
+declare class AiContextBuilderService {
+    private schemaMinifier;
+    constructor(schemaMinifier: SchemaMinifierService);
+    /**
+     * Builds the complete context for the AI prompt
+     */
+    buildPromptContext(fieldSchemas: Record<string, FieldSchemaLike>, targetType: 'field' | 'section' | 'action' | 'row' | 'column', propertySchema: RulePropertySchema): PromptContext;
+    buildRulePrompt(userPrompt: string, context: PromptContext): string;
+    buildSuggestionPrompt(context: PromptContext): string;
+    /**
+     * Formats available properties by targetType
+     */
+    private formatProperties;
+    /**
+     * Lists JSON Logic operators with examples
+     */
+    private formatOperators;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AiContextBuilderService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AiContextBuilderService>;
+}
+
+interface AiWizardData {
+    fieldSchemas: Record<string, FieldSchemaLike>;
+    targetSchemas?: any;
+    propertySchema: RulePropertySchema;
+}
+type WizardStep = 'prompt' | 'review';
+declare class AiRuleWizardDialogComponent implements OnInit {
+    dialogRef: MatDialogRef<AiRuleWizardDialogComponent>;
+    data: AiWizardData;
+    private aiService;
+    private validator;
+    private snackBar;
+    private contextBuilder;
+    private cdr;
+    selectedTargetType: 'field' | 'section' | 'action' | 'row' | 'column';
+    userPrompt: string;
+    isGenerating: boolean;
+    validationError: string | null;
+    loadingSuggestions: boolean;
+    suggestions: string[];
+    private suggestionsCache;
+    private suggestionsRequestId;
+    currentStep: WizardStep;
+    generatedResponse: AiRuleResponse | null;
+    warnings: AiValidationWarning[];
+    loadingMessages: string[];
+    currentLoadingMessage: string;
+    streamingText: string;
+    private loadingInterval;
+    constructor(dialogRef: MatDialogRef<AiRuleWizardDialogComponent>, data: AiWizardData, aiService: PraxisAiService, validator: AiResponseValidatorService, snackBar: MatSnackBar, contextBuilder: AiContextBuilderService, cdr: ChangeDetectorRef);
+    ngOnInit(): void;
+    onTargetTypeChange(): void;
+    getAvailableProperties(): _praxisui_ai.RulePropertyDefinition[];
+    loadSuggestions(forceRefresh?: boolean): Promise<void>;
+    reloadSuggestions(): void;
+    applySuggestion(text: string): void;
+    generate(): Promise<void>;
+    private startLoadingUX;
+    private stopLoadingUX;
+    backToPrompt(): void;
+    confirm(): void;
+    getProps(obj: any): {
+        key: string;
+        value: any;
+    }[];
+    hasProps(obj: any): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AiRuleWizardDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AiRuleWizardDialogComponent, "praxis-ai-rule-wizard-dialog", never, {}, {}, never, never, true, never>;
+}
+
+export { AI_INTENT_CONTRACT_SCHEMA_HASH, AI_INTENT_CONTRACT_VERSION, AiBackendApiService, AiPatchStreamConnectionError, AiResponseValidatorService, AiRuleWizardDialogComponent, BaseAiAdapter, PraxisAi, PraxisAiAssistantComponent, SchemaMinifierService };
+export type { AiChatMessage, AiConfigAdapter, AiContextDTO, AiContextTemplate, AiContextTemplateMeta, AiCurrentStateDigest, AiExamplePair, AiGlobalConfigSnapshot, AiHeaderContext, AiIntegrationConfig, AiModel, AiOrchestratorRequest, AiOrchestratorResponse, AiPatchDiff, AiPatchStreamCancelResponse, AiPatchStreamConnection, AiPatchStreamConnectionErrorKind, AiPatchStreamEnvelope, AiPatchStreamEventType, AiPatchStreamStartResponse, AiProviderCatalogItem, AiProviderCatalogResponse, AiProviderModelsRequest, AiProviderModelsResponse, AiProviderStatusResponse, AiProviderTestRequest, AiProviderTestResponse, AiRuleResponse, AiSchemaContext, AiSuggestion, AiSuggestionsRequest, AiSuggestionsResponse, AiUiContextRef, AiValidationError, AiValidationResult, AiValidationWarning, AiWizardData, Capability, FieldSchemaLike, MinifiedField, PatchResult, PromptContext, RulePropertyDefinition, RulePropertySchema, RulePropertyType, ValidationContext, ValueKind };