feat: agents (#9)

Author: tymondesigns

.cursor/commands/fix-stan.md

@@ -0,0 +1 @@
+Use `composer stan --no-progress` to see the PHPStan failures, and then fix them.

.gitattributes

@@ -9,5 +9,5 @@
 /testbench.yaml export-ignore
 /ecs.php export-ignore
 /tests export-ignore
-/cortex export-ignore
 /phpstan.neon export-ignore
+/workbench export-ignore

.github/actions/setup-php-composer/action.yml

@@ -0,0 +1,48 @@
+name: 'Setup PHP and Composer'
+description: 'Setup PHP and install Composer dependencies with caching'
+
+inputs:
+  php-version:
+    description: 'PHP version to use'
+    required: false
+    default: '8.4'
+  coverage:
+    description: 'Coverage driver to use (none, xdebug, pcov)'
+    required: false
+    default: 'none'
+  stability:
+    description: 'Composer stability preference (prefer-stable, prefer-lowest)'
+    required: false
+    default: 'prefer-stable'
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Setup PHP
+      uses: shivammathur/setup-php@v2
+      with:
+        php-version: ${{ inputs.php-version }}
+        coverage: ${{ inputs.coverage }}
+
+    - name: Get Composer Cache Directory
+      id: composer-cache
+      shell: bash
+      run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+    - name: Cache Composer dependencies
+      uses: actions/cache@v5
+      with:
+        path: ${{ steps.composer-cache.outputs.dir }}
+        key: ${{ runner.os }}-composer-${{ inputs.stability }}-${{ hashFiles('**/composer.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-composer-
+
+    - name: Install dependencies
+      shell: bash
+      run: |
+        if [ "${{ inputs.stability }}" = "prefer-lowest" ]; then
+          composer update --prefer-lowest --prefer-dist --no-interaction --no-progress
+        else
+          composer install --prefer-dist --no-interaction --no-progress
+        fi
+

.github/workflows/run-tests.yml

@@ -13,7 +13,7 @@ jobs:
       fail-fast: true
       matrix:
         os: [ubuntu-latest]
-        php: [8.3, 8.4]
+        php: [8.4, 8.5]
         stability: [prefer-lowest, prefer-stable]
 
     name: PHP${{ matrix.php }} - ${{ matrix.stability }} - ${{ matrix.os }}
@@ -22,20 +22,17 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v6
 
-      - name: Setup PHP
-        uses: shivammathur/setup-php@v2
+      - name: Setup PHP and Composer
+        uses: ./.github/actions/setup-php-composer
         with:
           php-version: ${{ matrix.php }}
-          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick, fileinfo
           coverage: none
+          stability: ${{ matrix.stability }}
 
       - name: Setup problem matchers
         run: |
           echo "::add-matcher::${{ runner.tool_cache }}/php.json"
           echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
 
-      - name: Install dependencies
-        run: composer update --${{ matrix.stability }} --prefer-dist --no-interaction
-
       - name: Execute tests
         run: vendor/bin/pest --colors=always

.github/workflows/static-analysis.yml

@@ -14,26 +14,8 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v6
 
-      - name: Setup PHP
-        uses: shivammathur/setup-php@v2
-        with:
-          php-version: 8.3
-          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick, fileinfo
-
-      - name: Get Composer Cache Directory
-        id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-
-      - name: Cache Composer dependencies
-        uses: actions/cache@v5
-        with:
-          path: ${{ steps.composer-cache.outputs.dir }}
-          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-composer-
-
-      - name: Install dependencies
-        run: composer install --prefer-dist --no-interaction --no-progress
+      - name: Setup PHP and Composer
+        uses: ./.github/actions/setup-php-composer
 
       - name: Cache phpstan results
         uses: actions/cache@v5
@@ -52,26 +34,36 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v6
 
-      - name: Setup PHP
-        uses: shivammathur/setup-php@v2
-        with:
-          php-version: 8.3
-          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick, fileinfo
+      - name: Setup PHP and Composer
+        uses: ./.github/actions/setup-php-composer
+
+      - name: Check type coverage
+        run: vendor/bin/pest --type-coverage --min=100
+
+  format:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
 
-      - name: Get Composer Cache Directory
-        id: composer-cache
-        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+      - name: Setup PHP and Composer
+        uses: ./.github/actions/setup-php-composer
 
-      - name: Cache Composer dependencies
+      - name: Cache rector results
         uses: actions/cache@v5
         with:
-          path: ${{ steps.composer-cache.outputs.dir }}
-          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          path: /tmp/rector
+          key: "rector-cache-${{ github.run_id }}" # always write a new cache
           restore-keys: |
-            ${{ runner.os }}-composer-
+            rector-cache-
 
-      - name: Install dependencies
-        run: composer install --prefer-dist --no-interaction --no-progress
+      - name: Cache ecs results
+        uses: actions/cache@v5
+        with:
+          path: /tmp/ecs
+          key: "ecs-cache-${{ github.run_id }}" # always write a new cache
+          restore-keys: |
+            ecs-cache-
 
-      - name: Check type coverage
-        run: vendor/bin/pest --type-coverage --min=100
+      - name: Run format checks
+        run: composer format --no-progress-bar

composer.json

@@ -11,18 +11,19 @@
     "authors": [
         {
             "name": "Sean Tymon",
-            "email": "tymon148@gmail.com",
+            "email": "sean@tymon.dev",
             "role": "Developer"
         }
     ],
     "require": {
-        "php": "^8.3",
+        "php": "^8.4",
         "adhocore/json-fixer": "^1.0",
-        "cortexphp/json-schema": "^0.6",
+        "cortexphp/json-schema": "dev-main",
         "cortexphp/model-info": "^0.3",
-        "illuminate/collections": "^11.23",
+        "illuminate/collections": "^12.0",
+        "laravel/prompts": "^0.3.8",
         "mozex/anthropic-php": "^1.1",
-        "openai-php/client": "^0.15",
+        "openai-php/client": "^0.18",
         "php-mcp/client": "^1.0",
         "psr-discovery/cache-implementations": "^1.2",
         "psr-discovery/event-dispatcher-implementations": "^1.1",
@@ -34,24 +35,28 @@
         "hkulekci/qdrant": "^0.5.8",
         "league/event": "^3.0",
         "mockery/mockery": "^1.6",
-        "orchestra/testbench": "^9.8",
-        "pestphp/pest": "^3.0",
-        "pestphp/pest-plugin-type-coverage": "^3.4",
+        "orchestra/testbench": "^10.6",
+        "pestphp/pest": "^4.0",
+        "pestphp/pest-plugin-type-coverage": "^4.0",
         "phpstan/phpstan": "^2.0",
         "rector/rector": "^2.0",
-        "symplify/easy-coding-standard": "^12.5"
+        "symplify/easy-coding-standard": "^13.0"
     },
     "autoload": {
         "psr-4": {
             "Cortex\\": "src/"
         },
         "files": [
-            "src/Support/helpers.php"
+            "src/Support/helpers.php",
+            "src/Prompts/helpers.php"
         ]
     },
     "autoload-dev": {
         "psr-4": {
-            "Cortex\\Tests\\": "tests/"
+            "Cortex\\Tests\\": "tests/",
+            "Workbench\\App\\": "workbench/app/",
+            "Workbench\\Database\\Factories\\": "workbench/database/factories/",
+            "Workbench\\Database\\Seeders\\": "workbench/database/seeders/"
         }
     },
     "scripts": {
@@ -69,6 +74,18 @@
             "@test",
             "@stan",
             "@type-coverage"
+        ],
+        "post-autoload-dump": [
+            "@clear",
+            "@prepare"
+        ],
+        "clear": "@php vendor/bin/testbench package:purge-skeleton --ansi",
+        "prepare": "@php vendor/bin/testbench package:discover --ansi",
+        "build": "@php vendor/bin/testbench workbench:build --ansi",
+        "serve": [
+            "Composer\\Config::disableProcessTimeout",
+            "@build",
+            "@php vendor/bin/testbench serve --ansi"
         ]
     },
     "config": {
@@ -79,9 +96,9 @@
             "php-http/discovery": true
         }
     },
-    "extra" : {
-        "laravel" : {
-            "providers" : [
+    "extra": {
+        "laravel": {
+            "providers": [
                 "Cortex\\CortexServiceProvider"
             ]
         }