@objectql/core 1.7.2 → 1.8.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @objectql/core
 
+## 1.8.0
+
+### Minor Changes
+
+- Release minor version 1.8.0
+
+### Patch Changes
+
+- Updated dependencies
+  - @objectql/types@1.8.0
+
+## 1.7.3
+
+### Patch Changes
+
+- Release patch version 1.7.3 with latest improvements and bug fixes
+- Updated dependencies
+  - @objectql/types@1.7.3
+
 ## 1.7.2
 
 ### Patch Changes

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 ObjectQL Contributors
+Copyright (c) 2026 ObjectQL Contributors (https://github.com/objectql)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/ai-agent.d.ts

@@ -0,0 +1,175 @@
+/**
+ * ObjectQL AI Agent - Programmatic API for AI-powered application generation
+ *
+ * This module provides a high-level API for using AI to generate and validate
+ * ObjectQL metadata programmatically.
+ */
+/**
+ * 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' | 'form' | 'view' | 'page' | 'menu' | 'action' | 'hook' | 'permission' | 'workflow' | 'report' | '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;