ref

Guikingone · Guikingone · commit ce2f0201652d · 2025-12-19T10:01:33.000+01:00
diff --git a/docs/components/platform.rst b/docs/components/platform.rst
@@ -467,30 +467,30 @@ High Availability
 As most platform exposes a REST API, errors can occurs during generation phase due to network issues, timeout and more.
 
 To prevent exceptions at the application level and allows to keep a smooth experience for end users,
-the ``Symfony\AI\Platform\FailoverPlatform`` can be used to automatically call a backup platform::
+the :class:``Symfony\\AI\\Platform\\Bridge\\Failover\\FailoverPlatform`` can be used to automatically call a backup platform::
 
+    use Symfony\AI\Platform\Bridge\Failover\FailoverPlatform;
     use Symfony\AI\Platform\Bridge\Ollama\PlatformFactory as OllamaPlatformFactory;
     use Symfony\AI\Platform\Bridge\OpenAi\PlatformFactory as OpenAiPlatformFactory;
-    use Symfony\AI\Platform\FailoverPlatform;
     use Symfony\AI\Platform\Message\Message;
     use Symfony\AI\Platform\Message\MessageBag;
     use Symfony\Component\RateLimiter\RateLimiterFactory;
     use Symfony\Component\RateLimiter\Storage\InMemoryStorage;
 
-    $ollamaPlatform = OllamaPlatformFactory::create('http://127.0.0.1:11434', http_client());
-    $openAiPlatform = OpenAiPlatformFactory::create('sk-foo', http_client());
-
-    $failoverPlatform = new FailoverPlatform([
-        $ollamaPlatform, // # Ollama will fail as 'gpt-4o' is not available in the catalog
-        $openAiPlatform,
-    ], new RateLimiterFactory([
+    $rateLimiter = new RateLimiterFactory([
         'policy' => 'sliding_window',
         'id' => 'failover',
-        'interval' => '60 seconds',
+        'interval' => '3 seconds',
         'limit' => 1,
-    ], new InMemoryStorage()));
+    ], new InMemoryStorage());
+
+    // # Ollama will fail as 'gpt-4o' is not available in the catalog
+    $platform = new FailoverPlatform([
+        OllamaPlatformFactory::create(env('OLLAMA_HOST_URL'), http_client()),
+        OpenAiPlatformFactory::create(env('OPENAI_API_KEY'), http_client()),
+    ], $rateLimiter);
 
