feat(ai): add embeddings instrumentation and CI compatibility

.github/workflows/ci.yaml

@@ -63,9 +63,11 @@ jobs:
       - name: Install Composer dependencies
         run: |
           # friendsofphp/php-cs-fixer: No need for this package to run phpunit and it conflicts with older Laravel versions
+          # laravel/ai: Only supports PHP 8.4+ and Laravel 12, remove globally and re-add below where supported
+          composer remove friendsofphp/php-cs-fixer laravel/ai --dev --no-interaction --no-update
+
           # laravel/pennant: Does not yet support Laravel 13
           # laravel/octane: Does not yet support Laravel 13
-          composer remove friendsofphp/php-cs-fixer --dev --no-interaction --no-update
           [[ "${{ matrix.packages.laravel }}" == "^13.0" ]] && composer remove laravel/pennant laravel/octane --dev --no-interaction --no-update || true
 
           # Require the correct versions we want to run phpunit for
@@ -76,12 +78,21 @@ jobs:
             "orchestra/testbench:${{ matrix.packages.testbench }}" \
             --no-interaction --no-update
 
+          # Re-require laravel/ai for supported combinations (PHP 8.4+ and Laravel 12)
+          if [ "${{ matrix.packages.laravel }}" == "^12.0" ] && ([ "${{ matrix.php }}" == "8.4" ] || [ "${{ matrix.php }}" == "8.5" ]); then
+            composer require "laravel/ai:^0.1.5" --dev --no-interaction --no-update
+          fi
+
           # Actually run the composer installation
           composer install --no-interaction --prefer-dist --no-progress
 
       - name: Run phpunit
         run: vendor/bin/phpunit --coverage-clover=coverage.xml --coverage-filter=src/Sentry
 
+      - name: Run AI integration tests
+        if: matrix.packages.laravel == '^12.0' && (matrix.php == '8.4' || matrix.php == '8.5')
+        run: vendor/bin/phpunit test/Sentry/Features/AiIntegrationTest.php
+
       - name: Upload coverage to Codecov
         uses: codecov/codecov-action@v4
         with:
@@ -177,7 +188,8 @@ jobs:
           # laravel/folio: Only supported on PHP 8.1 + Laravel 10.0 and above
           # laravel/pennant: Only supported on PHP 8.1 + Laravel 10.0 and above
           # laravel/octane: Only supported on PHP 8.1 + Laravel 10.10.1 and above
-          composer remove friendsofphp/php-cs-fixer livewire/livewire laravel/folio laravel/pennant laravel/octane --dev --no-interaction --no-update
+          # laravel/ai: Only supported on PHP 8.4+ and Laravel 12
+          composer remove friendsofphp/php-cs-fixer livewire/livewire laravel/folio laravel/pennant laravel/octane laravel/ai --dev --no-interaction --no-update
 
           # Require the correct versions we want to run phpunit for
           composer require \

.github/workflows/cs.yaml

@@ -24,7 +24,10 @@ jobs:
           php-version: '8.3'
 
       - name: Install dependencies
-        run: composer update --no-progress --no-interaction --prefer-dist
+        run: |
+          # laravel/ai: Only supported on PHP 8.4+
+          composer remove laravel/ai --dev --no-interaction --no-update
+          composer update --no-progress --no-interaction --prefer-dist
 
       - name: Run script
         run: vendor/bin/php-cs-fixer fix --verbose --diff --dry-run
@@ -42,7 +45,10 @@ jobs:
           php-version: '8.3'
 
       - name: Install dependencies
-        run: composer update --no-progress --no-interaction --prefer-dist
+        run: |
+          # laravel/ai: Only supported on PHP 8.4+
+          composer remove laravel/ai --dev --no-interaction --no-update
+          composer update --no-progress --no-interaction --prefer-dist
 
       - name: Run script
         run: vendor/bin/phpstan analyse

composer.json

@@ -37,6 +37,7 @@
     "require-dev": {
         "friendsofphp/php-cs-fixer": "^3.11",
         "guzzlehttp/guzzle": "^7.2",
+        "laravel/ai": "^0.1.5",
         "laravel/folio": "^1.1",
         "laravel/framework": "^6.0 | ^7.0 | ^8.0 | ^9.0 | ^10.0 | ^11.0 | ^12.0 | ^13.0",
         "laravel/octane": "^2.15",

config/sentry.php

@@ -128,6 +128,21 @@
         // This is required to capture any spans that are created after the response has been sent like queue jobs dispatched using `dispatch(...)->afterResponse()` for example
         'continue_after_response' => env('SENTRY_TRACE_CONTINUE_AFTER_RESPONSE', true),
 
+        // Capture AI agent interactions as spans (requires laravel/ai)
+        'gen_ai' => env('SENTRY_TRACE_GEN_AI_ENABLED', true),
+
+        // Capture AI invoke_agent spans
+        'gen_ai_invoke_agent' => env('SENTRY_TRACE_GEN_AI_INVOKE_AGENT_ENABLED', true),
+
+        // Capture AI chat spans
+        'gen_ai_chat' => env('SENTRY_TRACE_GEN_AI_CHAT_ENABLED', true),
+
+        // Capture AI execute_tool spans
+        'gen_ai_execute_tool' => env('SENTRY_TRACE_GEN_AI_EXECUTE_TOOL_ENABLED', true),
+
+        // Capture AI embeddings spans
+        'gen_ai_embeddings' => env('SENTRY_TRACE_GEN_AI_EMBEDDINGS_ENABLED', true),
+
         // Enable the tracing integrations supplied by Sentry (recommended)
         'default_integrations' => env('SENTRY_TRACE_DEFAULT_INTEGRATIONS_ENABLED', true),
     ],

