feat(server): Rework transport architecture and add StreamableHttpTransport (#49)

* feat(server): Rework transport architecture and add StreamableHttpTransport

- `Server::connect()` no longer contains a processing loop.
- `TransportInterface` is updated with `setMessageHandler()` and `listen()`.
- `StdioTransport` is updated to implement the new interface.
- A new, minimal `StreamableHttpTransport` is added for stateless HTTP.

* refactor(server): use  event-driven message handling

* feat(server): Introduce a formal session management system

* fix: ensure session elements are preserved when building server (regression from #46)

* refactor: consolidate HTTP example to use shared dependencies

* feat(server): Enhance message handling with session support

- Updated `TransportInterface` to use `onMessage` for handling incoming messages with session IDs.
- Refactored `Server`, `Handler`, and transport classes to accommodate session management using `Uuid`.
- Introduced methods for creating sessions with auto-generated and specific UUIDs in `SessionFactory` and `SessionFactoryInterface`.

* feat(server): Integrate session management in message handling

- Added session support to the `Server` and `Handler` classes, allowing for session data to be managed during message processing.
- Updated `TransportInterface` to include session context in the `send` method.
- Refactored various request handlers to utilize session information, ensuring proper session handling for incoming requests.
- Introduced a file-based session store for persistent session data management

* feat: Update session builder method to use set* instead of with*

* feat: Fix test compatibility with new session management architecture

* chore: apply code style fixes

* fix: remove deprecated SSE transport and resolve PHPStan issues

src/Server/RequestHandler/CallToolHandler.php

@@ -18,6 +18,7 @@ use Mcp\Schema\JsonRpc\HasMethodInterface;
 use Mcp\Schema\JsonRpc\Response;
 use Mcp\Schema\Request\CallToolRequest;
 use Mcp\Server\MethodHandlerInterface;
+use Mcp\Server\Session\SessionInterface;
 use Psr\Log\LoggerInterface;
 use Psr\Log\NullLogger;
 
@@ -38,7 +39,7 @@ final class CallToolHandler implements MethodHandlerInterface
         return $message instanceof CallToolRequest;
     }
 
-    public function handle(CallToolRequest|HasMethodInterface $message): Response|Error
+    public function handle(CallToolRequest|HasMethodInterface $message, SessionInterface $session): Response|Error
     {
         \assert($message instanceof CallToolRequest);
 

src/Server/RequestHandler/GetPromptHandler.php

@@ -18,6 +18,7 @@ use Mcp\Schema\JsonRpc\HasMethodInterface;
 use Mcp\Schema\JsonRpc\Response;
 use Mcp\Schema\Request\GetPromptRequest;
 use Mcp\Server\MethodHandlerInterface;
+use Mcp\Server\Session\SessionInterface;
 
 /**
  * @author Tobias Nyholm <tobias.nyholm@gmail.com>
@@ -34,7 +35,7 @@ final class GetPromptHandler implements MethodHandlerInterface
         return $message instanceof GetPromptRequest;
     }
 
-    public function handle(GetPromptRequest|HasMethodInterface $message): Response|Error
+    public function handle(GetPromptRequest|HasMethodInterface $message, SessionInterface $session): Response|Error
     {
         \assert($message instanceof GetPromptRequest);
 

src/Server/RequestHandler/InitializeHandler.php

@@ -18,6 +18,7 @@ use Mcp\Schema\Request\InitializeRequest;
 use Mcp\Schema\Result\InitializeResult;
 use Mcp\Schema\ServerCapabilities;
 use Mcp\Server\MethodHandlerInterface;
+use Mcp\Server\Session\SessionInterface;
 
 /**
  * @author Christopher Hertel <mail@christopher-hertel.de>
@@ -35,11 +36,14 @@ final class InitializeHandler implements MethodHandlerInterface
         return $message instanceof InitializeRequest;
     }
 
-    public function handle(InitializeRequest|HasMethodInterface $message): Response
+    public function handle(InitializeRequest|HasMethodInterface $message, SessionInterface $session): Response
     {
         \assert($message instanceof InitializeRequest);
 
-        return new Response($message->getId(),
+        $session->set('client_info', $message->clientInfo->jsonSerialize());
+
+        return new Response(
+            $message->getId(),
             new InitializeResult($this->capabilities, $this->serverInfo),
         );
     }

src/Server/RequestHandler/ListPromptsHandler.php

@@ -17,6 +17,7 @@ use Mcp\Schema\JsonRpc\Response;
 use Mcp\Schema\Request\ListPromptsRequest;
 use Mcp\Schema\Result\ListPromptsResult;
 use Mcp\Server\MethodHandlerInterface;
+use Mcp\Server\Session\SessionInterface;
 
 /**
  * @author Tobias Nyholm <tobias.nyholm@gmail.com>
@@ -34,7 +35,7 @@ final class ListPromptsHandler implements MethodHandlerInterface
         return $message instanceof ListPromptsRequest;
     }
 
-    public function handle(ListPromptsRequest|HasMethodInterface $message): Response
+    public function handle(ListPromptsRequest|HasMethodInterface $message, SessionInterface $session): Response
     {
         \assert($message instanceof ListPromptsRequest);
 

src/Server/RequestHandler/ListResourcesHandler.php

@@ -17,6 +17,7 @@ use Mcp\Schema\JsonRpc\Response;
 use Mcp\Schema\Request\ListResourcesRequest;
 use Mcp\Schema\Result\ListResourcesResult;
 use Mcp\Server\MethodHandlerInterface;
+use Mcp\Server\Session\SessionInterface;
 
 /**
  * @author Tobias Nyholm <tobias.nyholm@gmail.com>
@@ -34,7 +35,7 @@ final class ListResourcesHandler implements MethodHandlerInterface
         return $message instanceof ListResourcesRequest;
     }
 
-    public function handle(ListResourcesRequest|HasMethodInterface $message): Response
+    public function handle(ListResourcesRequest|HasMethodInterface $message, SessionInterface $session): Response
     {
         \assert($message instanceof ListResourcesRequest);
 

src/Server/RequestHandler/ListToolsHandler.php

@@ -17,6 +17,7 @@ use Mcp\Schema\JsonRpc\Response;
 use Mcp\Schema\Request\ListToolsRequest;
 use Mcp\Schema\Result\ListToolsResult;
 use Mcp\Server\MethodHandlerInterface;
+use Mcp\Server\Session\SessionInterface;
 
 /**
  * @author Christopher Hertel <mail@christopher-hertel.de>
@@ -35,7 +36,7 @@ final class ListToolsHandler implements MethodHandlerInterface
         return $message instanceof ListToolsRequest;
     }
 
-    public function handle(ListToolsRequest|HasMethodInterface $message): Response
+    public function handle(ListToolsRequest|HasMethodInterface $message, SessionInterface $session): Response
     {
         \assert($message instanceof ListToolsRequest);
 

src/Server/RequestHandler/PingHandler.php

@@ -16,6 +16,7 @@ use Mcp\Schema\JsonRpc\Response;
 use Mcp\Schema\Request\PingRequest;
 use Mcp\Schema\Result\EmptyResult;
 use Mcp\Server\MethodHandlerInterface;
+use Mcp\Server\Session\SessionInterface;
 
 /**
  * @author Christopher Hertel <mail@christopher-hertel.de>
@@ -27,7 +28,7 @@ final class PingHandler implements MethodHandlerInterface
         return $message instanceof PingRequest;
     }
 
-    public function handle(PingRequest|HasMethodInterface $message): Response
+    public function handle(PingRequest|HasMethodInterface $message, SessionInterface $session): Response
     {
         \assert($message instanceof PingRequest);
 

src/Server/RequestHandler/ReadResourceHandler.php

@@ -19,6 +19,7 @@ use Mcp\Schema\JsonRpc\HasMethodInterface;
 use Mcp\Schema\JsonRpc\Response;
 use Mcp\Schema\Request\ReadResourceRequest;
 use Mcp\Server\MethodHandlerInterface;
+use Mcp\Server\Session\SessionInterface;
 
 /**
  * @author Tobias Nyholm <tobias.nyholm@gmail.com>
@@ -35,7 +36,7 @@ final class ReadResourceHandler implements MethodHandlerInterface
         return $message instanceof ReadResourceRequest;
     }
 
-    public function handle(ReadResourceRequest|HasMethodInterface $message): Response|Error
+    public function handle(ReadResourceRequest|HasMethodInterface $message, SessionInterface $session): Response|Error
     {
         \assert($message instanceof ReadResourceRequest);