-    $result = $failoverPlatform->invoke('gpt-4o', new MessageBag(
+    $result = $platform->invoke('gpt-4o', new MessageBag(
         Message::forSystem('You are a helpful assistant.'),
         Message::ofUser('Tina has one brother and one sister. How many sisters do Tina\'s siblings have?'),
     ));
diff --git a/examples/composer.json b/examples/composer.json
@@ -84,6 +84,7 @@
         "symfony/ai-docker-model-runner-platform": "@dev",
         "symfony/ai-elasticsearch-store": "@dev",
         "symfony/ai-eleven-labs-platform": "@dev",
+        "symfony/ai-failover-platform": "@dev",
         "symfony/ai-gemini-platform": "@dev",
         "symfony/ai-generic-platform": "@dev",
         "symfony/ai-session-message-store": "@dev",
diff --git a/examples/misc/failover-platform.php b/examples/misc/failover-platform.php
@@ -9,32 +9,35 @@
  * file that was distributed with this source code.
  */
 
+use Symfony\AI\Platform\Bridge\Failover\FailoverPlatform;
 use Symfony\AI\Platform\Bridge\Ollama\PlatformFactory as OllamaPlatformFactory;
+use Symfony\AI\Platform\Bridge\OpenAi\Gpt\ResultConverter;
 use Symfony\AI\Platform\Bridge\OpenAi\PlatformFactory as OpenAiPlatformFactory;
-use Symfony\AI\Platform\FailoverPlatform;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
 use Symfony\Component\RateLimiter\RateLimiterFactory;
 use Symfony\Component\RateLimiter\Storage\InMemoryStorage;
 
 require_once dirname(__DIR__).'/bootstrap.php';
 
-$ollamaPlatform = OllamaPlatformFactory::create(env('OLLAMA_HOST_URL'), http_client());
-$openAiPlatform = OpenAiPlatformFactory::create(env('OPENAI_API_KEY'), http_client());
-
-$platform = new FailoverPlatform([
-    $ollamaPlatform, // # Ollama will fail as 'gpt-4o' is not available in the catalog
-    $openAiPlatform,
-], new RateLimiterFactory([
+$rateLimiter = new RateLimiterFactory([
     'policy' => 'sliding_window',
     'id' => 'failover',
     'interval' => '3 seconds',
     'limit' => 1,
-], new InMemoryStorage()));
+], new InMemoryStorage());
+
+// # Ollama will fail as 'gpt-4o' is not available in the catalog
+$platform = new FailoverPlatform([
+    OllamaPlatformFactory::create(env('OLLAMA_HOST_URL'), http_client()),
+    OpenAiPlatformFactory::create(env('OPENAI_API_KEY'), http_client()),
+], $rateLimiter);
 
 $result = $platform->invoke('gpt-4o', new MessageBag(
     Message::forSystem('You are a helpful assistant.'),
     Message::ofUser('Tina has one brother and one sister. How many sisters do Tina\'s siblings have?'),
 ));
 
+assert($result->getResultConverter() instanceof ResultConverter);
+
 echo $result->asText().\PHP_EOL;
diff --git a/src/ai-bundle/src/AiBundle.php b/src/ai-bundle/src/AiBundle.php
@@ -77,7 +77,7 @@
 use Symfony\AI\Platform\CachedPlatform;
 use Symfony\AI\Platform\Capability;
 use Symfony\AI\Platform\Exception\RuntimeException;
-use Symfony\AI\Platform\FailoverPlatform;
+use Symfony\AI\Platform\Bridge\Failover\FailoverPlatform;
 use Symfony\AI\Platform\Message\Content\File;
 use Symfony\AI\Platform\ModelCatalog\ModelCatalogInterface;
 use Symfony\AI\Platform\ModelClientInterface;
diff --git a/src/ai-bundle/tests/DependencyInjection/AiBundleTest.php b/src/ai-bundle/tests/DependencyInjection/AiBundleTest.php
@@ -37,7 +37,7 @@
 use Symfony\AI\Platform\CachedPlatform;
 use Symfony\AI\Platform\Capability;
 use Symfony\AI\Platform\EventListener\TemplateRendererListener;
-use Symfony\AI\Platform\FailoverPlatform;
+use Symfony\AI\Platform\Bridge\Failover\FailoverPlatform;
 use Symfony\AI\Platform\Message\TemplateRenderer\ExpressionLanguageTemplateRenderer;
 use Symfony\AI\Platform\Message\TemplateRenderer\StringTemplateRenderer;
 use Symfony\AI\Platform\Message\TemplateRenderer\TemplateRendererRegistry;
diff --git a/src/platform/composer.json b/src/platform/composer.json
@@ -73,7 +73,6 @@
         "symfony/http-client": "^7.3|^8.0",
         "symfony/http-client-contracts": "^3.5",
         "symfony/process": "^7.3|^8.0",
-        "symfony/rate-limiter": "^7.3|^8.0",
         "symfony/var-dumper": "^7.3|^8.0"
     },
     "minimum-stability": "dev",
diff --git a/src/platform/src/Bridge/Failover/.gitattributes b/src/platform/src/Bridge/Failover/.gitattributes
@@ -0,0 +1,3 @@
+/Tests export-ignore
+/phpunit.xml.dist export-ignore
+/.git* export-ignore
diff --git a/src/platform/src/Bridge/Failover/.github/PULL_REQUEST_TEMPLATE.md b/src/platform/src/Bridge/Failover/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,8 @@
+Please do not submit any Pull Requests here. They will be closed.
+---
+
+Please submit your PR here instead:
+https://github.com/symfony/ai
+
+This repository is what we call a "subtree split": a read-only subset of that main repository.
+We're looking forward to your PR there!
diff --git a/src/platform/src/Bridge/Failover/.github/workflows/close-pull-request.yml b/src/platform/src/Bridge/Failover/.github/workflows/close-pull-request.yml
@@ -0,0 +1,20 @@
+name: Close Pull Request
+
+on:
+  pull_request_target:
+    types: [opened]
+
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: superbrothers/close-pull-request@v3
+      with:
+        comment: |
+          Thanks for your Pull Request! We love contributions.
+
+          However, you should instead open your PR on the main repository:
+          https://github.com/symfony/ai
+
+          This repository is what we call a "subtree split": a read-only subset of that main repository.
+          We're looking forward to your PR there!
diff --git a/src/platform/src/Bridge/Failover/.gitignore b/src/platform/src/Bridge/Failover/.gitignore
@@ -0,0 +1,4 @@
+vendor/
+composer.lock
+phpunit.xml
+.phpunit.result.cache
diff --git a/src/platform/src/Bridge/Failover/CHANGELOG.md b/src/platform/src/Bridge/Failover/CHANGELOG.md
@@ -0,0 +1,7 @@
+CHANGELOG
+=========
+
+0.1
+---
+
+ * Add the bridge
diff --git a/src/platform/src/Bridge/Failover/FailoverPlatform.php b/src/platform/src/Bridge/Failover/FailoverPlatform.php
@@ -9,13 +9,14 @@
  * file that was distributed with this source code.
  */
 
-namespace Symfony\AI\Platform;
+namespace Symfony\AI\Platform\Bridge\Failover;
 
 use Psr\Log\LoggerInterface;
 use Psr\Log\NullLogger;
 use Symfony\AI\Platform\Exception\LogicException;
 use Symfony\AI\Platform\Exception\RuntimeException;
 use Symfony\AI\Platform\ModelCatalog\ModelCatalogInterface;
+use Symfony\AI\Platform\PlatformInterface;
 use Symfony\AI\Platform\Result\DeferredResult;
 use Symfony\Component\Clock\ClockInterface;
 use Symfony\Component\Clock\MonotonicClock;
diff --git a/src/platform/src/Bridge/Failover/LICENSE b/src/platform/src/Bridge/Failover/LICENSE
@@ -0,0 +1,19 @@
+Copyright (c) 2025-present Fabien Potencier
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
diff --git a/src/platform/src/Bridge/Failover/README.md b/src/platform/src/Bridge/Failover/README.md
@@ -0,0 +1,12 @@
+Failover Platform
+===================
+
+Failover platform bridge for Symfony AI.
+
+Resources
+---------
+
+ * [Contributing](https://symfony.com/doc/current/contributing/index.html)
+ * [Report issues](https://github.com/symfony/ai/issues) and
+   [send Pull Requests](https://github.com/symfony/ai/pulls)
+   in the [main Symfony AI repository](https://github.com/symfony/ai)
diff --git a/src/platform/src/Bridge/Failover/Tests/FailoverPlatformTest.php b/src/platform/src/Bridge/Failover/Tests/FailoverPlatformTest.php
@@ -9,12 +9,12 @@
  * file that was distributed with this source code.
  */
 
-namespace Symfony\AI\Platform\Tests;
+namespace Symfony\AI\Platform\Bridge\Failover\Tests;
 
 use PHPUnit\Framework\TestCase;
 use Psr\Log\LoggerInterface;
+use Symfony\AI\Platform\Bridge\Failover\FailoverPlatform;
 use Symfony\AI\Platform\Exception\RuntimeException;
-use Symfony\AI\Platform\FailoverPlatform;
 use Symfony\AI\Platform\ModelCatalog\FallbackModelCatalog;
 use Symfony\AI\Platform\ModelCatalog\ModelCatalogInterface;
 use Symfony\AI\Platform\PlatformInterface;
diff --git a/src/platform/src/Bridge/Failover/composer.json b/src/platform/src/Bridge/Failover/composer.json
@@ -0,0 +1,59 @@
+{
+    "name": "symfony/ai-failover-platform",
+    "description": "Failover platform bridge for Symfony AI",
+    "license": "MIT",
+    "type": "symfony-ai-platform",
+    "keywords": [
+        "ai",
+        "bridge",
+        "platform"
+    ],
+    "authors": [
+        {
+            "name": "Christopher Hertel",
+            "email": "mail@christopher-hertel.de"
+        },
+        {
+            "name": "Oskar Stark",
+            "email": "oskarstark@googlemail.com"
+        },
+        {
+            "name": "Symfony Community",
+            "homepage": "https://symfony.com/contributors"
+        }
+    ],
+    "require": {
+        "php": ">=8.2",
+        "symfony/ai-platform": "@dev",
+        "symfony/rate-limiter": "^7.3|^8.0"
+    },
+    "require-dev": {
+        "phpstan/phpstan": "^2.1",
+        "phpstan/phpstan-strict-rules": "^2.0",
+        "phpunit/phpunit": "^11.5.46"
+    },
+    "minimum-stability": "dev",
+    "autoload": {
+        "psr-4": {
+            "Symfony\\AI\\Platform\\Bridge\\Failover\\": ""
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Symfony\\AI\\PHPStan\\": "../../../../../.phpstan/",
+            "Symfony\\AI\\Platform\\Bridge\\Failover\\Tests\\": "Tests/"
+        }
+    },
+    "config": {
+        "sort-packages": true
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-main": "0.x-dev"
+        },
+        "thanks": {
+            "name": "symfony/ai",
+            "url": "https://github.com/symfony/ai"
+        }
+    }
+}
diff --git a/src/platform/src/Bridge/Failover/phpstan.dist.neon b/src/platform/src/Bridge/Failover/phpstan.dist.neon
@@ -0,0 +1,23 @@
+includes:
+    - ../../../../../.phpstan/extension.neon
+
+parameters:
+    level: 6
+    paths:
+        - .
+        - Tests/
+    excludePaths:
+        - vendor/
+    treatPhpDocTypesAsCertain: false
+    ignoreErrors:
+        -
+            message: "#^Method .*::test.*\\(\\) has no return type specified\\.$#"
+            reportUnmatched: false
+        -
+            identifier: missingType.iterableValue
+            path: Tests/*
+            reportUnmatched: false
+        -
+            identifier: 'symfonyAi.forbidNativeException'
+            path: Tests/*
+            reportUnmatched: false
diff --git a/src/platform/src/Bridge/Failover/phpunit.xml.dist b/src/platform/src/Bridge/Failover/phpunit.xml.dist
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
+         backupGlobals="false"
+         colors="true"
+         bootstrap="vendor/autoload.php"
+         failOnDeprecation="true"
+         failOnRisky="true"
+         failOnWarning="true"
+>
+    <php>
+        <ini name="error_reporting" value="-1" />
+    </php>
+
+    <testsuites>
+        <testsuite name="Symfony AI Failover Platform Test Suite">
+            <directory>./Tests/</directory>
+        </testsuite>
+    </testsuites>
+
+    <source ignoreSuppressionOfDeprecations="true">
+        <include>
+            <directory>./</directory>
+        </include>
+        <exclude>
+            <directory>./Resources</directory>
+            <directory>./Tests</directory>
+            <directory>./vendor</directory>
+        </exclude>
+    </source>
+</phpunit>

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+/Tests export-ignore`
	`2`	`+/phpunit.xml.dist export-ignore`
	`3`	`+/.git* export-ignore`