[Platform] Introduce Provider abstraction and model routing layer

chr-hertel · chr-hertel · commit e99655a7136a · 2026-04-20T22:16:48.000+02:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,7 @@ CHANGELOG
 ---
 
  * [BC BREAK] `PerplexityContract::create()` no longer accepts variadic `NormalizerInterface` arguments; pass an array instead
+ * [BC BREAK] Rename `PlatformFactory` to `Factory` with explicit `createProvider()` and `createPlatform()` methods
 
 0.7
 ---
diff --git a/Factory.php b/Factory.php
@@ -14,31 +14,59 @@
 use Symfony\AI\Platform\Bridge\Perplexity\Contract\PerplexityContract;
 use Symfony\AI\Platform\Contract;
 use Symfony\AI\Platform\ModelCatalog\ModelCatalogInterface;
+use Symfony\AI\Platform\ModelRouter\CatalogBasedModelRouter;
+use Symfony\AI\Platform\ModelRouterInterface;
 use Symfony\AI\Platform\Platform;
+use Symfony\AI\Platform\Provider;
+use Symfony\AI\Platform\ProviderInterface;
 use Symfony\Component\HttpClient\EventSourceHttpClient;
 use Symfony\Contracts\EventDispatcher\EventDispatcherInterface;
 use Symfony\Contracts\HttpClient\HttpClientInterface;
 
 /**
  * @author Mathieu Santostefano <msantostefano@proton.me>
  */
-final class PlatformFactory
+final class Factory
 {
-    public static function create(
+    /**
+     * @param non-empty-string $name
+     */
+    public static function createProvider(
         #[\SensitiveParameter] string $apiKey,
         ?HttpClientInterface $httpClient = null,
         ModelCatalogInterface $modelCatalog = new ModelCatalog(),
         ?Contract $contract = null,
         ?EventDispatcherInterface $eventDispatcher = null,
-    ): Platform {
+        string $name = 'perplexity',
+    ): ProviderInterface {
         $httpClient = $httpClient instanceof EventSourceHttpClient ? $httpClient : new EventSourceHttpClient($httpClient);
 
-        return new Platform(
+        return new Provider(
+            $name,
             [new ModelClient($httpClient, $apiKey)],
             [new ResultConverter()],
             $modelCatalog,
             $contract ?? PerplexityContract::create(),
             $eventDispatcher,
         );
     }
+
+    /**
+     * @param non-empty-string $name
+     */
+    public static function createPlatform(
+        #[\SensitiveParameter] string $apiKey,
+        ?HttpClientInterface $httpClient = null,
+        ModelCatalogInterface $modelCatalog = new ModelCatalog(),
+        ?Contract $contract = null,
+        ?EventDispatcherInterface $eventDispatcher = null,
+        string $name = 'perplexity',
+        ?ModelRouterInterface $modelRouter = null,
+    ): Platform {
+        return new Platform(
+            [self::createProvider($apiKey, $httpClient, $modelCatalog, $contract, $eventDispatcher, $name)],
+            $modelRouter ?? new CatalogBasedModelRouter(),
+            $eventDispatcher,
+        );
+    }
 }
diff --git a/Tests/FactoryTest.php b/Tests/FactoryTest.php
@@ -12,35 +12,35 @@
 namespace Symfony\AI\Platform\Bridge\Perplexity\Tests;
 
 use PHPUnit\Framework\TestCase;
-use Symfony\AI\Platform\Bridge\Perplexity\PlatformFactory;
+use Symfony\AI\Platform\Bridge\Perplexity\Factory;
 use Symfony\AI\Platform\Platform;
 use Symfony\Component\HttpClient\EventSourceHttpClient;
 use Symfony\Component\HttpClient\MockHttpClient;
 
 /**
  * @author Mathieu Santostefano <msantostefano@proton.me>
  */
-final class PlatformFactoryTest extends TestCase
+final class FactoryTest extends TestCase
 {
     public function testItCreatesPlatformWithDefaultSettings()
     {
-        $platform = PlatformFactory::create('pplx-test-api-key');
+        $platform = Factory::createPlatform('pplx-test-api-key');
 
         $this->assertInstanceOf(Platform::class, $platform);
     }
 
     public function testItCreatesPlatformWithCustomHttpClient()
     {
         $httpClient = new MockHttpClient();
-        $platform = PlatformFactory::create('pplx-test-api-key', $httpClient);
+        $platform = Factory::createPlatform('pplx-test-api-key', $httpClient);
 
         $this->assertInstanceOf(Platform::class, $platform);
     }
 
     public function testItCreatesPlatformWithEventSourceHttpClient()
     {
         $httpClient = new EventSourceHttpClient(new MockHttpClient());
-        $platform = PlatformFactory::create('pplx-test-api-key', $httpClient);
+        $platform = Factory::createPlatform('pplx-test-api-key', $httpClient);
 
         $this->assertInstanceOf(Platform::class, $platform);
     }

Original file line number	Diff line number	Diff line change
`@@ -12,35 +12,35 @@`
`12`	`12`	`namespace Symfony\AI\Platform\Bridge\Perplexity\Tests;`
`13`	`13`
`14`	`14`	`use PHPUnit\Framework\TestCase;`
`15`		`-use Symfony\AI\Platform\Bridge\Perplexity\PlatformFactory;`
	`15`	`+use Symfony\AI\Platform\Bridge\Perplexity\Factory;`
`16`	`16`	`use Symfony\AI\Platform\Platform;`
`17`	`17`	`use Symfony\Component\HttpClient\EventSourceHttpClient;`
`18`	`18`	`use Symfony\Component\HttpClient\MockHttpClient;`
`19`	`19`
`20`	`20`	`/**`
`21`	`21`	`* @author Mathieu Santostefano <[email protected]>`
`22`	`22`	`*/`
`23`		`-final class PlatformFactoryTest extends TestCase`
	`23`	`+final class FactoryTest extends TestCase`
`24`	`24`	`{`
`25`	`25`	`public function testItCreatesPlatformWithDefaultSettings()`
`26`	`26`	`{`
`27`		`- $platform = PlatformFactory::create('pplx-test-api-key');`
	`27`	`+ $platform = Factory::createPlatform('pplx-test-api-key');`
`28`	`28`
`29`	`29`	`$this->assertInstanceOf(Platform::class, $platform);`
`30`	`30`	`}`
`31`	`31`
`32`	`32`	`public function testItCreatesPlatformWithCustomHttpClient()`
`33`	`33`	`{`
`34`	`34`	`$httpClient = new MockHttpClient();`
`35`		`- $platform = PlatformFactory::create('pplx-test-api-key', $httpClient);`
	`35`	`+ $platform = Factory::createPlatform('pplx-test-api-key', $httpClient);`
`36`	`36`
`37`	`37`	`$this->assertInstanceOf(Platform::class, $platform);`
`38`	`38`	`}`
`39`	`39`
`40`	`40`	`public function testItCreatesPlatformWithEventSourceHttpClient()`
`41`	`41`	`{`
`42`	`42`	`$httpClient = new EventSourceHttpClient(new MockHttpClient());`
`43`		`- $platform = PlatformFactory::create('pplx-test-api-key', $httpClient);`
	`43`	`+ $platform = Factory::createPlatform('pplx-test-api-key', $httpClient);`
`44`	`44`
`45`	`45`	`$this->assertInstanceOf(Platform::class, $platform);`
`46`	`46`	`}`