WIP: Start work on integrating the PHP AI Client package

[dkotter]

Description of the Change

Note

This is an early test of the new PHP AI Client package and things will likely change as that matures. Opening this PR both for discussion and as an example of how that package can be implemented, but this PR may never ship or may change to use the WordPress AI Client package.

This PR brings in the PHP AI Client package as a new composer dependency and starts to use that where possible. At the moment, only implemented for OpenAI and only for these Features:

• Title Generation
• Excerpt Generation
• Content Resizing
• Key Takeaways
• Descriptive Text Generator
• Image Tags Generator
• Image Text Extraction
• Image Generation

We introduce a new base APIRequest class that Providers can extend for authentication purposes. This class has handling for existing API requests (GET, POST, POST FORM) so any existing functionality still works as expected but then introduces new handling for the PHP AI Client package, which allows Providers to opt-in to using that where it makes sense.

Potential next steps:

• Move the Google Provider over to the new approach, where that Provider is supported in the above Feature list
• Once v0.2.0 of the PHP AI Client package is released, move the Content Generation handling over, as right now there's not a great way to handle the back and forth messaging of that Feature but this is planned for v0.2.0
• Potentially look at extending the PHP AI Client package to support either other AI Providers (like Ollama) or other API features (like moderation, text to speech, speech to text). These may be things worth pushing upstream instead of leaving in ClassifAI

Note

E2E tests are failing here because our test plugin that hooks in and captures HTTP requests and mocks those no longer works with this PHP AI Client package, as it doesn't use the WordPress HTTP API and thus there aren't any hooks firing there. If we continue with this approach, we'll need to figure out a different way to capture and mock those requests. I think if we end up using the WordPress AI Client package though, that will be solved for us.

How to test the Change

Coming soon...

Changelog Entry

Added - New feature
Changed - Existing functionality
Deprecated - Soon-to-be removed feature
Removed - Feature
Fixed - Bug fix
Security - Vulnerability
Developer - Non-functional update

Credits

Props @dkotter

Checklist:

• I agree to follow this project's Code of Conduct.
• I have updated the documentation accordingly.
• I have added Critical Flows, Test Cases, and/or End-to-End Tests to cover my change.
• All new and existing tests pass.

[jeffpaul]

Potentially look at extending the PHP AI Client package to support either other AI Providers (like Ollama) or other API features (like moderation, text to speech, speech to text). These may be things worth pushing upstream instead of leaving in ClassifAI

My hope is we can push those upstream, though if the core team decides not to include additional providers or features then we might consider releasing those as their own extensions of the core PHP/WP clients versus keeping hardcoded within ClassifAI.

[github-actions]

@dkotter thanks for the PR! Could you please rebase your PR on top of the latest changes in the base branch?