@objectql/core 1.7.2 → 1.7.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @objectql/core
 
+## 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,21 +1,118 @@
-MIT License
-
-Copyright (c) 2026 ObjectQL Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+# PolyForm Shield License 1.0.0
+
+<https://polyformproject.org/licenses/shield/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose. However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software. Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software. For example:
+
+> Required Notice: Copyright ObjectQL Contributors (https://github.com/objectql)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else. These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice. Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization. **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise. Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.
+
+**Permitted purpose** means any purpose other than competing
+with the licensor or any product the licensor or its affiliates
+provides using the software.
+
+---
+
+Required Notice: Copyright (c) 2026 ObjectQL Contributors (https://github.com/objectql)

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;