phpstan-baseline.neon

@@ -99,3 +99,78 @@ parameters:
 			message: "#^Class Laravel\\\\Lumen\\\\Application not found\\.$#"
 			count: 2
 			path: src/Sentry/Laravel/Tracing/ServiceProvider.php
+
+		-
+			message: "#^Parameter \\$event of method Sentry\\\\Laravel\\\\Features\\\\AiIntegration\\:\\:handlePromptingAgentForTracing\\(\\) has invalid type Laravel\\\\Ai\\\\Events\\\\PromptingAgent\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php
+
+		-
+			message: "#^Parameter \\$event of method Sentry\\\\Laravel\\\\Features\\\\AiIntegration\\:\\:handleAgentPromptedForTracing\\(\\) has invalid type Laravel\\\\Ai\\\\Events\\\\AgentPrompted\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php
+
+		-
+			message: "#^Parameter \\$agent of method Sentry\\\\Laravel\\\\Features\\\\AiIntegration\\:\\:resolveAgentAttribute\\(\\) has invalid type Laravel\\\\Ai\\\\Contracts\\\\Agent\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php
+
+		-
+			message: "#^Parameter \\$usage of method Sentry\\\\Laravel\\\\Features\\\\AiIntegration\\:\\:setTokenUsage\\(\\) has invalid type Laravel\\\\Ai\\\\Responses\\\\Data\\\\Usage\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php
+
+		-
+			message: "#^Parameter \\$response of method Sentry\\\\Laravel\\\\Features\\\\AiIntegration\\:\\:enrichChatSpansWithStepData\\(\\) has invalid type Laravel\\\\Ai\\\\Responses\\\\AgentResponse\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php
+
+		-
+			message: "#^Parameter \\$provider of method Sentry\\\\Laravel\\\\Features\\\\AiIntegration\\:\\:resolveProviderUrlPrefix\\(\\) has invalid type Laravel\\\\Ai\\\\Providers\\\\Provider\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php
+
+		-
+			message: "#^Parameter \\$event of method Sentry\\\\Laravel\\\\Features\\\\AiIntegration\\:\\:handleInvokingToolForTracing\\(\\) has invalid type Laravel\\\\Ai\\\\Events\\\\InvokingTool\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php
+
+		-
+			message: "#^Parameter \\$event of method Sentry\\\\Laravel\\\\Features\\\\AiIntegration\\:\\:handleToolInvokedForTracing\\(\\) has invalid type Laravel\\\\Ai\\\\Events\\\\ToolInvoked\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php
+
+		-
+			message: "#^Parameter \\$agent of method Sentry\\\\Laravel\\\\Features\\\\AiIntegration\\:\\:resolveToolDefinitions\\(\\) has invalid type Laravel\\\\Ai\\\\Contracts\\\\Agent\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php
+
+		-
+			message: "#^Class Laravel\\\\Ai\\\\Contracts\\\\HasTools not found\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php
+
+		-
+			message: "#^Parameter \\$tool of method Sentry\\\\Laravel\\\\Features\\\\AiIntegration\\:\\:resolveToolDefinition\\(\\) has invalid type Laravel\\\\Ai\\\\Contracts\\\\Tool\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php
+
+		-
+			message: "#^Parameter \\$prompt of method Sentry\\\\Laravel\\\\Features\\\\AiIntegration\\:\\:resolveAttachments\\(\\) has invalid type Laravel\\\\Ai\\\\Prompts\\\\AgentPrompt\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php
+
+		-
+			message: "#^Parameter \\$agent of method Sentry\\\\Laravel\\\\Features\\\\AiIntegration\\:\\:resolveAgentInstructions\\(\\) has invalid type Laravel\\\\Ai\\\\Contracts\\\\Agent\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php
+
+		-
+			message: "#^Parameter \\$event of method Sentry\\\\Laravel\\\\Features\\\\AiIntegration\\:\\:handleGeneratingEmbeddingsForTracing\\(\\) has invalid type Laravel\\\\Ai\\\\Events\\\\GeneratingEmbeddings\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php
+
+		-
+			message: "#^Parameter \\$event of method Sentry\\\\Laravel\\\\Features\\\\AiIntegration\\:\\:handleEmbeddingsGeneratedForTracing\\(\\) has invalid type Laravel\\\\Ai\\\\Events\\\\EmbeddingsGenerated\\.$#"
+			count: 1
+			path: src/Sentry/Laravel/Features/AiIntegration.php

phpunit.xml

@@ -10,6 +10,7 @@
     <testsuites>
         <testsuite name="Sentry Laravel Test Suite">
             <directory>./test/Sentry/</directory>
+            <exclude>./test/Sentry/Features/AiIntegrationTest.php</exclude>
         </testsuite>
     </testsuites>
 </phpunit>