feature #1066 [Chat] Split Local bridge into Cache and Memory bridges (OskarStark)

OskarStark · OskarStark · commit 656dc49b412f · 2025-12-07T18:09:17.000+01:00
This PR was merged into the main branch. Discussion ---------- [Chat] Split Local bridge into Cache and Memory bridges | Q | A | ------------- | --- | Bug fix? | no | New feature? | yes | Docs? | no | Issues | Follows #1063 | License | MIT Commits ------- 7fa18a4 [Chat] Split Local bridge into Cache and Memory bridges
diff --git a/docs/components/chat.rst b/docs/components/chat.rst
@@ -18,7 +18,7 @@ To initiate a chat, you need to instantiate the ``Symfony\AI\Chat\Chat`` along
 with a ``Symfony\AI\Agent\AgentInterface`` and a ``Symfony\AI\Chat\MessageStoreInterface``::
 
     use Symfony\AI\Agent\Agent;
-    use Symfony\AI\Chat\Bridge\Local\InMemoryStore;
+    use Symfony\AI\Chat\Bridge\Memory\Store as InMemoryStore;
     use Symfony\AI\Chat\Chat;
     use Symfony\AI\Platform\Bridge\OpenAi\Gpt;
     use Symfony\AI\Platform\Bridge\OpenAi\PlatformFactory;
diff --git a/examples/chat/persistent-chat-cache.php b/examples/chat/persistent-chat-cache.php
@@ -10,7 +10,7 @@
  */
 
 use Symfony\AI\Agent\Agent;
-use Symfony\AI\Chat\Bridge\Local\CacheStore;
+use Symfony\AI\Chat\Bridge\Cache\Store as CacheStore;
 use Symfony\AI\Chat\Chat;
 use Symfony\AI\Platform\Bridge\OpenAi\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;
diff --git a/examples/chat/persistent-chat.php b/examples/chat/persistent-chat.php
@@ -10,7 +10,7 @@
  */
 
 use Symfony\AI\Agent\Agent;
-use Symfony\AI\Chat\Bridge\Local\InMemoryStore;
+use Symfony\AI\Chat\Bridge\Memory\Store as InMemoryStore;
 use Symfony\AI\Chat\Chat;
 use Symfony\AI\Platform\Bridge\OpenAi\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;
diff --git a/examples/commands/message-stores.php b/examples/commands/message-stores.php
@@ -13,11 +13,11 @@
 
 use Doctrine\DBAL\DriverManager;
 use MongoDB\Client as MongoDbClient;
+use Symfony\AI\Chat\Bridge\Cache\Store as CacheStore;
 use Symfony\AI\Chat\Bridge\Doctrine\DoctrineDbalMessageStore;
 use Symfony\AI\Chat\Bridge\HttpFoundation\SessionStore;
-use Symfony\AI\Chat\Bridge\Local\CacheStore;
-use Symfony\AI\Chat\Bridge\Local\InMemoryStore;
 use Symfony\AI\Chat\Bridge\Meilisearch\MessageStore as MeilisearchMessageStore;
+use Symfony\AI\Chat\Bridge\Memory\Store as InMemoryStore;
 use Symfony\AI\Chat\Bridge\MongoDb\MessageStore as MongoDbMessageStore;
 use Symfony\AI\Chat\Bridge\Pogocache\MessageStore as PogocacheMessageStore;
 use Symfony\AI\Chat\Bridge\Redis\MessageStore as RedisMessageStore;
diff --git a/src/ai-bundle/src/AiBundle.php b/src/ai-bundle/src/AiBundle.php
@@ -36,12 +36,12 @@
 use Symfony\AI\AiBundle\Profiler\TraceablePlatform;
 use Symfony\AI\AiBundle\Profiler\TraceableToolbox;
 use Symfony\AI\AiBundle\Security\Attribute\IsGrantedTool;
+use Symfony\AI\Chat\Bridge\Cache\Store as CacheMessageStore;
 use Symfony\AI\Chat\Bridge\Cloudflare\MessageStore as CloudflareMessageStore;
 use Symfony\AI\Chat\Bridge\Doctrine\DoctrineDbalMessageStore;
 use Symfony\AI\Chat\Bridge\HttpFoundation\SessionStore;
-use Symfony\AI\Chat\Bridge\Local\CacheStore as CacheMessageStore;
-use Symfony\AI\Chat\Bridge\Local\InMemoryStore as InMemoryMessageStore;
 use Symfony\AI\Chat\Bridge\Meilisearch\MessageStore as MeilisearchMessageStore;
