@objectql/core 4.0.1 → 4.0.3

package/dist/ai-agent.d.ts

@@ -1,176 +0,0 @@
-/**
- * ObjectQL
- * Copyright (c) 2026-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-/**
- * Configuration for the ObjectQL AI Agent
- */
-export interface AgentConfig {
-    /** OpenAI API key */
-    apiKey: string;
-    /** OpenAI model to use (default: gpt-4) */
-    model?: string;
-    /** Temperature for generation (0-1, default: 0.7) */
-    temperature?: number;
-    /** Preferred language for messages (default: en) */
-    language?: string;
-}
-/**
- * Options for generating application metadata
- */
-export interface GenerateAppOptions {
-    /** Natural language description of the application */
-    description: string;
-    /** Type of generation: basic (minimal), complete (comprehensive), or custom */
-    type?: 'basic' | 'complete' | 'custom';
-    /** Maximum tokens for generation */
-    maxTokens?: number;
-}
-/**
- * Result of application generation
- */
-export interface GenerateAppResult {
-    /** Whether generation was successful */
-    success: boolean;
-    /** Generated metadata files */
-    files: Array<{
-        filename: string;
-        content: string;
-        type: 'object' | 'validation' | 'action' | 'hook' | 'permission' | 'workflow' | 'data' | 'application' | 'typescript' | 'test' | 'other';
-    }>;
-    /** Any errors encountered */
-    errors?: string[];
-    /** AI model response (raw) */
-    rawResponse?: string;
-}
-/**
- * Conversation message for step-by-step generation
- */
-export interface ConversationMessage {
-    role: 'system' | 'user' | 'assistant';
-    content: string;
-}
-/**
- * Options for conversational generation
- */
-export interface ConversationalGenerateOptions {
-    /** Initial description or follow-up request */
-    message: string;
-    /** Previous conversation history */
-    conversationHistory?: ConversationMessage[];
-    /** Current application state (already generated files) */
-    currentApp?: GenerateAppResult;
-}
-/**
- * Result of conversational generation
- */
-export interface ConversationalGenerateResult extends GenerateAppResult {
-    /** Updated conversation history */
-    conversationHistory: ConversationMessage[];
-    /** Suggested next steps or questions */
-    suggestions?: string[];
-}
-/**
- * Options for validating metadata
- */
-export interface ValidateMetadataOptions {
-    /** Metadata content (YAML string or parsed object) */
-    metadata: string | any;
-    /** Filename (for context) */
-    filename?: string;
-    /** Whether to check business logic consistency */
-    checkBusinessLogic?: boolean;
-    /** Whether to check performance considerations */
-    checkPerformance?: boolean;
-    /** Whether to check security issues */
-    checkSecurity?: boolean;
-}
-/**
- * Result of metadata validation
- */
-export interface ValidateMetadataResult {
-    /** Whether validation passed (no errors) */
-    valid: boolean;
-    /** Errors found */
-    errors: Array<{
-        message: string;
-        location?: string;
-        code?: string;
-    }>;
-    /** Warnings found */
-    warnings: Array<{
-        message: string;
-        location?: string;
-        suggestion?: string;
-    }>;
-    /** Informational messages */
-    info: Array<{
-        message: string;
-        location?: string;
-    }>;
-}
-/**
- * ObjectQL AI Agent for programmatic application generation and validation
- */
-export declare class ObjectQLAgent {
-    private openai;
-    private validator;
-    private config;
-    constructor(config: AgentConfig);
-    /**
-     * Generate application metadata from natural language description
-     */
-    generateApp(options: GenerateAppOptions): Promise<GenerateAppResult>;
-    /**
-     * Validate metadata using AI
-     */
-    validateMetadata(options: ValidateMetadataOptions): Promise<ValidateMetadataResult>;
-    /**
-     * Refine existing metadata based on feedback
-     */
-    refineMetadata(metadata: string, feedback: string, iterations?: number): Promise<GenerateAppResult>;
-    /**
-     * Conversational generation with step-by-step refinement
-     * This allows users to iteratively improve the application through dialogue
-     */
-    generateConversational(options: ConversationalGenerateOptions): Promise<ConversationalGenerateResult>;
-    /**
-     * Generate suggestions for next steps based on current application state
-     */
-    private generateSuggestions;
-    /**
-     * Get system prompt for metadata generation
-     */
-    private getSystemPrompt;
-    /**
-     * Get system prompt for validation
-     */
-    private getValidationSystemPrompt;
-    /**
-     * Build generation prompt based on options
-     */
-    private buildGenerationPrompt;
-    /**
-     * Build validation prompt
-     */
-    private buildValidationPrompt;
-    /**
-     * Parse generation response and extract files
-     */
-    private parseGenerationResponse;
-    /**
-     * Parse validation feedback into structured result
-     */
-    private parseFeedback;
-    /**
-     * Infer file type from filename
-     */
-    private inferFileType;
-}
-/**
- * Convenience function to create an agent instance
- */
-export declare function createAgent(apiKey: string, options?: Partial<AgentConfig>): ObjectQLAgent;