@objectstack/spec 0.2.0 → 0.3.1

package/dist/ai/nlq.zod.d.ts

@@ -0,0 +1,1126 @@
+import { z } from 'zod';
+/**
+ * Natural Language Query (NLQ) Protocol
+ *
+ * Transforms natural language queries into ObjectQL AST (Abstract Syntax Tree).
+ * Enables business users to query data using natural language instead of writing code.
+ */
+/**
+ * Query Intent Type
+ */
+export declare const QueryIntentSchema: z.ZodEnum<["select", "aggregate", "filter", "sort", "compare", "trend", "insight", "create", "update", "delete"]>;
+/**
+ * Entity Recognition
+ */
+export declare const EntitySchema: z.ZodObject<{
+    type: z.ZodEnum<["object", "field", "value", "operator", "function", "timeframe"]>;
+    text: z.ZodString;
+    value: z.ZodAny;
+    confidence: z.ZodNumber;
+    span: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    type: "object" | "function" | "value" | "field" | "operator" | "timeframe";
+    confidence: number;
+    value?: any;
+    span?: [number, number] | undefined;
+}, {
+    text: string;
+    type: "object" | "function" | "value" | "field" | "operator" | "timeframe";
+    confidence: number;
+    value?: any;
+    span?: [number, number] | undefined;
+}>;
+/**
+ * Timeframe Detection
+ */
+export declare const TimeframeSchema: z.ZodObject<{
+    type: z.ZodEnum<["absolute", "relative"]>;
+    start: z.ZodOptional<z.ZodString>;
+    end: z.ZodOptional<z.ZodString>;
+    relative: z.ZodOptional<z.ZodObject<{
+        unit: z.ZodEnum<["hour", "day", "week", "month", "quarter", "year"]>;
+        value: z.ZodNumber;
+        direction: z.ZodDefault<z.ZodEnum<["past", "future", "current"]>>;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+        direction: "past" | "future" | "current";
+    }, {
+        value: number;
+        unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+        direction?: "past" | "future" | "current" | undefined;
+    }>>;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    type: "absolute" | "relative";
+    start?: string | undefined;
+    end?: string | undefined;
+    relative?: {
+        value: number;
+        unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+        direction: "past" | "future" | "current";
+    } | undefined;
+}, {
+    text: string;
+    type: "absolute" | "relative";
+    start?: string | undefined;
+    end?: string | undefined;
+    relative?: {
+        value: number;
+        unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+        direction?: "past" | "future" | "current" | undefined;
+    } | undefined;
+}>;
+/**
+ * NLQ Field Mapping
+ * Maps natural language field names to actual object fields
+ */
+export declare const NLQFieldMappingSchema: z.ZodObject<{
+    naturalLanguage: z.ZodString;
+    objectField: z.ZodString;
+    object: z.ZodString;
+    field: z.ZodString;
+    confidence: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    object: string;
+    field: string;
+    confidence: number;
+    naturalLanguage: string;
+    objectField: string;
+}, {
+    object: string;
+    field: string;
+    confidence: number;
+    naturalLanguage: string;
+    objectField: string;
+}>;
+/**
+ * Query Context
+ */
+export declare const QueryContextSchema: z.ZodObject<{
+    /** User Information */
+    userId: z.ZodOptional<z.ZodString>;
+    userRole: z.ZodOptional<z.ZodString>;
+    /** Current Context */
+    currentObject: z.ZodOptional<z.ZodString>;
+    currentRecordId: z.ZodOptional<z.ZodString>;
+    /** Conversation History */
+    conversationHistory: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        query: z.ZodString;
+        timestamp: z.ZodString;
+        intent: z.ZodOptional<z.ZodEnum<["select", "aggregate", "filter", "sort", "compare", "trend", "insight", "create", "update", "delete"]>>;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        query: string;
+        intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+    }, {
+        timestamp: string;
+        query: string;
+        intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+    }>, "many">>;
+    /** Preferences */
+    defaultLimit: z.ZodDefault<z.ZodNumber>;
+    timezone: z.ZodDefault<z.ZodString>;
+    locale: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    locale: string;
+    timezone: string;
+    defaultLimit: number;
+    userId?: string | undefined;
+    conversationHistory?: {
+        timestamp: string;
+        query: string;
+        intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+    }[] | undefined;
+    userRole?: string | undefined;
+    currentObject?: string | undefined;
+    currentRecordId?: string | undefined;
+}, {
+    userId?: string | undefined;
+    locale?: string | undefined;
+    timezone?: string | undefined;
+    conversationHistory?: {
+        timestamp: string;
+        query: string;
+        intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+    }[] | undefined;
+    userRole?: string | undefined;
+    currentObject?: string | undefined;
+    currentRecordId?: string | undefined;
+    defaultLimit?: number | undefined;
+}>;
+/**
+ * NLQ Parse Result
+ */
+export declare const NLQParseResultSchema: z.ZodObject<{
+    /** Original Query */
+    originalQuery: z.ZodString;
+    /** Intent Detection */
+    intent: z.ZodEnum<["select", "aggregate", "filter", "sort", "compare", "trend", "insight", "create", "update", "delete"]>;
+    intentConfidence: z.ZodNumber;
+    /** Entity Recognition */
+    entities: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["object", "field", "value", "operator", "function", "timeframe"]>;
+        text: z.ZodString;
+        value: z.ZodAny;
+        confidence: z.ZodNumber;
+        span: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        type: "object" | "function" | "value" | "field" | "operator" | "timeframe";
+        confidence: number;
+        value?: any;
+        span?: [number, number] | undefined;
+    }, {
+        text: string;
+        type: "object" | "function" | "value" | "field" | "operator" | "timeframe";
+        confidence: number;
+        value?: any;
+        span?: [number, number] | undefined;
+    }>, "many">;
+    /** Object & Field Resolution */
+    targetObject: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        naturalLanguage: z.ZodString;
+        objectField: z.ZodString;
+        object: z.ZodString;
+        field: z.ZodString;
+        confidence: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        object: string;
+        field: string;
+        confidence: number;
+        naturalLanguage: string;
+        objectField: string;
+    }, {
+        object: string;
+        field: string;
+        confidence: number;
+        naturalLanguage: string;
+        objectField: string;
+    }>, "many">>;
+    /** Temporal Information */
+    timeframe: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["absolute", "relative"]>;
+        start: z.ZodOptional<z.ZodString>;
+        end: z.ZodOptional<z.ZodString>;
+        relative: z.ZodOptional<z.ZodObject<{
+            unit: z.ZodEnum<["hour", "day", "week", "month", "quarter", "year"]>;
+            value: z.ZodNumber;
+            direction: z.ZodDefault<z.ZodEnum<["past", "future", "current"]>>;
+        }, "strip", z.ZodTypeAny, {
+            value: number;
+            unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+            direction: "past" | "future" | "current";
+        }, {
+            value: number;
+            unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+            direction?: "past" | "future" | "current" | undefined;
+        }>>;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        type: "absolute" | "relative";
+        start?: string | undefined;
+        end?: string | undefined;
+        relative?: {
+            value: number;
+            unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+            direction: "past" | "future" | "current";
+        } | undefined;
+    }, {
+        text: string;
+        type: "absolute" | "relative";
+        start?: string | undefined;
+        end?: string | undefined;
+        relative?: {
+            value: number;
+            unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+            direction?: "past" | "future" | "current" | undefined;
+        } | undefined;
+    }>>;
+    /** Query AST */
+    ast: z.ZodAny;
+    /** Metadata */
+    confidence: z.ZodNumber;
+    ambiguities: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        description: z.ZodString;
+        suggestions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        description: string;
+        suggestions?: string[] | undefined;
+    }, {
+        type: string;
+        description: string;
+        suggestions?: string[] | undefined;
+    }>, "many">>;
+    /** Alternative Interpretations */
+    alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        interpretation: z.ZodString;
+        confidence: z.ZodNumber;
+        ast: z.ZodAny;
+    }, "strip", z.ZodTypeAny, {
+        confidence: number;
+        interpretation: string;
+        ast?: any;
+    }, {
+        confidence: number;
+        interpretation: string;
+        ast?: any;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    confidence: number;
+    intent: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight";
+    originalQuery: string;
+    intentConfidence: number;
+    entities: {
+        text: string;
+        type: "object" | "function" | "value" | "field" | "operator" | "timeframe";
+        confidence: number;
+        value?: any;
+        span?: [number, number] | undefined;
+    }[];
+    fields?: {
+        object: string;
+        field: string;
+        confidence: number;
+        naturalLanguage: string;
+        objectField: string;
+    }[] | undefined;
+    targetObject?: string | undefined;
+    timeframe?: {
+        text: string;
+        type: "absolute" | "relative";
+        start?: string | undefined;
+        end?: string | undefined;
+        relative?: {
+            value: number;
+            unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+            direction: "past" | "future" | "current";
+        } | undefined;
+    } | undefined;
+    ast?: any;
+    ambiguities?: {
+        type: string;
+        description: string;
+        suggestions?: string[] | undefined;
+    }[] | undefined;
+    alternatives?: {
+        confidence: number;
+        interpretation: string;
+        ast?: any;
+    }[] | undefined;
+}, {
+    confidence: number;
+    intent: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight";
+    originalQuery: string;
+    intentConfidence: number;
+    entities: {
+        text: string;
+        type: "object" | "function" | "value" | "field" | "operator" | "timeframe";
+        confidence: number;
+        value?: any;
+        span?: [number, number] | undefined;
+    }[];
+    fields?: {
+        object: string;
+        field: string;
+        confidence: number;
+        naturalLanguage: string;
+        objectField: string;
+    }[] | undefined;
+    targetObject?: string | undefined;
+    timeframe?: {
+        text: string;
+        type: "absolute" | "relative";
+        start?: string | undefined;
+        end?: string | undefined;
+        relative?: {
+            value: number;
+            unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+            direction?: "past" | "future" | "current" | undefined;
+        } | undefined;
+    } | undefined;
+    ast?: any;
+    ambiguities?: {
+        type: string;
+        description: string;
+        suggestions?: string[] | undefined;
+    }[] | undefined;
+    alternatives?: {
+        confidence: number;
+        interpretation: string;
+        ast?: any;
+    }[] | undefined;
+}>;
+/**
+ * NLQ Request
+ */
+export declare const NLQRequestSchema: z.ZodObject<{
+    /** Query */
+    query: z.ZodString;
+    /** Context */
+    context: z.ZodOptional<z.ZodObject<{
+        /** User Information */
+        userId: z.ZodOptional<z.ZodString>;
+        userRole: z.ZodOptional<z.ZodString>;
+        /** Current Context */
+        currentObject: z.ZodOptional<z.ZodString>;
+        currentRecordId: z.ZodOptional<z.ZodString>;
+        /** Conversation History */
+        conversationHistory: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            query: z.ZodString;
+            timestamp: z.ZodString;
+            intent: z.ZodOptional<z.ZodEnum<["select", "aggregate", "filter", "sort", "compare", "trend", "insight", "create", "update", "delete"]>>;
+        }, "strip", z.ZodTypeAny, {
+            timestamp: string;
+            query: string;
+            intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+        }, {
+            timestamp: string;
+            query: string;
+            intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+        }>, "many">>;
+        /** Preferences */
+        defaultLimit: z.ZodDefault<z.ZodNumber>;
+        timezone: z.ZodDefault<z.ZodString>;
+        locale: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        locale: string;
+        timezone: string;
+        defaultLimit: number;
+        userId?: string | undefined;
+        conversationHistory?: {
+            timestamp: string;
+            query: string;
+            intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+        }[] | undefined;
+        userRole?: string | undefined;
+        currentObject?: string | undefined;
+        currentRecordId?: string | undefined;
+    }, {
+        userId?: string | undefined;
+        locale?: string | undefined;
+        timezone?: string | undefined;
+        conversationHistory?: {
+            timestamp: string;
+            query: string;
+            intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+        }[] | undefined;
+        userRole?: string | undefined;
+        currentObject?: string | undefined;
+        currentRecordId?: string | undefined;
+        defaultLimit?: number | undefined;
+    }>>;
+    /** Options */
+    includeAlternatives: z.ZodDefault<z.ZodBoolean>;
+    maxAlternatives: z.ZodDefault<z.ZodNumber>;
+    minConfidence: z.ZodDefault<z.ZodNumber>;
+    /** Execution */
+    executeQuery: z.ZodDefault<z.ZodBoolean>;
+    maxResults: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    includeAlternatives: boolean;
+    maxAlternatives: number;
+    minConfidence: number;
+    executeQuery: boolean;
+    context?: {
+        locale: string;
+        timezone: string;
+        defaultLimit: number;
+        userId?: string | undefined;
+        conversationHistory?: {
+            timestamp: string;
+            query: string;
+            intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+        }[] | undefined;
+        userRole?: string | undefined;
+        currentObject?: string | undefined;
+        currentRecordId?: string | undefined;
+    } | undefined;
+    maxResults?: number | undefined;
+}, {
+    query: string;
+    context?: {
+        userId?: string | undefined;
+        locale?: string | undefined;
+        timezone?: string | undefined;
+        conversationHistory?: {
+            timestamp: string;
+            query: string;
+            intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+        }[] | undefined;
+        userRole?: string | undefined;
+        currentObject?: string | undefined;
+        currentRecordId?: string | undefined;
+        defaultLimit?: number | undefined;
+    } | undefined;
+    includeAlternatives?: boolean | undefined;
+    maxAlternatives?: number | undefined;
+    minConfidence?: number | undefined;
+    executeQuery?: boolean | undefined;
+    maxResults?: number | undefined;
+}>;
+/**
+ * NLQ Response
+ */
+export declare const NLQResponseSchema: z.ZodObject<{
+    /** Parse Result */
+    parseResult: z.ZodObject<{
+        /** Original Query */
+        originalQuery: z.ZodString;
+        /** Intent Detection */
+        intent: z.ZodEnum<["select", "aggregate", "filter", "sort", "compare", "trend", "insight", "create", "update", "delete"]>;
+        intentConfidence: z.ZodNumber;
+        /** Entity Recognition */
+        entities: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<["object", "field", "value", "operator", "function", "timeframe"]>;
+            text: z.ZodString;
+            value: z.ZodAny;
+            confidence: z.ZodNumber;
+            span: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            type: "object" | "function" | "value" | "field" | "operator" | "timeframe";
+            confidence: number;
+            value?: any;
+            span?: [number, number] | undefined;
+        }, {
+            text: string;
+            type: "object" | "function" | "value" | "field" | "operator" | "timeframe";
+            confidence: number;
+            value?: any;
+            span?: [number, number] | undefined;
+        }>, "many">;
+        /** Object & Field Resolution */
+        targetObject: z.ZodOptional<z.ZodString>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            naturalLanguage: z.ZodString;
+            objectField: z.ZodString;
+            object: z.ZodString;
+            field: z.ZodString;
+            confidence: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            object: string;
+            field: string;
+            confidence: number;
+            naturalLanguage: string;
+            objectField: string;
+        }, {
+            object: string;
+            field: string;
+            confidence: number;
+            naturalLanguage: string;
+            objectField: string;
+        }>, "many">>;
+        /** Temporal Information */
+        timeframe: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<["absolute", "relative"]>;
+            start: z.ZodOptional<z.ZodString>;
+            end: z.ZodOptional<z.ZodString>;
+            relative: z.ZodOptional<z.ZodObject<{
+                unit: z.ZodEnum<["hour", "day", "week", "month", "quarter", "year"]>;
+                value: z.ZodNumber;
+                direction: z.ZodDefault<z.ZodEnum<["past", "future", "current"]>>;
+            }, "strip", z.ZodTypeAny, {
+                value: number;
+                unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+                direction: "past" | "future" | "current";
+            }, {
+                value: number;
+                unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+                direction?: "past" | "future" | "current" | undefined;
+            }>>;
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            type: "absolute" | "relative";
+            start?: string | undefined;
+            end?: string | undefined;
+            relative?: {
+                value: number;
+                unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+                direction: "past" | "future" | "current";
+            } | undefined;
+        }, {
+            text: string;
+            type: "absolute" | "relative";
+            start?: string | undefined;
+            end?: string | undefined;
+            relative?: {
+                value: number;
+                unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+                direction?: "past" | "future" | "current" | undefined;
+            } | undefined;
+        }>>;
+        /** Query AST */
+        ast: z.ZodAny;
+        /** Metadata */
+        confidence: z.ZodNumber;
+        ambiguities: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            description: z.ZodString;
+            suggestions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            description: string;
+            suggestions?: string[] | undefined;
+        }, {
+            type: string;
+            description: string;
+            suggestions?: string[] | undefined;
+        }>, "many">>;
+        /** Alternative Interpretations */
+        alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            interpretation: z.ZodString;
+            confidence: z.ZodNumber;
+            ast: z.ZodAny;
+        }, "strip", z.ZodTypeAny, {
+            confidence: number;
+            interpretation: string;
+            ast?: any;
+        }, {
+            confidence: number;
+            interpretation: string;
+            ast?: any;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        confidence: number;
+        intent: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight";
+        originalQuery: string;
+        intentConfidence: number;
+        entities: {
+            text: string;
+            type: "object" | "function" | "value" | "field" | "operator" | "timeframe";
+            confidence: number;
+            value?: any;
+            span?: [number, number] | undefined;
+        }[];
+        fields?: {
+            object: string;
+            field: string;
+            confidence: number;
+            naturalLanguage: string;
+            objectField: string;
+        }[] | undefined;
+        targetObject?: string | undefined;
+        timeframe?: {
+            text: string;
+            type: "absolute" | "relative";
+            start?: string | undefined;
+            end?: string | undefined;
+            relative?: {
+                value: number;
+                unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+                direction: "past" | "future" | "current";
+            } | undefined;
+        } | undefined;
+        ast?: any;
+        ambiguities?: {
+            type: string;
+            description: string;
+            suggestions?: string[] | undefined;
+        }[] | undefined;
+        alternatives?: {
+            confidence: number;
+            interpretation: string;
+            ast?: any;
+        }[] | undefined;
+    }, {
+        confidence: number;
+        intent: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight";
+        originalQuery: string;
+        intentConfidence: number;
+        entities: {
+            text: string;
+            type: "object" | "function" | "value" | "field" | "operator" | "timeframe";
+            confidence: number;
+            value?: any;
+            span?: [number, number] | undefined;
+        }[];
+        fields?: {
+            object: string;
+            field: string;
+            confidence: number;
+            naturalLanguage: string;
+            objectField: string;
+        }[] | undefined;
+        targetObject?: string | undefined;
+        timeframe?: {
+            text: string;
+            type: "absolute" | "relative";
+            start?: string | undefined;
+            end?: string | undefined;
+            relative?: {
+                value: number;
+                unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+                direction?: "past" | "future" | "current" | undefined;
+            } | undefined;
+        } | undefined;
+        ast?: any;
+        ambiguities?: {
+            type: string;
+            description: string;
+            suggestions?: string[] | undefined;
+        }[] | undefined;
+        alternatives?: {
+            confidence: number;
+            interpretation: string;
+            ast?: any;
+        }[] | undefined;
+    }>;
+    /** Query Results (if executeQuery = true) */
+    results: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
+    totalCount: z.ZodOptional<z.ZodNumber>;
+    /** Execution Metadata */
+    executionTime: z.ZodOptional<z.ZodNumber>;
+    needsClarification: z.ZodBoolean;
+    /** Suggestions */
+    suggestions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    parseResult: {
+        confidence: number;
+        intent: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight";
+        originalQuery: string;
+        intentConfidence: number;
+        entities: {
+            text: string;
+            type: "object" | "function" | "value" | "field" | "operator" | "timeframe";
+            confidence: number;
+            value?: any;
+            span?: [number, number] | undefined;
+        }[];
+        fields?: {
+            object: string;
+            field: string;
+            confidence: number;
+            naturalLanguage: string;
+            objectField: string;
+        }[] | undefined;
+        targetObject?: string | undefined;
+        timeframe?: {
+            text: string;
+            type: "absolute" | "relative";
+            start?: string | undefined;
+            end?: string | undefined;
+            relative?: {
+                value: number;
+                unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+                direction: "past" | "future" | "current";
+            } | undefined;
+        } | undefined;
+        ast?: any;
+        ambiguities?: {
+            type: string;
+            description: string;
+            suggestions?: string[] | undefined;
+        }[] | undefined;
+        alternatives?: {
+            confidence: number;
+            interpretation: string;
+            ast?: any;
+        }[] | undefined;
+    };
+    needsClarification: boolean;
+    results?: Record<string, any>[] | undefined;
+    suggestions?: string[] | undefined;
+    totalCount?: number | undefined;
+    executionTime?: number | undefined;
+}, {
+    parseResult: {
+        confidence: number;
+        intent: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight";
+        originalQuery: string;
+        intentConfidence: number;
+        entities: {
+            text: string;
+            type: "object" | "function" | "value" | "field" | "operator" | "timeframe";
+            confidence: number;
+            value?: any;
+            span?: [number, number] | undefined;
+        }[];
+        fields?: {
+            object: string;
+            field: string;
+            confidence: number;
+            naturalLanguage: string;
+            objectField: string;
+        }[] | undefined;
+        targetObject?: string | undefined;
+        timeframe?: {
+            text: string;
+            type: "absolute" | "relative";
+            start?: string | undefined;
+            end?: string | undefined;
+            relative?: {
+                value: number;
+                unit: "day" | "week" | "month" | "quarter" | "year" | "hour";
+                direction?: "past" | "future" | "current" | undefined;
+            } | undefined;
+        } | undefined;
+        ast?: any;
+        ambiguities?: {
+            type: string;
+            description: string;
+            suggestions?: string[] | undefined;
+        }[] | undefined;
+        alternatives?: {
+            confidence: number;
+            interpretation: string;
+            ast?: any;
+        }[] | undefined;
+    };
+    needsClarification: boolean;
+    results?: Record<string, any>[] | undefined;
+    suggestions?: string[] | undefined;
+    totalCount?: number | undefined;
+    executionTime?: number | undefined;
+}>;
+/**
+ * NLQ Training Example
+ */
+export declare const NLQTrainingExampleSchema: z.ZodObject<{
+    /** Input */
+    query: z.ZodString;
+    context: z.ZodOptional<z.ZodObject<{
+        /** User Information */
+        userId: z.ZodOptional<z.ZodString>;
+        userRole: z.ZodOptional<z.ZodString>;
+        /** Current Context */
+        currentObject: z.ZodOptional<z.ZodString>;
+        currentRecordId: z.ZodOptional<z.ZodString>;
+        /** Conversation History */
+        conversationHistory: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            query: z.ZodString;
+            timestamp: z.ZodString;
+            intent: z.ZodOptional<z.ZodEnum<["select", "aggregate", "filter", "sort", "compare", "trend", "insight", "create", "update", "delete"]>>;
+        }, "strip", z.ZodTypeAny, {
+            timestamp: string;
+            query: string;
+            intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+        }, {
+            timestamp: string;
+            query: string;
+            intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+        }>, "many">>;
+        /** Preferences */
+        defaultLimit: z.ZodDefault<z.ZodNumber>;
+        timezone: z.ZodDefault<z.ZodString>;
+        locale: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        locale: string;
+        timezone: string;
+        defaultLimit: number;
+        userId?: string | undefined;
+        conversationHistory?: {
+            timestamp: string;
+            query: string;
+            intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+        }[] | undefined;
+        userRole?: string | undefined;
+        currentObject?: string | undefined;
+        currentRecordId?: string | undefined;
+    }, {
+        userId?: string | undefined;
+        locale?: string | undefined;
+        timezone?: string | undefined;
+        conversationHistory?: {
+            timestamp: string;
+            query: string;
+            intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+        }[] | undefined;
+        userRole?: string | undefined;
+        currentObject?: string | undefined;
+        currentRecordId?: string | undefined;
+        defaultLimit?: number | undefined;
+    }>>;
+    /** Expected Output */
+    expectedIntent: z.ZodEnum<["select", "aggregate", "filter", "sort", "compare", "trend", "insight", "create", "update", "delete"]>;
+    expectedObject: z.ZodOptional<z.ZodString>;
+    expectedAST: z.ZodAny;
+    /** Metadata */
+    category: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    expectedIntent: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight";
+    context?: {
+        locale: string;
+        timezone: string;
+        defaultLimit: number;
+        userId?: string | undefined;
+        conversationHistory?: {
+            timestamp: string;
+            query: string;
+            intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+        }[] | undefined;
+        userRole?: string | undefined;
+        currentObject?: string | undefined;
+        currentRecordId?: string | undefined;
+    } | undefined;
+    tags?: string[] | undefined;
+    category?: string | undefined;
+    expectedObject?: string | undefined;
+    expectedAST?: any;
+    notes?: string | undefined;
+}, {
+    query: string;
+    expectedIntent: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight";
+    context?: {
+        userId?: string | undefined;
+        locale?: string | undefined;
+        timezone?: string | undefined;
+        conversationHistory?: {
+            timestamp: string;
+            query: string;
+            intent?: "select" | "sort" | "filter" | "create" | "update" | "delete" | "aggregate" | "compare" | "trend" | "insight" | undefined;
+        }[] | undefined;
+        userRole?: string | undefined;
+        currentObject?: string | undefined;
+        currentRecordId?: string | undefined;
+        defaultLimit?: number | undefined;
+    } | undefined;
+    tags?: string[] | undefined;
+    category?: string | undefined;
+    expectedObject?: string | undefined;
+    expectedAST?: any;
+    notes?: string | undefined;
+}>;
+/**
+ * NLQ Model Configuration
+ */
+export declare const NLQModelConfigSchema: z.ZodObject<{
+    /** Model */
+    modelId: z.ZodString;
+    /** Prompt Engineering */
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    includeSchema: z.ZodDefault<z.ZodBoolean>;
+    includeExamples: z.ZodDefault<z.ZodBoolean>;
+    /** Intent Detection */
+    enableIntentDetection: z.ZodDefault<z.ZodBoolean>;
+    intentThreshold: z.ZodDefault<z.ZodNumber>;
+    /** Entity Recognition */
+    enableEntityRecognition: z.ZodDefault<z.ZodBoolean>;
+    entityRecognitionModel: z.ZodOptional<z.ZodString>;
+    /** Field Resolution */
+    enableFuzzyMatching: z.ZodDefault<z.ZodBoolean>;
+    fuzzyMatchThreshold: z.ZodDefault<z.ZodNumber>;
+    /** Temporal Processing */
+    enableTimeframeDetection: z.ZodDefault<z.ZodBoolean>;
+    defaultTimeframe: z.ZodOptional<z.ZodString>;
+    /** Performance */
+    enableCaching: z.ZodDefault<z.ZodBoolean>;
+    cacheTTL: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    modelId: string;
+    cacheTTL: number;
+    includeSchema: boolean;
+    includeExamples: boolean;
+    enableIntentDetection: boolean;
+    intentThreshold: number;
+    enableEntityRecognition: boolean;
+    enableFuzzyMatching: boolean;
+    fuzzyMatchThreshold: number;
+    enableTimeframeDetection: boolean;
+    enableCaching: boolean;
+    systemPrompt?: string | undefined;
+    entityRecognitionModel?: string | undefined;
+    defaultTimeframe?: string | undefined;
+}, {
+    modelId: string;
+    cacheTTL?: number | undefined;
+    systemPrompt?: string | undefined;
+    includeSchema?: boolean | undefined;
+    includeExamples?: boolean | undefined;
+    enableIntentDetection?: boolean | undefined;
+    intentThreshold?: number | undefined;
+    enableEntityRecognition?: boolean | undefined;
+    entityRecognitionModel?: string | undefined;
+    enableFuzzyMatching?: boolean | undefined;
+    fuzzyMatchThreshold?: number | undefined;
+    enableTimeframeDetection?: boolean | undefined;
+    defaultTimeframe?: string | undefined;
+    enableCaching?: boolean | undefined;
+}>;
+/**
+ * NLQ Analytics
+ */
+export declare const NLQAnalyticsSchema: z.ZodObject<{
+    /** Query Metrics */
+    totalQueries: z.ZodNumber;
+    successfulQueries: z.ZodNumber;
+    failedQueries: z.ZodNumber;
+    averageConfidence: z.ZodNumber;
+    /** Intent Distribution */
+    intentDistribution: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    /** Common Patterns */
+    topQueries: z.ZodArray<z.ZodObject<{
+        query: z.ZodString;
+        count: z.ZodNumber;
+        averageConfidence: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+        query: string;
+        averageConfidence: number;
+    }, {
+        count: number;
+        query: string;
+        averageConfidence: number;
+    }>, "many">;
+    /** Performance */
+    averageParseTime: z.ZodNumber;
+    averageExecutionTime: z.ZodOptional<z.ZodNumber>;
+    /** Issues */
+    lowConfidenceQueries: z.ZodArray<z.ZodObject<{
+        query: z.ZodString;
+        confidence: z.ZodNumber;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        query: string;
+        confidence: number;
+    }, {
+        timestamp: string;
+        query: string;
+        confidence: number;
+    }>, "many">;
+    /** Timeframe */
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    startDate: string;
+    endDate: string;
+    totalQueries: number;
+    successfulQueries: number;
+    failedQueries: number;
+    averageConfidence: number;
+    intentDistribution: Record<string, number>;
+    topQueries: {
+        count: number;
+        query: string;
+        averageConfidence: number;
+    }[];
+    averageParseTime: number;
+    lowConfidenceQueries: {
+        timestamp: string;
+        query: string;
+        confidence: number;
+    }[];
+    averageExecutionTime?: number | undefined;
+}, {
+    startDate: string;
+    endDate: string;
+    totalQueries: number;
+    successfulQueries: number;
+    failedQueries: number;
+    averageConfidence: number;
+    intentDistribution: Record<string, number>;
+    topQueries: {
+        count: number;
+        query: string;
+        averageConfidence: number;
+    }[];
+    averageParseTime: number;
+    lowConfidenceQueries: {
+        timestamp: string;
+        query: string;
+        confidence: number;
+    }[];
+    averageExecutionTime?: number | undefined;
+}>;
+/**
+ * Field Synonym Configuration
+ */
+export declare const FieldSynonymConfigSchema: z.ZodObject<{
+    object: z.ZodString;
+    field: z.ZodString;
+    synonyms: z.ZodArray<z.ZodString, "many">;
+    examples: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    object: string;
+    field: string;
+    synonyms: string[];
+    examples?: string[] | undefined;
+}, {
+    object: string;
+    field: string;
+    synonyms: string[];
+    examples?: string[] | undefined;
+}>;
+/**
+ * Query Template
+ */
+export declare const QueryTemplateSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    label: z.ZodString;
+    /** Template */
+    pattern: z.ZodString;
+    variables: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<["object", "field", "value", "timeframe"]>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "object" | "value" | "field" | "timeframe";
+        name: string;
+        required: boolean;
+    }, {
+        type: "object" | "value" | "field" | "timeframe";
+        name: string;
+        required?: boolean | undefined;
+    }>, "many">;
+    /** Generated AST */
+    astTemplate: z.ZodAny;
+    /** Metadata */
+    category: z.ZodOptional<z.ZodString>;
+    examples: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    name: string;
+    id: string;
+    variables: {
+        type: "object" | "value" | "field" | "timeframe";
+        name: string;
+        required: boolean;
+    }[];
+    pattern: string;
+    tags?: string[] | undefined;
+    category?: string | undefined;
+    examples?: string[] | undefined;
+    astTemplate?: any;
+}, {
+    label: string;
+    name: string;
+    id: string;
+    variables: {
+        type: "object" | "value" | "field" | "timeframe";
+        name: string;
+        required?: boolean | undefined;
+    }[];
+    pattern: string;
+    tags?: string[] | undefined;
+    category?: string | undefined;
+    examples?: string[] | undefined;
+    astTemplate?: any;
+}>;
+export type QueryIntent = z.infer<typeof QueryIntentSchema>;
+export type Entity = z.infer<typeof EntitySchema>;
+export type Timeframe = z.infer<typeof TimeframeSchema>;
+export type NLQFieldMapping = z.infer<typeof NLQFieldMappingSchema>;
+export type QueryContext = z.infer<typeof QueryContextSchema>;
+export type NLQParseResult = z.infer<typeof NLQParseResultSchema>;
+export type NLQRequest = z.infer<typeof NLQRequestSchema>;
+export type NLQResponse = z.infer<typeof NLQResponseSchema>;
+export type NLQTrainingExample = z.infer<typeof NLQTrainingExampleSchema>;
+export type NLQModelConfig = z.infer<typeof NLQModelConfigSchema>;
+export type NLQAnalytics = z.infer<typeof NLQAnalyticsSchema>;
+export type FieldSynonymConfig = z.infer<typeof FieldSynonymConfigSchema>;
+export type QueryTemplate = z.infer<typeof QueryTemplateSchema>;
+//# sourceMappingURL=nlq.zod.d.ts.map