+use Symfony\AI\Chat\Bridge\Memory\Store as InMemoryMessageStore;
 use Symfony\AI\Chat\Bridge\MongoDb\MessageStore as MongoDbMessageStore;
 use Symfony\AI\Chat\Bridge\Pogocache\MessageStore as PogocacheMessageStore;
 use Symfony\AI\Chat\Bridge\Redis\MessageStore as RedisMessageStore;
diff --git a/src/ai-bundle/tests/Profiler/DataCollectorTest.php b/src/ai-bundle/tests/Profiler/DataCollectorTest.php
@@ -17,7 +17,7 @@
 use Symfony\AI\AiBundle\Profiler\TraceableChat;
 use Symfony\AI\AiBundle\Profiler\TraceableMessageStore;
 use Symfony\AI\AiBundle\Profiler\TraceablePlatform;
-use Symfony\AI\Chat\Bridge\Local\InMemoryStore;
+use Symfony\AI\Chat\Bridge\Memory\Store as InMemoryStore;
 use Symfony\AI\Chat\Chat;
 use Symfony\AI\Platform\Message\Content\Text;
 use Symfony\AI\Platform\Message\Message;
diff --git a/src/ai-bundle/tests/Profiler/TraceableChatTest.php b/src/ai-bundle/tests/Profiler/TraceableChatTest.php
@@ -14,7 +14,7 @@
 use PHPUnit\Framework\TestCase;
 use Symfony\AI\Agent\AgentInterface;
 use Symfony\AI\AiBundle\Profiler\TraceableChat;
-use Symfony\AI\Chat\Bridge\Local\InMemoryStore;
+use Symfony\AI\Chat\Bridge\Memory\Store as InMemoryStore;
 use Symfony\AI\Chat\Chat;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
diff --git a/src/ai-bundle/tests/Profiler/TraceableMessageStoreTest.php b/src/ai-bundle/tests/Profiler/TraceableMessageStoreTest.php
@@ -13,7 +13,7 @@
 
 use PHPUnit\Framework\TestCase;
 use Symfony\AI\AiBundle\Profiler\TraceableMessageStore;
-use Symfony\AI\Chat\Bridge\Local\InMemoryStore;
+use Symfony\AI\Chat\Bridge\Memory\Store as InMemoryStore;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
 use Symfony\Component\Clock\MonotonicClock;
diff --git a/src/chat/src/Bridge/Cache/Store.php b/src/chat/src/Bridge/Cache/Store.php
@@ -9,7 +9,7 @@
  * file that was distributed with this source code.
  */
 
-namespace Symfony\AI\Chat\Bridge\Local;
+namespace Symfony\AI\Chat\Bridge\Cache;
 
 use Psr\Cache\CacheItemPoolInterface;
 use Symfony\AI\Agent\Exception\RuntimeException;
@@ -20,7 +20,7 @@
 /**
  * @author Christopher Hertel <mail@christopher-hertel.de>
  */
-final class CacheStore implements ManagedStoreInterface, MessageStoreInterface
+final class Store implements ManagedStoreInterface, MessageStoreInterface
 {
     public function __construct(
         private readonly CacheItemPoolInterface $cache,
diff --git a/src/chat/src/Bridge/Memory/Store.php b/src/chat/src/Bridge/Memory/Store.php
@@ -9,7 +9,7 @@
  * file that was distributed with this source code.
  */
 
-namespace Symfony\AI\Chat\Bridge\Local;
+namespace Symfony\AI\Chat\Bridge\Memory;
 
 use Symfony\AI\Chat\ManagedStoreInterface;
 use Symfony\AI\Chat\MessageStoreInterface;
@@ -18,7 +18,7 @@
 /**
  * @author Christopher Hertel <mail@christopher-hertel.de>
  */
-final class InMemoryStore implements ManagedStoreInterface, MessageStoreInterface
+final class Store implements ManagedStoreInterface, MessageStoreInterface
 {
     /**
      * @var MessageBag[]
diff --git a/src/chat/tests/Bridge/Cache/StoreTest.php b/src/chat/tests/Bridge/Cache/StoreTest.php
@@ -9,16 +9,16 @@
  * file that was distributed with this source code.
  */
 
-namespace Symfony\AI\Chat\Tests\Bridge\Local;
+namespace Symfony\AI\Chat\Tests\Bridge\Cache;
 
 use PHPUnit\Framework\TestCase;
 use Psr\Cache\CacheItemInterface;
 use Psr\Cache\CacheItemPoolInterface;
-use Symfony\AI\Chat\Bridge\Local\CacheStore;
+use Symfony\AI\Chat\Bridge\Cache\Store;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
 
-final class CacheStoreTest extends TestCase
+final class StoreTest extends TestCase
 {
     public function testSetupStoresEmptyMessageBag()
     {
@@ -43,7 +43,7 @@ public function testSetupStoresEmptyMessageBag()
             ->method('save')
             ->with($cacheItem);
 
-        $store = new CacheStore($cache, 'test_key');
+        $store = new Store($cache, 'test_key');
         $store->setup();
     }
 
@@ -64,7 +64,7 @@ public function testSetupWithCustomTtl()
             ->method('save')
             ->with($cacheItem);
 
-        $store = new CacheStore($cache, 'test_key', 3600);
+        $store = new Store($cache, 'test_key', 3600);
         $store->setup();
     }
 
@@ -94,7 +94,7 @@ public function testSaveStoresMessageBag()
             ->method('save')
             ->with($cacheItem);
 
-        $store = new CacheStore($cache, 'messages');
+        $store = new Store($cache, 'messages');
         $store->save($messageBag);
     }
 
@@ -119,7 +119,7 @@ public function testLoadReturnsStoredMessages()
             ->method('get')
             ->willReturn($messageBag);
 
-        $store = new CacheStore($cache, 'test_key');
+        $store = new Store($cache, 'test_key');
         $result = $store->load();
 
         $this->assertSame($messageBag, $result);
@@ -143,7 +143,7 @@ public function testLoadReturnsEmptyMessageBagWhenCacheMiss()
         $cacheItem->expects($this->never())
             ->method('get');
 
-        $store = new CacheStore($cache, 'test_key');
+        $store = new Store($cache, 'test_key');
         $result = $store->load();
 
         $this->assertInstanceOf(MessageBag::class, $result);
@@ -158,7 +158,7 @@ public function testDropDeletesCacheItem()
             ->method('deleteItem')
             ->with('messages');
 
-        $store = new CacheStore($cache, 'messages');
+        $store = new Store($cache, 'messages');
         $store->drop();
     }
 }
