feat: add Prompt/Resource/Tool Chain

Author: Nyholm

examples/cli/index.php

@@ -2,8 +2,8 @@
 
 require __DIR__.'/vendor/autoload.php';
 
-use Symfony\Component\Console\Output\OutputInterface;
 use Symfony\Component\Console as SymfonyConsole;
+use Symfony\Component\Console\Output\OutputInterface;
 
 $debug = (bool) ($_SERVER['DEBUG'] ?? false);
 

examples/cli/src/Builder.php

@@ -2,9 +2,9 @@
 
 namespace App;
 
-use App\Manager\PromptManager;
-use App\Manager\ResourceManager;
-use App\Manager\ToolManager;
+use PhpLlm\McpSdk\Capability\PromptChain;
+use PhpLlm\McpSdk\Capability\ResourceChain;
+use PhpLlm\McpSdk\Capability\ToolChain;
 use PhpLlm\McpSdk\Server\NotificationHandler;
 use PhpLlm\McpSdk\Server\NotificationHandler\InitializedHandler;
 use PhpLlm\McpSdk\Server\RequestHandler;
@@ -24,15 +24,15 @@ class Builder
      */
     public static function buildRequestHandlers(): array
     {
-        $promptManager = new PromptManager([
+        $promptManager = new PromptChain([
             new ExamplePrompt(),
         ]);
 
-        $resourceManager = new ResourceManager([
+        $resourceManager = new ResourceChain([
             new ExampleResource(),
         ]);
 
-        $toolManager = new ToolManager([
+        $toolManager = new ToolChain([
             new ExampleTool(),
         ]);
 

examples/cli/src/ExamplePrompt.php

@@ -6,12 +6,13 @@
 use PhpLlm\McpSdk\Capability\Prompt\PromptGet;
 use PhpLlm\McpSdk\Capability\Prompt\PromptGetResult;
 use PhpLlm\McpSdk\Capability\Prompt\PromptGetResultMessages;
+use PhpLlm\McpSdk\Capability\Prompt\PromptGetterInterface;
 
-class ExamplePrompt implements MetadataInterface
+class ExamplePrompt implements MetadataInterface, PromptGetterInterface
 {
-    public function __invoke(PromptGet $request): PromptGetResult
+    public function get(PromptGet $input): PromptGetResult
     {
-        $firstName = $request->arguments['first name'] ?? null;
+        $firstName = $input->arguments['first name'] ?? null;
 
         return new PromptGetResult(
             $this->getDescription(),

examples/cli/src/ExampleResource.php

@@ -4,11 +4,12 @@
 
 use PhpLlm\McpSdk\Capability\Resource\MetadataInterface;
 use PhpLlm\McpSdk\Capability\Resource\ResourceRead;
+use PhpLlm\McpSdk\Capability\Resource\ResourceReaderInterface;
 use PhpLlm\McpSdk\Capability\Resource\ResourceReadResult;
 
-class ExampleResource implements MetadataInterface
+class ExampleResource implements MetadataInterface, ResourceReaderInterface
 {
-    public function __invoke(ResourceRead $request): ResourceReadResult
+    public function read(ResourceRead $input): ResourceReadResult
     {
         return new ResourceReadResult(
             'Content of '.$this->getName(),

examples/cli/src/ExampleTool.php

@@ -5,12 +5,13 @@
 use PhpLlm\McpSdk\Capability\Tool\MetadataInterface;
 use PhpLlm\McpSdk\Capability\Tool\ToolCall;
 use PhpLlm\McpSdk\Capability\Tool\ToolCallResult;
+use PhpLlm\McpSdk\Capability\Tool\ToolExecutorInterface;
 
-class ExampleTool implements MetadataInterface
+class ExampleTool implements MetadataInterface, ToolExecutorInterface
 {
-    public function __invoke(ToolCall $toolCall): ToolCallResult
+    public function call(ToolCall $input): ToolCallResult
     {
-        $format = $toolCall->arguments['format'] ?? 'Y-m-d H:i:s';
+        $format = $input->arguments['format'] ?? 'Y-m-d H:i:s';
 
         return new ToolCallResult(
             (new \DateTime('now', new \DateTimeZone('UTC')))->format($format)

src/Capability/Prompt/IdentifierInterface.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace PhpLlm\McpSdk\Capability\Prompt;
+
+interface IdentifierInterface
+{
+    public function getName(): string;
+}

src/Capability/Prompt/MetadataInterface.php

@@ -4,10 +4,8 @@
 
 namespace PhpLlm\McpSdk\Capability\Prompt;
 
-interface MetadataInterface
+interface MetadataInterface extends IdentifierInterface
 {
-    public function getName(): string;
-
     public function getDescription(): ?string;
 
     /**

src/Capability/Prompt/PromptGetterInterface.php

@@ -11,5 +11,5 @@ interface PromptGetterInterface
      * @throws PromptGetException      if the prompt execution fails
      * @throws PromptNotFoundException if the prompt is not found
      */
-    public function get(PromptGet $request): PromptGetResult;
+    public function get(PromptGet $input): PromptGetResult;
 }

examples/cli/src/Manager/PromptManager.php renamed to src/Capability/PromptChain.php

@@ -1,42 +1,43 @@
 <?php
 
-namespace App\Manager;
+namespace PhpLlm\McpSdk\Capability;
 
 use PhpLlm\McpSdk\Capability\Prompt\CollectionInterface;
+use PhpLlm\McpSdk\Capability\Prompt\IdentifierInterface;
 use PhpLlm\McpSdk\Capability\Prompt\MetadataInterface;
 use PhpLlm\McpSdk\Capability\Prompt\PromptGet;
 use PhpLlm\McpSdk\Capability\Prompt\PromptGetResult;
 use PhpLlm\McpSdk\Capability\Prompt\PromptGetterInterface;
 use PhpLlm\McpSdk\Exception\PromptGetException;
 use PhpLlm\McpSdk\Exception\PromptNotFoundException;
 
-class PromptManager implements PromptGetterInterface, CollectionInterface
+class PromptChain implements PromptGetterInterface, CollectionInterface
 {
     public function __construct(
         /**
-         * @var (MetadataInterface | callable(PromptGet):PromptGetResult)[]
+         * @var (IdentifierInterface & (MetadataInterface | PromptGetterInterface))[]
          */
         private array $items,
     ) {
     }
 
     public function getMetadata(): array
     {
-        return $this->items;
+        return array_filter($this->items, fn ($item) => $item instanceof MetadataInterface);
     }
 
-    public function get(PromptGet $request): PromptGetResult
+    public function get(PromptGet $input): PromptGetResult
     {
         foreach ($this->items as $item) {
-            if ($request->name === $item->getName()) {
+            if ($item instanceof PromptGetterInterface && $input->name === $item->getName()) {
                 try {
-                    return $item($request);
+                    return $item->get($input);
                 } catch (\Throwable $e) {
-                    throw new PromptGetException($request, $e);
+                    throw new PromptGetException($input, $e);
                 }
             }
         }
 
-        throw new PromptNotFoundException($request);
+        throw new PromptNotFoundException($input);
     }
 }

src/Capability/Resource/IdentifierInterface.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace PhpLlm\McpSdk\Capability\Resource;
+
+interface IdentifierInterface
+{
+    public function getUri(): string;
+}