Add Reasoning attribute for disabling reasoning across providers

src/Attributes/Reasoning.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Laravel\Ai\Attributes;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_CLASS)]
+class Reasoning
+{
+    public function __construct(public bool $enabled = true)
+    {
+        //
+    }
+}

src/Gateway/Anthropic/Concerns/BuildsTextRequests.php

@@ -36,6 +36,10 @@ protected function buildTextRequestBody(
 
         $providerOptions = $options?->providerOptions(Lab::Anthropic) ?? [];
 
+        if ($options?->reasoning === false) {
+            unset($providerOptions['thinking']);
+        }
+
         if (filled($schema) && $this->supportsNativeStructuredOutput($provider)) {
             $body['output_config'] = [
                 'format' => [

src/Gateway/Gemini/Concerns/BuildsTextRequests.php

@@ -92,6 +92,10 @@ private function assembleRequestBody(
             $generationConfig = array_merge($generationConfig, $providerOptions);
         }
 
+        if ($options?->reasoning === false && ! array_key_exists('thinkingConfig', $generationConfig)) {
+            $generationConfig['thinkingConfig'] = ['thinkingBudget' => 0];
+        }
+
         if (filled($generationConfig)) {
             $body['generationConfig'] = $generationConfig;
         }

src/Gateway/Ollama/Concerns/BuildsTextRequests.php

@@ -75,6 +75,10 @@ protected function buildChatRequestBody(
             $body['options'] = $mergedOptions;
         }
 
+        if ($options?->reasoning === false && ! array_key_exists('think', $body)) {
+            $body['think'] = false;
+        }
+
         return $body;
     }
 

src/Gateway/OpenAi/Concerns/BuildsTextRequests.php

@@ -44,6 +44,10 @@ protected function buildTextRequestBody(
             'top_p' => $options?->topP,
         ]));
 
+        if ($options?->reasoning === false) {
+            $body['reasoning'] = ['effort' => 'minimal'];
+        }
+
         $providerOptions = $options?->providerOptions(
             Lab::tryFrom($provider->driver()) ?? $provider->driver()
         );

src/Gateway/OpenRouter/Concerns/BuildsTextRequests.php

@@ -54,6 +54,10 @@ protected function buildTextRequestBody(
             $body = array_merge($body, $providerOptions);
         }
 
+        if ($options?->reasoning === false && ! array_key_exists('reasoning', $body)) {
+            $body['reasoning'] = ['exclude' => true];
+        }
+
         return $body;
     }
 

src/Gateway/TextGenerationOptions.php

@@ -4,6 +4,7 @@
 
 use Laravel\Ai\Attributes\MaxSteps;
 use Laravel\Ai\Attributes\MaxTokens;
+use Laravel\Ai\Attributes\Reasoning;
 use Laravel\Ai\Attributes\Temperature;
 use Laravel\Ai\Attributes\TopP;
 use Laravel\Ai\Contracts\Agent;
@@ -19,6 +20,7 @@ public function __construct(
         public readonly ?float $temperature = null,
         public readonly ?Agent $agent = null,
         public readonly ?float $topP = null,
+        public readonly ?bool $reasoning = null,
     ) {
         //
     }
@@ -50,6 +52,7 @@ public static function forAgent(Agent $agent): self
             temperature: self::resolve($agent, $reflection, 'temperature', Temperature::class),
             agent: $agent,
             topP: self::resolve($agent, $reflection, 'topP', TopP::class),
+            reasoning: self::resolveReasoning($agent, $reflection),
         );
     }
 
@@ -76,4 +79,26 @@ private static function resolve(Agent $agent, ReflectionClass $reflection, strin
 
         return ! empty($attributes) ? $attributes[0]->newInstance()->value : null;
     }
+
+    /**
+     * Resolve the reasoning preference from a `reasoning()` method or a `#[Reasoning]` attribute.
+     */
+    private static function resolveReasoning(Agent $agent, ReflectionClass $reflection): ?bool
+    {
+        if (method_exists($agent, 'reasoning')) {
+            try {
+                $value = $agent->reasoning();
+            } catch (\ArgumentCountError|\Error) {
+                $value = null;
+            }
+
+            if (! is_null($value)) {
+                return (bool) $value;
+            }
+        }
+
+        $attributes = $reflection->getAttributes(Reasoning::class);
+
+        return ! empty($attributes) ? $attributes[0]->newInstance()->enabled : null;
+    }
 }

tests/Feature/AgentAttributeTest.php

@@ -9,6 +9,8 @@
 use Tests\Fixtures\Agents\MethodOptionsAgent;
 use Tests\Fixtures\Agents\MethodOverridesAttributeAgent;
 use Tests\Fixtures\Agents\NullableMethodOptionsAgent;
