10 - Created a reference directory for the Page DTO

Author: larry.sulebalogun

src/Capability/Registry.php

@@ -27,7 +27,7 @@
 use Mcp\Schema\ResourceTemplate;
 use Mcp\Schema\ServerCapabilities;
 use Mcp\Schema\Tool;
-use Mcp\Server\RequestHandler\ReferencePage;
+use Mcp\Server\RequestHandler\Reference\Page;
 use Psr\EventDispatcher\EventDispatcherInterface;
 use Psr\Log\LoggerInterface;
 use Psr\Log\NullLogger;
@@ -248,15 +248,15 @@ public function getPrompt(string $name): ?PromptReference
     /**
      * Gets all registered tools.
      */
-    public function getTools(?int $limit = null, ?string $cursor = null): ReferencePage
+    public function getTools(?int $limit = null, ?string $cursor = null): Page
     {
         $tools = [];
         foreach ($this->tools as $toolReference) {
             $tools[$toolReference->tool->name] = $toolReference->tool;
         }
 
         if (null === $limit) {
-            return new ReferencePage($tools, null);
+            return new Page($tools, null);
         }
 
         $paginatedTools = $this->paginateResults($tools, $limit, $cursor);
@@ -267,21 +267,21 @@ public function getTools(?int $limit = null, ?string $cursor = null): ReferenceP
             $limit
         );
 
-        return new ReferencePage($paginatedTools, $nextCursor);
+        return new Page($paginatedTools, $nextCursor);
     }
 
     /**
      *  Gets all registered resources.
      */
-    public function getResources(?int $limit = null, ?string $cursor = null): ReferencePage
+    public function getResources(?int $limit = null, ?string $cursor = null): Page
     {
         $resources = [];
         foreach ($this->resources as $resourceReference) {
             $resources[$resourceReference->schema->uri] = $resourceReference->schema;
         }
 
         if (null === $limit) {
-            return new ReferencePage($resources, null);
+            return new Page($resources, null);
         }
 
         $paginatedResources = $this->paginateResults($resources, $limit, $cursor);
@@ -292,21 +292,21 @@ public function getResources(?int $limit = null, ?string $cursor = null): Refere
             $limit
         );
 
-        return new ReferencePage($paginatedResources, $nextCursor);
+        return new Page($paginatedResources, $nextCursor);
     }
 
     /**
      *  Gets all registered prompts.
      */
-    public function getPrompts(?int $limit = null, ?string $cursor = null): ReferencePage
+    public function getPrompts(?int $limit = null, ?string $cursor = null): Page
     {
         $prompts = [];
         foreach ($this->prompts as $promptReference) {
             $prompts[$promptReference->prompt->name] = $promptReference->prompt;
         }
 
         if (null === $limit) {
-            return new ReferencePage($prompts, null);
+            return new Page($prompts, null);
         }
 
         $paginatedPrompts = $this->paginateResults($prompts, $limit, $cursor);
@@ -317,21 +317,21 @@ public function getPrompts(?int $limit = null, ?string $cursor = null): Referenc
             $limit
         );
 
-        return new ReferencePage($paginatedPrompts, $nextCursor);
+        return new Page($paginatedPrompts, $nextCursor);
     }
 
     /**
      *  Gets all registered resource templates.
      */
-    public function getResourceTemplates(?int $limit = null, ?string $cursor = null): ReferencePage
+    public function getResourceTemplates(?int $limit = null, ?string $cursor = null): Page
     {
         $templates = [];
         foreach ($this->resourceTemplates as $templateReference) {
             $templates[$templateReference->resourceTemplate->uriTemplate] = $templateReference->resourceTemplate;
         }
 
         if (null === $limit) {
-            return new ReferencePage($templates, null);
+            return new Page($templates, null);
         }
 
         $paginatedTemplates = $this->paginateResults($templates, $limit, $cursor);
@@ -342,7 +342,7 @@ public function getResourceTemplates(?int $limit = null, ?string $cursor = null)
             $limit
         );
 
-        return new ReferencePage($paginatedTemplates, $nextCursor);
+        return new Page($paginatedTemplates, $nextCursor);
     }
 
     public function hasElements(): bool

src/Capability/Registry/ReferenceProviderInterface.php

@@ -11,9 +11,7 @@
 
 namespace Mcp\Capability\Registry;
 
-use Mcp\Schema\Prompt;
-use Mcp\Schema\Tool;
-use Mcp\Server\RequestHandler\ReferencePage;
+use Mcp\Server\RequestHandler\Reference\Page;
 
 /**
  * Interface for providing access to registered MCP elements.
@@ -46,22 +44,22 @@ public function getPrompt(string $name): ?PromptReference;
     /**
      * Gets all registered tools.
      */
-    public function getTools(?int $limit = null, ?string $cursor = null): ReferencePage;
+    public function getTools(?int $limit = null, ?string $cursor = null): Page;
 
     /**
      * Gets all registered resources.
      */
-    public function getResources(?int $limit = null, ?string $cursor = null): ReferencePage;
+    public function getResources(?int $limit = null, ?string $cursor = null): Page;
 
     /**
      * Gets all registered prompts.
      */
-    public function getPrompts(?int $limit = null, ?string $cursor = null): ReferencePage;
+    public function getPrompts(?int $limit = null, ?string $cursor = null): Page;
 
     /**
      * Gets all registered resource templates.
      */
-    public function getResourceTemplates(?int $limit = null, ?string $cursor = null): ReferencePage;
+    public function getResourceTemplates(?int $limit = null, ?string $cursor = null): Page;
 
     /**
      * Checks if any elements (manual or discovered) are currently registered.

src/Server/RequestHandler/ReferencePage.php renamed to src/Server/RequestHandler/Reference/Page.php

@@ -9,12 +9,12 @@
  * file that was distributed with this source code.
  */
 
-namespace Mcp\Server\RequestHandler;
+namespace Mcp\Server\RequestHandler\Reference;
 
 /**
  * @implements \ArrayAccess<int|string, mixed>
  */
-final class ReferencePage implements \Countable, \ArrayAccess
+final class Page implements \Countable, \ArrayAccess
 {
     /**
      * @param array<int|string, mixed> $references Items can be Tool, Prompt, ResourceTemplate, or Resource