AI Framework Foundation

[charvimehradu]

Pull Request for AI Framework Feature.

Summary of Changes

• Response.php is the foundational file for the AI framework that standardizes how responses are handled across all AI providers.
• It represents the results of an AI operation and will hold all the data returned from AI providers.
• Each AI provider creates a response object using constructor and users interact with the response objects using methods.
• __get() method allows property-style access ($response->content).

09 June 2025

• ProviderInterface.php: All AI providers must implement these methods.
• AbstractProvider.php: All providers share this code. It contains shared functionalities for all providers.

11 June 2025

• 'OpenAIProvider.php': Implementing OpenAIProvider core functionality
• The Tests folder contains basic php tests.

Testing Instructions

Documentation Changes Required

[bembelimen]

Please check the headers Joomla is using

[charvimehradu]

I have changed them with commit#4. Please check. I am not sure what should be the copyright for 2025, could you please confirm and I will update it in my next commit

[bembelimen]

Is only a 200 a valid response?

[charvimehradu]

With the latest commit, the following changes have been made:

• Changed file headers to follow Joomla standards - Updated copyright notices and licensing information to match Joomla Framework conventions.
• Implemented OpenAIProvider core functionality - OpenAI provider implementation with default endpoint v1/chat/completions and default model gpt-4o-mini. Provider support is determined by checking for API key availability in environment variables. The prompt() and ask() methods build request payloads that convert user prompts into OpenAI's expected message format. It also implements determineAIStatusCode() method that maps OpenAI's finish_reason responses to status codes.
• HTTP errors are handled by AbstractProvider's validateResponse() method, while OpenAI-specific API errors are processed in OpenAIProvider's parseOpenAIResponse() method.
• composer.json created to handle Http framework dependency and testing purposes.
• Created three basic tests:

1. HTTP Integration Test (http_test.php) - Verifies Joomla HttpFactory integration, tests both static and instance method call. Instance method call passes the test.
2. Response Object Test (response_test.php) - Tests custom Response class creation.
3. OpenAI API Integration Test (api_test.php) - Tests API connectivity verification.

[bembelimen]

Please use version 4.x now for both (they're released)