add anthropic rate limit exception

Author: floranpagliai

src/platform/src/Bridge/Anthropic/ResultConverter.php

@@ -11,6 +11,7 @@
 
 namespace Symfony\AI\Platform\Bridge\Anthropic;
 
+use Symfony\AI\Platform\Exception\RateExceededException;
 use Symfony\AI\Platform\Exception\RuntimeException;
 use Symfony\AI\Platform\Model;
 use Symfony\AI\Platform\Result\RawHttpResult;
@@ -38,8 +39,16 @@ public function supports(Model $model): bool
 
     public function convert(RawHttpResult|RawResultInterface $result, array $options = []): ResultInterface
     {
+        $response = $result->getObject();
+
+        if (429 === $response->getStatusCode()) {
+            $retryAfter = $response->getHeaders(false)['retry-after'][0] ?? null;
+            $retryAfterValue = $retryAfter ? (float) $retryAfter : null;
+            throw new RateExceededException('Rate limit exceeded', $retryAfterValue);
+        }
+
         if ($options['stream'] ?? false) {
-            return new StreamResult($this->convertStream($result->getObject()));
+            return new StreamResult($this->convertStream($response));
         }
 
         $data = $result->getData();

src/platform/src/Exception/RateExceededException.php

@@ -0,0 +1,25 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\AI\Platform\Exception;
+
+/**
+ * @author Floran Pagliai <floran.pagliai@gmail.com>
+ */
+final class RateExceededException extends \RuntimeException implements ExceptionInterface
+{
+    public function __construct(
+        string $message,
+        public readonly ?float $retryAfter = null,
+    ) {
+        parent::__construct($message);
+    }
+}

src/platform/tests/Bridge/Anthropic/ResultConverterRateLimitTest.php

@@ -0,0 +1,73 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\AI\Platform\Tests\Bridge\Anthropic;
+
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\Small;
+use PHPUnit\Framework\TestCase;
+use Symfony\AI\Platform\Bridge\Anthropic\ResultConverter;
+use Symfony\AI\Platform\Exception\RateExceededException;
+use Symfony\AI\Platform\Result\RawHttpResult;
+use Symfony\Component\HttpClient\MockHttpClient;
+use Symfony\Component\HttpClient\Response\MockResponse;
+
+#[CoversClass(ResultConverter::class)]
+#[Small]
+final class ResultConverterRateLimitTest extends TestCase
+{
+    public function testRateLimitExceededThrowsException()
+    {
+        $httpClient = new MockHttpClient([
+            new MockResponse('{"type":"error","error":{"type":"rate_limit_error","message":"This request would exceed the rate limit for your organization"}}', [
+                'http_code' => 429,
+                'response_headers' => [
+                    'retry-after' => '60',
+                ],
+            ]),
+        ]);
+
+        $httpResponse = $httpClient->request('POST', 'https://api.anthropic.com/v1/messages');
+        $handler = new ResultConverter();
+
+        $this->expectException(RateExceededException::class);
+        $this->expectExceptionMessage('Rate limit exceeded');
+
+        try {
+            $handler->convert(new RawHttpResult($httpResponse));
+        } catch (RateExceededException $e) {
+            $this->assertSame(60.0, $e->retryAfter);
+            throw $e;
+        }
+    }
+
+    public function testRateLimitExceededWithoutRetryAfter()
+    {
+        $httpClient = new MockHttpClient([
+            new MockResponse('{"type":"error","error":{"type":"rate_limit_error","message":"This request would exceed the rate limit for your organization"}}', [
+                'http_code' => 429,
+            ]),
+        ]);
+
+        $httpResponse = $httpClient->request('POST', 'https://api.anthropic.com/v1/messages');
+        $handler = new ResultConverter();
+
+        $this->expectException(RateExceededException::class);
+        $this->expectExceptionMessage('Rate limit exceeded');
+
+        try {
+            $handler->convert(new RawHttpResult($httpResponse));
+        } catch (RateExceededException $e) {
+            $this->assertNull($e->retryAfter);
+            throw $e;
+        }
+    }
+}