feat: agents

[tymondesigns]

This pull request introduces significant improvements to the project's PHP ecosystem, focusing on dependency updates, enhanced configuration, and streamlined CI workflows. The main changes include updating core and development dependencies to newer major versions, refactoring the configuration to use enums and support new drivers, and consolidating GitHub Actions for PHP setup and dependency caching. Additionally, it introduces new scripts and autoloading paths for better development and testing support.

Dependency and Compatibility Updates

• Upgraded PHP requirement to ^8.4 and updated several dependencies to their latest major versions in composer.json, including illuminate/collections, openai-php/client, orchestra/testbench, pestphp/pest, and others. Also added laravel/prompts and new autoload paths for a workbench environment. [1] [2]
• Updated development dependencies and scripts, including new post-autoload-dump, clear, prepare, build, and serve scripts to streamline local development and testing.

Configuration Enhancements

• Refactored config/cortex.php to use enum-based LLMDriver and ModelProvider for LLM providers, added new drivers (e.g., openai_chat, openai_responses), and updated default models and options for multiple providers. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12]
• Added support for new prompt factories, including a Blade-based factory, and improved configuration for caching and MCP/Workbench integration.
• Updated model info configuration to support feature ignoring and provider-based extensibility.
• Enabled the tavily tool by default in the MCP tools configuration.

Continuous Integration and Workflow Improvements

• Introduced a reusable composite GitHub Action (.github/actions/setup-php-composer/action.yml) to set up PHP, install Composer dependencies with caching, and handle stability preferences.
• Updated run-tests.yml and static-analysis.yml workflows to use the new composite action, bumped PHP versions in the test matrix, and improved caching strategies for Composer, phpstan, rector, and ecs. Also removed redundant steps and streamlined dependency installation. (Fe32f64eL9R9, [1] [2] [3]

Miscellaneous

• Added a helper markdown file for fixing PHPStan issues.
• Updated .gitattributes to exclude the workbench directory from exports and removed the cortex directory from export-ignore.

These changes collectively modernize the codebase, improve maintainability, and enhance the developer experience across local and CI environments.