diff --git a/src/chat/tests/Bridge/Memory/StoreTest.php b/src/chat/tests/Bridge/Memory/StoreTest.php
@@ -9,20 +9,20 @@
  * file that was distributed with this source code.
  */
 
-namespace Symfony\AI\Chat\Tests\Bridge\Local;
+namespace Symfony\AI\Chat\Tests\Bridge\Memory;
 
 use PHPUnit\Framework\TestCase;
-use Symfony\AI\Chat\Bridge\Local\InMemoryStore;
+use Symfony\AI\Chat\Bridge\Memory\Store;
 use Symfony\AI\Platform\Message\Content\Text;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
 use Symfony\AI\Platform\Message\UserMessage;
 
-final class InMemoryStoreTest extends TestCase
+final class StoreTest extends TestCase
 {
     public function testSetupInitializesEmptyMessageBag()
     {
-        $store = new InMemoryStore();
+        $store = new Store();
         $store->setup();
 
         $messages = $store->load();
@@ -33,7 +33,7 @@ public function testSetupInitializesEmptyMessageBag()
 
     public function testSaveStoresMessageBag()
     {
-        $store = new InMemoryStore();
+        $store = new Store();
 
         $messageBag = new MessageBag();
         $messageBag->add(Message::ofUser('Hello'));
@@ -49,7 +49,7 @@ public function testSaveStoresMessageBag()
 
     public function testLoadReturnsEmptyMessageBagWhenNotInitialized()
     {
-        $store = new InMemoryStore();
+        $store = new Store();
 
         $messages = $store->load();
 
@@ -59,7 +59,7 @@ public function testLoadReturnsEmptyMessageBagWhenNotInitialized()
 
     public function testLoadReturnsStoredMessages()
     {
-        $store = new InMemoryStore();
+        $store = new Store();
         $store->setup();
 
         $messageBag = new MessageBag();
@@ -78,7 +78,7 @@ public function testLoadReturnsStoredMessages()
 
     public function testDropClearsMessages()
     {
-        $store = new InMemoryStore();
+        $store = new Store();
 
         $messageBag = new MessageBag();
         $messageBag->add(Message::ofUser('Message 1'));
@@ -95,7 +95,7 @@ public function testDropClearsMessages()
 
     public function testSetupOptions()
     {
-        $store = new InMemoryStore();
+        $store = new Store();
 
         $store->setup(['foo' => 'bar']);
 
diff --git a/src/chat/tests/ChatTest.php b/src/chat/tests/ChatTest.php
@@ -14,7 +14,7 @@
 use PHPUnit\Framework\MockObject\MockObject;
 use PHPUnit\Framework\TestCase;
 use Symfony\AI\Agent\AgentInterface;
-use Symfony\AI\Chat\Bridge\Local\InMemoryStore;
+use Symfony\AI\Chat\Bridge\Memory\Store as InMemoryStore;
 use Symfony\AI\Chat\Chat;
 use Symfony\AI\Platform\Message\AssistantMessage;
 use Symfony\AI\Platform\Message\Message;
