feature #328 [Store] Add ManagedStoreInterface (Guikingone)

This PR was squashed before being merged into the main branch.

Discussion
----------

[Store] Add ManagedStoreInterface

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | yes
| Docs?         | yes
| Issues        | #285 #314
| License       | MIT

Hi 👋🏻

This PR aim to introduce the `ManagedStoreInterface` as discussed in #285, `Store` is a critical part of this library so I'm not gonna pretend that I know how each store currently work but here's the refactoring for most of them, tests must be improved but here's the first "draft".

This PR does not include the related commands.

Commits
-------

35aec00 [Store] Add ManagedStoreInterface

Author: chr-hertel

examples/memory/mariadb.php

@@ -54,7 +54,7 @@
 }
 
 // initialize the table
-$store->initialize();
+$store->setup();
 
 // create embeddings for documents as preparation of the chain memory
 $platform = PlatformFactory::create(env('OPENAI_API_KEY'), http_client());

examples/rag/mariadb-gemini.php

@@ -48,7 +48,7 @@
 }
 
 // initialize the table
-$store->initialize(['dimensions' => 768]);
+$store->setup(['dimensions' => 768]);
 
 // create embeddings for documents
 $platform = PlatformFactory::create(env('GEMINI_API_KEY'), http_client());

examples/rag/mariadb-openai.php

@@ -47,7 +47,7 @@
 }
 
 // initialize the table
-$store->initialize();
+$store->setup();
 
 // create embeddings for documents
 $platform = PlatformFactory::create(env('OPENAI_API_KEY'), http_client());

examples/rag/meilisearch.php

@@ -48,7 +48,7 @@
 }
 
 // initialize the index
-$store->initialize();
+$store->setup();
 
 // create embeddings for documents
 $platform = PlatformFactory::create(env('OPENAI_API_KEY'), http_client());

examples/rag/mongodb.php

@@ -54,7 +54,7 @@
 $indexer->index($documents);
 
 // initialize the index
-$store->initialize();
+$store->setup();
 
 $model = new Gpt(Gpt::GPT_4O_MINI);
 

examples/rag/neo4j.php

@@ -41,7 +41,7 @@
 );
 
 // initialize the table
-$store->initialize();
+$store->setup();
 
 // create embeddings and documents
 $documents = [];

examples/rag/postgres.php

@@ -47,7 +47,7 @@
 }
 
 // initialize the table
-$store->initialize();
+$store->setup();
 
 // create embeddings for documents
 $platform = PlatformFactory::create(env('OPENAI_API_KEY'), http_client());

examples/rag/qdrant.php

@@ -38,7 +38,7 @@
 );
 
 // initialize the collection (needs to be called before the indexer)
-$store->initialize();
+$store->setup();
 
 // create embeddings and documents
 foreach (Movies::all() as $movie) {

examples/rag/surrealdb.php

@@ -41,7 +41,7 @@
 );
 
 // initialize the table
-$store->initialize();
+$store->setup();
 
 // create embeddings and documents
 $documents = [];

examples/rag/typesense.php

@@ -37,7 +37,7 @@
 );
 
 // initialize the index
-$store->initialize();
+$store->setup();
 
 // create embeddings and documents
 $documents = [];