Add annotations to tools

src/MCP/McpConnector.php

@@ -91,7 +91,8 @@ protected function createTool(array $item): ToolInterface
     {
         $tool = Tool::make(
             name: $item['name'],
-            description: $item['description'] ?? null
+            description: $item['description'] ?? null,
+            annotations: $item['annotations'] ?? [],
         )->setCallable(function (...$arguments) use ($item) {
             $response = \call_user_func($this->client->callTool(...), $item['name'], $arguments);
 

src/Tools/Tool.php

@@ -11,7 +11,7 @@
 use NeuronAI\StructuredOutput\Deserializer\DeserializerException;
 
 /**
- * @method static static make(?string $name = null, ?string $description = null, array $properties = [])
+ * @method static static make(?string $name = null, ?string $description = null, array $properties = [], array $annotations = [])
  */
 class Tool implements ToolInterface
 {
@@ -51,11 +51,13 @@ class Tool implements ToolInterface
      * Tool constructor.
      *
      * @param ToolPropertyInterface[] $properties
+     * @param array<string, mixed> $annotations
      */
     public function __construct(
         protected string $name,
         protected ?string $description = null,
-        array $properties = []
+        array $properties = [],
+        protected array $annotations = [],
     ) {
         if ($properties !== []) {
             $this->properties = $properties;
@@ -86,6 +88,14 @@ protected function properties(): array
         return [];
     }
 
+    /**
+     * @return array<string, mixed>
+     */
+    public function getAnnotations(): array
+    {
+        return $this->annotations;
+    }
+
     /**
      * @return ToolPropertyInterface[]
      */

src/Tools/ToolInterface.php

@@ -26,6 +26,12 @@ public function addProperty(ToolPropertyInterface $property): ToolInterface;
      */
     public function getProperties(): array;
 
+    /**
+     * Get the annotations present on the tool.
+     * @return array<string, mixed>
+     */
+    public function getAnnotations(): array;
+
     /**
      * Names of the required properties.
      *

tests/Tools/ToolTest.php

@@ -465,4 +465,16 @@ public function test_properties_declaration_on_constructor_with_parent_construct
         $this->assertEquals('test tool', $tool->getDescription());
         $this->assertEquals('test', $tool->getKey());
     }
+
+    public function test_annotations(): void
+    {
+        $tool = Tool::make('foo-bar', 'description', annotations: [
+            'readOnly' => true,
+            'idempotent' => false,
+        ]);
+        $this->assertEquals([
+            'readOnly' => true,
+            'idempotent' => false,
+        ], $tool->getAnnotations());
+    }
 }