+use Tests\Fixtures\Agents\ReasoningDisabledAgent;
+use Tests\Fixtures\Agents\ReasoningMethodAgent;
 
 test('text generation options can be created from agent attributes', function () {
     $options = TextGenerationOptions::forAgent(new AttributeAgent);
@@ -60,6 +62,24 @@
         ->and($options->temperature)->toBe(0.9);
 });
 
+test('reasoning attribute is read from agent class', function () {
+    $options = TextGenerationOptions::forAgent(new ReasoningDisabledAgent);
+
+    expect($options->reasoning)->toBeFalse();
+});
+
+test('reasoning method takes priority over attribute', function () {
+    $options = TextGenerationOptions::forAgent(new ReasoningMethodAgent);
+
+    expect($options->reasoning)->toBeFalse();
+});
+
+test('reasoning is null when neither attribute nor method is provided', function () {
+    $options = TextGenerationOptions::forAgent(new AssistantAgent);
+
+    expect($options->reasoning)->toBeNull();
+});
+
 test('provider attribute is used when prompting', function () {
     AttributeAgent::fake();
 

tests/Feature/Providers/Ollama/RequestMappingTest.php

@@ -4,6 +4,7 @@
 use Illuminate\Support\Facades\Http;
 use Tests\Fixtures\Agents\AssistantAgent;
 use Tests\Fixtures\Agents\AttributeAgent;
+use Tests\Fixtures\Agents\ReasoningDisabledAgent;
 use Tests\Fixtures\Agents\StructuredAgent;
 use Tests\Fixtures\Tools\RandomNumberGenerator;
 
@@ -166,6 +167,30 @@
     expect($response->structured['symbol'])->toBe('Au');
 });
 
+test('reasoning-disabled agent sends think:false at the request top level', function () {
+    Http::fake(['*' => $this->fakeTextResponse('Hello')]);
+
+    (new ReasoningDisabledAgent)->prompt('Hello', provider: 'ollama');
+
+    Http::assertSent(function (Request $request) {
+        $body = json_decode($request->body(), true);
+
+        return array_key_exists('think', $body) && $body['think'] === false;
+    });
+});
+
+test('agents without reasoning attribute do not send think key', function () {
+    Http::fake(['*' => $this->fakeTextResponse('Hello')]);
+
+    agent()->prompt('Hello', provider: 'ollama');
+
+    Http::assertSent(function (Request $request) {
+        $body = json_decode($request->body(), true);
+
+        return ! array_key_exists('think', $body);
+    });
+});
+
 test('request is sent to the chat endpoint', function () {
     Http::fake(['*' => $this->fakeTextResponse('Hello')]);
 

tests/Feature/Providers/OpenAi/RequestMappingTest.php

@@ -4,6 +4,7 @@
 use Illuminate\Support\Facades\Http;
 use Tests\Fixtures\Agents\AssistantAgent;
 use Tests\Fixtures\Agents\AttributeAgent;
+use Tests\Fixtures\Agents\ReasoningDisabledAgent;
 use Tests\Fixtures\Agents\StructuredAgent;
 use Tests\Fixtures\Tools\RandomNumberGenerator;
 
@@ -179,3 +180,27 @@
 
     expect($response->structured['symbol'])->toBe('Au');
 });
+
+test('reasoning-disabled agent sends reasoning effort minimal', function () {
+    Http::fake(['*' => fakeOpenAiResponse('Hello')]);
+
+    (new ReasoningDisabledAgent)->prompt('Hello', provider: 'openai');
+
+    Http::assertSent(function (Request $request) {
+        $body = json_decode($request->body(), true);
+
+        return data_get($body, 'reasoning.effort') === 'minimal';
+    });
+});
+
+test('agents without reasoning attribute do not send reasoning key', function () {
+    Http::fake(['*' => fakeOpenAiResponse('Hello')]);
+
+    agent()->prompt('Hello', provider: 'openai');
+
+    Http::assertSent(function (Request $request) {
+        $body = json_decode($request->body(), true);
+
+        return ! array_key_exists('reasoning', $body);
+    });
+});

tests/Fixtures/Agents/ReasoningDisabledAgent.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Tests\Fixtures\Agents;
+
+use Laravel\Ai\Attributes\Reasoning;
+use Laravel\Ai\Contracts\Agent;
+use Laravel\Ai\Promptable;
+
+#[Reasoning(false)]
+class ReasoningDisabledAgent implements Agent
+{
+    use Promptable;
+
+    public function instructions(): string
+    {
+        return 'You are a helpful assistant.';
+    }
+}

tests/Fixtures/Agents/ReasoningMethodAgent.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Tests\Fixtures\Agents;
+
+use Laravel\Ai\Contracts\Agent;
+use Laravel\Ai\Promptable;
+
+class ReasoningMethodAgent implements Agent
+{
+    use Promptable;
+
+    public function instructions(): string
+    {
+        return 'You are a helpful assistant.';
+    }
+
+    public function reasoning(): bool
+    {
+        return false;
+    }
+}